نصب و ورود

نصب

Linux و macOS

curl -fsSL https://get.gerdoo.cloud/install.sh | sh
gerdoo version

اسکریپت سیستم‌عامل و معماری (amd64 یا arm64) را تشخیص می‌دهد و gerdoo را در /usr/local/bin می‌گذارد. اگر آن پوشه برای کاربر شما قابل نوشتن نباشد، فقط برای جابه‌جا کردن فایل sudo می‌خواهد. برای نصب در پوشهٔ دیگر، قبل از اجرا GERDOO_BIN_DIR را تنظیم کنید.

Windows

در PowerShell:

irm https://get.gerdoo.cloud/install.ps1 | iex
gerdoo version

بدون نیاز به دسترسی ادمین در %LOCALAPPDATA%\Programs\gerdoo نصب و به PATH کاربر اضافه می‌شود. بعد از نصب، یک پنجرهٔ PowerShell تازه باز کنید.

نصب دستی

curl -fL https://get.gerdoo.cloud/cli/latest/gerdoo_linux_amd64 -o gerdoo
chmod +x gerdoo
sudo mv gerdoo /usr/local/bin/gerdoo

فایل‌های دیگر: gerdoo_linux_arm64، gerdoo_darwin_amd64، gerdoo_darwin_arm64 (مک با تراشهٔ Apple) و gerdoo_windows_amd64.exe. برای راستی‌آزمایی، checksums.txt همان پوشه را ببینید.

به‌روزرسانی

gerdoo upgrade

آخرین نسخه را دانلود، با checksums.txt راستی‌آزمایی و جایگزین می‌کند. اگر نسخهٔ تازه‌ای بیرون آمده باشد، CLI روزی یک بار یادآوری می‌کند.

ورود

gerdoo login

CLI یک کد کوتاه نشان می‌دهد و صفحهٔ تأیید را در مرورگر باز می‌کند. مطمئن شوید کد صفحه با کد ترمینال یکی است و «تأیید» را بزنید. CLI توکن خودش را می‌گیرد و ذخیره می‌کند.

gerdoo whoami    # حسابی که وارد آن هستید
gerdoo logout    # پاک کردن توکن ذخیره‌شده

توکن در این فایل ذخیره می‌شود (فقط برای کاربر شما قابل خواندن):

• Linux: ~/.config/gerdoo/config.json
• macOS: ~/Library/Application Support/gerdoo/config.json
• Windows: %AppData%\gerdoo\config.json

در CI

gerdoo login لازم نیست. یک توکن API بسازید (ترجیحاً محدود به یک اپلیکیشن)، آن را در Secretهای CI بگذارید و به شکل متغیر GERDOO_TOKEN به CLI بدهید:

# GitHub Actions
- run: curl -fsSL https://get.gerdoo.cloud/install.sh | sh
- run: gerdoo deploy -y --service api
  env:
    GERDOO_TOKEN: ${{ secrets.GERDOO_TOKEN }}

-y جلوی سؤال تأیید را می‌گیرد و --service مشخص می‌کند کدام سرویس به‌روز شود (در CI پوشهٔ .gerdoo وجود ندارد).

اگر به خطا خوردید

gerdoo: command not found

پوشهٔ نصب در PATH نیست. ترمینال را دوباره باز کنید، یا /usr/local/bin (یا پوشه‌ای که با GERDOO_BIN_DIR داده‌اید) را به PATH اضافه کنید.

در macOS: «cannot be opened because the developer cannot be verified»

اگر فایل را دستی با مرورگر دانلود کرده‌اید، macOS آن را قرنطینه می‌کند. xattr -d com.apple.quarantine /usr/local/bin/gerdoo را اجرا کنید، یا از اسکریپت نصب استفاده کنید.

401 یا «نشست شما منقضی شده است»

توکن باطل شده (مثلاً از تنظیمات ابطالش کرده‌اید). دوباره gerdoo login کنید.