Упражнение. Настройка среды Azure DevOps
В этом разделе вы узнаете, как настроить организацию Azure DevOps и создать среду Azure App Service, в которую будет выполняться развертывание.
Вы узнаете, как:
- Настройте проект Azure DevOps.
- Управление рабочими элементами с помощью Azure Boards.
- Создайте среду Службы приложений Azure.
- Создайте переменные конвейера в Azure Pipelines.
- Создайте подключение к службе для проверки подлинности в подписке Azure.
Добавление пользователя в Azure DevOps
Чтобы завершить этот модуль, вам потребуется собственная подписка Azure. Вы можете бесплатно приступить к работе с Azure.
Для работы с Azure DevOps не требуется подписка Azure, но в этом модуле вы будете использовать Azure DevOps для развертывания в ресурсах Azure. Чтобы упростить процесс, используйте одну и ту же учетную запись Майкрософт для входа в Azure и Azure DevOps.
Если вы используете разные учетные записи Майкрософт для входа в Azure и Azure DevOps, добавьте пользователя с уровнем доступа "Базовый " в организацию DevOps в учетной записи Майкрософт, используемой для входа в Azure. Дополнительные сведения см. в статье "Добавление пользователей в организацию или проект ".
Затем выйдите из Azure DevOps и войдите обратно с помощью той же учетной записи, которую вы использовали для входа в подписку Azure.
Получение проекта Azure DevOps
Здесь вы убедитесь, что ваша организация Azure DevOps настроена для завершения остальной части этого модуля. Для этого вы запустите шаблон, создающий проект в Azure DevOps.
Модули в этом пути обучения формируют прогрессию. Вы следите за командой веб-разработчиков Tailspin в их процессе DevOps. Для обучения каждый модуль имеет собственный проект Azure DevOps.
Запуск шаблона
Запустите шаблон, который настраивает организацию Azure DevOps.
Получите и запустите проект ADOGenerator в Visual Studio или интегрированной среде разработки.
При появлении запроса ввести номер шаблона из списка шаблонов введите 39 для автоматизации развертываний контейнеров Docker с помощью Azure Pipelines, а затем нажмите клавишу ВВОД.
Выберите метод проверки подлинности. Вы можете настроить и использовать личный маркер доступа (PAT) или использовать имя входа устройства.
Заметка
Если вы настроили PAT, обязательно авторизуйте необходимые области. Для этого модуля можно использовать полный доступ, но в реальной ситуации необходимо предоставить только необходимые области.
Введите имя вашей организации Azure DevOps, а затем нажмите ВВОД.
Если появится запрос, введите Azure DevOps PAT, а затем нажмите клавишу ВВОД.
Введите имя проекта, например Space Game - web - Docker, а затем нажмите Enter.
После создания проекта перейдите в организацию Azure DevOps в браузере (по адресу
https://dev.azure.com/<your-organization-name>/) и выберите проект.
Создание вилки репозитория
Если вы еще не сделали этого, создайте форк репозитория mslearn-tailspin-spacegame-web-docker.
На сайте GitHub перейдите в репозиторий mslearn-tailspin-spacegame-web-docker .
Выберите вилку в правом верхнем углу экрана.
Выберите свою учетную запись GitHub в качестве владельца, затем выберите Создать форк.
Важный
В этом модуле страница "Очистка среды Azure DevOps" содержит важные действия по очистке. Очистка помогает убедиться, что вы не упустите бесплатные минуты сборки. Следуйте инструкциям по очистке, даже если этот модуль не завершен.
Настройка видимости проекта
Изначально ваш форк репозитория Space Game на GitHub установлен как общедоступный, тогда как проект, созданный с помощью шаблона Azure DevOps, установлен как частный. Доступ к общедоступному репозиторию на GitHub может любой пользователь, а частный репозиторий доступен только вам и пользователям, с которыми вы хотите поделиться им. Аналогичным образом, в Azure DevOps общедоступные проекты предоставляют доступ только для чтения пользователям, не прошедшим проверку подлинности, в то время как частные проекты требуют предоставления пользователям доступа и проверки подлинности для доступа к службам.
На данный момент не требуется изменять какие-либо из этих параметров в целях этого модуля. Однако для личных проектов необходимо определить видимость и доступ, которые вы хотите предоставить другим пользователям. Например, если проект является открытым исходным кодом, вы можете сделать репозиторий GitHub и проект Azure DevOps общедоступным. Если проект является закрытым, обычно вы сделаете репозиторий GitHub и проект Azure DevOps закрытым.
Далее вы можете найти следующие ресурсы, которые помогут определить, какой вариант лучше всего подходит для вашего проекта:
- Использование частных и общедоступных проектов
- Изменение видимости проекта на общедоступную или частную
- Настройка видимости репозитория
Перемещение рабочего элемента в "Выполнение"
Здесь вы назначите себе рабочий элемент в Azure Boards. Вы также переместите рабочий элемент в состояние "Выполнение ". На практике вы и ваша команда создадите рабочие элементы в начале каждого спринта или итерации.
Это рабочее задание предоставляет вам контрольный список, с которым вы можете работать. Он дает другим участникам команды представление о том, над чем вы работаете, и сколько работы осталось. Рабочий элемент также помогает применять ограничения на выполнение задач (WIP), чтобы команда не брала на себя слишком много работы одновременно.
Здесь вы переместите первый элемент, Создайте версию контейнера веб-сайта, используя Docker, в столбец Doing, а затем назначьте себе этот рабочий элемент.
Чтобы настроить рабочий элемент, выполните следующие действия.
В Azure DevOps перейдите в Boards. Затем выберите "Доски" в меню.
В рабочем элементе Создание контейнерной версии веб-сайта с использованием Docker выберите стрелку вниз в нижней части карточки, затем назначьте рабочий элемент себе.
Переместите рабочий элемент из столбца "To Do" в столбец "Doing".
В конце этого модуля вы переместите карточку в столбец Done после завершения задачи.
Создание среды службы приложений Azure
В модуле Создание конвейера выпуска с помощью Azure Pipelines вы создали экземпляр службы приложений, используя портал Azure. Хотя портал является отличным инструментом для изучения предложений Azure, настройка компонентов, таких как Служба приложений, может стать громоздкой.
В этом модуле вы будете использовать Azure CLI для запуска ресурсов, необходимых для развертывания и запуска экземпляра службы приложений. Доступ к Azure CLI можно получить из терминала или с помощью Visual Studio Code.
Важный
Для выполнения упражнений в этом модуле необходимо иметь собственную подписку Azure.
Запуск Cloud Shell на портале Azure
Перейдите на портал Azure и войдите.
Выберите Cloud Shell в строке меню и выберите интерфейс Bash .
Заметка
Cloud Shell требует, чтобы ресурс хранилища Azure сохранял все файлы, создаваемые в Cloud Shell. При первом открытии Cloud Shell вам будет предложено создать группу ресурсов, учетную запись хранения и общую папку файлов Azure. Эта настройка автоматически используется для всех будущих сеансов Cloud Shell.
Выбор региона Azure
Регион — это один или несколько центров обработки данных Azure, расположенных в определенном географическом расположении. Восточная часть США, западная часть США и Северная Европа являются несколькими примерами регионов. Каждый ресурс Azure, например экземпляр службы приложений, выделяется для определенного региона.
Чтобы упростить процесс выполнения команд, начните с выбора региона по умолчанию. После указания региона по умолчанию последующие команды будут использовать этот регион по умолчанию, если не указан другой регион явным образом.
Выполните следующую команду, чтобы получить список доступных регионов для подписки Azure.
az account list-locations \ --query "[].{Name: name, DisplayName: displayName}" \ --output tableВыберите регион, ближайший к вашему местоположению, из столбца Название в выходных данных. Например, можно выбрать eastasia или westus2.
Выполните следующую команду, чтобы задать регион по умолчанию. Замените заполнитель именем выбранного региона.
az configure --defaults location=<REGION>В этом примере в качестве региона по умолчанию задается westus2 :
az configure --defaults location=westus2
Создание переменных Bash
В этом разделе вы создадите переменные Bash, чтобы сделать процесс установки более удобным и менее подверженным ошибкам. Использование переменных для общих текстовых строк помогает избежать случайных опечаток.
Из Cloud Shell создайте случайное число. Это упрощает создание глобальных уникальных имен для определенных служб на следующем шаге.
resourceSuffix=$RANDOMСоздайте глобально уникальные имена для веб-приложения службы приложений и реестра контейнеров Azure. Используя двойные кавычки в этих командах, Bash запрашивает интерполяцию переменных с помощью встроенного синтаксиса.
webName="tailspin-space-game-web-${resourceSuffix}" registryName="tailspinspacegame${resourceSuffix}"Создайте еще две переменные Bash для хранения имен группы ресурсов и плана службы приложений.
rgName='tailspin-space-game-rg' planName='tailspin-space-game-asp'
Создание ресурсов Azure
Заметка
В целях обучения вы получите параметры сети по умолчанию. Эти параметры делают сайт доступным из Интернета. На практике вы можете настроить виртуальную сеть Azure, которая размещает веб-сайт в сети, которая не является маршрутизируемой в Интернете, и что доступ к ней можно получить только вам и вашей команде. Позже вы можете перенастроить сеть, чтобы сделать веб-сайт доступным для пользователей.
Выполните следующую команду
az group create, чтобы создать группу ресурсов с помощью имени, определенного ранее.az group create --name $rgNameВыполните следующую команду
az acr create, чтобы создать реестр контейнеров Azure с помощью имени, определенного ранее.az acr create --name $registryName \ --resource-group $rgName \ --sku Standard \ --admin-enabled trueВыполните следующую команду
az appservice plan create, чтобы создать план службы приложений с помощью имени, определенного ранее.az appservice plan create \ --name $planName \ --resource-group $rgName \ --sku B1 \ --is-linuxАргумент
--skuуказывает план B1. Этот план действует в тарифе "Базовый". Аргумент--is-linuxуказывает на использование рабочих процессов Linux.Важный
Если артикул B1 недоступен в подписке Azure, выберите другой план, например, S1 (стандартная ценовая категория).
Выполните следующую команду
az webapp create, чтобы создать экземпляр службы приложений.az webapp create \ --name $webName \ --resource-group $rgName \ --plan $planName \ --deployment-container-image-name $registryName.azurecr.io/web:latestВыполните следующую команду
az webapp list, чтобы указать имя узла и состояние экземпляра службы приложений.az webapp list \ --resource-group $rgName \ --query "[].{hostName: defaultHostName, state: state}" \ --output tableЗапишите имя узла для запущенной службы. Вам это понадобится позже, когда будете проверять свою работу. Ниже приведен пример:
HostName State ---------------------------------------------- ------- tailspin-space-game-web-4692.azurewebsites.net RunningВыполните следующую команду
az acr list, чтобы получить список сервера входа экземпляра реестра контейнеров Azure. Это имя сервера потребуется при создании переменных конвейера позже.az acr list \ --resource-group $rgName \ --query "[].{loginServer: loginServer}" \ --output tableОбратите внимание на сервер входа. Вам потребуется позже при настройке конвейера. Ниже приведен пример:
LoginServer --------------------------------- tailspinspacegame4692.azurecr.io
Важный
Страница "Очистка среды Azure DevOps" в этом модуле содержит важные действия по очистке. Очистка помогает убедиться, что вам не начисляют плату за ресурсы Azure после завершения этого модуля. Не забудьте выполнить действия по очистке, даже если этот модуль не завершен.
Создание переменных конвейера в Azure Pipelines
В разделе "Создание конвейера выпуска с помощью Azure Pipelines" вы добавили переменную в конвейер, в который хранится имя веб-приложения в службе приложений. Вы сделаете то же самое здесь. Кроме того, вы добавите имя реестра контейнеров Azure.
Эти имена можно жёстко прописать в конфигурации конвейера обработки, но если вы определите их как переменные, конфигурация будет более универсальной. Кроме того, если имена экземпляров изменяются, можно обновить переменные и активировать конвейер, не изменив конфигурацию.
Чтобы добавить переменные, выполните следующие действия.
В Azure DevOps перейдите в проект Space Game — web - Docker .
В разделе "Конвейеры" выберите библиотеку.
Выберите и группу переменных.
В разделе "Свойства" введите "Выпуск " для имени группы переменных.
В разделе "Переменные" нажмите кнопку +Добавить.
Для имени переменной введите WebAppName. В качестве значения введите имя экземпляра службы приложений, созданного выше, например tailspin-space-game-web-4692.
Важный
Задайте имя инстанции службы приложений, а не её имя узла. В этом примере вы введете tailspin-space-game-web-4692 , а не tailspin-space-game-web-4692.azurewebsites.net.
Повторите процесс, чтобы добавить другую переменную с именем RegistryName со значением сервера входа в реестр контейнеров Azure, например tailspinspacegame4692.azurecr.io.
Выберите разрешения для конвейера, а затем выберите значок
+для добавления конвейера. Выберите mslearn-tailspin-spacegame-web-docker , чтобы предоставить конвейеру разрешение на доступ к группе переменных.Нажмите кнопку "Сохранить " в верхней части страницы, чтобы сохранить переменные. Ваша группа переменных должна выглядеть следующим образом:
Создание необходимых подключений к службе
Здесь вы создадите подключение к службе, позволяющее Azure Pipelines получить доступ к подписке Azure. Azure Pipelines использует это подключение к службе для развертывания веб-сайта в Службе приложений. Вы создали аналогичное подключение к службе в предыдущем модуле. Вы также создадите подключение реестра Docker для публикации контейнера в реестре контейнеров Azure.
Важный
Убедитесь, что вы вошли на портал Azure и Azure DevOps под одной учетной записью Майкрософт.
В Azure DevOps перейдите в проект Space Game — web - Docker .
В нижнем углу страницы выберите параметры проекта.
В разделе "Пайплайны" выберите Сервисные подключения.
Выберите новое подключение к службе, а затем выберите Azure Resource Manager, а затем нажмите кнопку "Далее".
В верхней части страницы служебный принципал (автоматически). Затем нажмите кнопку "Далее".
Заполните следующие поля:
Поле Ценность Уровень области Подписка Подписка Подписка Azure Группа ресурсов tailspin-space-game-rg Имя соединения с сервисом Resource Manager — Tailspin — Space Game Во время процесса может появиться запрос на вход в учетную запись Майкрософт.
Убедитесь, что выбрано разрешение на доступ ко всем трубопроводам.
Нажмите кнопку "Сохранить".
Azure DevOps выполняет тестовое подключение, чтобы убедиться, что он может подключиться к подписке Azure. Если Azure DevOps не удается подключиться, у вас есть возможность войти во второй раз.
Выберите новое подключение к службе, а затем выберите " Реестр Docker", а затем нажмите кнопку "Далее".
В верхней части страницы выберите реестр контейнеров Azure.
Заполните следующие поля:
Поле Ценность Подписка Подписка Azure Реестр контейнеров Azure Выберите созданный ранее объект Имя соединения с сервисом Подключение реестра контейнеров Убедитесь, что выбрано разрешение на доступ ко всем трубопроводам.
Нажмите кнопку "Сохранить " после завершения.