Übung – Einrichten von Azure-Container-Apps
In dieser Einheit erstellen Sie eine Azure-Ressourcengruppe, die die Ressourcen für die Anwendung enthält. Anschließend richten Sie die PostgreSQL-Datenbank mithilfe der Azure CLI ein. Zum Schluss konfigurieren Sie die Quarkus-Anwendung für den Zugriff auf die PostgreSQL-Datenbank. Führen Sie die Befehle in der lokalen Bash-Umgebung aus, die in den Voraussetzungen konfiguriert ist. Verwenden Sie auf Windows Die konfigurierte WSL 2-Verteilung.
Vorbereiten der Arbeitsumgebung
Kehren Sie zur Bash-Shell zurück, die Sie für die früheren Maven-Befehle im generierten todo-Projektverzeichnis verwendet haben. Wenn der Entwicklungsmodus von Quarkus noch ausgeführt wird, drücken Sie STRG+C , bevor Sie fortfahren. Verwenden Sie diese Shell für die folgenden Exporte, und lassen Sie sie über den Anwendungsstart, das Verpacken und die Bereitstellung geöffnet.
Verwenden Sie Azure CLI 2.87.0 oder höher. Sie benötigen die Berechtigung zum Erstellen der Ressourcengruppe und Ressourcen und zum Registrieren ihrer Ressourcenanbieter, z. B. Mitwirkender oder Besitzer im Abonnementbereich. Abonnementrichtlinie und -kontingent können zusätzliche Einschränkungen festlegen.
Melden Sie sich bei Azure in dieser lokalen Bash-Umgebung an, indem Sie das interaktive Azure CLI-Anmeldeverfahren verwenden, einschließlich aller erforderlichen mehrstufigen Authentifizierung. Ersetzen Sie <subscription-id> durch Ihre beabsichtigte Abonnement-ID, wählen Sie dann dieses Abonnement aus und zeigen Sie es an:
az login
az account set --subscription "<subscription-id>"
az account show --query "{name:name,id:id}" --output table
Vergewissern Sie sich, dass das angezeigte Abonnement der zu verwendende Abonnement ist, bevor Sie kostenpflichtige Ressourcen erstellen. Wenn Sie sich bei Cloud Shell anmelden, melden Sie sich nicht in einer separaten lokalen CLI an. Führen Sie jeden Azure Befehl erfolgreich aus, bevor Sie fortfahren.
Sie müssen einige Umgebungsvariablen einrichten. Hier sind einige Hinweise zu den Variablen, die Sie erstellen:
| Variable | BESCHREIBUNG |
|---|---|
AZ_PROJECT |
Ein kurzer, kleingeschriebener Projektwert mit einem Eindeutigkeitssuffix. Behalten Sie den Variablennamen unverändert bei; das Suffix gehört zu seinem Wert. |
AZ_RESOURCE_GROUP |
Der Name der Ressourcengruppe, die die Ressourcen enthält. |
AZ_LOCATION |
Die Azure-Region. Es wird empfohlen, eine Region zu verwenden, die sich in der Nähe des Wohnorts befindet. Um die Liste der verfügbaren Regionen anzuzeigen, geben Sie az account list-locations an einer Eingabeaufforderung ein. |
AZ_CONTAINERAPP |
Der Name der Azure Container Apps-Instanz, die die Container enthält. |
AZ_CONTAINERAPP_ENV |
Der Name der Azure Container Apps-Umgebung. |
AZ_POSTGRES_SERVER_NAME |
Der weltweit einzigartige Name des flexiblen PostgreSQL-Servers. Verwenden Sie 3 bis 63 Zeichen, die aus Kleinbuchstaben, Zahlen und Bindestrichen bestehen. Der generierte psql${AZ_PROJECT} Wert folgt diesen Regeln. Wählen Sie ein anderes Suffix aus, wenn dieser Name nicht verfügbar ist. |
AZ_POSTGRES_DB_NAME |
Der Name der Anwendungsdatenbank. Sie erstellen diese Datenbank explizit nach dem Erstellen des Servers. |
AZ_POSTGRES_USERNAME |
Der Administratorbenutzername für Ihren PostgreSQL-Datenbankserver. |
AZ_POSTGRES_PASSWORD |
Das Administratorkennwort für Ihren PostgreSQL-Datenbankserver. Geben Sie an der stillen Eingabeaufforderung ein sicheres Kennwort ein. |
Hinweis
Sie können Ihre Azure-Ressourcen beliebig benennen, es wird jedoch empfohlen, Abkürzungsbeispiele für Azure-Ressourcenzu überprüfen. Dieser Artikel enthält Beispielkürzel für viele Azure-Ressourcen (z. B. rg für Ressourcengruppen und ca für Container-Apps).
Führen Sie den folgenden Block einmal aus, um die Variablen einzurichten. Wählen Sie eine für Ihr Abonnement geeignete Region aus, und geben Sie ein Kennwort ein, das den Anforderungen des PostgreSQL-Diensts entspricht. Die Kennwortaufforderung zeigt nicht an, was Sie eingeben.
export AZ_PROJECT="quarkus-${RANDOM}${RANDOM}"
export AZ_RESOURCE_GROUP="rg${AZ_PROJECT}"
export AZ_LOCATION="eastus"
export AZ_CONTAINERAPP="ca${AZ_PROJECT}"
export AZ_CONTAINERAPP_ENV="cae${AZ_PROJECT}"
export AZ_POSTGRES_DB_NAME="postgres${AZ_PROJECT}"
export AZ_POSTGRES_SERVER_NAME="psql${AZ_PROJECT}"
export AZ_POSTGRES_USERNAME="pgadmin"
read -r -s -p "PostgreSQL administrator password: " AZ_POSTGRES_PASSWORD
printf '\n'
export AZ_POSTGRES_PASSWORD
Das zufällige Suffix reduziert Konflikte mit Ressourcennamen; es garantiert nicht die globale Verfügbarkeit. Wenn der Name des PostgreSQL-Servers nicht verfügbar ist, wählen Sie vor dem Erstellen des Servers ein weiteres Suffix für AZ_POSTGRES_SERVER_NAME aus. Behalten Sie die anderen Ressourcenbezeichner unverändert bei.
Diese Umgebungsvariablen werden während des restlichen Moduls verwendet. Behalten Sie sie in dieser Bash-Shell bei, und führen Sie den Block für den zufälligen Namen und das Kennwort zwischen den einzelnen Einheiten nicht erneut aus. Das separate Terminal, das für HTTP-Anforderungen verwendet wird, benötigt nicht das Datenbankkennwort.
Erstellen Sie als Nächstes eine Ressourcengruppe:
az group create \
--name "$AZ_RESOURCE_GROUP" \
--location "$AZ_LOCATION"
Erstellen einer Instanz von Azure-Datenbank für PostgreSQL
Sie erstellen jetzt einen normalen verwalteten PostgreSQL 16-Server mit der Burstable B1ms SKU und 32 GiB des Premium SSD-Speichers. Die ausgewählte Region muss diese Version und SKU unterstützen und über verfügbare Abonnementkapazität verfügen. Beheben Sie alle Kontingent- oder Richtlinienfehler, bevor Sie fortfahren.
Registrieren Sie den PostgreSQL-Anbieter, und warten Sie, bis die Registrierung abgeschlossen ist:
az provider register --namespace Microsoft.DBforPostgreSQL --wait
Important
Diese Übung ermöglicht vorübergehend Datenbankverbindungsversuche von allen öffentlichen IPv4-Adressen. Die Authentifizierung ist weiterhin erforderlich. Verwenden Sie einen neuen Server und eine neue Ressourcengruppe, die der Übung zugeordnet ist, schließen Sie die spätere Firewalleinschränkung ab, und löschen Sie die Übungsressourcen, wenn Sie fertig sind. Diese anfängliche Netzwerkeinstellung ist keine Empfehlung für den Produktiveinsatz.
Erstellen Sie den PostgreSQL-Server:
az postgres flexible-server create \
--resource-group "$AZ_RESOURCE_GROUP" \
--location "$AZ_LOCATION" \
--name "$AZ_POSTGRES_SERVER_NAME" \
--admin-user "$AZ_POSTGRES_USERNAME" \
--admin-password="$AZ_POSTGRES_PASSWORD" \
--public-access All \
--tier Burstable \
--sku-name Standard_B1ms \
--storage-type Premium_LRS \
--storage-size 32 \
--version 16 \
--yes \
--output none
Mit --public-access All der Option wird der öffentliche Endpunkt aktiviert und die firewallregel für alle Adressen erstellt, die später in diesem Modul verwendet wird. Die spätere Ausnahme für Azure-Dienste verwendet weiterhin diesen öffentlichen Endpunkt und erlaubt Verbindungsversuche von Azure-Ressourcen, einschließlich der Abonnements anderer Kunden. Es handelt sich nicht um privaten oder ausschließlich anwendungsbezogenen Zugriff.
Nachdem die Servererstellung erfolgreich war, erstellen Sie die Anwendungsdatenbank explizit:
az postgres flexible-server db create \
--resource-group "$AZ_RESOURCE_GROUP" \
--server-name "$AZ_POSTGRES_SERVER_NAME" \
--name "$AZ_POSTGRES_DB_NAME" \
--output none
Stellen Sie sicher, dass die Datenbank vorhanden ist, bevor Sie die Anwendung starten:
az postgres flexible-server db show \
--resource-group "$AZ_RESOURCE_GROUP" \
--server-name "$AZ_POSTGRES_SERVER_NAME" \
--name "$AZ_POSTGRES_DB_NAME" \
--query name \
--output tsv
Der zurückgegebene Name muss mit dem Wert von AZ_POSTGRES_DB_NAME. Diese Datenbankbefehle verwenden --name für den Server und --server-name für die Datenbank.
Quarkus für den Zugriff auf die PostgreSQL-Datenbank konfigurieren
Rufen Sie den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Servers ab und erstellen Sie eine JDBC-URL ohne Anmeldeinformationen:
export AZ_POSTGRES_HOST=$(
az postgres flexible-server show \
--resource-group "$AZ_RESOURCE_GROUP" \
--name "$AZ_POSTGRES_SERVER_NAME" \
--query fullyQualifiedDomainName \
--output tsv
)
export AZ_POSTGRES_JDBC_URL="jdbc:postgresql://${AZ_POSTGRES_HOST}:5432/${AZ_POSTGRES_DB_NAME}?sslmode=require"
Diese URL verwendet sslmode=require, um eine verschlüsselte Übertragung zu erzwingen. Benutzername und Kennwort werden separat über die Datenquelleneigenschaften bereitgestellt, sodass Zeichen wie & in einem Kennwort nicht als URL-Parameter analysiert werden. Drucken Sie keine Anmeldeinformationswerte und verfolgen Sie sie nicht nach.
Die Verschlüsselung ist keine Überprüfung der Zertifikatsidentität.
sslmode=require überprüft nicht das Serverzertifikat und den Hostnamen. Wenn Sie diese Überprüfung benötigen, befolgen Sie die pgJDBC-Anleitung verify-full und Anweisungen zum Azure-Zertifikatvertrauen, einschließlich der Konfiguration vertrauenswürdiger Stammzertifikate. Das Bloße Ändern des Modus ohne Konfigurieren der Vertrauensstellung ist kein vollständiges Zertifikatüberprüfungsverfahren.
Konfigurieren Sie die Quarkus-Anwendung, um eine Verbindung mit der PostgreSQL-Datenbank herzustellen.
Ersetzen Sie in src/main/resources/application.properties die vorhandene unprofilierte Datenquellen-URL und die Schemagenerierungseinträge durch die folgenden vier Zeilen. Entfernen Sie auch alle nicht profilierten Benutzernamen- oder Kennworteinträge für Datenquellen. Behalten Sie die ${...} Ausdrücke wörtlich in der Datei bei; ersetzen Sie sie nicht durch Anmeldeinformationswerte. Lassen Sie nicht betroffene Einstellungen unverändert.
%dev,prod.quarkus.hibernate-orm.database.generation=update
%dev,prod.quarkus.datasource.jdbc.url=${AZ_POSTGRES_JDBC_URL}
%dev,prod.quarkus.datasource.username=${AZ_POSTGRES_USERNAME}
%dev,prod.quarkus.datasource.password=${AZ_POSTGRES_PASSWORD}
Diese Einstellungen gelten für die dev und prod profile, nicht für automatisierte Tests. Im Entwicklungsmodus wird die Azure-Datenbank für diese Einheit verwendet, und die bereitgestellte Anwendung verwendet sie im Produktionsmodus. Tests verwenden einen separaten PostgreSQL Dev Service. Lassen Sie Docker beim Testen oder Verpacken der Anwendung weiterlaufen. Der Maven-Lebenszyklus package führt die Tests aus; er darf der Azure-Datenbank keine Testdatensätze hinzufügen.
Unprofilierte QUARKUS_DATASOURCE_* Überschreibungen nicht exportieren. Wenn Sie zuvor irgendwelche in dieser Shell festgelegt haben, entfernen Sie sie vor dem Testen oder Packen, da sie diese Trennung außer Kraft setzen. Die AZ_ Variablen werden nur durch die profilspezifischen Ausdrücke aufgelöst. Weitere Informationen finden Sie in der Konfigurationsreferenz von Quarkus 3.18.4.
Führen Sie die Quarkus-Anwendung lokal aus, um die Remotedatenbankverbindung zu testen.
Ein Prozess erbt Umgebungsvariablen, wenn er gestartet wird. Das Exportieren von AZ_POSTGRES_* in einem anderen Terminal aktualisiert keinen bereits ausgeführten Quarkus-Prozess, und die Bearbeitung von application.properties allein reicht für diesen Übergang nicht aus.
Stellen Sie sicher, dass der frühere Entwicklungsprozess beendet wurde, indem Sie bei Bedarf STRG+C in seinem Terminal drücken. Starten Sie aus dem todo Verzeichnis in der Bash-Shell, das die exportierten Ressourcen- und Datenbankvariablen enthält, die Anwendung:
./mvnw clean quarkus:dev
Erstellen Sie beim Ausführen von Quarkus einige Aufgaben mithilfe der folgenden cURL-Befehle in einem zweiten lokalen Bash-Terminal. Lassen Sie die Shell, der die Variable gehört, mit Quarkus weiterlaufen:
curl --header "Content-Type: application/json" \
--request POST \
--data '{"description":"Take Quarkus MS Learn","details":"Take the MS Learn on deploying Quarkus to Azure Container Apps","done": "true"}' \
http://127.0.0.1:8080/api/todos
curl --header "Content-Type: application/json" \
--request POST \
--data '{"description":"Take Azure Container Apps MS Learn","details":"Take the ACA Learn module","done": "false"}' \
http://127.0.0.1:8080/api/todos
Überprüfen Sie als Nächstes, ob sich die Aufgaben in der Datenbank befinden, indem Sie auf den GET-Endpunkt zugreifen, der in der to-do-App definiert ist:
curl http://127.0.0.1:8080/api/todos
Die Antwort sollte die von Ihnen übermittelten Beschreibungen enthalten, ähnlich wie die folgende Ausgabe. Bezeichner, Zeitstempel und Reihenfolge können variieren, und das Wiederholen einer POST-Anfrage erstellt ein weiteres Element.
[
{
"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"
}
]
Wenn die Antwort die Elemente enthält, die Sie erstellt haben, haben Sie erfolgreich die Quarkus-Anwendung ausgeführt und Sie haben eine Verbindung zur Remote-PostgreSQL-Datenbank hergestellt.
Bevor Sie mit der Verpackung in der nächsten Einheit fortfahren, kehren Sie zum Terminal zurück, in dem Quarkus läuft, und drücken Sie STRG+C. Lassen Sie diese Bash-Shell im todo Verzeichnis geöffnet, wobei alle exportierten Variablen intakt sind. Führen Sie den Block für Zufallsnamen und Passwort nicht erneut aus. Verwenden Sie dieselbe Shell für das Packen und Bereitstellen.