Упражнение. Создание и запуск базового конвейера
Внимание
Для выполнения этого упражнения вам нужна собственная подписка Azure. При этом с вас может взиматься плата. Если у вас еще нет подписки Azure, создайте бесплатную учетную запись, прежде чем начинать работу.
Вам нужно автоматизировать развертывание обновлений для веб-сайта компании по продаже игрушек. В качестве первого шага необходимо создать базовый конвейер в Azure DevOps.
В этом упражнении вы выполните следующие действия.
- Создайте организацию и проект в Azure DevOps.
- Создайте базовый конвейер.
- Выполните базовый конвейер.
Создание проекта в Azure DevOps
В браузере перейдите по адресу dev.azure.com. Войдите под своей учетной записью или создайте новую.
Если вы создаете новую учетную запись, следуйте инструкциям на экране, чтобы создать организацию Azure DevOps. Затем в Azure DevOps появится запрос на создание нового проекта. Перейдите к следующему шагу, чтобы настроить проект.
Если вы вошли в существующую организацию Azure DevOps, нажмите кнопку Создать проект, чтобы создать новый проект.
В области Создание проекта для начала работы введите следующие сведения для нового проекта.
- Имя проекта: используйте понятное, но короткое имя. В этом упражнении введите toy-website.
- Описание. Введите описание цели проекта. Для этого упражнения введите веб-сайт компании Toy.
- Видимость. для создания общедоступных и частных репозиториев можно использовать Azure DevOps. В этом случае репозиторий должен быть частным, так как доступ к файлам веб-сайта компании должен осуществляться только сотрудниками организации. Позднее вы можете предоставить доступ другим пользователям.
Конфигурация вашего проекта должна выглядеть следующим образом.
Выберите Создать проект.
Клонирование репозитория
В области приветствия или в меню ресурса выберите Repos.
Если вы используете macOS, вам потребуется специальный пароль для клонирования репозитория Git. Выберите Создать учетные данные Git и скопируйте отображаемые имя пользователя и пароль в безопасное место.
В разделе Клонирование на компьютер выберите Клонировать в VS Code. Если появится запрос на открытие Visual Studio Code, выберите Открыть.
Если появится диалоговое окно с запросом на разрешение расширению открыть URI репозитория, нажмите кнопку Открыть.
Создайте папку на локальном устройстве, чтобы использовать для этого репозитория, а затем выберите " Выбрать в качестве расположения репозитория".
Если вы используете этот репозиторий в первый раз, вам будет предложено выполнить вход.
В Windows введите те же учетные данные, которые ранее использовались для входа в Azure DevOps в этом упражнении.
В macOS введите только что созданные имя пользователя и пароль Git.
Visual Studio Code предложит открыть репозиторий. Выберите Открыть.
Установка расширения Azure Pipelines
Майкрософт публикует расширение Azure Pipelines для Visual Studio Code, которое помогает писать файлы YAML конвейера. Рекомендуется установить это расширение, чтобы можно было проверять файлы YAML во время работы.
В Visual Studio Code выберите Вид>Расширения (сочетание клавиш CTRL + SHIFT + X).
В поле Поиск введите Azure Pipelines и выберите расширение Azure Pipelines, опубликованное корпорацией Майкрософт. Выберите Установить.
Создание определения конвейера YAML
Теперь, когда ваша организация, проект и репозиторий созданы, вы можете создать определение базового конвейера.
В Visual Studio Code откройте Проводник.
В обозревателе наведите указатель мыши на папку проекта TOY-WEBSITE и щелкните значок "Создать папку ". Назовите папку deploy.
Выберите папку развертывания и щелкните значок "Создать файл" в проекте TOY-WEBSITE. Присвойте файлу имя azure-pipelines.yml.
Файл YML откроется на главной панели. Вставьте следующее определение конвейера в файл:
trigger: none pool: vmImage: ubuntu-latest jobs: - job: steps: - script: echo Hello world! displayName: 'Placeholder step'Сохраните внесенные в файл изменения.
В Visual Studio Code откройте окно терминала, выбрав Терминал>Новый терминал
Откроется окно терминала, как правило, в нижней половине экрана.
Чтобы зафиксировать и отправить файл azure-pipelines.yml в репозиторий Git, вставьте этот код в панель терминала и нажмите клавишу ВВОД.
git add deploy/azure-pipelines.yml git commit -m "Add initial pipeline definition" git push
Настройка конвейера в Azure Pipelines
Вы создали определение конвейера. Теперь нужно зарегистрировать конвейер в Azure Pipelines.
В меню ресурсов сеанса Azure DevOps выберите "Конвейеры" и в области "Создать первый конвейер" выберите "Создать конвейер".
На вкладке "Где находится код", выберите Azure Repos Git.
На вкладке "Выбор" выберите область репозитория, выберите веб-сайт toy-site.
На вкладке "Настройка конвейера" выберите существующий файл YAML Azure Pipelines.
В раскрывающемся списке "Выбор существующего файла YAML" выберите /deploy/azure-pipelines.yml и нажмите кнопку "Продолжить".
На вкладке "Проверка конвейера YAML" отображается определение конвейера YAML в качестве нового конвейера.
Совет
Веб-интерфейс Azure Pipelines включает редактор для управления определением конвейера. В этом модуле мы работаем с файлом определения в Visual Studio Code, но вы также можете изучить принципы работы редактора Azure Pipelines.
Выберите Выполнить.
Azure Pipelines создает конвейер и выполняет его в первый раз.
Проверка выполнения конвейера
Внимание
Если вы впервые используете конвейеры в этой организации Azure DevOps, может появиться такое сообщение об ошибке:
Размещенный параллелизм не был приобретен или предоставлен.
Чтобы защититься от неправильного использования, Azure DevOps требует утвердить новые организации, прежде чем они смогут бесплатно использовать агенты конвейера, размещенные в Майкрософт.
При запуске конвейера на странице отображаются сведения о выполнении.
Каждый процесс выполнения конвейера имеет идентификатор. Вы можете использовать этот идентификатор для поиска определенного выполнения конвейера.
Изначально задание имеет состояние В очереди. Конвейер может не запуститься немедленно. Задание добавляется в очередь агента, а после того, как агент становится доступен, Azure Pipelines назначает его и запускает задание. После этого задание переходит в состояние Выполнение.
Страница содержит имя ветви и идентификатор для фиксации Git, используемой для выполнения. Здесь указывается версия содержимого репозитория, используемого конвейером.
Обновите страницу,чтобы состояние задания изменилось на Успешно. В разделе Задания выберите Задание.
На странице сведений о задании отображается журнал шагов, которые выполнял конвейер. Шаг заполнителя указан в списке шагов в меню слева.
Список шагов в задании содержит шаги, которые вы не создавали. Они были созданы в Azure Pipelines автоматически. В некоторых организациях могут также отображаться шаги, которые ваша организация автоматически включает во все конвейеры. Можно выбрать любой шаг, чтобы просмотреть файл журнала этого шага.
Выберите Оформить toy-website@main на s.
Журнал для каждого шага содержит сведения о том, что произошло во время выполнения конвейера. Журнал полезен, если необходимо диагностировать проблему с конвейером. У вас нет прямого доступа к агенту, который выполнял для вас шаги.
В данном случае содержимое репозитория было скачано из Azure Repos в файловую систему агента.
Выберите Шаг заполнителя.
Журнал для этого шага включает содержимое скрипта, которое вы указали в файле YAML конвейера, и текст
Hello world!из выходных данных скрипта.
Связывание выполнения конвейера с фиксацией
Полезно знать, как создать перекрестную ссылку между выполнением конвейера фиксацией, которую он содержал. Связывание выполнения конвейера с фиксацией помогает отслеживать историю развертываний и диагностировать проблемы. Azure DevOps позволяет связать выполнение конвейера с фиксацией несколькими способами. В этой процедуре вы вручную проверите журнал фиксаций.
Чтобы вернуться к обзору репозитория, выберите Repos>Фиксации в меню ресурсов DevOps.
Идентификатор фиксации совпадает с идентификатором фиксации, записанным при выполнении конвейера. Кроме того, в Azure Pipelines отображается состояние выполнения конвейера, связанного с фиксацией.
Выберите фиксацию. Список файлов, которые были изменены, и изменения из фиксации выделены зеленым цветом, что означает, что весь текст является новым.