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/migrate/tutorial-app-containerization-aspnet-kubernetes.md
+26-26Lines changed: 26 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,20 +6,20 @@ ms.author: vijain
6
6
ms.manager: kmadnani
7
7
ms.custom: subject-rbac-steps
8
8
ms.topic: tutorial
9
-
ms.date: 12/01/2022
9
+
ms.date: 04/24/2023
10
10
---
11
11
# ASP.NET app containerization and migration to Azure Kubernetes Service
12
12
13
13
In this article, you'll learn how to containerize ASP.NET applications and migrate them to [Azure Kubernetes Service (AKS)](https://azure.microsoft.com/services/kubernetes-service/) using the Azure Migrate: App Containerization tool. The containerization process doesn’t require access to your codebase and provides an easy way to containerize existing applications. The tool works by using the running state of the applications on a server to determine the application components and helps you package them in a container image. The containerized application can then be deployed on Azure Kubernetes Service (AKS).
14
14
15
-
The Azure Migrate: App Containerization tool currently supports -
15
+
The Azure Migrate: App Containerization tool currently supports:
16
16
17
17
- Containerizing ASP.NET apps and deploying them on Windows containers on Azure Kubernetes Service.
18
-
- Containerizing ASP.NET apps and deploying them on Windows containers on Azure App Service. [Learn more](./tutorial-app-containerization-aspnet-app-service.md)
19
-
- Containerizing Java Web Apps on Apache Tomcat (on Linux servers) and deploying them on Linux containers on AKS. [Learn more](./tutorial-app-containerization-java-kubernetes.md)
20
-
- Containerizing Java Web Apps on Apache Tomcat (on Linux servers) and deploying them on Linux containers on App Service. [Learn more](./tutorial-app-containerization-java-app-service.md)
18
+
- Containerizing ASP.NET apps and deploying them on Windows containers on Azure App Service. [Learn more](./tutorial-app-containerization-aspnet-app-service.md).
19
+
- Containerizing Java Web apps on Apache Tomcat (on Linux servers) and deploying them on Linux containers on AKS. [Learn more](./tutorial-app-containerization-java-kubernetes.md).
20
+
- Containerizing Java Web apps on Apache Tomcat (on Linux servers) and deploying them on Linux containers on App Service. [Learn more](./tutorial-app-containerization-java-app-service.md).
21
21
22
-
The Azure Migrate: App Containerization tool helps you to -
22
+
The Azure Migrate: App Containerization tool helps you to:
23
23
24
24
-**Discover your application**: The tool remotely connects to the application servers running your ASP.NET application and discovers the application components. The tool creates a Dockerfile that can be used to create a container image for the application.
25
25
-**Build the container image**: You can inspect and further customize the Dockerfile as per your application requirements and use that to build your application container image. The application container image is pushed to an Azure Container Registry you specify.
@@ -30,10 +30,10 @@ The Azure Migrate: App Containerization tool helps you to -
30
30
31
31
While all applications won't benefit from a straight shift to containers without significant rearchitecting, some of the benefits of moving existing apps to containers without rewriting include:
32
32
33
-
-**Improved infrastructure utilization:** With containers, multiple applications can share resources and be hosted on the same infrastructure. This can help you consolidate infrastructure and improve utilization.
34
-
-**Simplified management:** By hosting your applications on a modern managed platform like AKS and App Service, you can simplify your management practices. You can achieve this by retiring or reducing the infrastructure maintenance and management processes that you'd traditionally perform with owned infrastructure.
35
-
-**Application portability:** With increased adoption and standardization of container specification formats and platforms, application portability is no longer a concern.
36
-
-**Adopt modern management with DevOps:** Helps you adopt and standardize on modern practices for management and security and transition to DevOps.
33
+
-**Improved infrastructure utilization** - With containers, multiple applications can share resources and be hosted on the same infrastructure. This can help you consolidate infrastructure and improve utilization.
34
+
-**Simplified management** - By hosting your applications on a modern managed platform like AKS and App Service, you can simplify your management practices. You can achieve this by retiring or reducing the infrastructure maintenance and management processes that you'd traditionally perform with owned infrastructure.
35
+
-**Application portability** - With increased adoption and standardization of container specification formats and platforms, application portability is no longer a concern.
36
+
-**Adopt modern management with DevOps** - Helps you adopt and standardize on modern practices for management and security and transition to DevOps.
37
37
38
38
39
39
In this tutorial, you'll learn how to:
@@ -54,48 +54,48 @@ Before you begin this tutorial, you should:
54
54
55
55
**Requirement** | **Details**
56
56
--- | ---
57
-
**Identify a machine to install the tool** | A Windows machine to install and run the Azure Migrate: App Containerization tool. The Windows machine could be a server (Windows Server 2016 or later) or client (Windows 10) operating system, meaning that the tool can run on your desktop as well. <br/><br/> The Windows machine running the tool should have network connectivity to the servers/virtual machines hosting the ASP.NET applications to be containerized.<br/><br/> Ensure that 6-GB space is available on the Windows machine running the Azure Migrate: App Containerization tool for storing application artifacts. <br/><br/> The Windows machine should have internet access, directly or via a proxy. <br/> <br/>Install the Microsoft Web Deploy tool on the machine running the App Containerization helper tool and application server if not already installed. You can download the tool from [here](https://aka.ms/webdeploy3.6)
58
-
**Application servers** | Enable PowerShell remoting on the application servers: Sign in to the application server and Follow[these](/powershell/module/microsoft.powershell.core/enable-psremoting) instructions to turn on PowerShell remoting. <br/><br/> If the application server is running Window Server 2008 R2, ensure that PowerShell 5.1 is installed on the application server. Follow the instruction [here](/powershell/scripting/windows-powershell/wmf/setup/install-configure) to download and install PowerShell 5.1 on the application server. <br/><br/> Install the Microsoft Web Deploy tool on the machine running the App Containerization helper tool and application server if not already installed. You can download the tool from [here](https://aka.ms/webdeploy3.6)
59
-
**ASP.NET application** | The tool currently supports<br/><br/> - ASP.NET applications using Microsoft .NET framework 3.5 or later.<br/>- Application servers running Windows Server 2008 R2 or later (application servers should be running PowerShell version 5.1). <br/>- Applications running on Internet Information Services (IIS) 7.5 or later. <br/><br/> The tool currently doesn't support <br/><br/> - Applications requiring Windows authentication (AKS doesn’t support gMSA currently). <br/>- Applications that depend on other Windows services hosted outside IIS.
57
+
**Identify a machine to install the tool** | A Windows machine to install and run the Azure Migrate: App Containerization tool. The Windows machine could be a server (Windows Server 2016 or later) or client (Windows 10) operating system, meaning that the tool can run on your desktop as well. <br/><br/> The Windows machine running the tool should have network connectivity to the servers/virtual machines hosting the ASP.NET applications to be containerized.<br/><br/> Ensure that 6-GB space is available on the Windows machine running the Azure Migrate: App Containerization tool for storing application artifacts. <br/><br/> The Windows machine should have internet access, directly or via a proxy. <br/> <br/>Install the Microsoft Web Deploy tool on the machine running the App Containerization helper tool and application server if not already installed. You can download the tool from [here](https://aka.ms/webdeploy3.6).
58
+
**Application servers** | Enable PowerShell remoting on the application servers: Sign in to the application server and follow[these](/powershell/module/microsoft.powershell.core/enable-psremoting) instructions to turn on PowerShell remoting. <br/><br/> If the application server is running Windows Server 2008 R2, ensure that PowerShell 5.1 is installed on the application server. Follow the instruction [here](/powershell/scripting/windows-powershell/wmf/setup/install-configure) to download and install PowerShell 5.1 on the application server. <br/><br/> Install the Microsoft Web Deploy tool on the machine running the App Containerization helper tool and application server if not already installed. You can download the tool from [here](https://aka.ms/webdeploy3.6).
59
+
**ASP.NET application** | The tool currently supports:<br/> - ASP.NET applications using Microsoft .NET framework 3.5 or later.<br/>- Application servers running Windows Server 2008 R2 or later (application servers should be running PowerShell version 5.1). <br/>- Applications running on Internet Information Services (IIS) 7.5 or later. <br/><br/> The tool currently doesn't support: <br/>- Applications requiring Windows authentication(The App Containerization tool currently doesn't support gMSA). <br/>- Applications that depend on other Windows services hosted outside IIS.
60
60
61
61
62
62
## Prepare an Azure user account
63
63
64
64
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/pricing/free-trial/) before you begin.
65
65
66
-
Once your subscription is set up, you'll need an Azure user account with:
67
-
- Owner permissions on the Azure subscription
68
-
- Permissions to register Azure Active Directory apps
66
+
Once your subscription is set up, you need an Azure user account with:
67
+
- Owner permissions on the Azure subscription.
68
+
- Permissions to register Azure Active Directory apps.
69
69
70
70
If you just created a free Azure account, you're the owner of your subscription. If you're not the subscription owner, work with the owner to assign the permissions as follows:
71
71
72
72
1. In the Azure portal, search for "subscriptions", and under **Services**, select **Subscriptions**.
73
73
74
-
74
+
75
75
76
76
1. In the **Subscriptions** page, select the subscription in which you want to create an Azure Migrate project.
77
77
78
78
1. Select **Access control (IAM)**.
79
79
80
80
1. Select **Add** > **Add role assignment** to open the **Add role assignment** page.
81
81
82
-
1. Assign the following role. For detailed steps, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md).
82
+
1. Assign the following role. For detailed steps, see [Screenshot of assigning Azure roles using the Azure portal.](../role-based-access-control/role-assignments-portal.md).
83
83
84
84
| Setting | Value |
85
85
| --- | --- |
86
86
| Role | Owner |
87
87
| Assign access to | User |
88
88
| Members | azmigrateuser (in this example) |
89
89
90
-
90
+
91
91
92
92
1. Your Azure account also needs **permissions to register Azure Active Directory apps.**
93
93
94
94
1. In Azure portal, navigate to **Azure Active Directory** > **Users** > **User Settings**.
95
95
96
96
1. In **User settings**, verify that Azure AD users can register applications (set to **Yes** by default).
97
97
98
-
98
+
99
99
100
100
1. In case the 'App registrations' settings is set to 'No', request the tenant/global admin to assign the required permission. Alternately, the tenant/global admin can assign the **Application Developer** role to an account to allow the registration of Azure Active Directory App. [Learn more](../active-directory/fundamentals/active-directory-users-assign-role-azure-portal.md).
101
101
@@ -120,9 +120,9 @@ If you just created a free Azure account, you're the owner of your subscription.
120
120
4. Select **ASP.NET web apps** as the type of application you want to containerize.
121
121
5. To specify target Azure service, select **Containers on Azure Kubernetes Service**.
122
122
123
-
123
+
124
124
125
-
### Complete tool pre-requisites
125
+
### Complete tool prerequisites
126
126
1. Accept the **license terms**, and read the third-party information.
127
127
6. In the tool web app > **Set up prerequisites**, do the following steps:
128
128
-**Connectivity**: The tool checks that the Windows machine has internet access. If the machine uses a proxy:
@@ -141,7 +141,7 @@ If you just created a free Azure account, you're the owner of your subscription.
141
141
1. You'll need a device code to authenticate with Azure. Selecting on **Sign in** will open a modal with the device code.
142
142
2. Select **Copy code & sign in** to copy the device code and open an Azure sign in prompt in a new browser tab. If it doesn't appear, make sure you've disabled the pop-up blocker in the browser.
145
145
146
146
1. On the new tab, paste the device code and complete the sign in using your Azure account credentials. You can close the browser tab after sign in is complete and return to the App Containerization tool screen.
147
147
1. Select the **Azure tenant** that you want to use.
@@ -287,6 +287,6 @@ To troubleshoot any issues with the tool, you can look at the log files on the W
287
287
288
288
## Next steps
289
289
290
-
- Containerizing ASP.NET web apps and deploying them on Windows containers on App Service. [Learn more](./tutorial-app-containerization-aspnet-app-service.md)
291
-
- Containerizing Java web apps on Apache Tomcat (on Linux servers) and deploying them on Linux containers on AKS. [Learn more](./tutorial-app-containerization-java-kubernetes.md)
292
-
- Containerizing Java web apps on Apache Tomcat (on Linux servers) and deploying them on Linux containers on App Service. [Learn more](./tutorial-app-containerization-java-app-service.md)
290
+
- Containerizing ASP.NET web apps and deploying them on Windows containers on App Service. [Learn more](./tutorial-app-containerization-aspnet-app-service.md).
291
+
- Containerizing Java web apps on Apache Tomcat (on Linux servers) and deploying them on Linux containers on AKS. [Learn more](./tutorial-app-containerization-java-kubernetes.md).
292
+
- Containerizing Java web apps on Apache Tomcat (on Linux servers) and deploying them on Linux containers on App Service. [Learn more](./tutorial-app-containerization-java-app-service.md).
![prmerger-automator[bot]](https://avatars.githubusercontent.com/u/22479449?v=4&size=40){kind=avatar}
0 commit comments