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

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

Note

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

Prerequisites

• Установка интерфейса командной строки разработчика Azure
• Visual Studio Code (необязательно, для редактирования файлов)
• Учетная запись GitHub
• подписка Azure

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

В этом примере используется шаблон 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. При появлении запроса на настройку удаленного репозитория выберите создать частный репозиторий 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, введите 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. Выберите действия , чтобы просмотреть запущенный рабочий процесс.

   

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

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

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

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

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

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

   

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

   • Your commit
   • Коммит из настройки GitHub Actions

   

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

   

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, связанные с проектом.

Next steps

Мониторинг приложения с помощью интерфейса командной строки разработчика Azure (azd)