Create Azure Pipelines

Create your first pipeline

Azure Pipelines is a cloud service that you can use to automatically build and test your code projects. It’s particularly useful for building and deploying applications and can be easily integrated with your development workflow. To create an Azure Pipeline, you’ll need an Azure DevOps organization and a project.

Prerequisites – Azure DevOps

Make sure you have the following items:

• A GitHub account where you can create a repository. Create one for free.
• An Azure DevOps organization. Create one for free. If your team already has one, then make sure you’re an administrator of the Azure DevOps project that you want to use.
• An ability to run pipelines on Microsoft-hosted agents. You can either purchase a parallel job or you can request a free tier.

Create your first pipeline

• Java
• .NET
• Python
• JavaScript
• Azure CLI (Java)

Get the Java sample code

To get started, fork the following repository into your GitHub account.

https://github.com/MicrosoftDocs/pipelines-java

Create your first Java pipeline

1. Sign in to your Azure DevOps organization and go to your project.
2. Go to Pipelines, and then select New pipeline.
3. Do the steps of the wizard by first selecting GitHub as the location of your source code.
4. You might be redirected to GitHub to sign in. If so, enter your GitHub credentials.
5. When you see the list of repositories, select your repository.
6. You might be redirected to GitHub to install the Azure Pipelines app. If so, select Approve & install.
7. Azure Pipelines will analyze your repository and recommend the Maven pipeline template.
8. When your new pipeline appears, take a look at the YAML to see what it does. When you’re ready, select Save and run.
9. You’re prompted to commit a new azure-pipelines.yml file to your repository. After you’re happy with the message, select Save and run again.
10. If you want to watch your pipeline in action, select the build job.
11. You just created and ran a pipeline that we automatically created for you, because your code appeared to be a good match for the Maven template.
12. You now have a working YAML pipeline (azure-pipelines.yml) in your repository that’s ready for you to customize!
13. When you’re ready to make changes to your pipeline, select it in the Pipelines page, and then Edit the azure-pipelines.yml file.

Add a status badge to your repository

Many developers like to show that they’re keeping their code quality high by displaying a status badge in their repo.

To copy the status badge to your clipboard:

1. In Azure Pipelines, go to the Pipelines page to view the list of pipelines. Select the pipeline you created in the previous section.
2. Select, and then select Status badge.
3. Select Status badge.
4. Copy the sample Markdown from the Sample markdown section.

Now with the badge Markdown in your clipboard, take the following steps in GitHub:

1. Go to the list of files and select Readme.md. Select the pencil icon to edit.
2. Paste the status badge Markdown at the beginning of the file.
3. Commit the change to the main branch.
4. Notice that the status badge appears in the description of your repository.

To configure anonymous access to badges for private projects:

1. Navigate to Project Settings
2. Open the Settings tab under Pipelines
3. Toggle the Disable anonymous access to badges slider under General

 Note

Even in a private project, anonymous badge access is enabled by default. With anonymous badge access enabled, users outside your organization might be able to query information such as project names, branch names, and job names, and build status through the badge status API.

Because you just changed the Readme.md file in this repository, Azure Pipelines automatically builds your code, according to the configuration in the azure-pipelines.yml file at the root of your repository. Back in Azure Pipelines, observe that a new run appears. Each time you make an edit, Azure Pipelines starts a new run.

Your Azure Pipeline is now set up and ready to build and test your code. You can monitor the progress of your build and view the build results from the “Builds” page.

Next steps

You’ve just learned how to create your first pipeline in Azure. Learn more about configuring pipelines in the language of your choice:

• .NET Core
• Go
• Java
• Node.js
• Python
• Containers

Or, you can proceed to customize the pipeline you just created.

To run your pipeline in a container, see Container jobs.

For details about building GitHub repositories, see Build GitHub repositories.

To learn how to publish your Pipeline Artifacts, see Publish Pipeline Artifacts.

To find out what else you can do in YAML pipelines, see the YAML schema reference.

Clean up

If you created any test pipelines, they are easy to delete when you are done with them.

• Browser
• Azure DevOps CLI

To delete a pipeline, navigate to the summary page for that pipeline, and choose Delete from the … menu at the top-right of the page. Type the name of the pipeline to confirm, and choose Delete.