Distribuera Data API-byggare till Azure Container Apps

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.

• Data-API-byggarens CLI. Installera CLI.

• Azure CLI. Installera Azure CLI.

• Befintlig databas som stöds kan adresseras från Azure.

Skapa konfigurationsfilen

Börja med att skapa en DAB-konfigurationsfil (Data API Builder) för att ansluta till din befintliga databas. Den här filen används senare med den slutliga containern.

1. Skapa en tom katalog på den lokala datorn för att lagra konfigurationsfilen.

2. Initiera en ny baskonfigurationsfil med .dab init Använd följande inställningar minst vid initiering.

   Inställning	Värde
   Databastyp	Välj en databastyp som stöds.
   Anslutningssträng	@env() Använd funktionen för att referera DATABASE_CONNECTION_STRING till miljövariabeln.

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

   Viktigt!

   Vissa databastyper kräver ytterligare konfigurationsinställningar vid initiering.

3. Lägg till minst en databasentitet i konfigurationen. dab add Använd kommandot för att konfigurera en entitet. Konfigurera varje entitet för att tillåta alla behörigheter för anonyma användare. Upprepa dab add så många gånger du vill för dina entiteter.

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

4. Öppna och granska innehållet i dab-config.json-filen . Du använder den här filen senare i den här guiden.

Konfiguration av värdar i Azure Files

Ladda sedan upp konfigurationsfilen till en filresurs som skapats i Azure Files. Den här filresursen monteras slutligen i den slutliga containern som en volym.

1. Logga in på Azure-portalen (https://portal.azure.com).

2. Skapa en ny resursgrupp. Du använder den här resursgruppen för alla nya resurser i den här guiden.

   

   Tips/Råd

   Vi rekommenderar att du namnger resursgruppen msdocs-dab-aca. Alla skärmbilder i den här guiden använder det här namnet.

3. skapa ett Azure Storage-konto Använd de här inställningarna för att konfigurera kontot.

   Inställning	Värde
   resursgrupp	Välj den resursgrupp som du skapade tidigare
   Lagringskontonamn	Ange ett globalt unikt namn
   Region	Välj en Azure-region
   Prestanda	Välj Standard
   Redundans	Välj Lokalt redundant lagring (LRS)
   Aktivera åtkomst till lagringskontonyckel	Välj Aktiverad

   

4. Gå till det nya lagringskontot i Azure-portalen.

5. Välj Filresurser i avsnittet Datalagring på resursmenyn. Välj sedan Filresurs i kommandofältet för att skapa en ny resurs i lagringskontot. Använd följande inställningar för att konfigurera den nya fildelningen.

   Inställning	Värde
   Namn	Ange config
   Åtkomstnivå	Välj Populär
   Aktivera säkerhetskopiering	Välj inte

   

6. Ladda upp dab-config.json och andra nödvändiga filer till delningen. Använd alternativet Ladda upp i kommandofältet för att öppna dialogrutan Ladda upp filer . Välj båda filerna och välj sedan Ladda upp.

   

7. Välj Åtkomstnycklar i avsnittet Säkerhet + nätverk på resursmenyn. Registrera sedan lagringskontots namn och nyckelvärden från den här sidan. Du kommer att använda dessa värden senare i den här guiden.

   

Skapa bascontainerappen

Skapa nu containern i Azure med Hjälp av Azure Container Apps. Den här containern är värd för Data API Builder-avbildningen utan konfiguration.

1. Skapa en Azure Container Apps-resurs. Som en del av processen med att skapa appresursen måste du skapa en miljö. Använd de här inställningarna för att konfigurera båda resurserna.

   Resurs	Inställning	Värde
   Miljö	Miljönamn	Ange ett globalt unikt namn
   Miljö	Miljötyp	Välj endast förbrukning
   Miljö	Lagringsplats för loggar	Välj Spara inte loggar
   App	resursgrupp	Välj den resursgrupp som du skapade tidigare
   App	Lagringskontonamn	Ange ett globalt unikt namn
   App	Region	Välj samma region som lagringskontot
   App	Använda snabbstartsbild	Välj inte
   App	Bildkälla	Välj Docker Hub eller andra register
   App	Bildtyp	Välj Offentlig
   App	Registerinloggningsserver	Ange mcr.microsoft.com
   App	Bild och tagg	Ange azure-databases/data-api-builder:latest
   App	Miljövariabler – Namn	Ange DATABASE_CONNECTION_STRING
   App	Miljövariabler – värde	Ange anslutningssträngen för databasen.
   App	Ingress	Kontrollera att Aktiverad är markerat
   App	Inkommande trafik	Välj Acceptera trafik var som helst
   App	Klientcertifikatläge	Välj Ignorera
   App	Ingresstyp	Välj HTTP
   App	Målport	Ange 5000

   

   

   Tips/Råd

   Vi rekommenderar att du använder en anslutningssträng som inte innehåller auktoriseringsnycklar. Använd i stället hanterade identiteter och rollbaserad åtkomstkontroll för att hantera åtkomst mellan din databas och värd. Mer information finns i Azure-tjänster som använder hanterade identiteter.

2. Gå till den nya containerappen i Azure-portalen.

3. Använd fältet Program-URL i avsnittet Essentials för att bläddra till containerappens webbplats. Observera svaret som anger att DAB-containern körs och att statusen är felfri.

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

   Anmärkning

   Versionsnumret och namnet varierar beroende på din aktuella version av Data API Builder. I det här läget kan du inte navigera till några API-slutpunkter. Dessa slutpunkter kommer att vara tillgängliga när du monterar en DAB-konfigurationsfil.

Montera konfigurationsfilerna

Montera slutligen konfigurationsfilerna från Azure Files-resursen till containerappen. Med det här steget kan data-API-byggaren använda konfigurationsfilen för att ansluta till databasen.

1. Navigera till containermiljön som skapades tidigare i den här guiden med hjälp av Azure-portalen.

2. Välj Azure-filer i avsnittet Inställningar på resursmenyn. Välj sedan Lägg till i kommandofältet för att lägga till en befintlig filresurs i containermiljön. Använd följande inställningar för att konfigurera den nya fildelningen. Spara sedan den nya filresurskonfigurationen.

   Inställning	Värde
   Namn	Ange config-share
   Lagringskontonamn	Namnet på lagringskontot som registrerades tidigare i den här guiden.
   Lagringskontonyckel	Nyckeln för lagringskontot som registrerades tidigare i den här guiden.
   Fildelning	Ange config
   Åtkomstläge	Välj Skrivskyddad

   

3. Gå till containerappen igen i Azure-portalen.

4. Välj Revisioner och repliker i avsnittet Program på resursmenyn. Välj sedan Skapa ny revision från kommandofältet för att starta processen med att konfigurera en ny revision för containerappen.

5. Gå till avsnittet Volymer och välj alternativet Lägg till. Använd följande inställningar för att konfigurera den nya volymen. När du har konfigurerat volymen lägger du till volymen i containerrevisionen.

   Inställning	Värde
   Volymtyp	Välj Azure-filvolym
   Namn	Ange config-volume
   Fildelning	Ange config

   

6. Gå till avsnittet Container , välj den enda aktuella containern och välj sedan alternativet Redigera . Använd följande inställningar för att konfigurera två monteringar för containern. Spara dina ändringar.

   Inställning	Värde
   Volymnamn	Ange config-volume
   Monteringspunktens sökväg	Ange /App/dab-config.json
   Underordnad väg	Ange dab-config.json

   Inställning	Värde
   Volymnamn	Ange config-volume
   Monteringspunktens sökväg	Ange /App/schema.graphql
   Underordnad väg	Ange schema.graphql

   

7. Välj Skapa för att skapa en ny revision med de volymfästen du har angett. Med för att revisionen ska slutföra distributionen.

8. Använd fältet Program-URL i avsnittet Essentials för att bläddra till containerappens webbplats igen. Observera att svaret fortfarande anger att DAB-containern är felfri.

9. Navigera till /api/swagger-sökvägen för det aktuella körande programmet. Använd Swagger-användargränssnittet för att utfärda en HTTP GET-begäran för en av dina entiteter.

Rensa resurser

När du inte längre behöver exempelprogrammet eller resurserna tar du bort motsvarande distribution och alla resurser.

1. Navigera till resursgruppen med hjälp av Azure-portalen.

2. I kommandofältet väljer du Ta bort.

Nästa steg