Skip to content

Commit a9be7c2

Browse files
authored
Merge pull request MicrosoftDocs#57671 from itechedit/azure-devops-project-go
edit pass: azure-devops-project-go
2 parents d600179 + 191ee81 commit a9be7c2

File tree

1 file changed

+72
-45
lines changed

1 file changed

+72
-45
lines changed
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Create a CI/CD pipeline for Go lang with the Azure DevOps Project | Quickstart
3-
description: The DevOps Project makes it easy to get started on Azure. It helps you launch a Go lang web app on an Azure service in a few quick steps.
2+
title: 'Quickstart: Create a CI/CD pipeline for the Go programming language by using Azure DevOps Projects'
3+
description: DevOps Projects makes it easy to get started on Azure. It helps you launch a Go programming language web app on an Azure service in a few quick steps.
44
ms.prod: devops
55
ms.technology: devops-cicd
66
services: vsts
@@ -20,101 +20,128 @@ monikerRange: 'vsts'
2020
---
2121

2222

23-
# Create a CI/CD pipeline for Go with the Azure DevOps Project
23+
# Create a CI/CD pipeline for Go by using Azure DevOps Projects
2424

25-
Configure continuous integration (CI) and continuous delivery (CD) for your **Go** application with The **Azure DevOps Project**. The Azure DevOps Project simplifies the initial configuration of an Azure DevOps Services build and release pipeline.
25+
Configure continuous integration (CI) and continuous delivery (CD) for your Go app by using Azure DevOps Projects. DevOps Projects simplifies the initial configuration of an Azure DevOps build and release pipeline.
2626

2727
If you don't have an Azure subscription, you can get one free through [Visual Studio Dev Essentials](https://visualstudio.microsoft.com/dev-essentials/).
2828

2929
## Sign in to the Azure portal
3030

31-
The Azure DevOps Project creates a CI/CD pipeline in Azure. You can create a **new Azure DevOps Services** organization or use an **existing organization**. The Azure DevOps Project also creates **Azure resources** in the **Azure subscription** of your choice.
31+
DevOps Projects creates a CI/CD pipeline in Azure Pipelines. You can create a new Azure DevOps organization or use an existing organization. DevOps Projects also creates Azure resources in the Azure subscription of your choice.
3232

33-
1. Sign into the [Microsoft Azure portal](https://portal.azure.com).
33+
1. Sign in to the [Azure portal](https://portal.azure.com).
3434

35-
1. Choose the **+ Create a resource** icon in the left navigation bar, then search for **DevOps Project**. Choose **Create**.
35+
1. In the left pane, select **Create a resource**.
3636

37-
![Starting Continuous Delivery](_img/azure-devops-project-go/fullbrowser.png)
37+
1. In the search box, type **DevOps Project**, and then select **Create**.
3838

39-
## Select a sample application and Azure service
39+
![The DevOps Projects dashboard](_img/azure-devops-project-github/fullbrowser.png)
4040

41-
1. Select the **Go** sample application, and then select **Next**.
41+
## Select a sample app and Azure service
4242

43-
1. **Simple Go app** is the default framework. Choose **Next**.
43+
1. Select the **Go** sample app, and then select **Next**.
44+
45+
1. **Simple Go app** is the default framework. Select **Next**.
46+
The app framework, which you chose previously, dictates the type of Azure service deployment targets that are available for deployment.
47+
48+
1. Leave the default Azure service and select **Next**.
4449

45-
1. The application framework, which you chose on the previous steps, dictates the type of Azure service deployment targets available for deployment. Leave the default Azure service and Choose **Next**.
50+
## Configure Azure DevOps and an Azure subscription
4651

47-
## Configure Azure DevOps Services and an Azure subscription
52+
1. Create a new free Azure DevOps organization or choose an existing organization.
4853

49-
1. Create a **new** free Azure DevOps Services organization or choose an **existing** organization. Choose a **name** for your Azure DevOps project. Select your **Azure subscription**, **location**, and choose a **name** for your application. When you're done, choose **Done**.
54+
1. Enter a name for your Azure DevOps project.
5055

51-
1. In a few minutes, the **DevOps Project dashboard** loads in the Azure portal. A sample application is set up in a repository in your Azure DevOps Services organization, a build executes, and your application deploys to Azure. This dashboard provides visibility into your **code repository**, **Azure CI/CD pipeline**, and your **application in Azure**. On the right side of the dashboard, select **Browse** to view your running application.
56+
1. Select your Azure subscription and location, enter a name for your app, and then select **Done**.
57+
After a few minutes, the DevOps Projects dashboard is displayed in the Azure portal. A sample app is set up in a repo in your Azure DevOps organization, a build is executed, and your app is deployed to Azure.
58+
59+
The dashboard provides visibility into your code repo, your CI/CD pipeline, and your app in Azure. At the right, select **Browse** to view your running app.
5260

5361
![Dashboard view](_img/azure-devops-project-go/dashboardnopreview.png)
5462

55-
## Commit code changes and execute CI/CD
63+
## Commit your code changes and execute the CI/CD
5664

57-
The Azure DevOps Project created a Git repository in your Azure DevOps Services organization or GitHub account. Follow the steps below to view the repository and make code changes to your application.
65+
DevOps Projects creates a Git repo in Azure Repos or GitHub. To view the repo and make code changes to your app, do the following:
5866

59-
1. On the left-hand side of the DevOps Project dashboard, select the link for your **master** branch. This link opens a view to the newly created Git repository.
67+
1. On the DevOps Projects, at the left, select the link for your master branch.
68+
The link opens a view to the newly created Git repo.
6069

61-
1. To view the repository clone URL, select **Clone** from the top right of the browser. You can clone your Git repository in your favorite IDE. In the next few steps, you can use the web browser to make and commit code changes directly to the master branch.
70+
1. To view the repo clone URL, select **Clone** at the top right.
71+
You can clone your Git repo in your favorite IDE. In the next few steps, you can use the web browser to make and commit code changes directly to the master branch.
6272

63-
1. On the left-hand side of the browser, navigate to the **views/index.html** file.
73+
1. At the left, go to the *views/index.html* file, and then select **Edit**.
6474

65-
1. Select **Edit**, and make a change to some text. For example, modify text inside one of the div tags.
75+
1. Make a change to the file. For example, modify some text within one of the div tags.
6676

67-
1. Choose **Commit**, then save your changes.
77+
1. Select **Commit**, and then save your changes.
6878

69-
1. In your browser, navigate to the **Azure DevOps Project dashboard**. You should now see a build is in progress. The changes you made are automatically built and deployed via an Azure CI/CD pipeline.
79+
1. In your browser, go to the DevOps Projects dashboard.
80+
A build should be in progress. The changes you made are automatically built and deployed via a CI/CD pipeline.
7081

71-
## Examine the Azure CI/CD pipeline
82+
## Examine the CI/CD pipeline
7283

73-
The Azure DevOps Project automatically configured a full Azure CI/CD pipeline in your Azure DevOps Services organization. Explore and customize the pipeline as needed. Follow the steps below to familiarize yourself with the Azure DevOps Services build and release pipelines.
84+
DevOps Projects automatically configures a full CI/CD pipeline in Azure Repos. Explore and customize the pipeline as needed. To familiarize yourself with the Azure DevOps build and release pipelines, do the following:
7485

75-
1. Select **Build Pipelines** from the **top** of the Azure DevOps Project dashboard. This link opens a browser tab and opens the Azure DevOps Services build pipeline for your new project.
86+
1. Go to the DevOps Projects dashboard.
7687

77-
1. Select the **ellipsis**. This action opens a menu where you can start several activities such as queue a new build, pause a build, and edit the build pipeline.
88+
1. At the top, select **Build pipelines**.
89+
A browser tab displays the build pipeline for your new project.
90+
91+
1. Point to the **Status** field, and then select the ellipsis (...).
92+
A menu displays several options, such as queueing a new build, pausing a build, and editing the build pipeline.
7893

7994
1. Select **Edit**.
8095

81-
1. From this view, **examine the various tasks** for your build pipeline. The build executes various tasks such as fetching sources from the Git repository, restoring dependencies, and publishing outputs used for deployments.
96+
1. In this pane, you can examine the various tasks for your build pipeline.
97+
The build performs various tasks, such as fetching sources from the Git repo, restoring dependencies, and publishing outputs used for deployments.
8298

83-
1. At the top of the build pipeline, select the **build pipeline name**.
99+
1. At the top of the build pipeline, select the build pipeline name.
84100

85-
1. Change the **name** of your build pipeline to something more descriptive. Select **Save & queue**, then select **Save**.
101+
1. Change the name of your build pipeline to something more descriptive, select **Save & queue**, and then select **Save**.
86102

87-
1. Under your build pipeline name, select **History**. You see an audit trail of your recent changes for the build. Azure DevOps Services keeps track of any changes made to the build pipeline, and allows you to compare versions.
103+
1. Under your build pipeline name, select **History**.
104+
This pane displays an audit trail of your recent changes for the build. Azure DevOps keeps track of any changes made to the build pipeline, and it allows you to compare versions.
88105

89-
1. Select **Triggers**. The Azure DevOps Project automatically created a CI trigger, and every commit to the repository starts a new build. You can optionally choose to include or exclude branches from the CI process.
106+
1. Select **Triggers**.
107+
DevOps Projects automatically creates a CI trigger, and every commit to the repo starts a new build. Optionally, you can choose to include or exclude branches from the CI process.
90108

91-
1. Select **Retention**. Based on your scenario, you can specify policies to keep or remove a certain number of builds.
109+
1. Select **Retention**.
110+
Depending on your scenario, you can specify policies to keep or remove a certain number of builds.
92111

93-
1. Select **Build and Release**, then choose **Releases**. The Azure DevOps Project created an Azure DevOps Services release pipeline to manage deployments to Azure.
112+
1. Select **Build and Release**, and then select **Releases**.
113+
DevOps Projects creates a release pipeline to manage deployments to Azure.
94114

95-
1. On the left-hand side of the browser, select the **ellipsis** next to your release pipeline, then choose **Edit**.
115+
1. Select the ellipsis (...) next to your release pipeline, and then select **Edit**.
116+
The release pipeline contains a *pipeline*, which defines the release process.
96117

97-
1. The release pipeline contains a **pipeline**, which defines the release process. Under **Artifacts**, select **Drop**. The build pipeline you examined in the previous steps produces the output used for the artifact.
118+
1. Under **Artifacts**, select **Drop**.
119+
The build pipeline you examined previously produces the output that's used for the artifact.
98120

99-
1. To the right-hand side of the **Drop** icon, select the **Continuous deployment trigger**. This release pipeline has an enabled CD trigger, which executes a deployment every time there is a new build artifact available. Optionally, you can disable the trigger, so your deployments require manual execution.
121+
1. At the right of the **Drop** icon, select **Continuous deployment trigger**.
122+
This release pipeline has an enabled CD trigger, which executes a deployment every time a new build artifact is available. Optionally, you can disable the trigger so that your deployments require manual execution.
100123

101-
1. On the left-hand side of the browser, select **Tasks**. The tasks are the activities your deployment process performs. In this example, a task was created to deploy to **Azure App service**.
124+
1. At the left, select **Tasks**.
125+
Tasks are the activities your deployment process performs. In this example, a task was created to deploy to Azure App Service.
102126

103-
1. On the right-hand side of the browser, select **View releases**. This view shows a history of releases.
127+
1. At the right, select **View releases** to display a history of releases.
104128

105-
1. Select the **ellipsis** next to one of your releases, and choose **Open**. There are several menus to explore from this view such as a release summary, associated work items, and tests.
129+
1. Select the ellipsis (...) next to a release, and then select **Open**.
130+
You can explore several menus, such as a release summary, associated work items, and tests.
106131

107-
1. Select **Commits**. This view shows code commits associated with the specific deployment.
132+
1. Select **Commits**.
133+
This view shows code commits that are associated with this deployment.
108134

109-
1. Select **Logs**. The logs contain useful information about the deployment process. They can be viewed both during and after deployments.
135+
1. Select **Logs**.
136+
The logs contain useful information about the deployment process. You can view them both during and after deployments.
110137

111138
## Clean up resources
112139

113-
When no longer needed, you can delete the Azure App service and related resources created in this quickstart by using the **Delete** function from the Azure DevOps Project dashboard.
140+
When they are no longer needed, you can delete the Azure App Service instance and related resources that you created in this quickstart. To do so, use the **Delete** functionality on the DevOps Projects dashboard.
114141

115142
## Next steps
116143

117-
To learn more about modifying the build and release pipelines to meet the needs of your team, see this tutorial:
144+
To learn more about modifying the build and release pipelines to meet the needs of your team, see:
118145

119146
> [!div class="nextstepaction"]
120-
> [Customize CD process](https://docs.microsoft.com/azure/devops/pipelines/release/define-multistage-release-process?view=vsts)
147+
> [Define your multi-stage continuous deployment (CD) pipeline](https://docs.microsoft.com/azure/devops/pipelines/release/define-multistage-release-process?view=vsts)

0 commit comments

Comments
 (0)