Přidání a konfigurace definice prostředí

Tento článek vysvětluje, jak přidat, aktualizovat nebo odstranit definici prostředí v katalogu prostředí nasazení Azure. Vysvětluje také, jak odkazovat na image kontejneru pro nasazení vašeho prostředí.

V prostředích nasazení použijete katalog , který vašim vývojovým týmům poskytne kurátorovanou sadu předdefinovaných šablon infrastruktury jako kódu (IaC), které se nazývají definice prostředí.

Definice prostředí se skládá z alespoň dvou souborů:

Šablona z architektury IaC. Například:
- Šablona Azure Resource Manageru (ARM) může používat soubor s názvem azuredeploy.json.
- Soubor Bicep může používat soubor s názvem main.bicep.
- Šablona Terraformu může používat soubor s názvem azuredeploy.tf.
Konfigurační soubor, který poskytuje metadata o šabloně. Tento soubor by měl mít název environment.yaml.

Vývojové týmy používají definice prostředí, které poskytujete v katalogu k nasazení prostředí v Azure.

Microsoft poskytuje ukázkový katalog , který můžete použít jako úložiště. Můžete také použít vlastní privátní úložiště nebo můžete vytvořit fork a přizpůsobit definice prostředí v ukázkovém katalogu.

Po přidání katalogu do vývojového centra služba zkontroluje zadanou cestu ke složce a identifikuje složky, které obsahují šablonu a přidružený soubor prostředí. Zadaná cesta ke složce by měla být složka obsahující podsložky, které obsahují definiční soubory prostředí.

Přidání definice prostředí

Pokud chcete přidat definici prostředí do katalogu v prostředích nasazení, nejprve přidáte soubory do úložiště. Pak synchronizujete katalog dev center s aktualizovaným úložištěm.

Přidání definice prostředí:

V úložišti GitHub nebo Azure DevOps vytvořte podsložku v cestě ke složce úložiště.

Přidejte do nové podsložky úložiště dva soubory:

Soubor šablony IaC.

Prostředí jako soubor YAML.

Soubor environment.yaml obsahuje metadata související se šablonou IaC.

Následující skript je příkladem obsahu souboru environment.yaml pro šablonu ARM:

    name: WebApp
    version: 1.0.0
    summary: Azure Web App Environment
    description: Deploys a web app in Azure without a datastore
    runner: ARM
    templatePath: azuredeploy.json

Tato tabulka popisuje pole v souboru environment.yaml:

Pole	Popis
`name`	Název definice prostředí.
`version`	Verze definice prostředí. Toto pole je volitelné.
`summary`	Stručný popis definice prostředí.
`description`	Podrobný popis definice prostředí.
`runner`	Architektura IaC, kterou šablona používá. Hodnota může být `ARM` nebo `Bicep`. Můžete také zadat cestu k imagi kontejneru uložené v registru kontejneru.
`templatePath`	Cesta k souboru šablony IaC.

Další informace o možnostech a datových typech, které můžete použít v souboru environment.yaml, najdete v tématu Parametry a datové typy v souboru environment.yaml.

Ve vývojovém centru v části Konfigurace prostředí vyberte Katalogy. Vyberte úložiště a pak vyberte Synchronizovat.

Služba prohledá úložiště a vyhledá nové definice prostředí. Po synchronizaci úložiště jsou nové definice prostředí dostupné pro všechny projekty v centru pro vývojáře.

Nasazení prostředí pomocí imagí kontejnerů

Prostředí nasazení používají image kontejnerů k definování způsobu nasazení šablon pro prostředí nasazení. Prostředí nasazení nativně podporují ARM a Bicep, takže můžete nakonfigurovat definici prostředí, která nasadí prostředky Azure pro prostředí nasazení přidáním souborů šablon (azuredeploy.json a environment.yaml) do katalogu. Prostředí nasazení pak k vytvoření prostředí nasazení použije standardní image kontejneru ARM nebo Bicep.

Pro pokročilejší nasazení prostředí můžete vytvořit vlastní image kontejneru. Můžete například spouštět skripty před nebo po nasazení. Prostředí pro nasazení podporují vlastní image kontejnerů pro nasazení, což může pomoci s nasazením frameworků IaC, jako jsou Pulumi a Terraform.

Abyste mohli začít, můžete získat ukázkové image kontejnerů ARM a Bicep prostřednictvím služby Microsoft Artifact Registry (označované také jako Microsoft Container Registry).

Další informace o vytvoření vlastní image kontejneru najdete v tématu Konfigurace image kontejneru pro spouštění nasazení.

Určete ukázkový obrázek kontejneru pro ARM nebo Bicep

Ve souboru environment.yaml určuje vlastnost runner umístění obrazu, který chcete použít. Pokud chcete použít ukázkovou image publikovanou v microsoft Artifact Registry, použijte runner hodnoty uvedené v následující tabulce.

Architektura IaC	`runner` hodnota
ARM	ARM
Bicepsový sval	Bicepsový sval
Terraformování	Žádný ukázkový obrázek. Místo toho použijte vlastní image kontejneru.

Následující příklad ukazuje runner vlastnost, která odkazuje na ukázkovou image kontejneru Bicep:

    name: WebApp
    version: 1.0.0
    summary: Azure Web App Environment
    description: Deploys a web app in Azure without a datastore
    runner: Bicep
    templatePath: azuredeploy.json

Určete vlastní obraz kontejneru

Pokud chcete použít vlastní image kontejneru uloženou v úložišti, použijte v souboru environment.yaml následující runner formát:

runner: "{YOUR_REGISTRY}.azurecr.io/{YOUR_REPOSITORY}:{YOUR_TAG}”`

Upravte hodnotu runner, aby odkazovala na vaše úložiště a vlastní obraz, jak je znázorněno v tomto příkladu:

    name: WebApp
    version: 1.0.0
    summary: Azure Web App Environment
    description: Deploys a web app in Azure without a datastore
    runner: "{YOUR_REGISTRY}.azurecr.io/{YOUR_REPOSITORY}:{YOUR_TAG}"
    templatePath: azuredeploy.json

Vlastnictví	Popis
YOUR_REGISTRY	Registr, který ukládá vlastní image.
TVŮJ_REPOSITÁŘ	Vaše úložiště v daném registru.
YOUR_TAG	Značka, například číslo verze.

Zadání parametrů pro definici prostředí

Můžete zadat parametry pro definice prostředí, aby vývojáři mohli přizpůsobit svá prostředí.

Parametry jsou definovány v souboru environment.yaml.

Následující skript je příkladem souboru environment.yaml pro šablonu ARM, která obsahuje dva parametry: location a name.

name: WebApp
summary: Azure Web App Environment
description: Deploys a web app in Azure without a datastore
runner: ARM
templatePath: azuredeploy.json
parameters:
- id: "location"
  name: "location"
  description: "Location to deploy the environment resources"
  default: "[resourceGroup().location]"
  type: "string"
  required: false
- id: "name"
  name: "name"
  description: "Name of the web app "
  default: ""
  type: "string"
  required: false

Další informace naleznete v tématu Parametry a datové typy v environment.yaml.

Vývojáři můžou zadat hodnoty pro konkrétní parametry pro svá prostředí prostřednictvím portálu pro vývojáře.

Snímek obrazovky s podoknem parametrů na portálu pro vývojáře

Vývojáři můžou také zadat hodnoty pro konkrétní parametry pro svá prostředí prostřednictvím Azure CLI:

az devcenter dev environment create --environment-definition-name
                                    --catalog-name
                                    --dev-center
                                    --environment-name
                                    --environment-type
                                    --project
                                    [--description]
                                    [--no-wait]
                                    [--parameters]
                                    [--tags]
                                    [--user]
                                    [--user-id]

Pro více informací o příkazu viz az devcenter dev environment createrozšíření Azure CLI devcenter.

Aktualizace definice prostředí

Pokud chcete upravit konfiguraci prostředků Azure v existující definici prostředí v prostředí nasazení, aktualizujte přidružený soubor šablony v úložišti. Změna se okamžitě projeví při vytváření nového prostředí pomocí konkrétní definice prostředí. Aktualizace se také použije při opětovném nasazení prostředí přidruženého k této definici prostředí.

Chcete-li aktualizovat všechna metadata související se šablonou, upravte soubor environment.yaml a pak aktualizujte katalog.

Odstranění definice prostředí

Pokud chcete odstranit definici prostředí, odstraňte v úložišti podsložku, která obsahuje soubor šablony a přidružený soubor environment.yaml. Pak katalog aktualizujte.

Po odstranění definice prostředí už ho vývojové týmy nemůžou použít k nasazení nového prostředí. Aktualizujte odkaz na definici prostředí pro všechna existující prostředí, která používají definici odstraněného prostředí. Pokud se odkaz neaktualizuje a prostředí je znovu nasazeno, nasazení se nezdaří.

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-07-30