Руководство по развертыванию локально размещенных модулей CI/CD и агентов с помощью заданий приложений контейнеров Azure

Статья
02/03/2025

GitHub Actions и Azure Pipelines позволяют запускать рабочие процессы CI/CD с локальными средствами выполнения и агентами. Вы можете запускать локальные средства выполнения и агенты с помощью заданий приложений контейнеров Azure, управляемых событиями.

Локальные средства выполнения полезны, если необходимо запускать рабочие процессы, требующие доступа к локальным ресурсам или средствам, которые недоступны для облачного runner. Например, локальный модуль выполнения в задании "Приложения контейнеров" позволяет рабочему процессу получать доступ к ресурсам в виртуальной сети задания, которая недоступна для облачного запуска.

Запуск локальных runners в качестве заданий на основе событий позволяет воспользоваться бессерверным характером приложений контейнеров Azure. Задания выполняются автоматически, когда рабочий процесс активируется и завершает работу после завершения задания.

Вы оплачиваете только время выполнения задания.

В этом руководстве вы узнаете, как запускать GitHub Actions в качестве задания приложений контейнеров на основе событий.

Создание среды приложений-контейнеров для развертывания локального запуска
Создание репозитория GitHub для запуска рабочего процесса, использующего локальное средство выполнения
Создание образа контейнера, на котором выполняется runner GitHub Actions
Развертывание runner в качестве задания в среде "Приложения контейнеров"
Создайте рабочий процесс, использующий локальное средство выполнения и убедитесь, что он выполняется.

Внимание

Для частных репозиториев рекомендуется использовать только локальные модули выполнения. Использование их с общедоступными репозиториями может позволить опасному коду выполняться в локальном средстве выполнения. Дополнительные сведения см. в разделе безопасности локального запуска.

В этом руководстве описано, как запускать агенты Azure Pipelines в качестве задания приложений контейнеров на основе событий.

Создание среды приложений-контейнеров для развертывания локального агента
Создание организации и проекта Azure DevOps
Создание образа контейнера, на котором выполняется агент Azure Pipelines
Создание агента-заполнителя в среде "Приложения контейнеров" с помощью ручного задания
Развертывание агента в качестве задания в среде "Приложения контейнеров"
Создайте конвейер, использующий локальный агент и убедитесь, что он выполняется.

Внимание

Для частных проектов рекомендуется использовать только локальные агенты. Использование их с общедоступными проектами может позволить выполнять опасный код на локальном агенте. Дополнительные сведения см. в разделе "Безопасность локального агента".

Примечание.

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

Необходимые компоненты

Учетная запись Azure. Если у вас нет, ее можно создать бесплатно.
Azure CLI: установите Azure CLI.

Организация Azure DevOps. Если у вас нет организации DevOps с активной подпиской, ее можно создать бесплатно.

Ознакомьтесь с ограничениями заданий для списка ограничений.

Настройка

Чтобы войти в Azure из ИНТЕРФЕЙСА командной строки, выполните следующую команду и следуйте инструкциям, чтобы завершить процесс проверки подлинности.

Bash
PowerShell

az login

Connect-AzAccount

Чтобы убедиться, что вы используете последнюю версию интерфейса командной строки, выполните команду обновления.

Bash
PowerShell

az upgrade

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

Игнорируйте предупреждения об используемых модулях.

Затем установите или обновите расширение "Приложения контейнеров Azure" для интерфейса командной строки.

Если при выполнении az containerapp команд в Azure CLI или командлетах из Az.App модуля PowerShell возникают ошибки о отсутствующих параметрах, убедитесь, что установлена последняя версия расширения "Приложения контейнеров Azure".

Bash
PowerShell

az extension add --name containerapp --upgrade

Примечание.

Начиная с мая 2024 г. расширения Azure CLI больше не поддерживают предварительные версии функций по умолчанию. Чтобы получить доступ к функциям предварительной версии контейнерных приложений, установите расширение "Приложения контейнеров" с --allow-preview trueпомощью .

az extension add --name containerapp --upgrade --allow-preview true

Install-Module -Name Az.App

Обязательно обновите модуль до последней Az.App версии.

Update-Module -Name Az.App

Теперь, когда установлено текущее расширение или модуль, зарегистрируйте Microsoft.App пространства имен и Microsoft.OperationalInsights пространств имен.

Bash
PowerShell

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

Создание переменной среды

После завершения настройки Azure CLI вы можете определить переменные среды, которые используются в этой статье.

Bash
PowerShell

RESOURCE_GROUP="jobs-sample"
LOCATION="northcentralus"
ENVIRONMENT="env-jobs-sample"
JOB_NAME="github-actions-runner-job"

$RESOURCE_GROUP="jobs-sample"
$LOCATION="northcentralus"
$ENVIRONMENT="env-jobs-sample"
$JOB_NAME="github-actions-runner-job"

Bash
PowerShell

RESOURCE_GROUP="jobs-sample"
LOCATION="northcentralus"
ENVIRONMENT="env-jobs-sample"
JOB_NAME="azure-pipelines-agent-job"
PLACEHOLDER_JOB_NAME="placeholder-agent-job"

$RESOURCE_GROUP="jobs-sample"
$LOCATION="northcentralus"
$ENVIRONMENT="env-jobs-sample"
$JOB_NAME="azure-pipelines-agent-job"
$PLACEHOLDER_JOB_NAME="placeholder-agent-job"

Создание среды приложений-контейнеров

Среда "Приложения контейнеров Azure" выступает в качестве безопасной границы для приложений и заданий контейнеров, чтобы они могли совместно использовать ту же сеть и взаимодействовать друг с другом.

Примечание.

Сведения о создании среды приложений контейнеров, интегрированной с существующей виртуальной сетью, см. в статье "Предоставление виртуальной сети для среды приложений контейнеров Azure".

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

Bash
PowerShell

az group create \
    --name "$RESOURCE_GROUP" \
    --location "$LOCATION"

New-AzResourceGroup `
    --name "$RESOURCE_GROUP" `
    --location "$LOCATION"

Создайте среду приложений контейнеров с помощью следующей команды.

Bash
PowerShell

az containerapp env create \
    --name "$ENVIRONMENT" \
    --resource-group "$RESOURCE_GROUP" \
    --location "$LOCATION"

New-AzContainerAppManagedEnvironment `
  -Name $ENVIRONMENT `
  -ResourceGroupName $RESOURCE_GROUP `
  -Location $LOCATION

Создание репозитория GitHub для запуска рабочего процесса

Чтобы выполнить рабочий процесс, необходимо создать репозиторий GitHub, содержащий определение рабочего процесса.

Перейдите к GitHub и войдите.

Создайте новый репозиторий, введя следующие значения.

Параметр	Значение
Ответственный	Выберите имя пользователя GitHub.
Имя репозитория	Введите имя репозитория.
Visibility	Выберите категорию Частное.
Инициализация этого репозитория с помощью	Выберите параметр Добавить файл сведений.

Оставьте остальные значения выбранными по умолчанию.

Щелкните Create repository (Создать репозиторий).
В новом репозитории выберите "Действия".
Найдите шаблон простого рабочего процесса и выберите "Настроить".
Выберите "Зафиксировать изменения" , чтобы добавить рабочий процесс в репозиторий.

Рабочий процесс выполняется на ubuntu-latest размещенном в GitHub средстве выполнения и выводит сообщение в консоль. Позже вы замените размещенного на сайте GitHub средство выполнения на локальное средство выполнения.

Получение личного маркера доступа GitHub

Чтобы запустить локальное средство выполнения, необходимо создать личный маркер доступа (PAT) в GitHub. Каждый раз, когда запускается средство выполнения, ПАТ используется для создания маркера для регистрации бегуна в GitHub. Pat также используется правилом масштабирования GitHub Actions для отслеживания очереди рабочих процессов репозитория и запуска runner по мере необходимости.

Примечание.

Личные маркеры доступа (PATS) имеют дату окончания срока действия. Регулярно поворачивайте маркеры, чтобы они оставались действительными (не истекли) для поддержания непрерывной службы.

В GitHub выберите рисунок профиля в правом верхнем углу и выберите "Параметры".
Выберите Параметры разработчика.
В разделе "Личные маркеры доступа" выберите точные маркеры.
Выберите Создать новый маркер.

На экране нового детального личного маркера доступа введите следующие значения.

Параметр	Значение
Имя токена	Введите имя маркера.
Истечение срока действия	Выберите 30 дней.
Доступ к репозиторию	Выберите только репозитории и выберите созданный репозиторий.

Введите следующие значения разрешений репозитория.

Параметр	Значение
Действия	Выберите только для чтения.
Администрирование	Выберите "Чтение и запись".
Метаданные	Выберите только для чтения.

Щелкните Создать маркер.
Скопируйте значение маркера.

Определите переменные, используемые для настройки средства выполнения и правила масштабирования позже.

Bash
PowerShell

GITHUB_PAT="<GITHUB_PAT>"
REPO_OWNER="<REPO_OWNER>"
REPO_NAME="<REPO_NAME>"

$GITHUB_PAT="<GITHUB_PAT>"
$REPO_OWNER="<REPO_OWNER>"
$REPO_NAME="<REPO_NAME>"

Замените значения заполнителей следующими значениями:

Заполнитель	Значение
`<GITHUB_PAT>`	Созданный GitHub PAT.
`<REPO_OWNER>`	Владелец созданного ранее репозитория. Обычно это значение является именем пользователя GitHub.
`<REPO_NAME>`	Имя созданного ранее репозитория. Это значение совпадает с именем, введенным в поле имени репозитория.

Создание образа контейнера runner GitHub Actions

Чтобы создать локальное средство выполнения, необходимо создать образ контейнера, который выполняет средство выполнения. В этом разделе описано, как создать образ контейнера и отправить его в реестр контейнеров.

Примечание.

Образ, который вы создаете в этом руководстве, содержит базовый локальный модуль выполнения, подходящий для запуска в качестве задания "Приложения контейнеров". Его можно настроить для включения дополнительных средств или зависимостей, необходимых рабочим процессам.

Определите имя образа контейнера и реестра.
- Bash
- PowerShell
```
CONTAINER_IMAGE_NAME="github-actions-runner:1.0"
CONTAINER_REGISTRY_NAME="<CONTAINER_REGISTRY_NAME>"
```
```
$CONTAINER_IMAGE_NAME="github-actions-runner:1.0"
$CONTAINER_REGISTRY_NAME="<CONTAINER_REGISTRY_NAME>"
```
Замените <CONTAINER_REGISTRY_NAME> уникальным именем для создания реестра контейнеров. Имена реестра контейнеров должны быть уникальными в Azure и составлять от 5 до 50 символов длиной, содержащей только цифры и строчные буквы.

Создайте реестр контейнеров.

Bash
PowerShell

az acr create \
    --name "$CONTAINER_REGISTRY_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --location "$LOCATION" \
    --sku Basic

az acr create `
    --name "$CONTAINER_REGISTRY_NAME" `
    --resource-group "$RESOURCE_GROUP" `
    --location "$LOCATION" `
    --sku Basic

Реестр контейнеров должен разрешить маркеры аудитории Azure Resource Manager (ARM) для проверки подлинности, чтобы использовать управляемое удостоверение для извлечения образов.

Используйте следующую команду, чтобы проверить, разрешены ли маркеры ARM для доступа к Реестр контейнеров Azure (ACR).
- Bash
- PowerShell
```
az acr config authentication-as-arm show --registry "$CONTAINER_REGISTRY_NAME"
```
```
az acr config authentication-as-arm show --registry "$CONTAINER_REGISTRY_NAME"
```
Если разрешены маркеры ARM, команда выводит следующую команду.
```
{
  "status": "enabled"
}
```
Если это status так disabled, разрешите маркеры ARM с помощью следующей команды.
- Bash
- PowerShell
```
az acr config authentication-as-arm update --registry "$CONTAINER_REGISTRY_NAME" --status enabled
```
```
az acr config authentication-as-arm update --registry "$CONTAINER_REGISTRY_NAME" --status enabled
```

Файл Dockerfile для создания образа runner доступен на сайте GitHub. Выполните следующую команду, чтобы клонировать репозиторий и создать образ контейнера в облаке с помощью az acr build команды.

Bash
PowerShell

az acr build \
    --registry "$CONTAINER_REGISTRY_NAME" \
    --image "$CONTAINER_IMAGE_NAME" \
    --file "Dockerfile.github" \
    "https://github.com/Azure-Samples/container-apps-ci-cd-runner-tutorial.git"

az acr build `
    --registry "$CONTAINER_REGISTRY_NAME" `
    --image "$CONTAINER_IMAGE_NAME" `
    --file "Dockerfile.github" `
    "https://github.com/Azure-Samples/container-apps-ci-cd-runner-tutorial.git"

Теперь образ доступен в реестре контейнеров.

Создание управляемого удостоверения, назначаемого пользователем

Чтобы избежать использования учетных данных администратора, извлеките образы из частных репозиториев в Microsoft Реестр контейнеров Azure с помощью управляемых удостоверений для проверки подлинности. По возможности используйте управляемое удостоверение, назначаемое пользователем, для извлечения изображений.

Создайте управляемое удостоверение, назначаемое пользователем. Перед выполнением следующих команд выберите имя управляемого удостоверения и замените \<PLACEHOLDER\> его именем.
- Bash
- PowerShell
```
IDENTITY="<YOUR_IDENTITY_NAME>"
```
```
az identity create \
    --name $IDENTITY \
    --resource-group $RESOURCE_GROUP
```
```
$IDENTITY="<YOUR_IDENTITY_NAME>"
az identity create `
    --name $IDENTITY `
    --resource-group $RESOURCE_GROUP
```

Получите идентификатор ресурса удостоверения.

Bash
PowerShell

IDENTITY_ID=$(az identity show \
    --name $IDENTITY \
    --resource-group $RESOURCE_GROUP \
    --query id \
    --output tsv)

IDENTITY_ID=$(az identity show `
    --name $IDENTITY `
    --resource-group $RESOURCE_GROUP `
    --query id `
    --output tsv)

Развертывание локального runner в качестве задания

Теперь можно создать задание, которое используется для использования образа контейнера. В этом разделе описано, как создать задание, которое выполняет локальное средство выполнения и выполняет проверку подлинности с помощью GitHub, созданного ранее. Задание использует github-runner правило масштабирования для создания заданий на основе количества ожидающих выполнения рабочих процессов.

Создайте задание в среде "Приложения контейнеров".

Bash
PowerShell

az containerapp job create \
    --name "$JOB_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --environment "$ENVIRONMENT" \
    --trigger-type Event \
    --replica-timeout 1800 \
    --replica-retry-limit 0 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --image "$CONTAINER_REGISTRY_NAME.azurecr.io/$CONTAINER_IMAGE_NAME" \
    --min-executions 0 \
    --max-executions 10 \
    --polling-interval 30 \
    --scale-rule-name "github-runner" \
    --scale-rule-type "github-runner" \
    --scale-rule-metadata "githubAPIURL=https://api.github.com" "owner=$REPO_OWNER" "runnerScope=repo" "repos=$REPO_NAME" "targetWorkflowQueueLength=1" \
    --scale-rule-auth "personalAccessToken=personal-access-token" \
    --cpu "2.0" \
    --memory "4Gi" \
    --secrets "personal-access-token=$GITHUB_PAT" \
    --env-vars "GITHUB_PAT=secretref:personal-access-token" "GH_URL=https://github.com/$REPO_OWNER/$REPO_NAME" "REGISTRATION_TOKEN_API_URL=https://api.github.com/repos/$REPO_OWNER/$REPO_NAME/actions/runners/registration-token" \
    --registry-server "$CONTAINER_REGISTRY_NAME.azurecr.io" \
    --mi-user-assigned "$IDENTITY_ID" \
    --registry-identity "$IDENTITY_ID"

az containerapp job create `
    --name "$JOB_NAME" `
    --resource-group "$RESOURCE_GROUP" `
    --environment "$ENVIRONMENT" `
    --trigger-type Event `
    --replica-timeout 1800 `
    --replica-retry-limit 0 `
    --replica-completion-count 1 `
    --parallelism 1 `
    --image "$CONTAINER_REGISTRY_NAME.azurecr.io/$CONTAINER_IMAGE_NAME" `
    --min-executions 0 `
    --max-executions 10 `
    --polling-interval 30 `
    --scale-rule-name "github-runner" `
    --scale-rule-type "github-runner" `
    --scale-rule-metadata "githubAPIURL=https://api.github.com" "owner=$REPO_OWNER" "runnerScope=repo" "repos=$REPO_NAME" "targetWorkflowQueueLength=1" `
    --scale-rule-auth "personalAccessToken=personal-access-token" `
    --cpu "2.0" `
    --memory "4Gi" `
    --secrets "personal-access-token=$GITHUB_PAT" `
    --env-vars "GITHUB_PAT=secretref:personal-access-token" "GH_URL=https://github.com/$REPO_OWNER/$REPO_NAME" "REGISTRATION_TOKEN_API_URL=https://api.github.com/repos/$REPO_OWNER/$REPO_NAME/actions/runners/registration-token" `
    --registry-server "$CONTAINER_REGISTRY_NAME.azurecr.io" `
    --mi-user-assigned "$IDENTITY_ID" `
    --registry-identity "$IDENTITY_ID"

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

Параметр	Описание
`--replica-timeout`	Максимальная длительность выполнения реплики.
`--replica-retry-limit`	Количество повторных попыток неудачной реплики.
`--replica-completion-count`	Количество реплик для успешного выполнения задания считается успешным.
`--parallelism`	Количество реплик для запуска на выполнение задания.
`--min-executions`	Минимальное количество выполнения заданий для каждого интервала опроса.
`--max-executions`	Максимальное количество выполнения заданий для каждого интервала опроса.
`--polling-interval`	Интервал опроса, с помощью которого необходимо оценить правило масштабирования.
`--scale-rule-name`	Имя правила масштабирования.
`--scale-rule-type`	Тип используемого правила масштабирования. Дополнительные сведения о масштабировщике runner GitHub см. в документации ПО KEDA.
`--scale-rule-metadata`	Метаданные правила масштабирования. Если вы используете GitHub Enterprise, обновите `githubAPIURL` его URL-адрес API.
`--scale-rule-auth`	Проверка подлинности для правила масштабирования.
`--secrets`	Секреты, используемые для задания.
`--env-vars`	Переменные среды, используемые для задания.
`--registry-server`	Сервер реестра контейнеров, используемый для задания. Для Реестр контейнеров Azure команда автоматически настраивает проверку подлинности.
`--mi-user-assigned`	Идентификатор ресурса управляемого удостоверения, назначаемого пользователем, назначаемого заданием.
`--registry-identity`	Идентификатор ресурса управляемого удостоверения для проверки подлинности с помощью сервера реестра вместо использования имени пользователя и пароля. По возможности назначение роли acrpull создается автоматически для удостоверения.

Конфигурация правила масштабирования определяет источник событий для мониторинга. Правила вычисляются по каждому интервалу опроса, чтобы определить, сколько выполнений задания необходимо активировать. Дополнительные сведения см. в разделе "Настройка правил масштабирования".

Задание на основе событий теперь создается в среде "Приложения контейнеров".

Запуск рабочего процесса и проверка задания

Задание настраивается для оценки правила масштабирования каждые 30 секунд. Во время каждой оценки проверяется количество ожидающих выполнения рабочих процессов, для которых требуется локальное средство выполнения и запускает новое выполнение задания для ожидающего рабочего процесса, до настроенного не более 10 выполнений.

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

В репозитории GitHub перейдите к созданному ранее рабочему процессу. Это ФАЙЛ YAML в каталоге .github/workflows .
Выберите " Изменить" на месте.
Обновите свойство self-hostedдо runs-on :
```
runs-on: self-hosted
```
Выберите " Зафиксировать изменения...".
Выберите " Зафиксировать изменения".
Перейдите на вкладку "Действия ".

Теперь новый рабочий процесс помещается в очередь. В течение 30 секунд выполнение задания начнется, и рабочий процесс завершится в ближайшее время.

Дождитесь завершения действия, прежде чем перейти к следующему шагу.

Выведите список выполнений задания, чтобы убедиться, что выполнение задания было создано и выполнено успешно.

Bash
PowerShell

az containerapp job execution list \
    --name "$JOB_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --output table \
    --query '[].{Status: properties.status, Name: name, StartTime: properties.startTime}'

az containerapp job execution list `
    --name "$JOB_NAME" `
    --resource-group "$RESOURCE_GROUP" `
    --output table `
    --query '[].{Status: properties.status, Name: name, StartTime: properties.startTime}'

Создание проекта и репозитория Azure DevOps

Для выполнения конвейера требуется проект и репозиторий Azure DevOps.

Перейдите к Azure DevOps и войдите в учетную запись.
Выберите существующую организацию или создайте новую.

На странице обзора организации выберите новый проект и введите следующие значения.

Параметр	Значение
Имя проекта	Введите имя проекта.
Видимость	Выберите категорию Частное.

Нажмите кнопку создания.
В боковой навигации выберите Repos.
В разделе "Инициализация основной ветви" с помощью README или .gitignore выберите "Добавить README".
Оставьте остальные значения в качестве значений по умолчанию и выберите инициализация.

Создание пула агентов

Создайте пул агентов для запуска локального runner.

В проекте Azure DevOps разверните левую панель навигации и выберите параметры проекта.
В разделе "Конвейеры" в меню навигации "Параметры проекта" выберите пулы агентов.

Выберите " Добавить пул" и введите следующие значения.

Параметр	Значение
Пул для ссылки	Выберите Создать.
Тип пула	Выберите локальное размещение.
Имя	Введите контейнер-приложения.
Предоставление разрешения на доступ ко всем конвейерам	Установите этот флажок.

Нажмите кнопку создания.

Получение личного маркера доступа Azure DevOps

Чтобы запустить локальное средство выполнения, необходимо создать личный маркер доступа (PAT) в Azure DevOps. ПАТ используется для проверки подлинности средства выполнения с помощью Azure DevOps. Он также используется правилом масштабирования для определения количества ожидающих запусков конвейера и запуска новых выполнений заданий.

[!ПРИМЕЧАНИЕ]

Личные маркеры доступа (PATS) имеют дату окончания срока действия. Регулярно поворачивайте маркеры, чтобы они оставались действительными (не истекли) для поддержания непрерывной службы.

В Azure DevOps выберите параметры пользователя рядом с изображением профиля в правом верхнем углу.
Выберите Личные маркеры доступа.

На странице "Личные маркеры доступа" выберите новый маркер и введите следующие значения.

Параметр	Значение
Имя	Введите имя маркера.
Предприятие	Выберите выбранную или созданную ранее организацию.
Области действия	Выберите "Настраиваемый".
Отображение всех областей	Выберите " Показать все области".
Пулы агентов (чтение и управление)	Выберите пулы агентов (чтение и управление)

Оставьте все остальные области не выбранными.

Нажмите кнопку создания.
Скопируйте значение маркера в безопасное расположение.

Вы не можете получить маркер после выхода страницы.

Определите переменные, которые используются для настройки заданий приложений контейнеров позже.

Bash
PowerShell

AZP_TOKEN="<AZP_TOKEN>"
ORGANIZATION_URL="<ORGANIZATION_URL>"
AZP_POOL="container-apps"
REGISTRATION_TOKEN_API_URL="<YOUR_REGISTRATION_TOKEN_API_URL>"

$AZP_TOKEN="<AZP_TOKEN>"
$ORGANIZATION_URL="<ORGANIZATION_URL>"
$AZP_POOL="container-apps"
$REGISTRATION_TOKEN_API_URL="<YOUR_REGISTRATION_TOKEN_API_URL>"

Замените значения заполнителей следующими значениями:

Заполнитель	Значение	Комментарии
`<AZP_TOKEN>`	Созданный вами PAT Azure DevOps.
`<ORGANIZATION_URL>`	URL-адрес организации Azure DevOps. Убедитесь, что в конце URL-адреса отсутствует конечная `/` дата.	Например, `https://dev.azure.com/myorg` или `https://myorg.visualstudio.com`.
`<YOUR_REGISTRATION_TOKEN_API_URL>`	URL-адрес API маркера регистрации в файле entrypoint.sh .	Например, "https://myapi.example.com/get-token".

Создание образа контейнера агента Azure Pipelines

Чтобы создать автономный агент, необходимо создать образ контейнера, который запускает агент. В этом разделе описано, как создать образ контейнера и отправить его в реестр контейнеров.

Примечание.

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

Вернитесь в терминал, определите имя образа контейнера и реестра.
- Bash
- PowerShell
```
CONTAINER_IMAGE_NAME="azure-pipelines-agent:1.0"
CONTAINER_REGISTRY_NAME="<CONTAINER_REGISTRY_NAME>"
```
```
$CONTAINER_IMAGE_NAME="azure-pipelines-agent:1.0"
$CONTAINER_REGISTRY_NAME="<CONTAINER_REGISTRY_NAME>"
```
Замените <CONTAINER_REGISTRY_NAME> уникальным именем для создания реестра контейнеров.

Имена реестра контейнеров должны быть уникальными в Azure и составлять от 5 до 50 символов длиной, содержащей только цифры и строчные буквы.

Создайте реестр контейнеров.

Bash
PowerShell

az acr create \
    --name "$CONTAINER_REGISTRY_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --location "$LOCATION" \
    --sku Basic \
    --admin-enabled true

az acr create `
    --name "$CONTAINER_REGISTRY_NAME" `
    --resource-group "$RESOURCE_GROUP" `
    --location "$LOCATION" `
    --sku Basic `
    --admin-enabled true

Bash
PowerShell

az acr build \
    --registry "$CONTAINER_REGISTRY_NAME" \
    --image "$CONTAINER_IMAGE_NAME" \
    --file "Dockerfile.azure-pipelines" \
    "https://github.com/Azure-Samples/container-apps-ci-cd-runner-tutorial.git"

az acr build `
    --registry "$CONTAINER_REGISTRY_NAME" `
    --image "$CONTAINER_IMAGE_NAME" `
    --file "Dockerfile.azure-pipelines" `
    "https://github.com/Azure-Samples/container-apps-ci-cd-runner-tutorial.git"

Теперь образ доступен в реестре контейнеров.

Создание локального агента заполнителя

Перед запуском локального агента в новом пуле агентов необходимо создать агент-заполнитель. Агент заполнителя гарантирует доступность пула агентов. Конвейеры, использующие пул агентов, завершаются сбоем при отсутствии агента-заполнителя.

Вы можете запустить задание вручную, чтобы зарегистрировать автономный агент заполнителя. Задание выполняется один раз и может быть удалено. Агент заполнителя не использует ресурсы в приложениях контейнеров Azure или Azure DevOps.

Создайте задание вручную в среде "Приложения контейнеров", создающей агент заполнителя.

Bash
PowerShell

az containerapp job create -n "$PLACEHOLDER_JOB_NAME" -g "$RESOURCE_GROUP" --environment "$ENVIRONMENT" \
    --trigger-type Manual \
    --replica-timeout 300 \
    --replica-retry-limit 0 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --image "$CONTAINER_REGISTRY_NAME.azurecr.io/$CONTAINER_IMAGE_NAME" \
    --cpu "2.0" \
    --memory "4Gi" \
    --secrets "personal-access-token=$AZP_TOKEN" "organization-url=$ORGANIZATION_URL" \
    --env-vars "AZP_TOKEN=secretref:personal-access-token" "AZP_URL=secretref:organization-url" "AZP_POOL=$AZP_POOL" "AZP_PLACEHOLDER=1" "AZP_AGENT_NAME=placeholder-agent" \
    --registry-server "$CONTAINER_REGISTRY_NAME.azurecr.io"

    az containerapp job create -n "$PLACEHOLDER_JOB_NAME" -g "$RESOURCE_GROUP" --environment "$ENVIRONMENT" `
    --trigger-type Manual `
    --replica-timeout 300 `
    --replica-retry-limit 0 `
    --replica-completion-count 1 `
    --parallelism 1 `
    --image "$CONTAINER_REGISTRY_NAME.azurecr.io/$CONTAINER_IMAGE_NAME" `
    --cpu "2.0" `
    --memory "4Gi" `
    --secrets "personal-access-token=$AZP_TOKEN" "organization-url=$ORGANIZATION_URL" `
    --env-vars "AZP_TOKEN=secretref:personal-access-token" "AZP_URL=secretref:organization-url" "AZP_POOL=$AZP_POOL" "AZP_PLACEHOLDER=1" "AZP_AGENT_NAME=placeholder-agent" `
    --registry-server "$CONTAINER_REGISTRY_NAME.azurecr.io"

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

Параметр	Описание
`--replica-timeout`	Максимальная длительность выполнения реплики.
`--replica-retry-limit`	Количество повторных попыток неудачной реплики.
`--replica-completion-count`	Количество реплик для успешного выполнения задания считается успешным.
`--parallelism`	Количество реплик для запуска на выполнение задания.
`--secrets`	Секреты, используемые для задания.
`--env-vars`	Переменные среды, используемые для задания.
`--registry-server`	Сервер реестра контейнеров, используемый для задания. Для Реестр контейнеров Azure команда автоматически настраивает проверку подлинности.

AZP_PLACEHOLDER Настройка переменной среды настраивает контейнер агента для регистрации в качестве автономного агента заполнителя без выполнения задания.

Выполните задание вручную, чтобы создать агент заполнителя.

Bash
PowerShell

az containerapp job start -n "$PLACEHOLDER_JOB_NAME" -g "$RESOURCE_GROUP"

az containerapp job start -n "$PLACEHOLDER_JOB_NAME" -g "$RESOURCE_GROUP"

Bash
PowerShell

az containerapp job execution list \
    --name "$PLACEHOLDER_JOB_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --output table \
    --query '[].{Status: properties.status, Name: name, StartTime: properties.startTime}'

az containerapp job execution list `
    --name "$PLACEHOLDER_JOB_NAME" `
    --resource-group "$RESOURCE_GROUP" `
    --output table `
    --query '[].{Status: properties.status, Name: name, StartTime: properties.startTime}'

Убедитесь, что агент заполнителя был создан в Azure DevOps.
1. В Azure DevOps перейдите к проекту.
2. Выберите агенты контейнеров-приложений> для пулов>>параметров проекта.
3. Убедитесь, что именованный placeholder-agent агент заполнителя указан и его состояние находится в автономном режиме.

Задание не требуется снова. Ее можно удалить.

Bash
PowerShell

az containerapp job delete -n "$PLACEHOLDER_JOB_NAME" -g "$RESOURCE_GROUP"

az containerapp job delete -n "$PLACEHOLDER_JOB_NAME" -g "$RESOURCE_GROUP"

Создание локального агента в качестве задания на основе событий

Теперь, когда у вас есть агент-заполнитель, можно создать локальный агент. В этом разделе описано, как создать задание на основе событий, которое запускает локальный агент при активации конвейера.

Bash
PowerShell

az containerapp job create -n "$JOB_NAME" -g "$RESOURCE_GROUP" --environment "$ENVIRONMENT" \
    --trigger-type Event \
    --replica-timeout 1800 \
    --replica-retry-limit 0 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --image "$CONTAINER_REGISTRY_NAME.azurecr.io/$CONTAINER_IMAGE_NAME" \
    --min-executions 0 \
    --max-executions 10 \
    --polling-interval 30 \
    --scale-rule-name "azure-pipelines" \
    --scale-rule-type "azure-pipelines" \
    --scale-rule-metadata "poolName=$AZP_POOL" "targetPipelinesQueueLength=1" \
    --scale-rule-auth "personalAccessToken=personal-access-token" "organizationURL=organization-url" \
    --cpu "2.0" \
    --memory "4Gi" \
    --secrets "personal-access-token=$AZP_TOKEN" "organization-url=$ORGANIZATION_URL" \
    --env-vars "AZP_TOKEN=secretref:personal-access-token" "AZP_URL=secretref:organization-url" "AZP_POOL=$AZP_POOL" \
    --registry-server "$CONTAINER_REGISTRY_NAME.azurecr.io"

az containerapp job create -n "$JOB_NAME" -g "$RESOURCE_GROUP" --environment "$ENVIRONMENT" `
    --trigger-type Event `
    --replica-timeout 1800 `
    --replica-retry-limit 0 `
    --replica-completion-count 1 `
    --parallelism 1 `
    --image "$CONTAINER_REGISTRY_NAME.azurecr.io/$CONTAINER_IMAGE_NAME" `
    --min-executions 0 `
    --max-executions 10 `
    --polling-interval 30 `
    --scale-rule-name "azure-pipelines" `
    --scale-rule-type "azure-pipelines" `
    --scale-rule-metadata "poolName=$AZP_POOL" "targetPipelinesQueueLength=1" `
    --scale-rule-auth "personalAccessToken=personal-access-token" "organizationURL=organization-url" `
    --cpu "2.0" `
    --memory "4Gi" `
    --secrets "personal-access-token=$AZP_TOKEN" "organization-url=$ORGANIZATION_URL" `
    --env-vars "AZP_TOKEN=secretref:personal-access-token" "AZP_URL=secretref:organization-url" "AZP_POOL=$AZP_POOL" `
    --registry-server "$CONTAINER_REGISTRY_NAME.azurecr.io"

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

Параметр	Описание
`--min-executions`	Минимальное количество выполнения заданий для каждого интервала опроса.
`--max-executions`	Максимальное количество выполнения заданий для каждого интервала опроса.
`--polling-interval`	Интервал опроса, с помощью которого необходимо оценить правило масштабирования.
`--scale-rule-name`	Имя правила масштабирования.
`--scale-rule-type`	Тип используемого правила масштабирования. Дополнительные сведения о масштабировщике Azure Pipelines см. в документации ПО KEDA.
`--scale-rule-metadata`	Метаданные правила масштабирования.
`--scale-rule-auth`	Проверка подлинности для правила масштабирования.

Задание на основе событий теперь создается в среде "Приложения контейнеров".

Запуск конвейера и проверка задания

После настройки локального задания агента можно запустить конвейер и убедиться, что он работает правильно.

В левой части навигации проекта Azure DevOps перейдите к Конвейерам.
Выберите Создать конвейер.
Выберите Azure Repos Git в качестве расположения кода.
Выберите созданный ранее репозиторий.
Выберите Простейший конвейер.
В yamL конвейера измените значение pool на vmImage: ubuntu-latestname: container-apps.
```
pool:
  name: container-apps
```
Выберите Сохранить и выполнить.

Конвейер запускается и использует локальное задание агента, созданное в среде "Приложения контейнеров".

Bash
PowerShell

az containerapp job execution list \
    --name "$JOB_NAME" \
    --resource-group "$RESOURCE_GROUP" \
    --output table \
    --query '[].{Status: properties.status, Name: name, StartTime: properties.startTime}'

az containerapp job execution list `
    --name "$JOB_NAME" `
    --resource-group "$RESOURCE_GROUP" `
    --output table `
    --query '[].{Status: properties.status, Name: name, StartTime: properties.startTime}'

Совет

Возникли проблемы? Сообщите о них в репозитории Azure Container Apps на GitHub.

Очистка ресурсов

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

Внимание

Следующая команда удаляет указанную группу ресурсов и все ресурсы, содержащиеся в ней. Если в указанной группе ресурсов существуют другие ресурсы, кроме созданных для работы с этим учебником, они также будут удалены.

Bash
PowerShell

az group delete \
    --resource-group $RESOURCE_GROUP

az group delete `
    --resource-group $RESOURCE_GROUP

Чтобы удалить репозиторий GitHub, ознакомьтесь с разделом "Удаление репозитория".

Следующие шаги

Задания контейнерных приложений

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

Руководство по развертыванию локально размещенных модулей CI/CD и агентов с помощью заданий приложений контейнеров Azure

Необходимые компоненты

Настройка

Создание переменной среды

Создание среды приложений-контейнеров

Создание репозитория GitHub для запуска рабочего процесса

Получение личного маркера доступа GitHub

Создание образа контейнера runner GitHub Actions

Создание управляемого удостоверения, назначаемого пользователем

Развертывание локального runner в качестве задания

Запуск рабочего процесса и проверка задания

Создание проекта и репозитория Azure DevOps

Создание пула агентов

Получение личного маркера доступа Azure DevOps

Создание образа контейнера агента Azure Pipelines

Создание локального агента заполнителя

Создание локального агента в качестве задания на основе событий

Запуск конвейера и проверка задания

Очистка ресурсов

Следующие шаги

Обратная связь

Дополнительные ресурсы