Megosztás a következőn keresztül:

Azure Developer CLI-támogatás hozzáadása az alkalmazáshoz egy meglévő sablon használatával

  • Cikk

Az Azure Developer CLI (azd) két különböző munkafolyamatot biztosít az alkalmazáshoz használandó sablon inicializálásához, amelyek a következők:

  • Kód használata az aktuális könyvtárban: Ez a módszer elemzi az alkalmazást, és automatikusan létrehozza a támogatott infrastruktúrát és konfigurációs erőforrásokat.
  • Sablon kiválasztása: Ezzel a módszerrel integrálhat egy meglévő sablont az alkalmazással, vagy használhat egy meglévő sablont egy új alkalmazás kiindulópontjaként.

Mindkét módszert az Azure Developer CLI-sablonok létrehozása áttekintő dokumentum ismerteti.

Ebben a cikkben megtudhatja, hogyan adhat támogatást az Azure Developer CLI (azd) alkalmazásához a Sablon kiválasztása megközelítéssel. Az alternatív megközelítéssel kapcsolatos további információkért látogasson el az Alkalmazás támogatásának hozzáadása azd meglévő sablontitkot használva. A sablonok készítéséről azd további információt a Betanítás – sablonok létrehozása és üzembe helyezése azd című témakörben talál.

Sablon kiválasztása az alkalmazáshoz

A parancs sablon-munkafolyamatának azd init kiválasztása lehetővé teszi, hogy kiindulási pontként használjon egy meglévő azd sablont. A kiválasztott sablon tartalma hozzáadódik a projekt gyökérkönyvtárához. A legtöbb sablon biztosítja a szükséges fájlokat azd és mappákat, és sokuk tartalmaz egy teljes, kódként használható infrastruktúrafájlt, amely Azure-erőforrásokat épít ki egy kiválasztott alkalmazásverem számára.

Ebben a példában a Starter - Bicep sablont fogja használni, amely tartalmazza egy azd sablon alapvető szerkezetét és néhány hasznos sablontáblát az első lépésekhez. A kezdősablonok nagyszerű választásnak számítanak, ha a megfelelő sablonstruktúrát szeretné felépíteni és erőforrásokat kezdeni, de mégis saját infrastruktúrafájlokat szeretne létrehozni.

  1. Ha egy meglévő mintaalkalmazással szeretné követni az előttünk álló lépéseket, klónozza a következő kezdőprojektet egy üres könyvtárba a számítógépen:

    git clone https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart

  2. A választott parancssori eszközben keresse meg a klónozott projekt gyökérkönyvtárát.

  3. A sablon inicializálásához futtassa a azd init parancsot azd .

    azd init

  4. Amikor a rendszer kéri, válassza a sablon kiválasztásának lehetőségét.

    Képernyőkép a sablonbeállítások kiválasztásáról.

  5. A sablonok listájában válassza a Starter – Bicep lehetőséget. Beírhatja a sablon nevét, vagy a billentyűzet nyílbillentyűivel megkeresheti.

  6. Amikor a rendszer kéri, adjon meg egy rövid környezetnevet, például a testenv nevet.

  7. A futtatás azd initután a rendszer a következő objektumokat adja hozzá az aktuális címtárhoz:

    ├── .azdo                                        [ Configures an Azure Pipeline ]
├── .devcontainer                                [ For DevContainer ]
├── .github                                      [ Configures a GitHub workflow ]
├── .vscode                                      [ VS Code workspace configurations ]
├── .azure                                       [ Stores Azure configurations and environment variables ]
├── infra                                        [ Contains infrastructure as code files ]
│   ├── main.bicep/main.tf                       [ Main infrastructure file ]
│   ├── main.parameters.json/main.tfvars.json    [ Parameters file ]
│   └── core/modules                             [ Contains reusable Bicep/Terraform modules ]
└── azure.yaml                                   [ Describes the app and type of Azure resources]

A Bicep-fájlok frissítése

A projekt most már tartalmazza egy sablon alapvető struktúráját és eszközeit azd . Az Azure-erőforrások adott projekthez való kiépítéséhez azonban frissíteni kell a infra mappában lévő Bicep-fájlokat. A mintaalkalmazás üzemeltetéséhez a következő erőforrásokat kell meghatároznia Bicep-fájlok használatával:

  • Egy Azure-alkalmazás szolgáltatáscsomag
  • Linuxon futó Azure-alkalmazás szolgáltatás

  1. Nyissa meg a fő projektkönyvtárat a választott szerkesztőben, például a Visual Studio Code-ban.

  2. Nyissa meg a main.bicep fájlt a mappában a infra szerkesztővel. Ez a fájl hasznos sablonkódot tartalmaz az alapvető változók, paraméterek és elnevezési konvenciók beállításához. Az 50. sorhoz beolvasott Add resources to be provisioned belowmegjegyzésblokk alatt adja hozzá a következő Bicep-et:

    // Creates an app service instance to host the app
module web './core/host/appservice.bicep' = {
  name: 'web'
  scope: rg
  params: {
    name: '${abbrs.webSitesAppService}web-${resourceToken}'
    location: location
    tags: union(tags, { 'azd-service-name': 'web' })
    appServicePlanId: appServicePlan.outputs.id
    runtimeName: 'python'
    runtimeVersion: '3.8'
    scmDoBuildDuringDeployment: true
  }
}

// Create an App Service Plan to group applications under the same payment plan and SKU
module appServicePlan './core/host/appserviceplan.bicep' = {
  name: 'appserviceplan'
  scope: rg
  params: {
    name: '${abbrs.webServerFarms}${resourceToken}'
    location: location
    tags: tags
    sku: {
      name: 'B1'
    }
  }
}

    Feljegyzés

    • A rendszer egyedi sztringet hoz létre az előfizetés azonosítója alapján, és változóként ${resourceToken} használja. Ez a jogkivonat hozzá van fűzve a program által létrehozott azdösszes Azure-erőforrás nevéhez.
    • azd Címkék használatával azonosítja az erőforrásokat, így a szervezet elnevezési konvenciójának megfelelően módosíthatja a neveket.
    • Az 'azd-service-name': 'web' app service címkéje az üzembehelyezési állomás azonosítására használt érték azd . Az értéknek meg kell egyeznie az azure.yaml fájlban a szolgáltatáshoz definiált értékkel.

Az azure.yaml fájl frissítése

Az alkalmazás azd üzembe helyezéséhez többet kell tudnia az alkalmazásról. A azure.yaml fájl a forráskód helyének, nyelvének és az Azure hosting szolgáltatásának meghatározására szolgál az alkalmazás minden egyes szolgáltatásához. A részletekért tekintse meg az azure.yaml sémát.

  1. Nyissa meg a azure.yaml projekt gyökerét.

  2. Adja hozzá a következő sorokat a fájl aljára:

    name: msdocs-python-flask-webapp-quickstart
services:
  web:
    project: .
    language: py
    host: appservice

A sablon kiépítése és üzembe helyezése

  1. Mentse az összes módosítást, és futtassa a következő parancsot az alkalmazáserőforrások Üzembe helyezéséhez és üzembe helyezéséhez az Azure-ban:

    azd up

  2. Amikor a parancs befejeződik, a parancs kimenetében található hivatkozásra kattintva lépjen az üzembe helyezett helyre.

A projekt mostantól kompatibilis az Azure Developer CLI-vel, és sablonként is használható.

Feljegyzés

azdEmellett támogatja a Buildpack használatát az alkalmazások alapértelmezett tárolóba való tárolásához. Ha a sablon az azd Azure Container Appst vagy az Azure Kubernetes Service-t célozza, de nem tartalmaz Docker-fájlt, azd automatikusan létrehoz egy rendszerképet a Buildpack használatával.