Руководство. Создание конвейера CI/CD для существующего кода с помощью Azure DevOps ProjectsTutorial: Create a CI/CD pipeline for your existing code by using Azure DevOps Projects

Azure DevOps Projects представляет собой упрощенный интерфейс, который позволяет добавить существующий код и репозиторий Git либо выбрать пример приложения, чтобы создать конвейер непрерывной интеграции (CI) и непрерывной поставки (CD) в Azure.Azure DevOps Projects presents a simplified experience where you can bring your existing code and Git repo or choose a sample application to create a continuous integration (CI) and continuous delivery (CD) pipeline to Azure.

Вы сможете выполнять следующие задачи:You will:

  • создание конвейера CI/CD с помощью DevOps Projects;Use DevOps Projects to create a CI/CD pipeline
  • настройка доступа к репозиторию GitHub и выбор платформы;Configure access to your GitHub repo and choose a framework
  • настройка Azure DevOps и подписки Azure;Configure Azure DevOps and an Azure subscription
  • фиксация изменений в GitHub и их автоматическое развертывание в Azure;Commit changes to GitHub and automatically deploy them to Azure
  • изучение конвейера CI/CD в Azure Pipelines;Examine the Azure Pipelines CI/CD pipeline
  • настройка мониторинга Azure Application Insights;Configure Azure Application Insights monitoring
  • очистка ресурсов.Clean up resources

Предварительные требованияPrerequisites

  • Подписка Azure.An Azure subscription. Вы можете получить бесплатную подписку с помощью Visual Studio Dev Essentials.You can get one free through Visual Studio Dev Essentials.
  • Доступ к GitHub или внешнему репозиторию Git, содержащему код .NET, Java, PHP, Node, Python или статический веб-код.Access to a GitHub or external Git repo that contains .NET, Java, PHP, Node, Python, or static web code.

Вход на портал AzureSign in to the Azure portal

Azure DevOps Projects создает конвейер CI/CD в Azure Pipelines.Azure DevOps Projects creates a CI/CD pipeline in Azure Pipelines. Вы можете создать новую организацию Azure DevOps или использовать существующую.You can create a new Azure DevOps organization or use an existing organization. Azure DevOps Projects также создает ресурсы Azure в требуемой подписке Azure.Azure DevOps Projects also creates Azure resources in the Azure subscription of your choice.

  1. Войдите на портале Azure.Sign in to the Azure portal.

  2. В области слева выберите Создать.In the left pane, select New.

  3. В поле поиска введите DevOps Projects, а затем выберите Создать.In the search box, type DevOps Projects, and then select Create.

    Панель мониторинга DevOps Projects

  4. Выберите Добавьте свой код и нажмите кнопку Далее.Select Bring your own code, and then select Next.

Настройка доступа к репозиторию GitHub и выбор платформыConfigure access to your GitHub repo and choose a framework

  1. Щелкните GitHub или "Внешний Git", а затем выберите репозиторий и ветвь, содержащую ваше приложение.Select either GitHub or an external Git repo, and then select your repo and the branch that contains your application.

  2. Выберите веб-платформу и нажмите кнопку Далее.Select your web framework, and then select Next.

    Платформа .NET

    Платформа приложения, которую вы выбрали ранее, определяет доступный тип объекта развертывания в службе Azure.The application framework, which you chose previously, dictates the type of Azure service deployment target that's available here.

  3. Выберите целевую службу и нажмите кнопку Далее.Select the target service, and then select Next.

Настройка Azure DevOps и подписки AzureConfigure Azure DevOps and an Azure subscription

  1. Создайте новую организацию Azure DevOps или выберите существующую.Create a new Azure DevOps organization or select an existing organization.

    a.a. Задайте имя проекта в Azure DevOps.Enter a name for your project in Azure DevOps.

    b.b. Выберите подписку Azure и расположение, введите имя приложения и нажмите кнопку Готово.Select your Azure subscription and location, enter a name for your application, and then select Done.

    Через несколько минут панель мониторинга DevOps Projects отобразится на портале Azure.After a few minutes, the DevOps Projects dashboard is displayed in the Azure portal. Пример приложения настраивается в репозитории в организации Azure DevOps, после чего выполняется сборка и развертывание приложения в Azure.A sample application is set up in a repo in your Azure DevOps organization, a build is executed, and your application is deployed to Azure. На этой панели мониторинга отображаются сведения о репозитории кода GitHub, конвейере CI/CD и приложении в Azure.This dashboard provides visibility into your GitHub code repo, the CI/CD pipeline, and your application in Azure.

  2. Выберите Обзор, чтобы просмотреть выполняющееся приложение.Select Browse to view your running application.

    Представление панели мониторинга DevOps Projects

Azure DevOps Projects автоматически настраивает сборку непрерывной интеграции и триггер выпуска.Azure DevOps Projects automatically configures a CI build and release trigger. Код остается в репозитории GitHub или другом внешнем репозитории.Your code remains in your GitHub repo or another external repo.

Фиксация изменений в GitHub и их автоматическое развертывание в AzureCommit changes to GitHub and automatically deploy them to Azure

Теперь вы готовы к совместной работе над приложением с использованием процесса CI/CD, который позволяет автоматически развернуть последние результаты работы на веб-сайте.You're now ready to collaborate with a team on your app by using a CI/CD process that automatically deploys your latest work to your website. При каждом изменении в репозитории GitHub запускается сборка в Azure DevOps, и конвейер CD выполняет развертывание в Azure.Each change to the GitHub repo starts a build in Azure DevOps, and a CD pipeline executes a deployment to Azure.

  1. Внесите изменения в приложение и зафиксируйте их в репозитории GitHub.Make a change to your application, and then commit the change to your GitHub repo.
    Через несколько секунд в Azure Pipelines начнется выполнение сборки.After a few moments, a build starts in Azure Pipelines. Состояние сборки вы можете отслеживать на панели мониторинга DevOps Projects или в браузере в организации Azure DevOps.You can monitor the build status in the DevOps Projects dashboard, or you can monitor it in the browser with your Azure DevOps organization.

  2. После завершения сборки обновите приложение, чтобы проверить внесенные изменения.After the build is completed, refresh your application to verify your changes.

Изучение конвейера CI/CD в Azure PipelinesExamine the Azure Pipelines CI/CD pipeline

Azure DevOps Projects автоматически настраивает конвейер CI/CD в Azure Pipelines.Azure DevOps Projects automatically configures a CI/CD pipeline in Azure Pipelines. При необходимости изучите и настройте конвейер.Explore and customize the pipeline as needed. Чтобы составить представление о конвейерах сборки и выпуска, сделайте следующее:To familiarize yourself with the build and release pipelines, do the following:

  1. В верхней части панели мониторинга DevOps Projects выберите Конвейеры сборки.At the top of the DevOps Projects dashboard, select Build pipelines.
    На вкладке браузера отобразится конвейер сборки нового проекта.A browser tab displays the build pipeline for your new project.

  2. Выберите поле Состояние и щелкните значок многоточия (…).Point to the Status field, and then select the ellipsis (...).
    В появившемся меню содержится несколько пунктов, таких как постановка в очередь новой сборки, приостановка сборки и изменение конвейера сборки.A menu displays several options, such as queueing a new build, pausing a build, and editing the build pipeline.

  3. Выберите ИзменитьSelect Edit.

  4. В этой области можно просмотреть различные задачи для конвейера сборки.In this pane, you can examine the various tasks for your build pipeline.
    Конвейер сборки выполняет различные задачи, такие как получение источников из репозитория Git, восстановление зависимостей и публикация результатов, используемых для развертывания.The build performs various tasks, such as fetching sources from the Git repo, restoring dependencies, and publishing outputs used for deployments.

  5. Выберите имя конвейера сборки в верхней части соответствующей области.At the top of the build pipeline, select the build pipeline name.

  6. Замените имя конвейера сборки более понятным для себя, выберите Сохранить и поместить в очередь и нажмите кнопку Сохранить.Change the name of your build pipeline to something more descriptive, select Save & queue, and then select Save.

  7. Под именем конвейера сборки щелкните Журнал.Under your build pipeline name, select History.
    Вы увидите журнал аудита последних изменений сборки.You see an audit trail of your recent changes for the build. Azure DevOps отслеживает все изменения, внесенные в конвейер сборки, и позволяет сравнивать версии.Azure DevOps keeps track of any changes made to the build pipeline, and it allows you to compare versions.

  8. Выберите Триггеры.Select Triggers.
    Azure DevOps Projects автоматически создает триггер CI, а каждая фиксация в репозитории создает новую сборку.Azure DevOps Projects automatically creates a CI trigger, and every commit to the repo starts a new build. При необходимости выберите для процесса непрерывной интеграции включение или исключение ветвей.Optionally, you can choose to include or exclude branches from the CI process.

  9. Щелкните Период удержания.Select Retention.
    В зависимости от сценария можно указать политики для хранения или удаления определенного количества сборок.Depending on your scenario, you can specify policies to keep or remove a certain number of builds.

  10. Выберите Сборка и выпуск, а затем щелкните Выпуски.Select Build and Release, and then select Releases.
    Azure DevOps Projects создает конвейер выпуска для управления развертываниями в Azure.Azure DevOps Projects creates a release pipeline to manage deployments to Azure.

  11. Щелкните многоточие (…) рядом с конвейером выпуска и выберите Изменить.Select the ellipsis (...) next to your release pipeline, and then select Edit.
    Конвейер выпуска содержит конвейер, в котором определен процесс выпуска.The release pipeline contains a pipeline, which defines the release process.

  12. В разделе Артефакты выберите Удалить.Under Artifacts, select Drop.
    Конвейер сборки, который вы изучали на предыдущих этапах, создаст выходные данные для артефакта.The build pipeline you examined in the previous steps produces the output that's used for the artifact.

  13. Рядом со значком Удалить выберите Триггер непрерывного развертывания.Next to the Drop icon, select Continuous deployment trigger.
    Этот выпуск конвейера содержит триггер непрерывного развертывания, выполняющий развертывание каждый раз, когда становится доступным новый артефакт сборки.This release pipeline has an enabled CD trigger, which executes a deployment every time there is a new build artifact available. При желании можно отключить триггер, чтобы выполнить развертывание вручную.Optionally, you can disable the trigger so that your deployments require manual execution.

  14. В области слева выберите Задачи.At the left, select Tasks.
    Задачи — это действия, которые выполняются в процессе развертывания.Tasks are the activities that your deployment process executes. В этом примере задача заключается в развертывании в Службе приложений Azure.In this example, a task was created to deploy to the Azure App service.

  15. В области справа выберите Просмотреть выпуски, чтобы отобразить журнал выпусков.At the right, select View releases to display a history of releases.

  16. Щелкните многоточие (…) рядом с конвейером выпуска и выберите Открыть.Select the ellipsis (...) next to a release, and then select Open.
    В этом представлении доступно несколько меню, например меню сводки по выпуску, меню связанных рабочих элементов и тестов.There are several menus to explore, such as a release summary, associated work items, and tests.

  17. Щелкните Фиксации.Select Commits.
    В этом представлении отображаются фиксации кода, связанные с этим развертыванием.This view shows code commits that are associated with this deployment.

  18. Выберите Журналы.Select Logs.
    Журналы содержат полезную информацию о процессе развертывания.The logs contain useful information about the deployment process. Их можно просматривать во время и после развертывания.You can view them both during and after deployments.

Настройка мониторинга Azure Application InsightsConfigure Azure Application Insights monitoring

С помощью Azure Application Insights можно легко отслеживать производительность и использование своего приложения.With Azure Application insights, you can easily monitor your application's performance and usage. Azure DevOps Projects автоматически настраивает ресурс Application Insights для вашего приложения.Azure DevOps Projects automatically configures an Application Insights resource for your application. Вы можете дополнительно настроить различные предупреждения и возможности мониторинга по мере необходимости.You can further configure various alerts and monitoring capabilities as needed.

  1. На портале Azure перейдите к панели мониторинга DevOps Projects.In the Azure portal, go to the DevOps Projects dashboard.

  2. В правом нижнем углу щелкните ссылку Application Insights для вашего приложения.At the lower right, select the Application Insights link for your app.
    Откроется панель Application Insights.The Application Insights pane opens. Это представление содержит информацию об использовании, производительности и доступности приложения.This view contains usage, performance, and availability monitoring information for your app.

    Панель Application Insights

  3. Щелкните Диапазон времени, а затем выберите За последний час.Select Time range, and then select Last hour. Щелкните Обновить, чтобы отфильтровать результаты.To filter the results, select Update.
    Теперь вы можете просмотреть все действия за последние 60 минут.You can now view all activity from the last 60 minutes. Чтобы закрыть представление диапазона времени, щелкните x.To exit the time range, select x.

  4. Выберите Оповещения и щелкните Добавить оповещение метрики.Select Alerts, and then select Add metric alert.

  5. Введите имя оповещения.Enter a name for the alert.

  6. В раскрывающемся списке Source Alter on (Изменить источник) выберите App Service resource (Ресурс Службы приложений).In the Source Alter on drop-down list, select your App Service resource.

  7. В раскрывающемся списке Метрика просмотрите различные оповещения метрик.In the Metric drop-down list, examine the various alert metrics.
    По умолчанию оповещение отображается, если время отклика сервера превышает 1 секунду.The default alert is for a server response time greater than 1 second. Различные оповещения можно легко настроить, чтобы улучшить возможности мониторинга приложения.You can easily configure a variety of alerts to improve the monitoring capabilities of your app.

  8. Установите флажок Notify via Email owners, contributors, and readers (Уведомлять по электронной почте владельцев, участников и читателей).Select the Notify via Email owners, contributors, and readers check box.
    При желании вы можете выполнять дополнительные действия, когда срабатывает оповещение, реализовав приложение логики в Azure.Optionally, you can perform additional actions when an alert is displayed by executing an Azure logic app.

  9. Нажмите кнопку ОК, чтобы создать оповещение.Select OK to create the alert.
    Через несколько секунд предупреждение появится на панели мониторинга как активное.After a few moments, the alert appears as active on the dashboard.

  10. Выйдите из области оповещений и вернитесь на панель Application Insights.Exit the Alerts area, and go back to the Application Insights pane.

  11. Выберите Доступность, а затем щелкните Добавить тест.Select Availability, and then select Add test.

  12. Введите имя теста и нажмите кнопку Создать.Enter a test name, and then select Create.
    Создается простой тест проверки связи для проверки доступности вашего приложения.A simple ping test is created to verify the availability of your application. Через несколько минут результаты тестирования будут доступны, а на панели мониторинга Application Insights отобразится состояние доступности.After a few minutes, test results are available, and the Application Insights dashboard displays an availability status.

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

Службу приложений Azure и связанные с ней ресурсы, созданные при работе с этим руководством, можно удалить, если они больше не нужны.When they are no longer needed, you can delete the Azure App service and related resources that you created in this tutorial. Для этого воспользуйтесь функцией Удалить на панели мониторинга DevOps Projects.To do so, use the Delete functionality on the DevOps Projects dashboard.

Дополнительная информацияNext steps

После настройки процесса CI/CD с помощью этого руководства в Azure DevOps Projects автоматически создается конвейер сборки и выпуска.When you configured your CI/CD process in this tutorial, a build and release pipeline were automatically created in Azure DevOps Projects. Вы можете изменить эти конвейеры сборки и выпуска в соответствии с потребностями вашей команды.You can modify these build and release pipelines to meet the needs of your team. Вы научились выполнять следующие задачи:You learned how to:

  • создание конвейера CI/CD с помощью DevOps Projects;Use DevOps Projects to create a CI/CD pipeline
  • настройка доступа к репозиторию GitHub и выбор платформы;Configure access to your GitHub repo and choose a framework
  • настройка Azure DevOps и подписки Azure;Configure Azure DevOps and an Azure subscription
  • фиксация изменений в GitHub и их автоматическое развертывание в Azure;Commit changes to GitHub and automatically deploy them to Azure
  • изучение конвейера CI/CD в Azure Pipelines;Examine the Azure Pipelines CI/CD pipeline
  • настройка мониторинга Azure Application Insights;Configure Azure Application Insights monitoring
  • очистка ресурсов.Clean up resources

Дополнительные сведения о конвейере CI/CDTo learn more about the CI/CD pipeline, see:

Define your multi-stage continuous deployment (CD) pipeline (Настройка многоэтапного конвейера для непрерывного развертывания)Define your multi-stage continuous deployment (CD) pipeline