Sdílet prostřednictvím

Práce s prostředími Azure Developer CLI

Azure Developer CLI (azd) pomáhá vytvářet a spravovat prostředí s vlastními konfiguracemi, jako jsou vývoj, testování a prod. Tento článek ukazuje, jak vytvářet a spravovat prostředí a jak je používat se soubory infrastruktury Bicep.

Vytvoření prostředí

Pomocí příkazu vytvořte nové prostředí azd env new :

azd env new <environment-name>

Pokud například chcete vytvořit vývojové prostředí:

azd env new dev

Když spustíte příkaz, například azd up nebo azd deploy, azd zobrazí výzvu k výběru předplatného Azure a umístění pro nové prostředí. Nastavení výzvy se uloží do nového prostředí .env nebo config.json souborů.

Předplatné a umístění můžete také zadat přímo v příkazu:

azd env new prod --subscription "My Production Subscription" --location eastus2

Seznam prostředí

Pokud chcete zobrazit všechna dostupná prostředí pro váš projekt, použijte:

azd env list

Tento příkaz zobrazí všechna prostředí, která jste vytvořili, a zvýrazní aktuální aktivní prostředí:

NAME      DEFAULT   LOCAL     REMOTE
dev       true      true      false
test      false     true      false
prod      false     true      false

Přepínání mezi prostředími

Pokud chcete přepnout do jiného prostředí, použijte příkaz azd env select :

azd env select <environment-name>

Pokud chcete například přepnout do produkčního prostředí:

azd env select prod

Poznámka:

Tento příkaz změní aktivní prostředí, což má vliv na následující azd příkazy, například provision nebo deploy.

Vysvětlení výchozího prostředí

Globální konfigurační soubor .azure/config.json sleduje aktuálně vybrané prostředí. Při spuštění azd init a neexistují žádná prostředí, azd automaticky vytvoří první prostředí a nastaví ho jako výchozí. Pokud už máte jedno nebo více prostředí a spustíte azd env new <name>, zobrazí se výzva, abyste zvolili, azd jestli chcete nové prostředí nastavit jako výchozí. Pokud odmítnete, vytvoří se nové prostředí, ale váš aktuální výběr zůstane beze změny.

Výchozí prostředí pro jeden příkaz můžete dočasně přepsat pomocí příznaku --environment . Použití tohoto příznaku nezmění výchozí nastavení pro budoucí příkazy.

Aktualizace nastavení prostředí

Pomocí příkazu můžete aktualizovat místní proměnné azd env refresh prostředí. Tento příkaz vyhledá nejnovější nasazení Azure pro vaši aplikaci, načte hodnoty proměnných prostředí podle názvu a pak aktualizuje místní .env soubor s těmito nejnovějšími hodnotami pro vybrané prostředí. Pokud jste například zřídili verzi dev i prod verzi a aktuálně máte dev vybrané prostředí, načte z tohoto nasazení nejnovější výstup, který naplní soubor .env.

azd env refresh

Poznámka:

Příkaz azd env refresh znovu nasadí prostředky. Aktualizuje pouze konfiguraci místního prostředí tak, aby odpovídala aktuálnímu stavu v Azure.

Aktualizace prostředí je užitečná v následujících případech:

  • Chcete zajistit, aby místní .env soubor odrážel nejnovější výstupy z vaší infrastruktury (jako jsou připojovací řetězce, koncové body atd.).
  • Po aktualizaci prostředí potřebujete synchronizovat proměnné prostředí.

Pokud jiní členové týmu provedli změny konfigurace prostředí nebo pokud jste provedli změny prostřednictvím webu Azure Portal, můžete nastavení místního prostředí aktualizovat takto:

Spouštění příkazů v konkrétních prostředích

V konkrétním prostředí můžete spouštět mnoho azd příkazů beze změny aktivního prostředí pomocí příznaku --environment-e :

azd up --environment dev

Tento příkaz spustí up pracovní postup (zřízení a nasazení) v dev prostředí beze změny aktivního prostředí.

Případně můžete napřed přepnout do zamýšleného prostředí:

azd env select test
azd up

Poznámka:

Týmy by měly zvážit použití kanálů CICD prostřednictvím azd pipeline config příkazu místo přímého nasazení pomocí příkazů, jako azd up jsou například nebo azd provision.

Odstranění prostředků prostředí

Pokud chcete odstranit prostředky Azure pro konkrétní prostředí, použijte tento azd down příkaz:

azd down <environment-name>

Poznámka:

V současné době není možné prostředí odstranit ani přejmenovat azd přímo pomocí příkazů. Pokud potřebujete prostředí přejmenovat:

  • Slouží azd down k odstranění prostředků prostředí.
  • Spuštěním azd env new <new-name> vytvořte nové prostředí.
  • Ručně odstraňte starou .env složku ze .azuresložky .

Použití názvu prostředí v souborech infrastruktury

Proměnnou AZURE_ENV_NAME ze souboru prostředí .env můžete použít k přizpůsobení nasazení infrastruktury v Bicep. To je užitečné pro pojmenování, označování nebo konfiguraci prostředků na základě aktuálního prostředí.

Poznámka:

Další informace o použití proměnných prostředí ke konfiguraci projektů Azure Developer CLI najdete v tématu Práce s proměnnými prostředí .

  1. azd nastaví proměnnou AZURE_ENV_NAME prostředí při inicializaci projektu.

    AZURE_ENV_NAME=dev

  2. main.parameters.json V souboru odkazujte na proměnnou prostředí, takže azd nahradí její hodnotu:

    {
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "environmentName": {
      "value": "${AZURE_ENV_NAME}"
    }
  }
}

    Při nasazení s azdhodnotou z .env souboru Bicep se předá hodnota z souboru Bicep .main.parameters.json

  3. V šabloně Bicep definujte parametr pro název prostředí:

    param environmentName string

  4. Pomocí parametru environmentName můžete označit prostředky, což usnadňuje identifikaci prostředí, ke kterému prostředek patří:

    param environmentName string

resource storageAccount 'Microsoft.Storage/storageAccounts@2022-09-01' = {
  name: 'mystorage${uniqueString(resourceGroup().id)}'
  location: resourceGroup().location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  tags: {
    Environment: environmentName
    Project: 'myproject'
  }
}

Tento přístup pomáhá se správou prostředků, sledováním nákladů a automatizací tím, že jednotlivé prostředky přidružuje k jeho prostředí nasazení.

Další kroky

Správa proměnných prostředí v Azure Developer CLI

Přizpůsobení pracovních postupů Azure Developer CLI pomocí hooků

  • Last updated on