Упражнение - Настройте свою среду

  • 15 мин

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

Для этого выполните следующие действия.

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

Добавление пользователя в Azure DevOps

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

Несмотря на то, что для работы с Azure DevOps подписка не требуется, в данном случае вы будете использовать Azure DevOps для развертывания ресурсов Azure, которые существуют в вашей подписке Azure. Чтобы упростить процесс, войдите в подписку Azure и организацию Azure DevOps в одной учетной записи Майкрософт.

Если вы используете разные учетные записи Майкрософт для входа в Azure и Azure DevOps, добавьте пользователя в организацию DevOps в учетной записи Майкрософт, используемой для входа в Azure. Дополнительные сведения см. в статье Добавление пользователей организации и управление доступом. При добавлении пользователя выберите уровень доступа Базовый.

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

Получите проект Azure DevOps

Убедитесь, что ваша организация Azure DevOps настроена для завершения остальной части этого модуля. Для этого выполните шаблон, создающий проект в Azure DevOps.

Модули в этом учебном пути формируют прогрессию, когда вы следуете за веб-командой Tailspin в их путешествии в DevOps. Для обучения каждый модуль имеет связанный проект Azure DevOps.

Запуск шаблона

Запустите шаблон, который настраивает все для вас в организации Azure DevOps.

Запустите шаблон

На сайте демонстрационного генератора Azure DevOps выполните следующие действия, чтобы запустить шаблон:

  1. Выберите войдите и примите условия использования.

  2. На странице Создание проекта выберите свою организацию Azure DevOps и введите имя проекта, например Space Game — web — release.

    снимок экрана веб-сайта azure DevOps Demo Generator с процессом создания проекта.

  3. Выберите Да, я хочу форк этого репозитория>Авторизовать. Если появится окно, авторизуйте доступ к учетной записи GitHub.

    Важный

    Этот параметр необходимо выбрать, чтобы шаблон подключится к репозиторию GitHub. Выберите его, даже если вы уже скопировали проект веб-сайта Space Game. Шаблон использует ваше существующее ответвление.

  4. Выберите Создать проект. Выполнение шаблона занимает несколько минут.

  5. Выберите Перейти к проекту, чтобы перейти к проекту в Azure DevOps.

Важный

Страница Очистка среды Azure DevOps в этом модуле содержит важные действия по очистке. Очищение помогает убедиться, что вы не израсходуете бесплатные минуты сборки. Не забудьте выполнить действия по очистке, даже если этот модуль не завершен.

Настройка видимости проекта

Изначально ваша вилка репозитория Space Game на GitHub изначально общедоступна, в то время как проект, созданный с помощью шаблона Azure DevOps, изначально частный. Доступ к общедоступному репозиторию на GitHub может любой пользователь, а частный репозиторий доступен только вам и пользователям, с которыми вы хотите поделиться им. Аналогичным образом, в Azure DevOps общедоступные проекты предоставляют доступ только для чтения пользователям, не прошедшим проверку подлинности, в то время как частные проекты требуют предоставления пользователям доступа и проверки подлинности для доступа к службам.

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

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

Подготовь Visual Studio Code

Настройте Visual Studio Code, чтобы создать веб-сайт локально и использовать исходные файлы.

Visual Studio Code поставляется с интегрированным терминалом, чтобы вы могли редактировать файлы и работать из командной строки, все из одного места.

  1. Запустите Visual Studio Code.

  2. Выберите терминал, а затем выберите Новый терминал.

  3. В раскрывающемся списке выберите Git Bash. Если вы знакомы с другой оболочкой Unix, которую вы предпочитаете использовать, например Zsh, выберите эту оболочку. Git для Windows предоставляет Git Bash, что упрощает выполнение команд Git.

    Заметка

    В Windows, если вы не видите Git Bash в списке в качестве параметра, убедитесь, что вы установили Git, а затем перезапустите Visual Studio Code.

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

    cd ~

Настройка Git

Если вы не знакомы с Git и GitHub, сначала необходимо выполнить несколько команд, чтобы связать удостоверение с Git и пройти проверку подлинности с помощью GitHub. Для получения дополнительной информации см. Установка Git.

Как минимум, вам потребуется выполнить следующие действия:

  1. Скачайте и установите последнюю версиюGit.
  2. Установите имя пользователя.
  3. Задайте адрес электронной почты коммита.

Заметка

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

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

Настройка проекта в Visual Studio Code

Когда вы запустили шаблон для настройки проекта Azure DevOps, процесс автоматически закрепил репозиторий mslearn-tailspin-spacegame-web-deploy. Теперь вы скачаете, или клонируете, копию на ваш компьютер, чтобы можно было с ней работать.

Клонируйте свой форк локально

  1. На GitHubперейдите в вилку веб-проекта Space Game (mslearn-tailspin-spacegame-web-deploy).

  2. Выберите код, а затем на вкладке HTTPS нажмите кнопку копирования, чтобы скопировать URL-адрес в буфер обмена.

    снимок экрана, показывающий, как найти URL-адрес и копировать кнопку из репозитория GitHub.

  3. В Visual Studio Code перейдите в окно терминала, открытое ранее.

  4. Выполните команду git clone. Замените URL-адрес, показанный здесь содержимым буфера обмена:

    git clone https://github.com/your-name/mslearn-tailspin-spacegame-web-deploy.git

  5. Перейдите в каталог mslearn-tailspin-spacegame-web-deploy. Этот каталог является корнем репозитория.

    cd mslearn-tailspin-spacegame-web-deploy

Настройка upstream-репозитория

Удаленный — это репозиторий Git, в котором члены команды работают совместно (например, репозиторий на GitHub). Здесь вы перечисляете свои удаленные репозитории и добавляете удаленный репозиторий, указающий на репозиторий компании Microsoft, чтобы получить самый свежий пример кода.

  1. Выполните следующую команду, чтобы вывести список удаленных элементов.

    git remote -v

    Вы видите, что у вас есть доступ к репозиторию как для получения (скачивания), так и отправки (отправки):

    origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (fetch)
origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (push)

    Источник указывает репозиторий на сайте GitHub. При форке кода из другого репозитория исходный удаленный (тот, из которого вы сделали форк) обычно называется верхний уровень.

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

    git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.git

  3. Запустите git remote второй раз, чтобы увидеть изменения:

    git remote -v

    У вас по-прежнему есть доступ к загрузке и передаче в вашем репозитории. Теперь у вас также есть доступ к репозиторию Майкрософт для получения данных.

    origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (fetch)
origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (push)
upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.git (fetch)
upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.git (push)

Открытие проекта в Visual Studio Code

  1. Выполните следующую команду из корневого каталога проекта.

    code .

  2. Откройте интегрированный терминал. Терминал помещает вас в корень веб-проекта.

Если команда code заканчивается с ошибкой, необходимо добавить Visual Studio Code в системную переменную PATH. Для этого сделайте:

  1. В Visual Studio Code выберите F1 или выберите Вид>Палитра команд для доступа к палитре команд.
  2. Введите команду оболочки и найдите команду оболочки : установите команду code в команде PATH.
  3. Перезапустите терминал, чтобы новый PATH вступил в силу.

Теперь вы готовы работать с исходным кодом Space Game и конфигурацией Azure Pipelines из локальной среды разработки.

Получите ветку из GitHub

  1. В Visual Studio Code откройте интегрированный терминал.

  2. Выполните следующие команды, чтобы получить ветвь release-pipeline из репозитория MicrosoftDocs и переключиться на новую ветвь upstream/release-pipeline.

    git fetch upstream release-pipeline
git checkout -B release-pipeline upstream/release-pipeline

  3. В Visual Studio Code откройте файл azure-pipelines.yml и ознакомьтесь с начальной конфигурацией конвейера YAML.

Запуск конвейера

На этом этапе у вас есть:

  • Форк из репозитория mslearn-tailspin-spacegame-web-deploy в вашей учетной записи GitHub.
  • Репозиторий mslearn-tailspin-spacegame-web-deploy клонирован локально.
  • Ветвь под названием release-pipeline, содержащая исходный код веб-сайта и начальную конфигурацию Azure Pipelines.

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

  1. Перейдите к проекту в Azure Devops, а затем выберите Конвейеры.

  2. Выберите конвейер mslearn-tailspin-spacegame-web-deploy. При появлении запроса убедитесь, что вы выбрали разрешить доступ к ресурсам, чтобы авторизовать подключение к службе.

    снимок экрана Azure Pipelines с конвейером для этого проекта. Конвейер не имеет запущенных процессов.

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

    снимок экрана Azure Pipelines с расположением кнопки

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

    снимок экрана Azure Pipelines, показывающий выполнение задания.

  5. После завершения сборки нажмите кнопку "Назад", чтобы вернуться на страницу сводки.

    снимок экрана Azure Pipelines, показывающий, как перейти на страницу сводки.

  6. Выберите опубликованный артефакт.

    снимок экрана Azure Pipelines с расположением ссылки на опубликованный артефакт.

  7. Tailspin.Space.Game.Web.zip — это артефакт сборки. Этот файл содержит созданное приложение и его зависимости.

    снимок экрана Azure Pipelines с опубликованным артефактом. Артефакт содержит файл .zip.

Теперь у вас есть конвейер сборки для веб-проекта Space Game. Затем вы добавите этап развертывания для развертывания артефакта сборки в Службе приложений Azure.