پرش به مطلب اصلی

راه‌اندازی CI/CD به وسیله Gitlab

گیت لب برای راه اندازی CI/CD از Gitlab Piplines استفاده می کند که می توانید مستندات آن را در اینجا مشاهده کنید و به صورت کامل با آن آشنا شوید. در این صفحه از مستندات با مراحل راه‌اندازی CI/CD به وسیله Gitlab برای سرویس های چابکان آشنا می شویم.

انتخاب CLI و Token مقصد​

برای چابکان از @chabokan.net/cli، chabok login و chabok deploy استفاده کنید؛ برای کلودیوا از @cloudiva.net/cli، diva login و diva deploy. نمونهٔ پنل مقصد را از زبانهٔ مربوط انتخاب کنید.

در مثال چابکان secret با نام CHABOKAN_TOKEN و در مثال کلودیوا با نام CLOUDIVA_TOKEN تعریف می‌شود. مقدار secret باید Token مدیریت همان پنل باشد: Token چابکان یا Token کلودیوا. نام متغیر را می‌توانید تغییر دهید، ولی تعریف secret و ارجاع آن در pipeline باید یکسان باشد. API Key هوش مصنوعی جایگزین این Token نیست.

مرحله اول​

در ابتدا نیاز دارید که یک فایل با نام  زیر در مسیر اصلی پروژه‌ی خود ایجاد کنید:

.gitlab-ci.yml

و سپس قطعه‌کد زیر را در این فایل قرار دهید:

image: node:24-alpine

stages:
  - update-service

deploy:
  stage: update-service
  only:
    - main
  script:
    - npm install -g @chabokan.net/cli
    - chabok login -t $CHABOKAN_TOKEN
    - chabok deploy -s my-service

با ایجاد فایل بالا شما به درستی فرآیند CI و CD را در گیت لب فعال کرده اید. همانطور که در کد بالا مشاهده میکنید، ابتدا CLI پنل مقصد نصب می‌شود؛ سپس با chabok login و chabok deploy در چابکان یا diva login و diva deploy در کلودیوا، ورود و استقرار انجام می‌شود.

توجه

توجه کنید که بجای my-service باید نام سرویسی که در پنل مقصد، چابکان یا کلودیوا، ایجاد کرده‌اید را بنویسید.

مرحله دوم​

اگر به فایل .gitlab-ci.yml دقت کرده باشید secret با نام CHABOKAN_TOKEN در نمونهٔ چابکان یا CLOUDIVA_TOKEN در نمونهٔ کلودیوا وجود دارد که مقدار آن Token مدیریت همان پنل است که باید آن را به گیت لب معرفی نمایید. برای به دست آوردن api token شخصی حساب کاربری خود باید وارد صفحهٔ کلید دسترسی چابکان یا کلید دسترسی کلودیوا متناسب با مقصد شوید و کلید خود را دریافت کنید.

راه‌اندازی CI/CD از طریق Gitlab در چابکان

مرحله سوم​

حالا که ما api token را به دست آوردیم باید آن را به گیت لب معرفی کنیم. برای این کار وارد تنظیمات CI/CD ریپازیتوری شوید و کمی به پایین اسکرول کنید. در بخش Variables بر روی گزینه‌ی Expand کلیک کنید تا گزینه‌ی Add Variable نمایش داده شود. حال برای تعریف یک Variable جدید، روی گزینه‌ی Add Variable کلیک کنید. نام (Key) این Variable را  CHABOKAN_TOKEN برای چابکان یا CLOUDIVA_TOKEN برای کلودیوا  و مقدار آن را از صفحهٔ Token چابکان یا Token کلودیوا متناسب با مقصد کپی کرده و در بخش Value قرار دهید. پس از انتخاب گزینه‌های Mask variable، بر روی گزینه‌ی Add variable کلیک کنید.

راه‌اندازی CI/CD از طریق Gitlab در چابکان

مرحله چهارم​

اگر تمام مراحل بالا به درستی انجام داده باشید، فرآیند CI و CD شما با موفقت تنظیم شده است و با push کردن در برنچ Main فرآیند CI و CD شما شروع می شود.