Vytvoření prostředí a přístup k němu pomocí Azure CLI

  • Článek

Tato příručka vysvětluje, jak vytvořit a získat přístup k prostředí v existujícím projektu prostředí nasazení Azure pomocí Azure CLI.

Požadavky

Vytvořit prostředí

Vytvoření prostředí automaticky vytvoří požadované prostředky a skupinu prostředků pro jejich uložení. Název skupiny prostředků se řídí vzorem {projectName}-{environmentName}. Skupinu prostředků můžete zobrazit na webu Azure Portal.

Provedením následujících kroků v Azure CLI vytvořte prostředí a nakonfigurujte prostředky. Výstupy můžete zobrazit podle definice v konkrétní šabloně Azure Resource Manageru (šablona ARM).

Poznámka:

Prostředí nasazení mohou vytvořit jenom uživatelé, kteří mají roli uživatele prostředí nasazení, roli Správa projektu DevCenter nebo předdefinované role s příslušnými oprávněními. Uživatelé, kteří mají roli Čtenář prostředí nasazení, můžou zobrazit vlastní prostředí a prostředí vytvořená jinými uživateli.

  1. Přihlaste se k Azure CLI:

    az login

  2. Nainstalujte rozšíření Azure Dev Center pro rozhraní příkazového řádku.

    az extension add --name devcenter --upgrade

  3. Vypíšete všechny projekty prostředí nasazení Azure, ke kterým máte přístup:

    az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects'" -o table

  4. Nakonfigurujte výchozí předplatné jako předplatné, které obsahuje projekt:

    az account set --subscription <subscriptionName>

  5. Nakonfigurujte výchozí skupinu prostředků jako skupinu prostředků, která obsahuje projekt:

    az config set defaults.group=<resourceGroupName>

  6. Uveďte typ prostředí, která můžete vytvořit v konkrétním projektu:

    az devcenter dev environment-type list --dev-center <devcenterName> --project-name <projectName> -o table

  7. Uveďte definice prostředí, které jsou k dispozici pro konkrétní projekt:

    az devcenter dev environment-definition list --dev-center <devcenterName> --project-name <projectName> -o table

  8. Vytvořte prostředí pomocí definice prostředí (infrastruktura jako šablona kódu definovaná v souboru environment.yaml ) ze seznamu dostupných definic prostředí:

    az devcenter dev environment create --dev-center-name <devcenterName>
    --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
    --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>

    Pokud konkrétní definice prostředí vyžaduje nějaké parametry, použijte --parameters a zadejte parametry jako řetězec JSON nebo soubor JSON. Příklad:

    $params = "{ 'name': 'firstMsi', 'location': 'northeurope' }"
az devcenter dev environment create --dev-center-name <devcenterName>
    --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
    --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>
    --parameters $params

Poznámka:

Můžete použít --help k zobrazení dalších podrobností o libovolném příkazu, akceptovaných argumentech a příkladech. Můžete az devcenter dev environment create --help například zobrazit další podrobnosti o vytváření prostředí.

Řešení chyby oprávnění

Musíte mít roli uživatele prostředí nasazení, roli Správa projektu DevCenter nebo předdefinované role, která má požadovaná oprávnění k vytvoření prostředí.

Pokud nemáte správná oprávnění, prostředí se nevytvořilo. Může se zobrazit chybová zpráva podobná následujícímu příkladu:

(EnvironmentNotFound) The environment resource was not found.
Code: EnvironmentNotFound
Message: The environment resource was not found.

Pokud chcete tento problém vyřešit, přiřaďte správná oprávnění: Udělení přístupu vývojovému týmu.

Přístup k prostředí

Přístup k prostředí:

  1. Uveďte existující prostředí, která jsou k dispozici v konkrétním projektu:

     az devcenter dev environment list --dev-center <devcenterName> --project-name <projectName>

  2. Prohlédněte si koncové body přístupu k různým prostředkům definovaným ve výstupech šablony ARM.

  3. Přístup ke konkrétním prostředkům pomocí koncových bodů

Nasazení prostředí

az devcenter dev environment deploy-action --action-id "deploy" --dev-center-name <devcenterName> \
    -g <resourceGroupName> --project-name <projectName> --environment-name <environmentName> --parameters <parametersJsonString>

Odstranění prostředí

az devcenter dev environment delete --dev-center-name <devcenterName>  --project-name <projectName> --environment-name <environmentName> --user-id "me"

Související obsah