Упражнение. Настройка среды

Завершено

Команда медленно интегрирует стратегию 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.

    Screenshot of the Azure DevOps Demo Generator web site showing the process to create the project.

  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-адрес в буфер обмена.

    Screenshot that shows how to locate the URL and copy button from the GitHub repository.

  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
    

Настройка вышестоящего удаленного репозитория

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

  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. Выполните следующие команды, чтобы получить ветвь конвейера выпуска из репозитория MicrosoftDocs и проверка создать новую ветвь вышестоящий или конвейер выпуска.

    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. Если появится запрос, убедитесь, что для авторизации подключения службы выберите "Авторизовать ресурсы ".

    Screenshot of Azure Pipelines showing the pipeline for this project. The pipeline has no runs.

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

    Screenshot of Azure Pipelines showing the location of the Run pipeline button.

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

    Screenshot of Azure Pipelines showing the running job.

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

    Screenshot of Azure Pipelines showing how to navigate to the summary page.

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

    Screenshot of Azure Pipelines showing the location of the link to the published artifact.

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

    Screenshot of Azure Pipelines showing the published artifact. The artifact includes a .zip file.

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