Sdílet prostřednictvím


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

Tento článek 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

Kategorie Požadavek
Instalace rozšíření Azure CLI pro prostředí nasazení Azure.
Postup Dokončení Vytvoření a konfigurace vývojového centra pomocí azure CLI.
Postup Dokončení Vytvoření a konfigurace projektu pomocí azure CLI.
Dovolení Vytvoření prostředí: Role uživatele prostředí nasazení, role správce projektu DevCenter nebo předdefinovaná role, která má příslušná oprávnění.

Vytvoření 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ávce projektu DevCenter nebo předdefinované role, která má příslušná oprávnění. Uživatelé, kteří mají roli Čtenáře nasazovacích prostředí, můžou zobrazit vlastní prostředí a prostředí vytvořená ostatními uživateli.

  1. Přihlaste se k Azure CLI:

    az login
    
  2. Nainstalujte nebo upgradujte rozšíření Azure Dev Center pro rozhraní příkazového řádku:

    az extension add --name devcenter --upgrade
    
  3. Zobrazte seznam všech projektů 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. Zobrazte seznam definic 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í (šablona infrastruktury jako 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. Napří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:

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

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

Musíte mít roli uživatele prostředí nasazení , roli správce projektu DevCenter nebo předdefinovanou roli , 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ělit přístup 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ů

Nasaďte prostředí

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

Odstraňte prostředí

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