نصب و ورود

نصب و به‌روزرسانی

نصب خودکار با install.sh یا نصب دستی باینری مناسب سیستم.

روش پیشنهادی نصب، اجرای دستور curl -fsSL https://get.gerdoo.cloud/install.sh | sh است. این اسکریپت روی Linux و macOS معماری amd64 و arm64 را تشخیص می‌دهد و فایل مناسب را از https://get.gerdoo.cloud  دریافت می‌کند.

مسیر نصب پیش‌فرض /usr/local/bin است. اگر این مسیر برای کاربر فعلی قابل نوشتن نباشد، اسکریپت هنگام انتقال باینری از sudo استفاده می‌کند. برای نصب در مسیر دیگر، متغیر GERDOO_BIN_DIR را تنظیم کنید.

برای نصب دستی، فایل gerdoo_<os>_<arch> را از صفحه releases دانلود کنید، با chmod +x اجرایی کنید و با نام gerdoo در یکی از مسیرهای PATH قرار دهید. در Windows فایل gerdoo_windows_amd64.exe را دانلود و روی PATH قرار دهید.

پس از نصب، با gerdoo version نسخه نصب‌شده را بررسی کنید.

ورود، خروج و توکن‌ها

احراز هویت با حساب گردو و استفاده از توکن در CI.

برای شروع، gerdoo login را اجرا کنید. CLI یک کد کوتاه نمایش می‌دهد و مرورگر شما را روی صفحهٔ تأیید گردو باز می‌کند؛ کافی است کد نمایش‌داده‌شده در ترمینال را با کد داخل صفحه مقایسه و ورود را تأیید کنید. سپس CLI به‌صورت خودکار توکن خود را دریافت می‌کند. رمز عبور شما هرگز در ترمینال وارد نمی‌شود — همین موضوع باعث می‌شود بتوانید با خیال راحت اجازه دهید یک دستیار هوش مصنوعی از CLI استفاده کند.

اگر مرورگر به‌طور خودکار باز نشد یا روی ماشین راه دور کار می‌کنید، gerdoo login --no-browser آدرس را چاپ می‌کند تا خودتان بازش کنید. اگر از قبل توکن دارید، gerdoo login --token grd_... آن را ذخیره می‌کند. برای ماشین‌هایی که مرورگر ندارند و توکن هم از قبل ساخته نشده، gerdoo login --password همان روش قدیمی ایمیل/موبایل و رمز عبور را اجرا می‌کند.

توکن در ~/.config/gerdoo/config.json ذخیره می‌شود. gerdoo whoami حساب فعلی را نشان می‌دهد و gerdoo logout فایل تنظیمات را حذف می‌کند.

اگر می‌خواهید به API دیگری وصل شوید، از gerdoo login --api <url> یا متغیر GERDOO_API استفاده کنید. مقدار پیش‌فرض https://api.gerdoo.cloud  است.

در CI/CD، بهتر است توکن را به صورت secret نگهداری کنید و هنگام اجرا با GERDOO_TOKEN در اختیار CLI بگذارید. در این حالت نیازی به اجرای gerdoo login نیست.

نصب سریع

اسکریپت install.sh سیستم‌عامل و معماری را تشخیص می‌دهد، باینری مناسب را دانلود می‌کند و آن را در /usr/local/bin نصب می‌کند.

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

نصب دستی

برای نصب دستی، فایل gerdoo_<os>_<arch> مناسب سیستم خود را از releases یا مسیر دانلود دریافت کنید، اجرایی کنید و روی PATH قرار دهید.

# نمونه Linux amd64
curl -fL https://get.gerdoo.cloud/cli/latest/gerdoo_linux_amd64 -o gerdoo
chmod +x gerdoo
sudo mv gerdoo /usr/local/bin/gerdoo
gerdoo version