Merge pull request #49319 from yoshioterada/yoshio-patch1-deploy-quarkus-app-2-aca

AnnaMHuff · web-flow · commit 1a0049346f1c · 2025-03-06T08:52:57.000-07:00
Updated the documents for Deploy a Quarkus application to Azure Container Apps
diff --git a/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/1-introduction.yml b/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/1-introduction.yml
@@ -6,9 +6,10 @@ metadata:
   prefetch-feature-rollout: true
   title: Introduction
   description: Introduction
-  ms.date: 02/14/2024
-  author: agoncal
-  ms.author: antoniomanug
+  ms.date: 03/06/2025
+  author: KarlErickson
+  ms.author: karler
+  ms.reviewer: yoterada
   ms.topic: unit
   ms.custom:
     - team=devdiv
diff --git a/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/2-build.yml b/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/2-build.yml
@@ -6,9 +6,10 @@ metadata:
   prefetch-feature-rollout: true
   title: Create a Quarkus application
   description: Create a Quarkus application, test it, and run it locally.
-  ms.date: 02/14/2024
-  author: agoncal
-  ms.author: antoniomanug
+  ms.date: 03/05/2025
+  author: KarlErickson
+  ms.author: karler
+  ms.reviewer: yoterada
   ms.topic: unit
   ms.custom:
     - team=devdiv
diff --git a/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/3-exercise-build.yml b/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/3-exercise-build.yml
@@ -6,9 +6,10 @@ metadata:
   prefetch-feature-rollout: true
   title: Exercise - Create a Quarkus application
   description: In this exercise, you bootstrap a Quarkus application, develop it, test it, and run it locally.
-  ms.date: 02/14/2024
-  author: agoncal
-  ms.author: antoniomanug
+  ms.date: 03/06/2025
+  author: KarlErickson
+  ms.author: karler
+  ms.reviewer: yoterada
   ms.topic: unit
   ms.custom:
     - team=devdiv
diff --git a/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/4-azure-container-apps.yml b/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/4-azure-container-apps.yml
@@ -6,9 +6,10 @@ metadata:
   prefetch-feature-rollout: true
   title: Set up Azure Container Apps
   description: Learn about setting up the Azure Container Apps resources and the PostgreSQL database.
-  ms.date: 02/14/2024
-  author: agoncal
-  ms.author: antoniomanug
+  ms.date: 03/06/2025
+  author: KarlErickson
+  ms.author: karler
+  ms.reviewer: yoterada
   ms.topic: unit
   ms.custom:
     - team=devdiv
diff --git a/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/5-exercise-rg-postgres.yml b/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/5-exercise-rg-postgres.yml
@@ -6,9 +6,10 @@ metadata:
   prefetch-feature-rollout: true
   title: Exercise - Set up Azure Container Apps
   description: In this exercise, you set up the Azure Resource Group and the PostgreSQL database.
-  ms.date: 02/14/2024
-  author: agoncal
-  ms.author: antoniomanug
+  ms.date: 03/06/2025
+  author: KarlErickson
+  ms.author: karler
+  ms.reviewer: yoterada
   ms.topic: unit
   ms.custom:
     - team=devdiv
diff --git a/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/6-exercise-azure-container-apps.yml b/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/6-exercise-azure-container-apps.yml
@@ -6,9 +6,10 @@ metadata:
   prefetch-feature-rollout: true
   title: Deploy a Quarkus application to Azure Container Apps
   description: In this exercise, you set up an Azure Container Apps environment and deploy a Quarkus Docker container.
-  ms.date: 02/14/2024
-  author: agoncal
-  ms.author: antoniomanug
+  ms.date: 03/06/2025
+  author: KarlErickson
+  ms.author: karler
+  ms.reviewer: yoterada
   ms.topic: unit
   ms.custom:
     - team=devdiv
diff --git a/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/7-exercise-secure.yml b/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/7-exercise-secure.yml
@@ -6,9 +6,10 @@ metadata:
   prefetch-feature-rollout: true
   title: Exercise - Restrict access to the Azure Container Apps environment
   description: In this exercise, you restrict access to the PostgreSQL database environment by changing the firewall rules.
-  ms.date: 02/14/2024
-  author: agoncal
-  ms.author: antoniomanug
+  ms.date: 03/06/2025
+  author: KarlErickson
+  ms.author: karler
+  ms.reviewer: yoterada
   ms.topic: unit
   ms.custom: team=devdiv, devx-track-extended-java, devx-track-azurecli
   ms.contributors: antoniomanug
diff --git a/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/8-knowledge-check.yml b/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/8-knowledge-check.yml
@@ -6,9 +6,10 @@ metadata:
   prefetch-feature-rollout: true
   title: Knowledge check
   description: Knowledge check
-  ms.date: 02/14/2024
-  author: agoncal
-  ms.author: antoniomanug
+  ms.date: 03/06/2025
+  author: KarlErickson
+  ms.author: karler
+  ms.reviewer: yoterada
   ms.topic: unit
   ms.custom:
     - team=devdiv
diff --git a/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/9-summary.yml b/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/9-summary.yml
@@ -6,9 +6,10 @@ metadata:
   prefetch-feature-rollout: true
   title: Summary
   description: Summary
-  ms.date: 02/14/2024
-  author: agoncal
-  ms.author: antoniomanug
+  ms.date: 03/06/2025
+  author: KarlErickson
+  ms.author: karler
+  ms.reviewer: yoterada
   ms.topic: unit
   ms.custom:
     - team=devdiv
diff --git a/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/includes/3-exercise-build.md b/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/includes/3-exercise-build.md
@@ -17,8 +17,8 @@ You don't need to specify Azure dependencies because you run your application lo
 At a command prompt, generate the to-do application:
 
 ```bash
-mvn -U io.quarkus:quarkus-maven-plugin:3.7.3:create \
-    -DplatformVersion=3.7.3 \
+mvn -U io.quarkus:quarkus-maven-plugin:3.19.0:create \
+    -DplatformVersion=3.18.4 \
     -DprojectGroupId=com.example.demo \
     -DprojectArtifactId=todo \
     -DclassName="com.example.demo.TodoResource" \
@@ -179,25 +179,21 @@ mvnw.cmd quarkus:dev  # On Windows
 
 The Quarkus application should start and connect to your database. You should see the following output:
 
-```shell
-[io.qua.dat.dep.dev.DevServicesDatasourceProcessor] Dev Services for the default datasource (postgresql) started.
-[io.qua.hib.orm.dep.HibernateOrmProcessor] Setting quarkus.hibernate-orm.database.generation=drop-and-create to initialize Dev Services managed database
+```output
+2025-02-28 08:38:33,418 INFO  [io.qua.dat.dep.dev.DevServicesDatasourceProcessor] (build-28) Dev Services for default datasource (postgresql) started - container ID is ce37977203b0
+2025-02-28 08:38:33,421 INFO  [io.qua.hib.orm.dep.dev.HibernateOrmDevServicesProcessor] (build-6) Setting quarkus.hibernate-orm.database.generation=drop-and-create to initialize Dev Services managed database
 __  ____  __  _____   ___  __ ____  ______ 
  --/ __ \/ / / / _ | / _ \/ //_/ / / / __/ 
  -/ /_/ / /_/ / __ |/ , _/ ,< / /_/ /\ \   
 --\___\_\____/_/ |_/_/|_/_/|_|\____/___/   
-[org.hib.eng.jdb.spi.SqlExceptionHelper] (JPA Startup Thread) SQL Warning Code: 0, SQLState: 00000
+2025-02-28 08:38:35,278 INFO  [io.quarkus] (Quarkus Main Thread) todo 1.0.0-SNAPSHOT on JVM (powered by Quarkus 3.18.4) started in 5.367s. Listening on: http://localhost:8080
 
-[org.hib.eng.jdb.spi.SqlExceptionHelper] (JPA Startup Thread) table "todo" does not exist, skipping
-[org.hib.eng.jdb.spi.SqlExceptionHelper] (JPA Startup Thread) SQL Warning Code: 0, SQLState: 00000
-[org.hib.eng.jdb.spi.SqlExceptionHelper] (JPA Startup Thread) sequence "hibernate_sequence" does not exist, skipping
-[io.quarkus] (Quarkus Main Thread) todo 1.0.0-SNAPSHOT on JVM (powered by Quarkus) started in 4.381s. Listening on: http://localhost:8080
-[io.quarkus] (Quarkus Main Thread) Profile dev activated. Live Coding activated.
-[io.quarkus] (Quarkus Main Thread) Installed features: [agroal, cdi, hibernate-orm, hibernate-orm-panache, jdbc-postgresql, narayana-jta, resteasy, resteasy-jackson, smallrye-context-propagation, vertx]
+2025-02-28 08:38:35,280 INFO  [io.quarkus] (Quarkus Main Thread) Profile dev activated. Live Coding activated.
+2025-02-28 08:38:35,280 INFO  [io.quarkus] (Quarkus Main Thread) Installed features: [agroal, cdi, hibernate-orm, hibernate-orm-panache, jdbc-postgresql, narayana-jta, resteasy, resteasy-jackson, smallrye-context-propagation, vertx]
 
 --
 Tests paused
-Press [r] to resume testing, [o] Toggle test output, [:] for the terminal, [h] for more options>
+Press [e] to edit command line args (currently ''), [r] to resume testing, [o] Toggle test output, [:] for the terminal, [h] for more options>
 ```
 
 To test the application, you can use cURL.
@@ -214,7 +210,7 @@ curl --header "Content-Type: application/json" \
 This command should return the created item (with an identifier):
 
 ```json
-{"id":1,"description":"Take Quarkus MS Learn","details":"Take the MS Learn on deploying Quarkus to Azure Container Apps","done":true,"createdAt":"2022-12-30T15:17:20.280203Z"}
+{"id":1,"description":"Take Quarkus MS Learn","details":"Take the MS Learn on deploying Quarkus to Azure Container Apps","done":true,"createdAt":"2025-02-26T07:27:30.093447Z"}
 ```
 
 Create a second to-do by using the following cURL command:
@@ -290,7 +286,7 @@ mvnw.cmd clean test  # On Windows
 
 You should see output that looks similar to this:
 
-```shell
+```output
 [INFO] -------------------------------------------------------
 [INFO]  T E S T S
 [INFO] -------------------------------------------------------
diff --git a/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/includes/5-exercise-rg-postgres.md b/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/includes/5-exercise-rg-postgres.md
@@ -37,7 +37,7 @@ These environment variables are used throughout the rest of this module.
 
 Next, create a resource group:
 
-```bash
+```azurecli
 az group create \
     --name $AZ_RESOURCE_GROUP \
     --location $AZ_LOCATION
@@ -47,7 +47,15 @@ az group create \
 
 You'll now create a managed PostgreSQL server. Run the following command to create a small instance of Azure Database for PostgreSQL:
 
-```bash
+If you have never created a PostgreSQL Server before, you need to register the provider. To register the PostgreSQL provider, run the following command:
+
+```azurecli
+az provider register --namespace Microsoft.DBforPostgreSQL
+```
+
+Then, create the PostgreSQL Server.
+
+```azurecli
 az postgres flexible-server create \
     --resource-group "$AZ_RESOURCE_GROUP" \
     --location "$AZ_LOCATION" \
@@ -79,13 +87,16 @@ export POSTGRES_CONNECTION_STRING=$(
     --output tsv
 )
 
-export POSTGRES_CONNECTION_STRING_SSL="$POSTGRES_CONNECTION_STRING&ssl=true&sslmode=require"
+export POSTGRES_CONNECTION_STRING_SSL="$POSTGRES_CONNECTION_STRING&ssl=true"
 
 echo "POSTGRES_CONNECTION_STRING_SSL=$POSTGRES_CONNECTION_STRING_SSL"
 ```
 
 Note the connection string that's returned.
 
+> [!NOTE]
+> Microsoft recommends using the most secure authentication flow available. The authentication flow described in this procedure, such as for databases, caches, messaging or AI services, requires a very high degree of trust in the application and carries risks not present in other flows. Use this flow only when more secure options, like managed identities for passwordless or keyless connections, are not viable. For local machine operations, prefer user identities for passwordless or keyless connections.
+
 ## Configure the Quarkus application to connect to the PostgreSQL database
 
 Update the `application.properties` file in the `src/main/resources` folder of the project to configure the connection string to the PostgreSQL database. To do so, set the `quarkus.datasource.jdbc.url` property to the previously output `$POSTGRES_CONNECTION_STRING_SSL` value. The `&ssl=true&sslmode=require` part of the connection string forces the driver to use SSL, a requirement for Azure Database for PostgreSQL.
@@ -128,18 +139,20 @@ You should see the following output:
 
 ```json
 [
-   {
-      "description" : "Take Quarkus MS Learn",
-      "details" : "Take the MS Learn on deploying Quarkus to Azure Container Apps",
-      "done" : true,
-      "id" : 1
-   },
-   {
-      "description" : "Take Azure Container Apps MS Learn",
-      "details" : "Take the ACA Learn module",
-      "done" : false,
-      "id" : 2
-   }
+  {
+    "id": 1,
+    "description": "Take Quarkus MS Learn",
+    "details": "Take the MS Learn on deploying Quarkus to Azure Container Apps",
+    "done": true,
+    "createdAt": "2025-02-26T08:03:28.390854Z"
+  },
+  {
+    "id": 2,
+    "description": "Take Azure Container Apps MS Learn",
+    "details": "Take the ACA Learn module",
+    "done": false,
+    "createdAt": "2025-02-26T08:03:34.142249Z"
+  }
 ]
 ```
 
diff --git a/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/includes/6-exercise-azure-container-apps.md b/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/includes/6-exercise-azure-container-apps.md
@@ -107,9 +107,9 @@ caeazure-deploy-quarkus             rgazure-deploy-quarkus  eastus      Microsof
 workspace-rgazuredeployquarkuscDD3  rgazure-deploy-quarkus  eastus      Microsoft.OperationalInsights/workspaces
 ```
 
-## Run the deployed Quarkus application
+## Verify the deployed application
 
-You can now run the deployed Quarkus application. First, you need to get the URL of the application. You can get it by running the following command:
+You can now verify the deployed application. First, you need to get the URL of the application. You can get it by running the following command:
 
 ```bash
 export AZ_APP_URL=$(
diff --git a/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/includes/7-exercise-secure.md b/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/includes/7-exercise-secure.md
@@ -4,7 +4,7 @@ In this unit, you ensure that the PostgreSQL database can be accessed only by th
 
 First, make sure you can access the PostgreSQL server by using the Azure CLI. To do that, run this command:
 
-```bash
+```azurecli
 az postgres flexible-server execute \
     --name "$AZ_POSTGRES_SERVER_NAME" \
     --database-name "$AZ_POSTGRES_DB_NAME" \
@@ -22,7 +22,7 @@ Azure Database for PostgreSQL provides security by default. Its firewall usually
 
 You can list the existing firewall rules by running this command:
 
-```bash
+```azurecli
 az postgres flexible-server firewall-rule list \
     --name "$AZ_POSTGRES_SERVER_NAME" \
     --resource-group "$AZ_RESOURCE_GROUP" \
@@ -31,16 +31,16 @@ az postgres flexible-server firewall-rule list \
 
 You should see the following output:
 
-```bash
-EndIpAddress     Name                       ResourceGroup            StartIpAddress
----------------  -------------------------  -----------------------  ----------------
-255.255.255.255  AllowAll_2023-1-3_10-20-4  rgazure-deploy-quarkus  0.0.0.0
+```output
+EndIpAddress     Name                         ResourceGroup           StartIpAddress
+---------------  ---------------------------  ----------------------  ----------------
+255.255.255.255  AllowAll_2025-2-26_16-57-40  rgazure-deploy-quarkus  0.0.0.0
 ```
 
 Notice that the range of allowed IP addresses is `0.0.0.0` through `255.255.255.255`. A firewall rule like this allows any client to access the database. To ensure that only the Quarkus application can access the database, you need to update the firewall rules of the PostgreSQL server.
 In this case, it's just a matter of removing the public rule. To remove it, run the following command:
 
-```bash
+```azurecli
 az postgres flexible-server firewall-rule delete \
     --name "$AZ_POSTGRES_SERVER_NAME" \
     --resource-group "$AZ_RESOURCE_GROUP" \
@@ -50,7 +50,7 @@ az postgres flexible-server firewall-rule delete \
 
 Now try to query the database by running a SQL statement from the CLI:
 
-```bash
+```azurecli
 az postgres flexible-server execute \
     --name "$AZ_POSTGRES_SERVER_NAME" \
     --database-name "$AZ_POSTGRES_DB_NAME" \
@@ -62,7 +62,7 @@ az postgres flexible-server execute \
 
 The call eventually times out. You should see this message:
 
-```bash
+```output
 Unable to connect to flexible server: connection to server failed: Operation timed out
 ```
 
@@ -76,7 +76,7 @@ curl https://$AZ_APP_URL/api/todos
 
 You need to configure the firewall to allow access to only the Quarkus application. You need to add a new firewall rule. To add the rule, run this command:
 
-```bash
+```azurecli
 az postgres flexible-server firewall-rule create \
     --name "$AZ_POSTGRES_SERVER_NAME" \
     --resource-group "$AZ_RESOURCE_GROUP" \
@@ -89,7 +89,7 @@ Setting the `start-ip-address` and the `end-ip-address` to `0.0.0.0` allows acce
 
 If you try to access the database from the CLI by running the following command, the attempt should fail:
 
-```bash
+```azurecli
 az postgres flexible-server execute \
     --name "$AZ_POSTGRES_SERVER_NAME" \
     --database-name "$AZ_POSTGRES_DB_NAME" \
diff --git a/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/index.yml b/learn-pr/azure/deploy-java-quarkus-azure-container-app-postgres/index.yml
@@ -5,9 +5,10 @@ metadata:
   prefetch-feature-rollout: true
   title: Deploy a Quarkus application to Azure Container Apps
   description: Create a Quarkus application, connect it to a PostgreSQL database, and then deploy it to Azure Container Apps.
-  ms.date: 02/14/2024
-  author: agoncal
-  ms.author: antoniomanug
+  ms.date: 03/06/2025
+  author: KarlErickson
+  ms.author: karler
+  ms.reviewer: yoterada
   ms.topic: module-standard-task-based
   ms.custom: team=devdiv
   ms.contributors: antoniomanug
