Упражнение. Создание действия GitHub для создания образа контейнера

Завершено

В этом уроке вы выполните следующие задачи:

  • Создайте действие GitHub для реализации конвейера сборки.
  • Измените код сервиса купонов, чтобы запустить процесс сборки.
  • Отслеживайте ход выполнения рабочего процесса сборки в режиме реального времени.

Создание действия сборки

Код YAML в этой процедуре определяет действие GitHub, которое:

  • Срабатывает при отправке фиксации в исходный код службы купонов или её модульные тесты в ветви main.
  • Определяет переменные среды, специфичные для определенного шага.
  • Имеет задание или набор шагов, выполняющихся на том же исполнителе рабочего процесса с именем Build and push image to ACR.

Важный

Условия триггера и другие артефакты действий или рабочих процессов GitHub зависят от приложений и сред. Чтобы было легче понять, в этом примере детали упрощены. Рабочие процессы сборки и развертывания охватывают изменения продуктовых сервисов, поскольку все микросервисы хранятся в едином репозитории. В фактическом рабочем сценарии каждая микрослужба будет храниться в отдельном репозитории.

Выполните следующие действия, чтобы создать действие сборки GitHub Actions:

  1. В вашем форкнутом репозитории на GitHub выберите вкладку Actions.

  2. На странице Get started with GitHub Actions выберите ссылку set up a workflow yourself.

    Снимок экрана: вкладка

  3. На следующей странице вставьте следующий код YAML в редактор.

    name: Build and deploy an app to AKS
    
    on:
      push:
        branches: ["main"]
      workflow_dispatch:
    
    env:
      # Local environment variables used later in the workflow
      AZURE_CONTAINER_REGISTRY: 'name of your Azure Container Registry'
      CONTAINER_NAME: 'productservice'
      RESOURCE_GROUP: 'rg-eshop'
      CLUSTER_NAME: 'aks-eshop'
      DEPLOYMENT_MANIFEST_PATH: './product.yml'
      DOCKER_PATH: './DockerfileProducts.acr'
    
    jobs:
      buildImage:
        permissions:
          contents: read
          id-token: write
        runs-on: ubuntu-latest
        steps:
          # Checks out the repository this file is in
          - uses: actions/checkout@v3
    
          # Logs in with your Azure credentials stored in GitHub secrets
          - name: Azure login
            uses: azure/login@v1.4.6
            with:
              creds: '${{ secrets.AZURE_CREDENTIALS }}'
    
          # Builds and pushes an image up to your Azure Container Registry
          - name: Build and push image to ACR
            run: |
              az acr build --file ${{ env.DOCKER_PATH }} --image ${{ env.AZURE_CONTAINER_REGISTRY }}.azurecr.io/${{ env.CONTAINER_NAME }}:${{ github.sha }} --registry ${{ env.AZURE_CONTAINER_REGISTRY }} -g ${{ env.RESOURCE_GROUP }} .
    
    

    Замените имя реестра контейнеров Azure именем ACR, созданным на предыдущем уроке; например, acseshop186748394.

  4. Замените имя файла main.yml рабочего процесса по умолчанию azure-kubernetes-service.yml, а затем выберите Commit changes.

  5. Commit changes На экране выберите Commit directly to the main branchи выберите Commit changes.

    Вы завершили создание рабочего процесса сборки для конвейера CI/CD.

  6. В терминале выполните следующую команду, чтобы просмотреть текущие версии службы продуктов, хранящиеся в ACR:

    az acr repository show-tags -n AZURE_CONTAINER_REGISTRY --repository productservice --orderby time_desc --output table
    

    Заменив AZURE_CONTAINER_REGISTRY именем ACR, вы увидите выходные данные, аналогичные следующим:

    Result
    ----------------------------------------
    v1
    

Запуск сборки

Рабочий процесс сборки запускается автоматически, как только вы коммитите файл рабочего процесса. Вы также можете активировать сборку вручную.

  1. В репозитории выберите вкладку Actions.
  2. Слева в разделе All workflowsвыберите рабочий процесс Build and deploy an app to AKS, а затем выберите Run workflow.

Мониторинг сборки

Чтобы просмотреть ход выполнения сборки в режиме реального времени, выполните следующие действия.

  1. В репозитории выберите вкладку Actions.

  2. Выберите последний запуск рабочего процесса, указанный для Build and deploy an app to AKS рабочего процесса. Имя выполнения — это сообщение фиксации, используемое на предыдущем шаге.

  3. Выберите задание buildImage.

    Снимок экрана: рабочий процесс GitHub.

  4. Если подождите несколько минут, шаги в задании должны завершиться успешно.

  5. В терминале выполните эту команду еще раз, чтобы просмотреть версии службы продуктов, хранящиеся в ACR.

    az acr repository show-tags -n AZURE_CONTAINER_REGISTRY --repository productservice --orderby time_desc --output table
    

    Вы увидите выходные данные, аналогичные приведенному ниже, где показана новая версия образа, добавленная в ACR из рабочего процесса GitHub:

    Result
    ----------------------------------------
    8c75edb7a349ec570bd4eac397015bc3c547186e
    v1