Rayno DocsRayno Cloud v2.2.0
docsci-cd

CI/CD با GitHub و GitLab

ساخت ایمیج در CI خارجی، انتشار Registry و Deploy فقط با Image آماده.

# CI/CD با GitHub Actions و GitLab CI

در Rayno Cloud، ساخت برنامه همیشه در CI runner انجام می‌شود؛ سرورهای Worker فقط ایمیج آماده را از رجیستری دریافت می‌کنند. قالب‌های آماده در مخزن داخل rayno-cloud/ci/templates/ قرار دارند.

GitHub Actions

فایل .github/workflows/rayno-deploy.yml را از قالب rayno-cloud/ci/templates/github-actions/deploy.yml کپی کنید. این Workflow روی GitHub-hosted runner ایمیج را می‌سازد، با commit SHA تگ می‌کند، به GHCR Push می‌کند و با CLI نسخه را deploy می‌کند.

Secretهای لازم:

  • RAYNO_TOKEN: کلید API با حداقل دسترسی لازم.
  • RAYNO_API_URL: اختیاری؛ مقدار پیش‌فرض https://api.rayno.cloud/api/v1.
  • REGISTRY_USER و REGISTRY_TOKEN فقط در صورت استفاده از رجیستری خصوصی و در مرحله Push لازم‌اند.

GitLab CI

قالب rayno-cloud/ci/templates/gitlab/.gitlab-ci.yml را به پروژه اضافه کنید. Runner باید Docker-in-Docker یا BuildKit سازگار داشته باشد. RAYNO_TOKEN را به‌صورت Masked و Protected CI Variable تعریف کنید.

سیاست ایمیج و رجیستری

  • به هر Build یک تگ غیرقابل‌تغییر مانند $CI_COMMIT_SHA اختصاص دهید.
  • ایمیج را در Registry منتشر کنید.
  • برای رجیستری خصوصی، قبل از Deploy باید روی Workerها Pull Credential/Registry Secret به‌شکل امن پیکربندی شده باشد. قالب کاربر فعلاً مرحله‌ی Push و Deploy را نشان می‌دهد؛ تزریق credential رجیستری خصوصی از مسیر محصول باید جداگانه فعال و آزموده شود. گزینه‌ی ساده‌تر، ایمیج public با دسترسی محدود به محتواست.
  • خطاهای تست و Build در رابط GitHub/GitLab و لاگ Jobها ثبت می‌شوند؛ Worker لاگ Build ندارد چون Build نمی‌کند.

سه محیط

برای local، staging و production از Secretها، رجیستری‌ها و دامنه‌های مجزا استفاده کنید. از انتشار مستقیم branch توسعه به production خودداری کنید. نسخه‌ی production باید از commit تاییدشده و با tag immutable ساخته شود.

محدودیت فعلی

اتصال OAuth گیت برای دسترسی به مخزن می‌تواند در Control Plane ثبت شود، اما webhook عمومی نصب‌شونده روی هر repository و اجرای خودکار pipeline با GitHub App در این نسخه کامل نشده است. راهکار قابل استفاده‌ی فعلی، Workflowهای GitHub Actions/GitLab CI در همین صفحه است.

آخرین به‌روزرسانی: مستندات نسخه پلتفرم (Rayno Cloud v2.2.0)مشکلی در مستندات پیدا کردید؟ تیکت بزنید