Bereitstellen des Daten-API-Generators für Azure-Container-Apps

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.

• CLI des Daten-API-Erstellers. Installieren Sie die CLI-.

• Azure CLI. Installieren sie die Azure CLI.

• Vorhandene unterstützte Datenbank, die von Azure adressierbar ist.

Erstellen der Konfigurationsdatei

Erstellen Sie zunächst eine DAB-Konfigurationsdatei (Data API Builder), um eine Verbindung mit Ihrer vorhandenen Datenbank herzustellen. Diese Datei wird später mit dem endgültigen Container verwendet.

1. Erstellen Sie ein leeres Verzeichnis auf Ihrem lokalen Computer, um die Konfigurationsdatei zu speichern.

2. Initialisieren Sie eine neue Basiskonfigurationsdatei mit dab init. Verwenden Sie bei der Initialisierung mindestens die folgenden Einstellungen.

   Konfiguration	Wert
   Datenbanktyp	Wählen Sie einen unterstützten Datenbanktyp aus.
   Verbindungszeichenfolge	Verwenden Sie die @env()-Funktion, um auf die DATABASE_CONNECTION_STRING Umgebungsvariable zu verweisen.

   dab init --database-type "<database-type>" --connection-string "@env('DATABASE_CONNECTION_STRING')"
   

   Wichtig

   Einige Datenbanktypen erfordern zusätzliche Konfigurationseinstellungen für die Initialisierung.

3. Fügen Sie der Konfiguration mindestens eine Datenbankentität hinzu. Verwenden Sie den Befehl dab add, um eine Entität zu konfigurieren. Konfigurieren Sie jede Entität, um alle Berechtigungen für anonyme Benutzer zuzulassen. Wiederholen Sie dab add so oft, wie Sie möchten, für Ihre Entitäten.

   dab add "<entity-name>" --source "<schema>.<table>" --permissions "anonymous:*"
   

4. Öffnen und überprüfen Sie den Inhalt der dab-config.json Datei. Sie verwenden diese Datei an späterer Stelle in diesem Handbuch.

Hostkonfiguration in Azure-Dateien

Laden Sie als Nächstes die Konfigurationsdatei in eine Dateifreigabe hoch, die in Azure Files erstellt ist. Diese Dateifreigabe wird letztendlich als Datenvolumen an den endgültigen Container bereitgestellt.

1. Melden Sie sich beim Azure-Portal an (https://portal.azure.com).

2. Erstellen Sie eine neue Ressourcengruppe. Sie verwenden diese Ressourcengruppe für alle neuen Ressourcen in diesem Handbuch.

   

   Tipp

   Es wird empfohlen, die Ressourcengruppe "msdocs-dab-aca" zu benennen. Alle Screenshots in diesem Handbuch verwenden diesen Namen.

3. Erstellen Sie ein Azure Storage-Konto. Verwenden Sie diese Einstellungen, um das Konto zu konfigurieren.

   Konfiguration	Wert
   Ressourcengruppe	Wählen Sie die Zuvor erstellte Ressourcengruppe aus.
   Name des Speicherkontos	Geben Sie einen global eindeutigen Namen ein.
   Region	Auswählen einer Azure-Region
   Leistung	Wählen Sie Standard-
   Redundanz	Wählen Sie lokal redundanter Speicher (LRS)
   Aktivieren des Zugriffs auf den Speicherkontoschlüssel	Wählen Sie Aktiviert aus

   

4. Navigieren Sie zum neuen Speicherkonto im Azure-Portal.

5. Wählen Sie Dateifreigaben im Abschnitt Datenspeicher des Ressourcenmenüs aus. Wählen Sie dann Dateifreigabe aus der Befehlsleiste aus, um eine neue Freigabe im Speicherkonto zu erstellen. Verwenden Sie die folgenden Einstellungen, um die neue Dateifreigabe zu konfigurieren.

   Konfiguration	Wert
   Name	Geben Sie config ein.
   Zugriffs-Stufe	Wählen Sie Hot aus.
   Sicherung aktivieren	Nicht auswählen

   

6. Laden Sie die dab-config.json und alle anderen erforderlichen Dateien in den freigegebenen Ordner hoch. Verwenden Sie die Option Hochladen in der Befehlsleiste, um das Dialogfeld Dateien hochladen zu öffnen. Wählen Sie zuerst beide Dateien aus und klicken Sie dann auf Upload.

   

7. Wählen Sie Zugriffstasten im Abschnitt Sicherheit + Netzwerk des Ressourcenmenüs aus. Notieren Sie dann den Namen des Speicherkontos und den Wert des Schlüssels auf dieser Seite. Sie werden diese Werte später in diesem Handbuch verwenden.

   

Erstellen der Basiscontainer-App

Erstellen Sie nun den Container in Azure mithilfe von Azure-Container-Apps. Dieser Container hostt das Daten-API-Generator-Image ohne Konfiguration.

1. Erstellen Sie eine Azure-Container-Apps-Ressource. Im Rahmen des Prozesses zum Erstellen der App-Ressource müssen Sie eine Umgebung erstellen. Verwenden Sie diese Einstellungen, um beide Ressourcen zu konfigurieren.

   Ressource	Konfiguration	Wert
   Umgebung	Umgebungsname	Geben Sie einen global eindeutigen Namen ein.
   Umgebung	Umgebungstyp	Nur Verbrauch auswählen
   Umgebung	Protokollziel	Wählen Sie "Protokolle nicht speichern" aus.
   App	Ressourcengruppe	Wählen Sie die Zuvor erstellte Ressourcengruppe aus.
   App	Name des Speicherkontos	Geben Sie einen global eindeutigen Namen ein.
   App	Region	Wählen Sie dieselbe Region wie das Speicherkonto aus.
   App	Schnellstartbild verwenden	Nicht auswählen
   App	Bildquelle	Wählen Sie Docker Hub oder andere Registrierungen aus
   App	Bildtyp	Wählen Sie Öffentlich.
   App	Anmeldeserver für die Registrierung	Geben Sie mcr.microsoft.com ein.
   App	Bild und Etikett	Geben Sie azure-databases/data-api-builder:latest ein.
   App	Umgebungsvariablen – Name	Geben Sie DATABASE_CONNECTION_STRING ein.
   App	Umgebungsvariablen – Wert	Geben Sie die Verbindungszeichenfolge für Ihre Datenbank ein.
   App	Ingress	Stellen Sie sicher, dass "Aktiviert" ausgewählt ist.
   App	Eingehender Datenverkehr	Wählen Sie "Datenverkehr von überall annehmen" aus.
   App	Clientzertifikatmodus	Wählen Sie "Ignorieren" aus.
   App	Eingangstyp	Wählen Sie HTTP aus.
   App	Zielport	Geben Sie 5000 ein.

   

   

   Tipp

   Es wird empfohlen, eine Verbindungszeichenfolge zu verwenden, die keine Autorisierungsschlüssel enthält. Verwenden Sie stattdessen verwaltete Identitäten und rollenbasierte Zugriffssteuerung, um den Zugriff zwischen Ihrer Datenbank und Ihrem Host zu verwalten. Weitere Informationen finden Sie unter Azure-Dienste, die verwaltete Identitätenverwenden.

2. Navigieren Sie im Azure-Portal zur neuen Container-App.

3. Verwenden Sie das Feld "Anwendungs-URL " im Abschnitt "Essentials ", um zur Website der Container-App zu navigieren. Beachten Sie die Antwort, die angibt, dass der DAB-Container läuft und der Status fehlerfreiist.

   {
       "status": "healthy",
       "version": "1.1.7",
       "app-name": "dab_oss_1.1.7"
   }
   

   Hinweis

   Die Versionsnummer und der Name variieren je nach ihrer aktuellen Version des Daten-API-Generators. An diesem Punkt können Sie nicht zu api-Endpunkten navigieren. Diese Endpunkte sind verfügbar, sobald Sie eine DAB-Konfigurationsdatei bereitstellen.

Bereitstellen der Konfigurationsdateien

Stellen Sie schließlich die Konfigurationsdateien aus der Azure Files-Freigabe in die Container-App bereit. In diesem Schritt kann der Daten-API-Generator die Konfigurationsdatei verwenden, um eine Verbindung mit Ihrer Datenbank herzustellen.

1. Navigieren Sie mithilfe des Azure-Portals zu der zuvor in diesem Leitfaden erstellten Containerumgebung.

2. Wählen Sie Azure-Dateien im Abschnitt "Einstellungen" des Ressourcenmenüs aus. Wählen Sie dann auf der Befehlsleiste "Hinzufügen" aus, um der Containerumgebung eine vorhandene Dateifreigabe hinzuzufügen. Verwenden Sie die folgenden Einstellungen, um die neue Dateifreigabe zu konfigurieren. Speichern Sie dann die neue Dateifreigabekonfiguration.

   Konfiguration	Wert
   Name	Geben Sie config-share ein.
   Name des Speicherkontos	Name des zuvor in diesem Handbuch aufgezeichneten Speicherkontos.
   Speicherkontoschlüssel	Schlüssel des zuvor in diesem Leitfaden aufgezeichneten Speicherkontos.
   Dateifreigabe	Geben Sie config ein.
   Zugriffsmodus	Wählen Sie Schreibgeschützt aus

   

3. Navigieren Sie erneut im Azure-Portal zur Container-App.

4. Wählen Sie "Überarbeitungen" und "Replikate" im Abschnitt "Anwendung" des Ressourcenmenüs aus. Wählen Sie dann in der Befehlsleiste "Neue Überarbeitung erstellen" aus, um den Prozess der Konfiguration einer neuen Revision für Ihre Container-App zu starten.

5. Navigieren Sie zum Abschnitt "Volumes", und wählen Sie die Option "Hinzufügen" aus. Verwenden Sie die folgenden Einstellungen, um das neue Volume zu konfigurieren. Nachdem Sie das Volume konfiguriert haben, fügen Sie das Volume zur Containerrevision hinzu.

   Konfiguration	Wert
   Volumetyp	Azure-Dateivolume auswählen
   Name	Geben Sie config-volume ein.
   Dateifreigabe	Geben Sie config ein.

   

6. Navigieren Sie zum Abschnitt "Container ", wählen Sie den einzelnen aktuellen Container aus, und wählen Sie dann die Option "Bearbeiten" aus. Verwenden Sie die folgenden Einstellungen, um zwei Einhängepunkte für den Container zu konfigurieren. Speichern Sie die Änderungen.

   Konfiguration	Wert
   Volumename	Geben Sie config-volume ein.
   Einbindungspfad	Geben Sie /App/dab-config.json ein.
   Unterpfad	Geben Sie dab-config.json ein.

   Konfiguration	Wert
   Volumename	Geben Sie config-volume ein.
   Einbindungspfad	Geben Sie /App/schema.graphql ein.
   Unterpfad	Geben Sie schema.graphql ein.

   

7. Wählen Sie Erstellen aus, um eine neue Revision mit den von Ihnen angegebenen Volume-Einbindungen zu erstellen. Für die Überarbeitung, um die Bereitstellung abzuschließen.

8. Verwenden Sie das Feld "Anwendungs-URL " im Abschnitt "Essentials ", um erneut zur Website der Container-App zu navigieren. Beachten Sie, dass die Antwort weiterhin angibt, dass der DAB-Container in einwandfreiem Zustandist.

9. Navigieren Sie zum /api/swagger Pfad für die aktuelle ausgeführte Anwendung. Verwenden Sie die Swagger-Benutzeroberfläche, um eine HTTP GET-Anforderung für eine Ihrer Entitäten ausstellen zu können.

Bereinigen von Ressourcen

Wenn Sie die Beispielanwendung oder Ressourcen nicht mehr benötigen, entfernen Sie die entsprechende Bereitstellung und alle Ressourcen.

1. Navigieren Sie mithilfe des Azure-Portals zur Ressourcengruppe.

2. Wählen Sie in der BefehlsleisteLöschenaus.

Nächster Schritt