Vývoj rozhraní API pro data pomocí Azure Web App for Containers

Vývoj rozhraní API pro data pomocí Azure Web App for Containers nabízí robustní a škálovatelné řešení pro moderní aplikace. Díky výkonu kontejnerů a spravovaných služeb Azure můžou vývojáři snadno vytvářet, nasazovat a spravovat rozhraní API, což zajišťuje výkon a spolehlivost. Tento přístup nejen zjednodušuje proces vývoje, ale také vylepšuje přenositelnost a škálovatelnost aplikací, takže je ideální volbou pro dnešní moderní softwarovou krajinu.

Prozkoumání výhod používání služby Web App for Containers

• Přenositelnost: Kontejnery zapouzdřují aplikaci a její závislosti a zajišťují, aby běžela konzistentně napříč různými prostředími. Tím se eliminuje problém "funguje na mém počítači" , takže nasazení na různé platformy bude bezproblémové.

• Škálovatelnost: Azure Web App for Containers umožňuje automatické škálování na základě poptávky. To znamená, že vaše datové rozhraní API dokáže zvládnout zvýšené zatížení bez ručního zásahu, což zajišťuje vysokou dostupnost a výkon.

• Zjednodušená správa: Azure spravuje základní infrastrukturu, včetně oprav operačního systému, vyrovnávání zatížení a zřizování kapacity. Vývojáři se tak můžou soustředit na psaní kódu místo správy serverů.

Vytvoření rozhraní API pro data pomocí služby Azure Web App for Containers

Pokud chcete vytvořit rozhraní API pro data pomocí Azure Web App for Containers, musíte vytvořit aplikaci kontejneru s imagí DAB, přiřadit potřebná oprávnění, nastavit soubor Dockerfile a aktualizovat aplikaci novou imagí a přihlašovacími údaji. Nakonec načtěte název domény a otestujte rozhraní API.

Než začnete, ujistěte se, že máte předplatné Azure, skupinu prostředků a přístup ke službě Azure Cloud Shell.

Vytvoření aplikace typu kontejner

Pomocí následujícího postupu můžete vytvořit azure Container Apps.

1. Slouží az containerapp env create k vytvoření nového prostředí aplikací kontejnerů Azure.

   az containerapp env create \ 
     --resource-group $RESOURCE_GROUP_NAME \
     --name $CONTAINER_ENV_NAME \
     --logs-destination none \
     --location $LOCATION
   

2. Vytvořte novou aplikaci kontejneru pomocí příkazu az containerapp create a použijte k tomu DAB image kontejneru mcr.microsoft.com/azure-databases/data-api-builder.

   az containerapp create \ 
     --resource-group $RESOURCE_GROUP_NAME \
     --environment $CONTAINER_ENV_NAME \
     --name $API_CONTAINER_NAME \
     --image "mcr.microsoft.com/azure-databases/data-api-builder" \
     --ingress "external" \
     --target-port "5000" \
     --system-assigned
   

Pak můžete získat hlavní identifikátor spravované identity pomocí az identity show.

Přiřazení uživatelských oprávnění

Přiřaďte oprávnění spravované identity přiřazené systémem ke čtení dat z Azure SQL a čtení a zápisu do služby Azure Container Registry.

az role assignment create \
  --assignee $CURRENT_USER_PRINCIPAL_ID \
  --role $ROLE_ID \
  --scope $RESOURCE_GROUP_ID

Vytvořit instanci služby Azure Container Registry

Pokud chcete vytvořit novou instanci služby Azure Container Registry, spusťte následující příkaz.

az acr create \
  --resource-group $RESOURCE_GROUP_NAME \
  --name <CONTAINER_REGISTRY_NAME> \
  --sku "Standard" \
  --location <LOCATION> \
  --admin-enabled false

Sestavení a nasazení image kontejneru

1. Pro fázi sestavení použijte kontejnerovou image mcr.microsoft.com/dotnet/sdk.

2. Nainstalujte CLI pro DAB.

   RUN dotnet tool install Microsoft.DataApiBuilder
   

3. Spuštěním příkazu <a0/0> vytvořte konfigurační soubor pro připojení ke zdrojové databázi Azure SQL Database.

4. Vytvořte entity pro mapování na tabulky ve zdrojové databázi.

   RUN dotnet tool run dab -- add Address --source "SalesLT.Address" --permissions "anonymous:read"
   

5. Zkopírujte konfigurační soubor do konečné image kontejneru mcr.microsoft.com/azure-databases/data-api-builder .

6. Sestavte image jako úlohu registru kontejneru Azure spuštěním az acr build příkazu k sestavení image.

7. Nakonfigurujte aplikaci kontejneru tak, aby používala registr kontejneru.

   az containerapp registry set \
     --name <container-app-name> \
     --resource-group <resource-group-name> \
     --server <container-registry-login-server> \
     --username <container-registry-username> \
     --password <container-registry-password>
   

8. Vytvořte tajný kód pomocí azure SQL připojovací řetězec.

   az containerapp secret set \
     --name <container-app-name> \
     --resource-group <resource-group-name> \
     --secrets "SQLConnectionString=<your-sql-connection-string>"
   

9. Aktualizujte aplikaci kontejneru pomocí nové vlastní image kontejneru a připojovací řetězec.

   az containerapp update \
     --name <container-app-name> \
     --resource-group <resource-group-name> \
     --image <container-registry-login-server>/<image-name>:<tag> \
     --secrets "SQLConnectionString=<your-sql-connection-string>"
   

10. Načtěte plně kvalifikovaný název domény aplikace kontejneru.

    az containerapp show \
      --name <container-app-name> \
      --resource-group <resource-group-name> \
      --query "properties.configuration.ingress.fqdn" \
      --output "tsv"
    

Tento postup aktualizuje aplikaci kontejneru Azure pomocí nové vlastní image kontejneru a přihlašovacích údajů a načte plně kvalifikovaný název domény aplikace kontejneru.

Nakonec přejděte na adresu URL a otestujte rozhraní API, abyste měli jistotu, že všechno funguje správně.