راه‌اندازی CI/CD در برنامه با Github

برای راه‌اندازی CI/CD در GitHub می‌توانید از قابلیت GitHub Actions استفاده کنید. در ابتدا یک پوشه به نام github. در مسیر اصلی پروژه‌‌تان ایجاد کرده و سپس پوشه‌ی دیگری به نام workflows داخل آن ایجاد کنید تا مسیر github/workflows. در پروژه‌ی شما قرار بگیرد. در این مسیر می‌توان Actionهای مورد نظر را تعریف کرد بنابراین یک فایل با نام liara.yaml را در این مسیر ایجاد کرده و قطعه‌کد زیر را در این فایل قرار دهید:

name: CD-Liara
on:
push:
  branches:
    - main
jobs:
deploy:
  runs-on: ubuntu-latest

  steps:
    - uses: actions/checkout@v3
    - uses: actions/setup-node@v3
      with:
        node-version: "22"
    - name: update-liara
      env:
        LIARA_TOKEN: ${{ secrets.LIARA_API_TOKEN }}
      run: |
        npm i -g @liara/cli@9
        liara deploy --app="APP_NAME" --api-token="$LIARA_TOKEN" --no-app-logs

در مثال فوق باید مقدار APP_NAME را با شناسه‌ی برنامه‌تان در لیارا جایگزین کنید. در صورت نیاز به تنظیم پورتی مانند 3000 که برنامه‌ی شما روی آن اجرا می‌شود لازم است پارامتر port=3000-- را هم برای دستور liara deploy تنظیم کنید.

در صورتی که از تیم‌ها در لیارا استفاده می‌کنید و می‌خواهید برنامه را در یک تیم خاص مستقر کنید، باید پارامتر "team-id="your-team-id-- را هم به دستور liara deploy اضافه کنید و مقدار your-team-id را با شناسه‌ی تیم خود جایگزین نمایید.

در قطعه‌کد فوق تمام مراحل لازم برای استقرار یک پروژه در لیارا تعریف شده است. در ابتدا ابزار Liara CLI نصب شده و سپس دستور liara deploy اجرا می‌شود. پس از شخصی‌سازی مقدار APP_NAME در فایل liara.yaml باید کلید دسترسی به API حساب‌تان را در بخش Secret تنظیمات ریپازیتوری GitHub اضافه کنید.

برای این کار وارد تنظیمات ریپازیتوری شوید و از منوی Secrets، روی گزینه‌ی Actions کلیک کنید.

سپس برای تعریف یک Secret جدید، روی گزینه‌ی New repository secret کلیک کنید. نام این Secret را LIARA_API_TOKEN و مقدار آن را از صفحه‌ی کلید دسترسی به API کپی کرده و در بخش Value قرار داده و بر روی گزینه‌ی Add secret کلیک کنید.

در آخر با push کردن فایل github/workflows/liara.yaml. در ریپازیتوری GitHub متوجه خواهید شد که یک pipeline به‌صورت خودکار در تب Action ریپازیتوری شما اجرا شده است و شما نیز می‌توانید مراحل استقرار پروژه‌ی خود را در صفحه‌ی تاریخچه دنبال کنید.

در برخی موارد، لازم است چند محیط جداگانه برای برنامه‌تان ایجاد کنید. به عنوان مثال ممکن است برنامه‌تان در سه محیط test, staging و production قرارداشته باشد و بخواهید برای هر محیط یک CI/CD جدا راه‌اندازی کنید. در این صورت، ابتدا باید سه برنامه و سه branch جدا ایجاد کنید. در این حالت، هر branch به یک برنامه اشاره دارد. سپس می‌بایست فایل github/workflows/liara.yaml. را به شکل زیر بنویسید:

name: CD-Liara

on:
push:
  branches:
    - main
    - test
    - staging

jobs:
deploy:
  runs-on: ubuntu-latest

  steps:
    - uses: actions/checkout@v3
    - uses: actions/setup-node@v3
      with:
        node-version: "18"

    - name: Install Liara CLI
      run: npm i -g @liara/cli@7

    - name: Deploy
      env:
        LIARA_TOKEN: ${{ secrets.LIARA_API_TOKEN }}
      run: |
        if [ ${{ github.ref }} == 'refs/heads/master' ]; then
          liara deploy --app="my-production-app" --api-token="$LIARA_TOKEN" --no-app-logs
        elif [ ${{ github.ref }} == 'refs/heads/test' ]; then
          liara deploy --app="my-test-app" --api-token="$LIARA_TOKEN" --no-app-logs
        elif [ ${{ github.ref }} == 'refs/heads/staging' ]; then
          liara deploy --app="my-staging-app" --api-token="$LIARA_TOKEN" --no-app-logs
        fi

توجه داشته باشید که در این مثال، branch های master, test و staging به ترتیب برای محیط‌های production, test و staging انتخاب‌شده اند. شما می‌توانید با توجه به برنامه خود، نام branch ها را تغییر دهید. در سه دستور liara deploy نام برنامه‌ها برای محیط‌های production, test و staging به ترتیب my-production-app, my-test-app و my-staging-app انتخاب‌‌شده است. شما باید با توجه برنامه‌‌های خود، نام برنامه‌ها را تغییر دهید.