Tutorial: Connect to a managed Admin for Spring in Azure Container Apps

The following commands help you create your resource group and container app environment.

1. Create variables to support your application configuration. These values are provided for you for the purposes of this lesson.

   export LOCATION=chinaeast
   export RESOURCE_GROUP=my-resource-group
   export ENVIRONMENT=my-environment
   export JAVA_COMPONENT_NAME=admin
   export APP_NAME=sample-admin-client
   export IMAGE="mcr.microsoft.com/javacomponents/samples/sample-admin-for-spring-client:latest"
   

   Variable	Description
   LOCATION	The Azure region location where you create your container app and Java component.
   ENVIRONMENT	The container app environment name for your demo application.
   RESOURCE_GROUP	The Azure resource group name for your demo application.
   JAVA_COMPONENT_NAME	The name of the Java component created for your container app. In this case, you create an Admin for Spring Java component.
   IMAGE	The container image used in your container app.

2. Sign in to Azure with the Azure CLI.

   az cloud set -n AzureChinaCloud
   az login
   # az cloud set -n AzureCloud   //means return to Public Azure.
   

3. Create a resource group.

   az group create \
       --name $RESOURCE_GROUP \
       --location $LOCATION \
       --query "properties.provisioningState"
   

   When you use the --query parameter, the response filters down to a simple success or failure message.

4. Create your container app environment.

   az containerapp env create \
       --name $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --location $LOCATION
   

To create each of the resources necessary to create a container app, follow these steps:

1. Search for Container Apps in the Azure portal and select Create.

2. On the Basics tab, enter the following values:

   Property	Value
   Subscription	Select your Azure subscription.
   Resource group	Select Create new to create a new resource group named my-resource-group.
   Container app name	Enter sample-admin-client.
   Deployment source	Select Container image.
   Region	Select the region nearest you.
   Container app environment	Select Create new to create a new environment.

3. On the Create Container Apps environment window, enter the following values:

   Property	Value
   Environment name	Enter my-environment.
   Zone redundancy	Select Disabled.

4. Select Create, and then select the Container tab.

5. On the Container tab, enter the following values:

   Property	Value
   Name	Enter sample-admin-client.
   Image source	Select Docker Hub or other registries.
   Image type	Select Public.
   Registry sign-in server	Enter mcr.microsoft.com.
   Image and tag	Enter javacomponents/samples/sample-admin-for-spring-client:latest.

6. Select the Ingress tab.

7. On the Ingress tab, enter the following values and leave the rest of the form filled in with the default values.

   Property	Value
   Ingress	Select Enabled.
   Ingress traffic	Select Accept traffic from anywhere.
   Ingress type	Select HTTP.
   Target port	Enter 8080.

8. Select Review + create.

9. After the validation checks pass, select Create to create your container app.

Now that you have an existing environment, you can create your container app and bind it to a Java component instance of an Admin for Spring component.

1. Create the Admin for Spring Java component.

   az containerapp env java-component admin-for-spring create \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \
       --min-replicas 1 \
       --max-replicas 1
   

2. Update the Admin for Spring Java component.

   az containerapp env java-component admin-for-spring update \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \
       --min-replicas 2 \
       --max-replicas 2
   

Now that you have an existing environment and admin client container app, you can create a Java component instance of Admin for Spring.

1. Go to your container app's environment in the portal.

2. On the service menu, under Services, select Services.

3. Select the Configure dropdown, then select Java component.

4. On the Configure Java component pane, enter the following values:

   Property	Value
   Java component type	Select Admin for Spring.
   Java component name	Enter admin.

5. Select Next.

6. On the Review tab, select Configure.

1. Create the container app and bind it to the Admin for Spring component.

   az containerapp create \
       --name $APP_NAME \
       --resource-group $RESOURCE_GROUP \
       --environment $ENVIRONMENT \
       --image $IMAGE \
       --min-replicas 1 \
       --max-replicas 1 \
       --ingress external \
       --target-port 8080 \
       --bind $JAVA_COMPONENT_NAME
   

1. Go to your Container App environment in the portal.

2. On the service menu, under Services, select Services.

3. From the list, select admin.

4. Under Bindings, select the App name dropdown, then select sample-admin-client.

5. Select the Review tab.

6. Select Configure.

7. Return to your container app in the portal. Copy the URL of your app to a text editor so that you can use it in an upcoming step.

To remove a binding from a container app, use the --unbind option.

az containerapp update \
    --name $APP_NAME \
    --unbind $JAVA_COMPONENT_NAME \
    --resource-group $RESOURCE_GROUP

1. Go to your container app environment in the portal.

2. On the service menu, under Services, select Services.

3. From the list, select admin.

4. Under Bindings, find the line for sample-admin-client, select it, and then select Delete.

5. Select Next.

6. Select the Review tab.

7. Select Configure.