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

Azure DevOps Services

Из этого краткого руководства вы узнаете, как создать образ контейнера для развертывания приложений с помощью Azure Pipelines. Чтобы создать этот образ, вам потребуется только Dockerfile в вашем репозитории. Вы можете создавать контейнеры Linux или Windows в зависимости от агента, используемого в конвейере.

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

Создание вилки репозитория с примером

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

https://github.com/MicrosoftDocs/pipelines-javascript-docker

Создание образа Linux или Windows

# Docker
# Build a Docker image
# https://docs.microsoft.com/azure/devops/pipelines/languages/docker

trigger:
- main

pool:
  name: default
  demands: docker

variables:
  imageName: 'pipelines-javascript-docker'

steps:
 - task: Docker@2
   displayName: Build an image
   inputs:
     repository: $(imageName)
     command: build
     Dockerfile: '$(Build.SourcesDirectory)/app/Dockerfile'

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

Образы контейнеров создаются и хранятся в агенте. Отправьте образ в Реестр контейнеров Google, Docker Hub или Реестр контейнеров Azure. Дополнительные сведения см. в статье "Отправка изображения в Docker Hub" или "Реестр контейнеров Google" или отправка образа в Реестр контейнеров Azure.

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

Если вы не планируете использовать это приложение, удалите репозиторий конвейера и кода.

Вопросы и ответы

Какие агенты можно использовать для создания образов контейнеров?

• Создавать образы контейнеров Linux можно с помощью размещенных в Майкрософт агентов Ubuntu или локальных агентов на основе платформы Linux.

• Создавать образы контейнеров Windows можно с помощью размещенных в Майкрософт агентов Windows или локальных агентов на основе платформы Windows. Все агенты на основе платформы Windows, размещаемые в Майкрософт, поставляются с подсистемой и клиентом Moby, необходимыми для сборок Docker.

• Вы не можете использовать агенты macOS, размещенные Корпорацией Майкрософт, для создания образов контейнеров, так как модуль Moby, необходимый для создания образов, не предустановлен на этих агентах.

Дополнительные сведения см. в разделе Варианты агентов Windows и Linux, доступные для агентов, размещенных в Майкрософт.

Какие предварительно подготовленные образы Docker доступны для размещенных агентов?

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

Разделы справки задать переменную BuildKit для сборок Docker?

BuildKit предоставляет улучшения производительности, управления хранилищами, функциональных возможностей и безопасности. Сборка BuildKit в настоящее время не поддерживается на узлах Windows.

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

trigger:
- main
   
pool:
  vmImage: 'ubuntu-latest'
   

variables:
  imageName: 'pipelines-javascript-docker'
  DOCKER_BUILDKIT: 1
    
steps:
- task: Docker@2
  displayName: Build an image
  inputs:
    repository: $(imageName)
    command: build
    Dockerfile: app/Dockerfile

Как использовать локальный агент?

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

Как создать сборку Docker на основе скрипта вместо использования задачи Docker?

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

docker build -f Dockerfile -t foobar.azurecr.io/hello:world .

Эта команда создает образ, эквивалентный одному созданному с помощью задачи Docker. Во внутреннем плане задача Docker вызывает двоичный файл Docker в скрипте и объединяет несколько других команд, чтобы обеспечить несколько дополнительных преимуществ. Узнайте больше о задаче Docker.

Можно ли повторно использовать кэширование слоев во время сборки в Azure Pipelines?

При использовании агентов, предоставляемых Microsoft, каждое задание отправляется на свежесозданную виртуальную машину на основе образа, генерируемого из шаблонов репозитория azure-pipelines-image-generation. Эти виртуальные машины очищаются после завершения задания. Это временное время существования предотвращает повторное использование этих виртуальных машин для последующих заданий и повторное использование кэшированных слоев Docker. В качестве обходного решения можно настроить многоэтапную сборку, которая создает два образа и отправляет их в реестр образов на ранней стадии. Затем можно сообщить Docker использовать эти изображения в качестве источника кэша с аргументом --cache-from .

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

Как создавать образы контейнеров Linux для архитектур, отличных от x64?

При использовании размещенных в Майкрософт агентов Linux образы контейнеров Linux создаются для архитектуры x64. Для создания образов для других архитектур, таких как процессоры x86 или ARM, можно использовать эмулятор компьютера, например QEMU.

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

1. Создайте Dockerfile с базовым изображением, соответствующим целевой архитектуре:

   FROM arm64v8/alpine:latest
   

2. Выполните следующий скрипт в задании перед сборкой образа:

   # register QEMU binary - this can be done by running the following image
   docker run --rm --privileged multiarch/qemu-user-static --reset -p yes
   # build your image
   

Дополнительные сведения см. в разделе qemu-user-static на сайте GitHub.

Разделы справки выполнять тесты и публиковать результаты тестирования для контейнерных приложений?

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

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

После создания образа контейнера отправьте образ в Реестр контейнеров Azure, Docker Hub или реестр контейнеров Google. Чтобы узнать, как отправить образ в реестр контейнеров, ознакомьтесь со следующими статьями: