Data API Builder implementeren in Azure Container Apps

Vereiste voorwaarden

• Een Azure-account met een actief abonnement. Gratis een account maken

• Data-API-bouwer CLI. Installeer de CLI.

• Azure CLI. Installeer de Azure CLI.

• Bestaande ondersteunde database die kan worden adresseerbaar vanuit Azure.

Het configuratiebestand bouwen

Maak eerst een DAB-configuratiebestand (Data API Builder) om verbinding te maken met uw bestaande database. Dit bestand wordt later gebruikt met de uiteindelijke container.

1. Maak een lege map op uw lokale computer om het configuratiebestand op te slaan.

2. Initialiseer een nieuw basisconfiguratiebestand met behulp van dab init. Gebruik de volgende instellingen minimaal voor initialisatie.

   Configuratie	Waarde
   Databasetype	Selecteer een ondersteund databasetype.
   Verbindingsstring	Gebruik de @env() functie om te verwijzen naar de DATABASE_CONNECTION_STRING omgevingsvariabele.

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

   Belangrijk

   Voor sommige databasetypen zijn extra configuratie-instellingen vereist voor initialisatie.

3. Voeg ten minste één database-entiteit toe aan de configuratie. Gebruik de dab add opdracht om een entiteit te configureren. Configureer elke entiteit om alle machtigingen voor anonieme gebruikers toe te staan. Herhaal dab add zo vaak als u wilt voor uw entiteiten.

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

4. Open en controleer de inhoud van het dab-config.json-bestand . U gebruikt dit bestand verderop in deze handleiding.

Hostconfiguratie in Azure Files

Upload vervolgens het configuratiebestand naar een bestandsshare die is gemaakt in Azure Files. Deze bestandsshare wordt uiteindelijk als volume gekoppeld aan de uiteindelijke container.

1. Meld u aan bij Azure Portal (https://portal.azure.com).

2. Een nieuwe resourcegroep maken. U gebruikt deze resourcegroep voor alle nieuwe resources in deze handleiding.

   

   Hint

   U wordt aangeraden de resourcegroep msdocs-dab-aca een naam te geven. Alle schermafbeeldingen in deze handleiding gebruiken deze naam.

3. Een Azure Storage-account maken. Gebruik deze instellingen om het account te configureren.

   Configuratie	Waarde
   Resourcegroep	Selecteer de resourcegroep die u eerder hebt gemaakt
   Naam van opslagaccount	Voer een wereldwijd unieke naam in
   Regio	Een Azure-regio selecteren
   prestatie	Selecteer Standaard
   Redundantie	Lokaal redundante opslag (LRS) selecteren
   Toegang tot opslagaccountsleutels inschakelen	Selecteer Ingeschakeld.

   

4. Navigeer naar het nieuwe opslagaccount in Azure Portal.

5. Selecteer Bestandsdeling in de sectie Gegevensopslag van het resourcemenu. Selecteer vervolgens bestandsshare in de opdrachtbalk om een nieuwe share te maken in het opslagaccount. Gebruik de volgende instellingen om de nieuwe bestandsshare te configureren.

   Configuratie	Waarde
   Naam	config invoeren
   Toegangslaag	Hot selecteren
   Back-up inschakelen	Niet selecteren

   

6. Upload de dab-config.json en eventuele andere vereiste bestanden naar de share. Gebruik de optie Uploaden in de opdrachtbalk om het dialoogvenster Bestanden uploaden te openen. Selecteer beide bestanden en kies dan Uploaden.

   

7. Selecteer Toegangssleutels in de sectie Beveiliging en netwerken van het resourcemenu. Noteer vervolgens de opslagaccountnaam en sleutelwaarden op deze pagina. U gebruikt deze waarden verderop in deze handleiding.

   

De basiscontainer-app maken

Maak nu de container in Azure met behulp van Azure Container Apps. Deze container host de installatiekopieën van de Data API Builder zonder een configuratie.

1. Maak een Azure Container Apps-resource. Als onderdeel van het proces voor het maken van de app-resource moet u een omgeving maken. Gebruik deze instellingen om beide resources te configureren.

   Hulpbron	Configuratie	Waarde
   Omgeving	Omgevingsnaam	Voer een wereldwijd unieke naam in
   Omgeving	Omgevingstype	Selecteer alleen verbruik
   Omgeving	Doel van logboeken	Selecteer Logboeken niet opslaan
   App	Resourcegroep	Selecteer de resourcegroep die u eerder hebt gemaakt
   App	Naam van opslagaccount	Voer een wereldwijd unieke naam in
   App	Regio	Selecteer dezelfde regio als het opslagaccount
   App	Quickstart-kopie gebruiken	Niet selecteren
   App	Afbeeldingsbron	Docker Hub of andere registers selecteren
   App	Afbeeldingstype	Selecteer Openbaar
   App	Registeraanmeldingsserver	mcr.microsoft.com invoeren
   App	Afbeelding en tag	azure-databases/data-api-builder:latest invoeren
   App	Omgevingsvariabelen - Naam	DATABASE_CONNECTION_STRING invoeren
   App	Omgevingsvariabelen - Waarde	Voer de verbindingsreeks voor uw database in.
   App	Toegang	Controleren of ingeschakeld is
   App	Inkomend verkeer	Selecteer Verkeer vanaf elke locatie accepteren
   App	Clientcertificaatmodus	Selecteer Negeren
   App	Type inkomend verkeer	HTTP selecteren
   App	Doelpoort	5000 invoeren

   

   

   Hint

   U wordt aangeraden een verbindingsreeks te gebruiken die geen autorisatiesleutels bevat. Gebruik in plaats daarvan beheerde identiteiten en op rollen gebaseerd toegangsbeheer om de toegang tussen uw database en host te beheren. Zie Azure-services die gebruikmaken van beheerde identiteiten voor meer informatie.

2. Navigeer naar de nieuwe container-app in Azure Portal.

3. Gebruik het veld Toepassings-URL in de sectie Essentials om naar de website van de container-app te bladeren. Bekijk de reacties die aangeven dat de DAB-container actief is en dat de status in orde is.

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

   Opmerking

   Het versienummer en de naam variëren op basis van uw huidige versie van Data API Builder. Op dit moment kunt u niet navigeren naar API-eindpunten. Deze eindpunten zijn beschikbaar zodra u een DAB-configuratiebestand koppelt.

De configuratiebestanden koppelen

Koppel ten slotte de configuratiebestanden van de Azure Files-share aan de container-app. Met deze stap kan de data-API-opbouwfunctie het configuratiebestand gebruiken om verbinding te maken met uw database.

1. Navigeer naar de containeromgeving die u eerder in deze handleiding hebt gemaakt met behulp van Azure Portal.

2. Selecteer Azure-bestanden in de sectie Instellingen van het resourcemenu. Selecteer vervolgens Toevoegen op de opdrachtbalk om een bestaande bestandsshare toe te voegen aan de containeromgeving. Gebruik de volgende instellingen om de nieuwe bestandsshare te configureren. Sla vervolgens de nieuwe configuratie van de bestandsshare op.

   Configuratie	Waarde
   Naam	config-share invoeren
   Naam van opslagaccount	De naam van het opslagaccount dat eerder in deze handleiding is vastgelegd.
   Sleutel van opslagaccount	Sleutel van het opslagaccount dat eerder in deze handleiding is vastgelegd.
   Bestandsdeling	config invoeren
   Toegangsmodus	Alleen-lezen selecteren

   

3. Navigeer opnieuw naar de container-app in Azure Portal.

4. Selecteer Revisies en replica's in de sectie Toepassing van het resourcemenu. Selecteer vervolgens Nieuwe revisie maken op de opdrachtbalk om het proces voor het configureren van een nieuwe revisie voor uw container-app te starten.

5. Navigeer naar de sectie Volumes en selecteer de optie Toevoegen. Gebruik de volgende instellingen om het nieuwe volume te configureren. Nadat u het volume hebt geconfigureerd, voegt u het volume toe aan de containerrevisie.

   Configuratie	Waarde
   Volume type	Azure-bestandsvolume selecteren
   Naam	config-volume invoeren
   Bestandsdeling	config invoeren

   

6. Navigeer naar de sectie Container , selecteer de enkele huidige container en selecteer vervolgens de optie Bewerken . Gebruik de volgende instellingen om twee koppelingen voor de container te configureren. Sla uw wijzigingen op.

   Configuratie	Waarde
   Volumenaam	config-volume invoeren
   Koppelingspad	/App/dab-config.json invoeren
   Subpad	dab-config.json invoeren

   Configuratie	Waarde
   Volumenaam	config-volume invoeren
   Koppelingspad	/App/schema.graphql invoeren
   Subpad	schema.graphql invoeren

   

7. Kies Maken om een nieuwe revisie aan te maken met de volumekoppelingen die u hebt opgegeven. Nu de revisie bijna is voltooid, wordt de implementatie afgerond.

8. Gebruik het veld Toepassings-URL in de sectie Essentials om opnieuw naar de website van de container-app te bladeren. U ziet dat het antwoord nog steeds aangeeft dat de DAB-container in orde is.

9. Navigeer naar het /api/swagger pad voor de huidige actieve toepassing. Gebruik de Swagger-gebruikersinterface om een HTTP GET-aanvraag voor een van uw entiteiten uit te geven.

De hulpbronnen opschonen

Wanneer u de voorbeeldtoepassing of resources niet meer nodig hebt, verwijdert u de bijbehorende implementatie en alle resources.

1. Navigeer naar de resourcegroep met behulp van Azure Portal.

2. Selecteer Verwijderen in de opdrachtbalk.

Volgende stap