|
1 | 1 | ---
|
2 | 2 | title: Migrate to Azure Container Apps
|
3 |
| -description: Describes an overview approach of migrating to Azure Container Apps. |
| 3 | +description: Describes migrating to Azure Container Apps. |
4 | 4 | author: KarlErickson
|
5 | 5 | ms.author: karler
|
6 |
| -ms.reviewer: dixue |
| 6 | +ms.reviewer: dingmeng-xue |
7 | 7 | ms.service: azure-spring-apps
|
8 | 8 | ms.topic: upgrade-and-migration-article
|
9 |
| -ms.date: 03/10/2025 |
| 9 | +ms.date: 03/13/2025 |
10 | 10 | ms.custom: devx-track-java, devx-track-extended-java
|
11 | 11 | ---
|
12 | 12 |
|
@@ -80,35 +80,50 @@ The migration approach from Azure Spring Apps to Azure Container Apps involves t
|
80 | 80 |
|
81 | 81 | ## Migration assistant tool
|
82 | 82 |
|
83 |
| -To speed up your migration and help you evaluate features on Azure Container Apps, we provide a new command in Azure CLI. This command retrieves the configurations of existing Azure Spring Apps resource based on the resource id of service instance and translates them into Biceps files for Azure Container App resources. This method allows you to quickly set up an Azure Container Apps managed environment and applications while applying basic settings similar to those in your Azure Spring Apps. For more details, refer to the following steps or see [az spring export](/cli/azure/spring#az-spring-export) |
84 |
| - |
85 |
| -1. Install Azure CLI version 2.45.0 or higher and latest version of Azure Spring Apps extension using the following command `az extension add --name spring`. |
86 |
| -1. Generate Bicep files to create the corresponding Azure Container Apps resources. It also generates a `README.md` file with detailed instructions. |
87 |
| - ```azurecli |
88 |
| - az spring export \ |
89 |
| - --target aca \ |
90 |
| - --subscription <subscription-id> \ |
91 |
| - --resource-group <resource-group-name> \ |
92 |
| - --service <service-name> \ |
93 |
| - --output-folder <output-folder-name> |
94 |
| - ``` |
95 |
| -1. Follow the instructions in `README.md` to update the required parameters in the Bicep files. |
96 |
| -1. Create a resource group if it doesn't exist. |
97 |
| - ```azurecli |
98 |
| - az group create \ |
99 |
| - --subscription <subscription-id> \ |
100 |
| - --name <resource-group-name> \ |
101 |
| - --location <location> |
102 |
| - ``` |
103 |
| -1. Deploy Azure Container Apps resources to the resource group. You may need to run the command multiple times and adjust the configuration based on the response message. |
104 |
| - ```azurecli |
105 |
| - az deployment group create |
106 |
| - --resource-group <resource-group-name> --template-file main.bicep --parameters param.bicepparam --subscription <subscription-id> |
107 |
| - ``` |
108 |
| -1. Follow the instructions in `README.md` file to update resources for advanced features. These features include uploading certificates, enabling a custom domain, adding role assignments to the system-assigned managed identity, and more. |
109 |
| - |
110 |
| -If you need the Terraform configuration of those resources, you can export them using the export workflow of Azure Terraform Resource Provider. For more information, see [Overview of the Azure Terraform Resource Provider](/azure/developer/terraform/azure-terraform-resource-provider/resource-provider-overview). |
111 |
| - |
| 83 | +To speed up your migration and help you evaluate features on Azure Container Apps, we provide a new command in Azure CLI. This command retrieves the configurations of existing Azure Spring Apps resources based on the resource ID of the service instance and translates them into Bicep files for Azure Container App resources. This method enables you to quickly set up an Azure Container Apps managed environment and applications while applying basic settings similar to those in your existing Azure Spring Apps resources. For more information, see [az spring export](/cli/azure/spring#az-spring-export). |
| 84 | + |
| 85 | +To create Azure Container Apps resources that match the configurations of your existing Azure Spring Apps resources, use the following steps: |
| 86 | + |
| 87 | +1. Install Azure CLI version 2.45.0 or higher and the latest version of Azure Spring Apps extension by using the `az extension add --name spring` command. |
| 88 | + |
| 89 | +1. Generate Bicep files to create the corresponding Azure Container Apps resources by using the following command: |
| 90 | + |
| 91 | + ```azurecli |
| 92 | + az spring export \ |
| 93 | + --resource-group <resource-group-name> \ |
| 94 | + --target aca \ |
| 95 | + --subscription <subscription-id> \ |
| 96 | + --service <service-name> \ |
| 97 | + --output-folder <output-folder-name> |
| 98 | + ``` |
| 99 | +
|
| 100 | +1. The previous command generates a **README.md** file with detailed instructions. Follow those instructions to update the required parameters in the Bicep files. |
| 101 | +
|
| 102 | +1. If a resource group doesn't exist, create it by using the following command: |
| 103 | +
|
| 104 | + ```azurecli |
| 105 | + az group create \ |
| 106 | + --name <resource-group-name> \ |
| 107 | + --subscription <subscription-id> \ |
| 108 | + --location <location> |
| 109 | + ``` |
| 110 | +
|
| 111 | +1. Deploy Azure Container Apps resources to the resource group by using the following command: |
| 112 | +
|
| 113 | + > [!NOTE] |
| 114 | + > You may need to run the command multiple times and adjust the configuration based on the response message. |
| 115 | +
|
| 116 | + ```azurecli |
| 117 | + az deployment group create \ |
| 118 | + --resource-group <resource-group-name> \ |
| 119 | + --template-file main.bicep \ |
| 120 | + --parameters param.bicepparam \ |
| 121 | + --subscription <subscription-id> |
| 122 | + ``` |
| 123 | +
|
| 124 | +1. Follow the instructions in the **README.md** file to update resources for advanced features. These features include uploading certificates, enabling a custom domain, adding role assignments to the system-assigned managed identity, and more. |
| 125 | +
|
| 126 | +1. If you need the Terraform configuration of those resources, export them using the export workflow of Azure Terraform Resource Provider. For more information, see [Overview of the Azure Terraform Resource Provider](/azure/developer/terraform/azure-terraform-resource-provider/resource-provider-overview). |
112 | 127 |
|
113 | 128 | ## Tutorial
|
114 | 129 |
|
|
0 commit comments