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: articles/devops-project/azure-devops-project-aks.md
+44-63Lines changed: 44 additions & 63 deletions
Original file line number
Diff line number
Diff line change
@@ -1,22 +1,23 @@
1
1
---
2
-
title: 'Tutorial: Deploy ASP.NET Core apps to Azure Kubernetes Service with Azure DevOps Projects'
3
-
description: Azure DevOps Projects makes it easy to get started on Azure. With DevOps Projects, you can deploy your ASP.NET Core app with the Azure Kubernetes Service (AKS) in a few quick steps.
2
+
title: 'Deploy ASP.NET Core apps to Azure Kubernetes Service with Azure DevOps Starter'
3
+
description: Azure DevOps Starter makes it easy to get started on Azure. With DevOps Starter, you can deploy your ASP.NET Core app with the Azure Kubernetes Service (AKS) in a few quick steps.
4
4
ms.author: mlearned
5
5
ms.manager: gwallace
6
6
ms.prod: devops
7
7
ms.technology: devops-cicd
8
8
ms.topic: tutorial
9
-
ms.date: 07/09/2018
9
+
ms.date: 03/24/2020
10
10
author: mlearned
11
11
monikerRange: 'vsts'
12
12
---
13
13
14
14
15
-
# Tutorial: Deploy ASP.NET Core apps to Azure Kubernetes Service with Azure DevOps Projects
15
+
# Deploy ASP.NET Core apps to Azure Kubernetes Service with Azure DevOps Starter
16
16
17
-
Azure DevOps Projects presents a simplified experience where you can bring your existing code and Git repo or choose a sample application to create a continuous integration (CI) and continuous delivery (CD) pipeline to Azure.
17
+
Azure DevOps Starter presents a simplified experience where you can bring your existing code and Git repo or choose a sample application to create a continuous integration (CI) and continuous delivery (CD) pipeline to Azure.
18
+
19
+
DevOps Starter also:
18
20
19
-
DevOps Projects also:
20
21
* Automatically creates Azure resources, such as Azure Kubernetes Service (AKS).
21
22
* Creates and configures a release pipeline in Azure DevOps that sets up a build and release pipeline for CI/CD.
22
23
* Creates an Azure Application Insights resource for monitoring.
@@ -25,7 +26,7 @@ DevOps Projects also:
25
26
In this tutorial, you will:
26
27
27
28
> [!div class="checklist"]
28
-
> * Use DevOps Projects to deploy an ASP.NET Core app to AKS
29
+
> * Use DevOps Starter to deploy an ASP.NET Core app to AKS
29
30
> * Configure Azure DevOps and an Azure subscription
30
31
> * Examine the AKS cluster
31
32
> * Examine the CI pipeline
@@ -37,21 +38,19 @@ In this tutorial, you will:
37
38
38
39
* An Azure subscription. You can get one free through [Visual Studio Dev Essentials](https://visualstudio.microsoft.com/dev-essentials/).
39
40
40
-
## Use DevOps Projects to deploy an ASP.NET Core app to AKS
41
+
## Use DevOps Starter to deploy an ASP.NET Core app to AKS
41
42
42
-
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, such as an AKS cluster, in the Azure subscription of your choice.
43
+
DevOps Starter creates a CI/CD pipeline in Azure Pipelines. You can create a new Azure DevOps organization or use an existing organization. DevOps Starter also creates Azure resources, such as an AKS cluster, in the Azure subscription of your choice.
43
44
44
45
1. Sign in to the [Azure portal](https://portal.azure.com).
45
46
46
-
1. In the left pane, select **Create a resource**.
47
-
48
-
1. In the search box, type **DevOps Projects**, and then select **Create**.
47
+
1. In the search box, type **DevOps Starter**, and then select. Click on **Add** to cerate a new one.
1. Under **Choose an application framework**, select **ASP.NET Core**.
53
+
1. Under **Choose an application framework**, select **ASP.NET Core** and then select **Next**.
55
54
56
55
1. Select **Kubernetes Service**, and then select **Next**.
57
56
@@ -63,84 +62,67 @@ DevOps Projects creates a CI/CD pipeline in Azure Pipelines. You can create a ne
63
62
64
63
1. Select your Azure subscription.
65
64
66
-
1. To view additional Azure configuration settings and to identify the number of nodes for the AKS cluster, select **Change**.
67
-
This pane displays various options for configuring the type and location of Azure services.
65
+
1. To view additional Azure configuration settings and to identify the number of nodes for the AKS cluster, select **Change**. This pane displays various options for configuring the type and location of Azure services.
68
66
69
-
1. Exit the Azure configuration area, and then select **Done**.
70
-
After a few minutes, the process is completed. A sample ASP.NET Core app is set up in a Git repo in your Azure DevOps organization, an AKS cluster is created, a CI/CD pipeline is executed, and your app is deployed to Azure.
67
+
1. Exit the Azure configuration area, and then select **Done**. After a few minutes, the process is completed. A sample ASP.NET Core app is set up in a Git repo in your Azure DevOps organization, an AKS cluster is created, a CI/CD pipeline is executed, and your app is deployed to Azure.
71
68
72
-
After all this is completed, the Azure DevOps Project dashboard is displayed in the Azure portal. You can also go to the DevOps Projects dashboard directly from **All resources** in the Azure portal.
69
+
After all this is completed, the Azure DevOps Starter dashboard is displayed in the Azure portal. You can also go to the DevOps Starter dashboard directly from **All resources** in the Azure portal.
73
70
74
-
This dashboard provides visibility into your Azure DevOps code repository, your CI/CD pipeline, and your AKS cluster. You can configure additional CI/CD options in your Azure DevOps pipeline. At the right, select **Browse** to view your running app.
71
+
This dashboard provides visibility into your Azure DevOps code repository, your CI/CD pipeline, and your AKS cluster. You can configure additional CI/CD options in your Azure DevOps pipeline. At the right, select **Browse** to view your running app.
75
72
76
73
## Examine the AKS cluster
77
74
78
-
DevOps Projects automatically configures an AKS cluster, which you can explore and customize. To familiarize yourself with the AKS cluster, do the following:
75
+
DevOps Starter automatically configures an AKS cluster, which you can explore and customize. To familiarize yourself with the AKS cluster, do the following:
79
76
80
-
1. Go to the DevOps Projects dashboard.
77
+
1. Go to the DevOps Starter dashboard.
81
78
82
-
1. At the right, select the AKS service.
83
-
A pane opens for the AKS cluster. From this view you can perform various actions, such as monitoring container health, searching logs, and opening the Kubernetes dashboard.
79
+
1. At the right, select the AKS service. A pane opens for the AKS cluster. From this view you can perform various actions, such as monitoring container health, searching logs, and opening the Kubernetes dashboard.
84
80
85
-
1. At the right, select **View Kubernetes dashboard**.
86
-
Optionally, follow the steps to open the Kubernetes dashboard.
81
+
1. At the right, select **View Kubernetes dashboard**. Optionally, follow the steps to open the Kubernetes dashboard.
87
82
88
83
## Examine the CI pipeline
89
84
90
-
DevOps Projects automatically configures a CI/CD pipeline in your Azure DevOps organization. You can explore and customize the pipeline. To familiarize yourself with it, do the following:
85
+
DevOps Starter automatically configures a CI/CD pipeline in your Azure DevOps organization. You can explore and customize the pipeline. To familiarize yourself with it, do the following:
91
86
92
-
1. Go to the DevOps Projects dashboard.
87
+
1. Go to the DevOps Starter dashboard.
93
88
94
-
1. At the top of the DevOps Projects dashboard, select **Build Pipelines**.
95
-
A browser tab displays the build pipeline for your new project.
89
+
1. At the top of the DevOps Starter dashboard, select **Build Pipelines**. A browser tab displays the build pipeline for your new project.
96
90
97
-
1. Point to the **Status** field, and then select the ellipsis (...).
98
-
A menu displays several options, such as queueing a new build, pausing a build, and editing the build pipeline.
91
+
1. Point to the **Status** field, and then select the ellipsis (...). A menu displays several options, such as queueing a new build, pausing a build, and editing the build pipeline.
99
92
100
93
1. Select **Edit**.
101
94
102
-
1. In this pane, you can examine the various tasks for your build pipeline.
103
-
The build performs various tasks, such as fetching sources from the Git repo, restoring dependencies, and publishing outputs used for deployments.
95
+
1. In this pane, you can examine the various tasks for your build pipeline. The build performs various tasks, such as fetching sources from the Git repo, restoring dependencies, and publishing outputs used for deployments.
104
96
105
97
1. At the top of the build pipeline, select the build pipeline name.
106
98
107
99
1. Change the name of your build pipeline to something more descriptive, select **Save & queue**, and then select **Save**.
108
100
109
-
1. Under your build pipeline name, select **History**.
110
-
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.
101
+
1. Under your build pipeline name, select **History**. 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.
111
102
112
-
1. Select **Triggers**.
113
-
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.
103
+
1. Select **Triggers**. DevOps Starter 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.
114
104
115
-
1. Select **Retention**.
116
-
Depending on your scenario, you can specify policies to keep or remove a certain number of builds.
105
+
1. Select **Retention**. Depending on your scenario, you can specify policies to keep or remove a certain number of builds.
117
106
118
107
## Examine the CD release pipeline
119
108
120
-
DevOps Projects automatically creates and configures the necessary steps to deploy from your Azure DevOps organization to your Azure subscription. These steps include configuring an Azure service connection to authenticate Azure DevOps to your Azure subscription. The automation also creates a release pipeline, which provides the CD to Azure. To learn more about the release pipeline, do the following:
109
+
DevOps Starter automatically creates and configures the necessary steps to deploy from your Azure DevOps organization to your Azure subscription. These steps include configuring an Azure service connection to authenticate Azure DevOps to your Azure subscription. The automation also creates a release pipeline, which provides the CD to Azure. To learn more about the release pipeline, do the following:
121
110
122
-
1. Select **Build and Release**, and then select **Releases**.
123
-
DevOps Projects creates a release pipeline to manage deployments to Azure.
111
+
1. Select **Build and Release**, and then select **Releases**. DevOps Starter creates a release pipeline to manage deployments to Azure.
124
112
125
-
1. Select the ellipsis (...) next to your release pipeline, and then select **Edit**.
126
-
The release pipeline contains a *pipeline*, which defines the release process.
113
+
1. Select the ellipsis (...) next to your release pipeline, and then select **Edit**. The release pipeline contains a *pipeline*, which defines the release process.
127
114
128
-
1. Under **Artifacts**, select **Drop**.
129
-
The build pipeline you examined in the previous steps produces the output that's used for the artifact.
115
+
1. Under **Artifacts**, select **Drop**. The build pipeline you examined in the previous steps produces the output that's used for the artifact.
130
116
131
-
1. At the right of the **Drop** icon, select **Continuous deployment trigger**.
132
-
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.
117
+
1. At the right of the **Drop** icon, select **Continuous deployment trigger**. 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.
133
118
134
119
1. At the right, select **View releases** to display a history of releases.
135
120
136
-
1. Select the ellipsis (...) next to a release, and then select **Open**.
137
-
You can explore several menus, such as a release summary, associated work items, and tests.
121
+
1. Select the ellipsis (...) next to a release, and then select **Open**. You can explore several menus, such as a release summary, associated work items, and tests.
138
122
139
-
1. Select **Commits**.
140
-
This view shows code commits that are associated with this deployment. Compare releases to view the commit differences between deployments.
123
+
1. Select **Commits**. This view shows code commits that are associated with this deployment. Compare releases to view the commit differences between deployments.
141
124
142
-
1. Select **Logs**.
143
-
The logs contain useful information about the deployment process. You can view them both during and after deployments.
125
+
1. Select **Logs**. The logs contain useful information about the deployment process. You can view them both during and after deployments.
144
126
145
127
## Commit changes to Azure Repos and automatically deploy them to Azure
146
128
@@ -155,28 +137,27 @@ You're now ready to collaborate with a team on your app by using a CI/CD process
155
137
156
138
1. Make a change to the file, such as adding some text within one of the div tags.
157
139
158
-
1. At the top right, select **Commit**, and then select **Commit** again to push your change.
159
-
After a few moments, a build starts in Azure DevOps and a release executes to deploy the changes. Monitor the build status on the DevOps Projects dashboard or in the browser with your Azure DevOps organization.
140
+
1. At the top right, select **Commit**, and then select **Commit** again to push your change. After a few moments, a build starts in Azure DevOps and a release executes to deploy the changes. Monitor the build status on the DevOps Starter dashboard or in the browser with your Azure DevOps organization.
160
141
161
142
1. After the release is completed, refresh your app to verify your changes.
162
143
163
144
## Clean up resources
164
145
165
-
If you are testing, you can avoid accruing billing charges by cleaning up your resources. When they are no longer needed, you can delete the AKS cluster and related resources that you created in this tutorial. To do so, use the **Delete** functionality on the DevOps Projects dashboard.
146
+
If you are testing, you can avoid accruing billing charges by cleaning up your resources. When they are no longer needed, you can delete the AKS cluster and related resources that you created in this tutorial. To do so, use the **Delete** functionality on the DevOps Starter dashboard.
166
147
167
148
> [!IMPORTANT]
168
-
> The following procedure permanently deletes resources. The *Delete* functionality destroys the data that's created by the project in DevOps Projects in both Azure and Azure DevOps, and you will be unable to retrieve it. Use this procedure only after you've carefully read the prompts.
149
+
> The following procedure permanently deletes resources. The *Delete* functionality destroys the data that's created by the project in DevOps Starter in both Azure and Azure DevOps, and you will be unable to retrieve it. Use this procedure only after you've carefully read the prompts.
169
150
170
-
1. In the Azure portal, go to the DevOps Projects dashboard.
171
-
2. At the top right, select **Delete**.
172
-
3. At the prompt, select **Yes** to *permanently delete* the resources.
151
+
1. In the Azure portal, go to the DevOps Starter dashboard.
152
+
1. At the top right, select **Delete**.
153
+
1. At the prompt, select **Yes** to *permanently delete* the resources.
173
154
174
155
## Next steps
175
156
176
157
You can optionally modify these build and release pipelines to meet the needs of your team. You can also use this CI/CD pattern as a template for your other pipelines. In this tutorial, you learned how to:
177
158
178
159
> [!div class="checklist"]
179
-
> * Use DevOps Projects to deploy an ASP.NET Core app to AKS
160
+
> * Use DevOps Starter to deploy an ASP.NET Core app to AKS
180
161
> * Configure Azure DevOps and an Azure subscription
0 commit comments