نصب و ورود

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

نصب خودکار با 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 آدرس API را نشان می‌دهد، سپس ایمیل یا شماره موبایل و رمز عبور را می‌پرسد و یک توکن مخصوص CLI دریافت می‌کند.

توکن در ~/.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