Azure Developer CLI-támogatás azure-beli üzembe helyezési környezetekhez

Az Azure Developer CLI (azd) támogatást nyújt Azure Deployment Environments. Az Azure Deployment Environment (ADE) az előre meghatározott előfizetésekben üzembe helyezett Azure-erőforrások előre konfigurált gyűjteménye. Az Azure-szabályozás azokra az előfizetésekre vonatkozik, amelyek a környezet típusa, például tesztkörnyezet, tesztelés, előkészítés vagy éles környezet alapján vannak alkalmazva. Az Azure Deployment Environments használatával vállalati biztonsági szabályzatokat kényszeríthet ki, és előre definiált infrastruktúra-sablonokat (IaC) biztosít.

Előfeltételek

Ha azure-beli üzembehelyezési környezeteket szeretne használni azd, ellenőrizze, hogy teljesítette-e a következő előfeltételeket:

Az Azure Deployment Environment támogatásának engedélyezése

A azd konfigurálhatja az erőforrások üzembehelyezési környezetekben való üzembe helyezésére és üzembe helyezésére szabványos parancsokkal, például azd up vagy azd provision. Az Azure Deployment Environments támogatásának engedélyezéséhez futtassa a következő parancsot:

azd config set platform.type devcenter

Ha platform.type be van állítva devcenter, az összes azd távoli környezet állapota és a kiépítés új fejlesztői központ-összetevőket használ. Ez a konfiguráció azt is jelenti, hogy a infra helyi sablonok mappája figyelmen kívül lesz hagyva. azd Ehelyett a fejlesztői központ katalógusában definiált infrastruktúrasablonok egyikét használja az erőforrás-kiépítéshez.

A fejlesztői központ támogatását a következő paranccsal is letilthatja:

azd config unset platform

Azure-beli üzembehelyezési környezetek használata

Ha a fejlesztői központ funkció engedélyezve van, egyes gyakori azd parancsok alapértelmezett viselkedése megváltozik, hogy működjön ezekkel a távoli környezetekkel. A fejlesztői központ funkció kibővül a standard azdtávoli környezet támogatásiáltal biztosított funkciókkal.

azd init

A azd init parancsélmény dev center módban az összes azd kompatibilis ADE-sablont megjeleníti a konfigurált katalógusból való kiválasztáshoz. Az init folyamat során, miután azd klónozza a sablonkódot, a azure.yaml fájl automatikusan frissül, hogy egy platform szakaszt tartalmazzon a kiválasztott sablon alapján kiválasztott konfigurációval. A konfiguráció tartalmazza a fejlesztői központ nevét, katalógusát és környezetdefinícióját.

azd init

azd up

A azd up parancscsomagok, az üzembe helyezés és az alkalmazás üzembe helyezése az Azure Deployment Environmentsben. A parancs kiépítési szakasza azd up azonban a távoli fejlesztői központban a válogatott infrastruktúra-kódsablonokat használja, míg az üzembe helyezési fázis a forráskódot telepíti a azd sablonban. Bár a fejlesztői központ mód engedélyezve van, figyelmen kívül hagyja a infra helyi azd sablon mappáját, azd és csak a fejlesztői központ sablonjaival épít ki erőforrásokat. A parancs a szükséges értékeket is kéri, például az Azure Deployment Environment-projektet vagy a környezet típusát.

azd up

azd sablonlista

A azd template list parancs az elérhető infrastruktúrasablonokat jeleníti meg a fejlesztői központ katalógusában, nem pedig az alapértelmezett AZD Awesome katalógusból származó sablonokat. katalógusok olyan válogatott és jóváhagyott infrastruktúra-mint-kód sablonokat biztosítanak, amellyel a fejlesztői csapatok környezeteket hozhatnak létre.

azd template list

Képernyőkép a frissített sablongyűjteményről.

azd rendelkezés

A azd provision parancs új fejlesztői központ-környezeteket hoz létre. A parancssor minden hiányzó értéket, például a környezet típusát vagy a projektet kéri. A parancs futtatásakor a társított infrastruktúrasablon használatával hozza létre a megfelelő Azure-erőforrásokat az adott környezethez. Bár a fejlesztői központ mód engedélyezve van, figyelmen kívül hagyja a infra helyi azd sablon mappáját, azd és csak a fejlesztői központ sablonjaival épít ki erőforrásokat.

azd provision

azd env list

A azd env list parancs ugyanazokat a környezeteket jeleníti meg, mint a fejlesztői portálon.

azd env list

Erőforrások címkézése azure-beli üzembehelyezési környezetekhez

azd azure-beli üzembehelyezési környezetek kiépítése a fejlesztői központ katalógusából származó válogatott sablonokra támaszkodik. A katalógus sablonjai címkéket rendelhetnek a kiépített Azure-erőforrásokhoz, hogy az alkalmazásszolgáltatásokat társíthassa a azure.yaml fájlban. Ha a sablonok nem rendelnek címkéket, a probléma kétféleképpen oldható meg:

  • A fejlesztői központ katalógusának rendszergazdájával együttműködve győződjön meg arról, hogy a kiépített Azure-erőforrások címkéket tartalmaznak a azure.yaml fájlban meghatározott szolgáltatásokhoz való társításához.

  • Címkék használata helyett adja meg a resourceName a azure.yaml fájlban:

    services:
    api:
        project: ./src/api
        host: containerapp
        language: js
        resourceName: sample-api-containerapp
    web:
        project: ./src/web
        host: containerapp
        language: js
        resourceName: sample-web-containerapp

Fejlesztői központ beállításainak konfigurálása

Több helyen is megadhat azd beállításokat a fejlesztői központokhoz. A beállítások ezekből a helyekről vannak kombinálva, hogy a konfigurációk végső készletét a következő sorrendben hozza létre:

  1. Környezeti változók
  2. Azd-környezet konfigurálása
  3. Projektkonfiguráció
  4. Felhasználói konfiguráció

azd automatikusan kérni fogja az ezekből a forrásokból hiányzó konfigurációs értékeket. Ezen konfigurációs beállítások mindegyikét a következő szakaszok ismertetik.

Környezeti változók

azd a következő környezeti változókat észleli és használja:

  • AZURE_DEVCENTER_NAME
  • AZURE_DEVCENTER_PROJECT
  • AZURE_DEVCENTER_CATALOG
  • AZURE_DEVCENTER_ENVIRONMENT_DEFINITION
  • AZURE_DEVCENTER_ENVIRONMENT_TYPE
  • AZURE_DEVCENTER_ENVIRONMENT_USER

Konfigurációk definiálása

Konfigurálja a fejlesztői központokat a azd környezeti hatókörben .azure/<env>/config.json fájlban:

{
    "platform": {
        "config": {
            "catalog": "SampleCatalog",
            "environmentDefinition": "Todo",
            "environmentType": "Dev",
            "name": "sample-devcenter",
            "Project": "SampleProject"
        }
    }
}

Projekt hatóköre

Konfigurálja a fejlesztői központokat a azd fájl platform csomópontjának azure.yaml projekthatókörében:

name: todo-nodejs-mongo-aca
metadata:
    template: todo-nodejs-mongo-aca@0.0.1-beta
platform:
    type: devcenter
    config:
        catalog: SampleCatalog
        environmentDefinition: Todo
        name: sample-devcenter
        project: SampleProject
services:
    api:
        project: ./src/api
        host: containerapp
        language: js
    web:
        project: ./src/web
        host: containerapp
        language: js

Felhasználói hatókör

Konfigurálja a fejlesztői központokat a ~/<user_profile>/.azd/config.json fájl felhasználói hatókörében:

{
    "platform": {
        "config": {
            "catalog": "SampleCatalog",
            "environmentDefinition": "Todo",
            "environmentType": "Dev",
            "name": "sample-devcenter",
            "Project": "SampleProject"
        }
    }
}
  • Last updated on