Поделиться через


Создание конвейера CI/CD GitHub Actions с помощью интерфейса командной строки разработчика Azure

В этой статье вы узнаете, как использовать интерфейс командной строки разработчика Azure (azd) для создания конвейера CI/CD GitHub Actions для шаблона azd. Этот конвейер позволяет отправлять обновления шаблонов в репозиторий кода и автоматически подготавливать и развертывать изменения в среде Azure.

Note

Команда azd pipeline config находится в бета-версии. Дополнительные сведения см. в стратегии управления версиями компонентов и выпуска.

Prerequisites

Инициализация шаблона

В этом примере используется шаблон Hello-AZD , но вы можете выполнить следующие действия для любого azd шаблона, включающего файл определения конвейера (обычно найденный в папке .github или .azdo папках).

  1. В пустом hello-azd каталоге инициализируйте шаблон:

    azd init -t hello-azd
    
  2. При появлении запроса введите имя среды, например helloazd.

Создание конвейера с помощью GitHub Actions

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

  1. В терминале в корне шаблона выполните следующую команду:

    azd pipeline config
    
  2. При появлении запроса на выбор поставщика выберите GitHub.

    ? Select a provider:  [Use arrows to move, type to filter]
    > GitHub
      Azure DevOps
    
  3. Выберите нужную подписку и регион Azure.

  4. При появлении запроса на настройку удаленного репозитория выберите Create новый частный репозиторий GitHub. Если у вас есть существующий проект, который вы хотите использовать, можно также выбрать Выбрать существующий проект GitHub.

    ? How would you like to configure your git remote to GitHub?  [Use arrows to move, type to filter]
      Select an existing GitHub project
    > Create a new private GitHub repository
      Enter a remote URL directly
    
  5. Введите имя нового репозитория.

  6. При появлении запроса на коммит и отправку локальных изменений для запуска нового процесса GitHub Actions введите y.

  7. Просмотрите выходные данные в терминале. Команда azd pipeline config отображает имя репозитория GitHub для проекта.

    Note

    По умолчанию azd pipeline config настраивает OpenID Connect (OIDC), который также называется федеративными учетными данными. Чтобы использовать учетные данные клиента, выполните команду azd pipeline config --auth-type client-credentials.

    OIDC/федеративные учетные данные не поддерживаются для Terraform.

    Дополнительные сведения о поддержке OIDC см. в azdразделе .

  8. В браузере откройте репозиторий GitHub для проекта.

  9. Выберите действия , чтобы просмотреть запущенный рабочий процесс.

    Скриншот выполняющегося рабочего процесса GitHub.

Тестирование конвейера с изменением кода

  1. В каталоге /src/components/pages проекта откройте Home.razorфайл .

  2. Hello AZD! Найдите текст заголовка в верхней части файла.

  3. Измените текст на Hello, pipeline!.

  4. Сохраните файл.

  5. Зафиксируйте и отправьте изменения. Это действие активирует конвейер GitHub Actions для развертывания обновления.

    Снимок экрана: шаги, необходимые для внесения и фиксации изменений в тестовый файл.

  6. В браузере откройте репозиторий GitHub проекта, чтобы увидеть:

    • Фиксация
    • Коммит из настроек GitHub Actions

    Screenshot зафиксированного изменения в GitHub.

  7. Выберите действия , чтобы просмотреть тестовое обновление, отраженное в рабочем процессе.

    Screenshot рабочего процесса GitHub, запущенного после тестового обновления.

  8. Чтобы просмотреть развернутое обновление, посетите URL-адрес веб-фронтенда, предоставленный в выходных azd данных.

Использование azd в качестве действия GitHub

Вы можете установить azd как действие GitHub с помощью действия setup-azd. Чтобы использовать его, добавьте в файл следующую команду .github/workflows/azure-dev.yml :

on: [push]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Install azd
        uses: Azure/setup-azd@v1.0.0

Note

Проверьте релизы setup-azd для получения последнего номера версии.

Очистите ресурсы

Если ресурсы Azure, созданные в этой статье, больше не требуются, выполните следующую команду:

azd down

Эта команда удаляет все Azure ресурсы, связанные с проектом.

Дальнейшие действия