devtest-lab-add-artifact-repo.md

title	description	services	documentationcenter	author	manager	editor	ms.assetid	ms.service	ms.workload	ms.tgt_pltfrm	ms.devlang	ms.topic	ms.date	ms.author
Add a Git repository to a lab in Azure DevTest Labs | Microsoft Docs	Learn how to add a GitHub or Visual Studio Team Services Git repository for your custom artifacts source in Azure DevTest Labs.	devtest-lab,virtual-machines,visual-studio-online	na	tomarcher	douge		01b459f7-eaf2-45a8-b4b5-2c0a821b33c8	devtest-lab	na	na	na	article	01/11/2017	tarcher

Add a Git repository to store custom artifacts and Resource Manager templates

You can create custom artifacts for the VMs in your lab, or use Azure Resource Manager templates to create a custom test environment. You must add a private Git repository for the artifacts or Resource Manager templates that your team creates. The repository can be hosted on GitHub or on Visual Studio Team Services.

We offer a GitHub repository of artifacts that you can deploy as-is, or you can customize them for your labs. When you customize or create an artifact, you can't store the artifact in the public repository. You must create your own private repo for custom artifacts and for artifacts that you create.

When you create a VM, you can save the Resource Manager template, customize it if you want, and then use it later to create more VMs. You must create your own private repository to store your custom Resource Manager templates.

• To learn how to create a GitHub repository, see GitHub Bootcamp.
• To learn how to create a Team Services project that has a Git repository, see Connect to Visual Studio Team Services.

The following figure is an example of how a repository that has artifacts might look in GitHub:

Get the repository information and credentials

To add a repository to your lab, first, get key information from your repository. The following sections describe how to get required information for repositories that are hosted on GitHub or Visual Studio Team Services.

Get the GitHub repository clone URL and personal access token

1. Go to the home page of the GitHub repository that contains the artifact or Resource Manager template definitions.
2. Select Clone or download.
3. To copy the URL to the clipboard, select the HTTPS clone url button. Save the URL for later use.
4. In the upper-right corner of GitHub, select the profile image, and then select Settings.
5. In the Personal settings menu on the left, select Personal access tokens.
6. Select Generate new token.
7. On the New personal access token page, under Token description, enter a description. Accept the default items under Select scopes, and then select Generate Token.
8. Save the generated token. You'll use the token later.
9. Close GitHub.
10. Continue to the Connect your lab to the repository section.

Get the Visual Studio Team Services repository clone URL and personal access token

1. Go to the home page of your team collection (for example, https://contoso-web-team.visualstudio.com), and then select your project.
2. On the project home page, select Code.
3. To view the clone URL, on the project Code page, select Clone.
4. Save the URL. You'll use the URL later.
5. To create a personal access token, in the user account drop-down menu, select My profile.
6. On the profile information page, select Security.
7. On the Security tab, select Add.
8. On the Create a personal access token page:
   1. Enter a Description for the token.
   2. In the Expires In list, select 180 days.
   3. In the Accounts list, select All accessible accounts.
   4. Select the All scopes option.
   5. Select Create Token.
9. The new token appears in the Personal Access Tokens list. Select Copy Token, and then save the token value for later use.
10. Continue to the Connect your lab to the repository section.

Connect your lab to the repository

1. Sign in to the Azure portal.

2. Select More Services, and then select DevTest Labs from the list of services.

3. From the list of labs, select your lab.

4. Select Configuration and policies > Repositories > + Add.

   

5. On the second Repositories page, specify the following information:

6. Name. Enter a name for the repository.

7. Git Clone Url. Enter the Git HTTPS clone URL that you copied earlier from either GitHub or Visual Studio Team Services.

8. Branch. To get your definitions, enter the branch.

9. Personal Access Token. Enter the personal access token that you got earlier from either GitHub or Visual Studio Team Services.

10. Folder Paths. Enter at least one folder path relative to the clone URL that contains your artifact or Resource Manager template definitions. When you specify a subdirectory, make sure you include the forward slash in the folder path.

    

11. Select Save.

Related blog posts

• Troubleshoot failing artifacts in DevTest Labs
• Join a VM to an existing Active Directory domain by using a Resource Manager template in DevTest Labs

[!INCLUDE devtest-lab-try-it-out]

Next steps

After you have created your private Git repository, you can do one or both of the following, depending on your needs:

• Store your custom artifacts. You can use them later to create new VMs.
• Create multi-VM environments and PaaS resources by using Resource Manager templates. Then, you can store the templates in your private repo.

When you create a VM, you can verify that the artifacts or templates are added to your Git repository. They are immediately available in the list of artifacts or templates. The name of your private repo is shown in the column that specifies the source.