You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: learn-pr/azure-devops/host-build-agent/includes/3-set-up-environment.md
+21-13Lines changed: 21 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,26 +14,34 @@ The modules in this learning path form a progression, where you follow the Tails
14
14
15
15
### Run the template
16
16
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.
18
18
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.
21
20
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**.
23
22
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.
27
24
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.
30
27
31
-
1.Select **Create Project**.
28
+
1.Enter your Azure DevOps organization name, then press **Enter**.
32
29
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**.
34
31
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**.
37
45
38
46
> [!IMPORTANT]
39
47
> 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