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

  • 8 мин

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

Для этого необходимо сделать следующее:

  • Настройте проект Azure DevOps для этого модуля.
  • Переместите рабочий элемент для этого модуля в Azure Boards в столбец "Выполнение ".
  • Убедитесь, что проект настроен локально, чтобы можно было отправлять изменения в конвейер.

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

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

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

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

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

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

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

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

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

    Внимание

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

  4. Выберите "Создать проект".

    A screenshot of the Azure DevOps Demo Generator Create New Project screen with the Create Project button highlighted.

    Шаблон запустится через несколько секунд.

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

Внимание

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

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

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

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

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

Локальная настройка проекта

Здесь вы загрузите проект Space Game в Visual Studio Code, настроите GIT, клонируете репозиторий локально и настроите вышестоящий удаленный репозиторий таким образом, чтобы можно было скачать начальный код.

Примечание.

Если вы уже настроили проект mslearn-tailspin-spacegame-web локально, вы можете перейти к следующему разделу.

Открытие интегрированного терминала

В Visual Studio Code есть встроенный терминал, поэтому вы можете редактировать файлы и работать с командной строкой в одном расположении.

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

  2. В меню "Вид" выберите терминал.

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

    A screenshot of Visual Studio Code showing the location of the Bash shell.

    Окно терминала позволяет выбрать любую оболочку, установленную в системе, например Bash, Zsh и PowerShell.

    Здесь вы используете Bash. Git для Windows предоставляет Git Bash, который позволяет легко выполнять команды Git.

    Примечание.

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

  4. Выполните команду, чтобы перейти к каталогу cd , из которого требуется работать, например в домашнем каталоге (~). Вы можете выбрать другой каталог, если вы хотите.

    cd ~

Настройка Git

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

В разделе Настройка Git этот процесс объясняется более подробно.

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

  1. Задайте имя пользователя.
  2. Задайте адрес электронной почты фиксации.
  3. Кэшируйте пароль GitHub.

Примечание.

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

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

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

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

Клонирование вилки локально

Теперь у вас есть копия веб-проекта Space Game в вашей учетной записи GitHub. Теперь вы скачайте или клонируете копию на компьютер, чтобы вы могли работать с ней.

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

Чтобы клонировать веб-проект Space Game на компьютер:

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

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

    Locating the URL and copy button from the GitHub repository.

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

  4. В терминале перейдите к каталогу, из которого нужно работать, например в домашнем каталоге (~). Вы можете выбрать другой каталог, если вы хотите.

    cd ~

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

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

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

    cd mslearn-tailspin-spacegame-web

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

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

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

    git remote -v

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

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

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

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

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

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

    git remote -v

    Вы видите, что у вас все еще есть доступ для получения (загрузки) и отправки (передачи) репозитория. Кроме того, теперь у вас есть доступ на получение из репозитория Майкрософт и отправку в него:

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

Откройте проект в обозревателе файлов

В Visual Studio Code окно терминала указывает на корневой каталог веб-проекта Space Game. Чтобы просмотреть ее структуру и работать с файлами, из проводника вы откроете проект.

  1. Самый простой способ открыть проект заключается в повторном открытии Visual Studio Code в текущем каталоге. Для этого во встроенном терминале выполните следующую команду.

    code -r .

    В обозревателе вы увидите каталог и дерево файлов.

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

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

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

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