Sdílet prostřednictvím


Rychlý start: Použití Tvůrce rozhraní Data API s Azure SQL a Azure Static Web Apps

V tomto rychlém průvodci nasadíte nástroj Data API (DAB) jako Docker kontejner do Azure Container Apps. K nasazení DAB spolu s databází Azure SQL s využitím nejnovějších osvědčených postupů použijete šablonu Azure Developer CLI (AZD). Šablona také nasadí ukázkovou webovou aplikaci, která se připojí ke koncovému bodu DAB pomocí GraphQL.

Požadavky

  • Azure Developer CLI
  • .NET 9.0

Pokud účet Azure nemáte, vytvořte si bezplatný účet, než začnete.

Inicializace projektu

Pomocí Azure Developer CLI (azd) vytvořte účet Azure SQL, nasaďte DAB jako kontejnerizované řešení a nasaďte kontejnerizovanou ukázkovou aplikaci. Ukázková aplikace používá DAB k dotazování ukázkových dat.

  1. Otevřete terminál v prázdném adresáři.

  2. Pokud ještě nejste ověřeni, pomocí azd auth loginse ověřte v Azure Developer CLI. Postupujte podle kroků určených nástrojem k ověření v rozhraní příkazového řádku pomocí vašich upřednostňovaných přihlašovacích údajů Azure.

    azd auth login
    
  3. K inicializaci projektu použijte azd init.

    azd init --template dab-azure-sql-quickstart
    
  4. Během inicializace nakonfigurujte jedinečný název prostředí.

  5. Nasazení úplného řešení do Azure pomocí azd up. Šablony Bicep nasazují účet Azure SQL DAB do Azure Container Apps a ukázkovou webovou aplikaci.

    azd up
    
  6. Během procesu zřizování vyberte své předplatné a požadované umístění. Počkejte na dokončení procesu zřizování. Proces může trvat přibližně sedm minut.

  7. Po dokončení zřizování prostředků Azure se do výstupu zahrne adresa URL spuštěné webové aplikace.

    Deploying services (azd deploy)
    
    (✓) Done: Deploying service api
    - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>
    
    (✓) Done: Deploying service web
    - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>
    
    SUCCESS: Your up workflow to provision and deploy to Azure completed in 7 minutes 0 seconds.
    
  8. Poznamenejte si hodnoty adresy URL API a webových služeb. Tyto hodnoty použijete dále v tomto průvodci.

Konfigurace připojení k databázi

Teď přejděte do každé kontejnerizované aplikace v Azure Container Apps a ověřte, že fungují podle očekávání.

  1. Nejprve přejděte na URL adresu služby API . Tato adresa URL odkazuje na spuštěnou instanci DAB.

  2. Prohlédněte si výstup JSON z DAB. Mělo by to znamenat, že kontejner DAB je spuštěný a stav je v pořádku.

    {
      "status": "healthy",
      "version": "1.1.7",
      "app-name": "dab_oss_1.1.7"
    }
    
  3. Přejděte na relativní cestu pro instanci DAB: /swagger. Tato adresa URL by měla otevřít Swagger UI integrované vývojové prostředí (IDE) REST.

  4. V integrovaném vývojovém prostředí Swagger spusťte požadavek GET pro všechny řádky v tabulce Azure SQL products.

  5. Nakonec přejděte na adresu URL pro webovou službu . Tato adresa URL odkazuje na spuštěnou ukázkovou webovou aplikaci, která se připojuje ke koncovému bodu GraphQL, ke kterému jste získali přístup v předchozím kroku.

  6. Prohlédněte si spuštěnou webovou aplikaci a zkontrolujte výstupní data.

    snímek obrazovky se spuštěnou webovou aplikací v Azure Container Apps.

Odklidit

Pokud už ukázkovou aplikaci nebo prostředky nepotřebujete, odeberte odpovídající nasazení a všechny prostředky.

  1. Odeberte nasazení z předplatného Azure.

    azd down
    
  2. Pokud používáte GitHub Codespaces, odstraňte spuštěný codespace, abyste maximalizovali nároky na úložiště a jádra.

Další krok