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

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

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

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

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

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

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

1. Получите и запустите проект ADOGenerator в Visual Studio или интегрированной среде разработки.

2. При появлении запроса ввести номер шаблона из списка шаблонов введите 24 для запуска тестов качества в вашем конвейере сборки с помощью Azure Pipelines, затем нажмите Enter.

3. Выберите метод проверки подлинности. Вы можете настроить и использовать личный маркер доступа (PAT) или использовать имя входа устройства.

   Примечание.

   Если вы настроили PAT, обязательно авторизуйте необходимые области. Для этого модуля можно использовать полный доступ, но в реальной ситуации необходимо предоставить только необходимые области.

4. Введите имя вашей организации Azure DevOps, а затем нажмите ВВОД.

5. Если появится запрос, введите Azure DevOps PAT, а затем нажмите клавишу ВВОД.

6. Введите имя проекта, например Space Game - web - Test, а затем нажмите клавишу ВВОД.

7. После создания проекта перейдите в организацию Azure DevOps в браузере (по адресу https://dev.azure.com/<your-organization-name>/) и выберите проект.

Создание вилки репозитория

Если вы еще не сделали этого, создайте форк репозитория mslearn-tailspin-spacegame-web.

1. На сайте GitHub перейдите в репозиторий mslearn-tailspin-spacegame-web .

2. Выберите вилку в правом верхнем углу экрана.

3. Выберите свою учетную запись GitHub в качестве владельца, затем выберите Создать форк.

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

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

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

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

• Использование частных и общедоступных проектов
• Изменение видимости проекта на общедоступную или частную
• Настройка видимости репозитория

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

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

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

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

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

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

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

   

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

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

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

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

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

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

Чтобы клонировать веб-проект Space Game на компьютер, выполните следующие действия.

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

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

   

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. При форке кода из другого репозитория исходный удаленный (тот, из которого вы сделали форк) обычно называют как upstream.

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

   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 из локальной среды разработки.