← همه مقالات
دیپلوی

دیپلوی ریپوی خصوصی GitHub روی Weblines Cloud — سه روش، از ساده تا کنترل‌شده

ریپوی خصوصی را بدون ساختن image با دست دیپلوی کن: اتصال GitHub، Access Token یا Deploy Key — کدام را کی انتخاب کنیم و قدم‌به‌قدم.

کدِ بیشترِ تیم‌ها در ریپوی خصوصی است. در Weblines Cloud (ابر وب‌لاینز) لازم نیست برای دیپلوی، خودت image بسازی و در registry منتشر کنی: ریپوی خصوصی را مستقیم وصل می‌کنی و build و اجرا با پلتفرم است.

کدام روش؟#

روشمناسب برایURL ریپو
اتصال GitHubساده‌ترین؛ وقتی GitHub را در تنظیماتِ سازمان (Integrations) وصل کرده‌ایاز لیستِ ریپوها انتخاب می‌شود
Access TokenGitLab، Gitea یا هر میزبانِ گیت با توکنhttps://…
Deploy Keyکمترین دسترسی: کلیدی فقط برای همین یک ریپو، فقط خواندنیSSH، مثلاً [email protected]:org/app.git

اگر نمی‌دانی کدام، با اتصال GitHub شروع کن. اگر امنیت و جداسازی مهم‌تر است، Deploy Key.

قدم‌ها در ویزارد#

  1. Services → + NEW SERVICE → Custom app را باز کن.
  2. در مرحله‌ی SOURCE، گزینه‌ی Git Repo را بزن و ریپو و branch را بده — یا با «Use a connected GitHub repo» از لیست انتخاب کن.
  3. در مرحله‌ی OPTIONS، زیرِ Repo access روش را انتخاب کن:
    • Access Token: توکن را وارد کن (نام‌کاربری اختیاری است).
    • Deploy Key: کلیدِ خصوصی را وارد کن، یا کلیدی را که قبلاً ذخیره کرده‌ای انتخاب کن. کلیدِ عمومیِ همان جفت را در تنظیماتِ ریپو (Deploy keys، فقط Read) اضافه کن.
  4. پورتی را که اپ رویش گوش می‌دهد بده (پیش‌فرض برای گیت: 3000) و در صورتِ نیاز روشِ build را از Auto به Dockerfile یا Docker Compose عوض کن.
  5. در REVIEW، GENERATE را بزن. لاگِ build زنده در همان ویزارد می‌آید تا اپ روی زیردامنه‌ی weblines.ir بالا بیاید.

ساختنِ Deploy Key#

روی سیستمِ خودت:

bash
ssh-keygen -t ed25519 -C "weblines-deploy" -f ./weblines-deploy -N ""
  • weblines-deploy.pub (عمومی) → در GitHub: Settings → Deploy keys → Add deploy key، فقط Read.
  • weblines-deploy (خصوصی) → در ویزاردِ Weblines.

خطاهای رایج#

  • Permission denied (publickey) — کلیدِ عمومی در ریپو اضافه نشده، یا URL به‌جای SSH با https:// است.
  • authentication failed با توکن — توکن منقضی شده یا دسترسیِ خواندنِ ریپو را ندارد.
  • build موفق ولی سایت بالا نمی‌آید — پورتِ ویزارد با پورتی که اپ رویش گوش می‌دهد یکی نیست.

راهنمای کامل‌تر در مستندات: ساخت از Git.

بعد از دیپلوی#

  • تغییرِ کد را با دکمه‌ی DEPLOY روی کارتِ اپ منتشر کن؛ FULL BUILD فقط وقتی لازم است که وابستگی‌ها یا Dockerfile عوض شده.
  • دیتابیس لازم داری؟ PostgreSQL مدیریت‌شده در چند کلیک — از کارتِ اپ به آن لینکش کن تا DATABASE_URL تزریق شود، و یک بار DEPLOY بزن.

مقالات مرتبط