Skip to content

Commit f7b51e5

Browse files
authored
pull base content,head:MicrosoftDocs:main,into:wwlpublishsync
2 parents bc24b3f + 8308d6a commit f7b51e5

File tree

1 file changed

+21
-13
lines changed

1 file changed

+21
-13
lines changed

learn-pr/azure-devops/host-build-agent/includes/3-set-up-environment.md

Lines changed: 21 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -14,26 +14,34 @@ The modules in this learning path form a progression, where you follow the Tails
1414

1515
### Run the template
1616

17-
Run a template that sets up everything for you in your Azure DevOps organization.
17+
Run a template that sets up your Azure DevOps organization.
1818

19-
> [!div class="nextstepaction"]
20-
> [Run the template](https://azuredevopsdemogenerator.azurewebsites.net/?x-ms-routing-name=self&name=host-build-agent&azure-portal=true)
19+
1. [Get and run the ADOGenerator project](https://github.com/microsoft/AzDevOpsDemoGenerator/blob/main/docs/RunApplication.md) in Visual Studio or the IDE of your choice.
2120

22-
To run the template, do the following on the Azure DevOps Demo Generator site:
21+
1. When prompted to **Enter the template number from the list of templates**, enter **28** for **Host your own build agent in Azure Pipelines**, then press **Enter**.
2322

24-
1. Select **Sign In** and accept the usage terms.
25-
1. On the **Create New Project** page, select your Azure DevOps organization, then enter a project name such as *Space Game - web - Agent*.
26-
1. Select **Fork repository on GitHub**, and then select **Authorize**. If a window appears, authorize access to your GitHub account.
23+
1. Choose your authentication method. You can [set up and use a Personal Access Token (PAT)](/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate#create-a-pat) or use device login.
2724

28-
> [!IMPORTANT]
29-
> You need to select this option for the template to connect to your GitHub repository. Select it even if you've already forked the _Space Game_ website project. The template uses your existing fork.
25+
> [!NOTE]
26+
> If you set up a PAT, If you set up a PAT, make sure to authorize the necessary [scopes](/azure/devops/integrate/get-started/authentication/oauth#scopes). For this module, you can use **Full access**, but in a real-world situation, you should ensure you grant only the necessary scopes.
3027
31-
1. Select **Create Project**.
28+
1. Enter your Azure DevOps organization name, then press **Enter**.
3229

33-
:::image type="content" source="../media/3-create-new-project.png" alt-text="A screenshot of the Azure DevOps Demo Generator Create New Project screen with the Create Project button highlighted.":::
30+
1. If prompted, enter your Azure DevOps PAT, then press **Enter**.
3431

35-
It takes a few moments for the template to run.
36-
1. Select **Navigate to project** to go to your project in Azure DevOps.
32+
1. Enter a project name such as *Space Game - web - Agent*, then press **Enter**.
33+
34+
1. Once your project is created, go to your Azure DevOps organization in your browser (at `https://dev.azure.com/<your-organization-name>/`) and select the project.
35+
36+
### Fork the repository
37+
38+
If you haven't already, create a fork of the **mslearn-tailspin-spacegame-web** repository.
39+
40+
1. On GitHub, go to the [mslearn-tailspin-spacegame-web](https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web) repository.
41+
42+
1. Select **Fork** at the top-right of the screen.
43+
44+
1. Choose your GitHub account as the **Owner**, then select **Create fork**.
3745

3846
> [!IMPORTANT]
3947
> The [Clean up your Azure DevOps environment](/training/modules/host-build-agent/6-clean-up-environment?azure-portal=true) page in this module contains important cleanup steps. Cleaning up helps ensure that you don't run out of free build minutes. Be sure to perform the cleanup steps even if you don't complete this module.

0 commit comments

Comments
 (0)