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 در همین صفحه است.