Benutzerdefinierter Domänennamen und kostenlose verwaltete Zertifikate in Azure Container Apps

1. Navigieren Sie im Azure-Portal zu Ihrer Container-App.

2. Vergewissern Sie sich, dass für Ihre App der HTTP-Eingang aktiviert ist, indem Sie im Abschnitt Einstellungen die Option Eingang auswählen. Wenn der Eingang nicht aktiviert ist, aktivieren Sie ihn mit den folgenden Schritten:

   1. Legen Eingehender HTTP-Datenverkehr auf Aktiviert fest.
   2. Wählen Sie die gewünschte Einstellung für Eingehender Datenverkehr aus.
   3. Geben Sie den Zielport ein.
   4. Wählen Sie Speichern.

3. Wählen Sie im Abschnitt Einstellungen die Option Benutzerdefinierte Domänen aus.

4. Wählen Sie Benutzerdefinierte Domäne hinzufügen.

5. Wählen Sie im Fenster Benutzerdefinierte Domäne und Zertifikat hinzufügen unter TLS/SSL-Zertifikat die Option Verwaltetes Zertifikat aus.

6. Geben Sie in Domäne die Domäne ein, die Sie hinzufügen möchten.

7. Wählen Sie den Typ des Hostnamenseintrags basierend auf dem Typ Ihrer Domäne aus.

   Domänentyp	Datensatztyp	Hinweise
   Apex-Domäne	A-Eintrag	Eine Apex-Domäne ist eine Domäne auf Stammebene Ihrer Domäne. Wenn Ihre DNS-Zone beispielsweise contoso.com lautet, ist contoso.com die Apex-Domäne.
   Unterdomäne	CNAME	Eine Unterdomäne ist eine Domäne, die Teil einer anderen Domäne ist. Wenn Ihre DNS-Zone beispielsweise contoso.com lautet, ist www.contoso.com ein Beispiel einer Unterdomäne, die in der Zone konfiguriert werden kann.

8. Erstellen Sie mithilfe des DNS-Anbieters, der Ihre Domäne hostet, DNS-Einträge basierend auf dem Typ des Hostnamenseintrags, den Sie mit den im Abschnitt Domänenüberprüfung gezeigten Werten ausgewählt haben. Die Einträge verweisen die Domäne auf Ihre Container-App und überprüfen, ob Sie der Besitzer sind.

   • Wenn Sie A-Eintrag ausgewählt haben, erstellen Sie die folgenden DNS-Einträge:

     Datensatztyp	Host	Wert
     A	@	IP-Adresse Ihrer Container Apps-Umgebung.
     TXT	asuid	Domänenprüfcode.

   • Wenn Sie CNAME ausgewählt haben, erstellen Sie die folgenden DNS-Einträge:

     Datensatztyp	Host	Wert
     CNAME	Die Unterdomäne (z. B. www)	Automatisch generierte Domäne Ihrer Container-App.
     TXT	asuid. gefolgt von der Unterdomäne (z. B. asuid.www)	Domänenprüfcode.

9. Wählen Sie Überprüfen aus.

10. Wenn die Überprüfung erfolgreich war, wählen Sie Hinzufügen aus.

    Die Ausstellung des Zertifikats und das Hinzufügen der Domäne zu Ihrer Container-App können mehrere Minuten dauern.

11. Sobald der Vorgang abgeschlossen ist, wird Ihr Domänenname in der Liste der benutzerdefinierten Domänen mit dem Status Gesichert angezeigt. Navigieren Sie zu Ihrer Domäne, um zu überprüfen, ob sie zugänglich ist.

Container Apps unterstützt Apex- und Unterdomänen. Jeder Domänentyp erfordert einen anderen DNS-Eintragstyp und eine andere Überprüfungsmethode.

1. Melden Sie sich mit der Azure-Befehlszeilenschnittstelle (CLI) bei Azure an:

   az login
   

2. Installieren Sie als Nächstes die Azure Container Apps-Erweiterung für die CLI.

   az extension add --name containerapp --upgrade
   

3. Legen Sie die folgenden Umgebungsvariablen fest. Ersetzen Sie <PLACEHOLDERS> durch Ihre eigenen Werte.

   RESOURCE_GROUP = "<RESOURCE_GROUP>"
   CONTAINER_APP = "<CONTAINER_APP>"
   ENVIRONMENT = "<ENVIRONMENT>"
   TARGET_PORT = "<TARGET_PORT>"
   DOMAIN_NAME = "<DOMAIN_NAME>"
   CERTIFICATE_LOWERCASE_NAME = "<CERTIFICATE_LOWERCASE_NAME>"
   CERTIFICATE_LOCAL_PATH = "<CERTIFICATE_LOCAL_PATH>"
   CERTIFICATE_PASSWORD = "<CERTIFICATE_PASSWORD>"
   

   • Ersetzen Sie <CERTIFICATE_LOCAL_PATH> durch den lokalen Pfad der Zertifikatsdatei.
   • Ersetzen Sie <CERTIFICATE_LOWERCASE_NAME> durch den Namen eines Zertifikats in Kleinbuchstaben, der innerhalb der Umgebung eindeutig ist.
   • Ersetzen Sie <TARGET_PORT> durch den Port, an dem Ihre Container-App lauscht.

4. Vergewissern Sie sich, dass für Ihre Container-App der HTTP-Eingang aktiviert ist.

   az containerapp ingress show \
       -n $CONTAINER_APP \
       -g $RESOURCE_GROUP
   

   Wenn der Eingang nicht aktiviert ist, aktivieren Sie ihn mit den folgenden Schritten:

   az containerapp ingress enable \
       -n $CONTAINER_APP \
       -g $RESOURCE_GROUP \
       --type external \
       --target-port $TARGET_PORT \
       --transport auto
   

5. Wenn Sie eine Apex-Domäne konfigurieren, rufen Sie die IP-Adresse Ihrer Container Apps-Umgebung ab.

   az containerapp env show \
       -n $ENVIRONMENT \
       -g $RESOURCE_GROUP \
       -o tsv \
       --query "properties.staticIp"
   

6. Wenn Sie eine Unterdomäne konfigurieren, rufen Sie die automatisch generierte Domäne Ihrer Container-App ab.

   az containerapp show \
       -n $CONTAINER_APP \
       -g $RESOURCE_GROUP \
       -o tsv \
       --query "properties.configuration.ingress.fqdn"
   

7. Rufen Sie den Domänenprüfcode ab.

   az containerapp show \
       -n $CONTAINER_APP \
       -g $RESOURCE_GROUP \
       -o tsv \
       --query "properties.customDomainVerificationId"
   

8. Erstellen Sie mithilfe des DNS-Anbieters, der Ihre Domäne hostet, DNS-Einträge basierend auf dem Eintragstyp, den Sie mit den im Abschnitt Domänenüberprüfung gezeigten Werten ausgewählt haben. Die Einträge verweisen die Domäne auf Ihre Container-App und überprüfen, ob Sie der Besitzer sind.

   • Wenn Sie A-Eintrag ausgewählt haben, erstellen Sie die folgenden DNS-Einträge:

     Datensatztyp	Host	Wert
     A	@	IP-Adresse Ihrer Container Apps-Umgebung.
     TXT	asuid	Domänenprüfcode.

   • Wenn Sie CNAME ausgewählt haben, erstellen Sie die folgenden DNS-Einträge:

     Datensatztyp	Host	Wert
     CNAME	Die Unterdomäne (z. B. www)	Automatisch generierte Domäne Ihrer Container-App.
     TXT	asuid. gefolgt von der Unterdomäne (z. B. asuid.www)	Domänenprüfcode.

9. Fügen Sie der Container-App die Domäne hinzu.

   az containerapp hostname add \
       --hostname $DOMAIN_NAME \
       -g $RESOURCE_GROUP \
       -n $CONTAINER_APP
   

10. Konfigurieren Sie das verwaltete Zertifikat, und binden Sie die Domäne an Ihre Container-App.

    az containerapp hostname bind \
        --hostname $DOMAIN_NAME \
        -g $RESOURCE_GROUP \
        -n $CONTAINER_APP \
        --environment $ENVIRONMENT \
        --validation-method <VALIDATION_METHOD>
    

    • Wenn Sie einen A-Eintrag konfigurieren, ersetzen Sie <VALIDATION_METHOD> durch HTTP.

    • Wenn Sie einen CNAME-Eintrag konfigurieren, ersetzen Sie <VALIDATION_METHOD> durch CNAME.

    Die Ausstellung des Zertifikats und das Hinzufügen der Domäne zu Ihrer Container-App können mehrere Minuten dauern.

11. Navigieren Sie nach Abschluss des Vorgangs zu Ihrer Domäne, um zu überprüfen, ob auf sie zugegriffen werden kann.