Tworzenie środowiska i uzyskiwanie do tego dostępu przy użyciu interfejsu wiersza polecenia platformy Azure

  • Artykuł

W tym przewodniku wyjaśniono, jak utworzyć i uzyskać dostęp do środowiska w istniejącym projekcie środowiska wdrażania platformy Azure przy użyciu interfejsu wiersza polecenia platformy Azure.

Wymagania wstępne

Utwórz środowisko

Utworzenie środowiska automatycznie tworzy wymagane zasoby i grupę zasobów do ich przechowywania. Nazwa grupy zasobów jest zgodna ze wzorcem {projectName}-{environmentName}. Grupę zasobów można wyświetlić w witrynie Azure Portal.

Wykonaj poniższe kroki w interfejsie wiersza polecenia platformy Azure, aby utworzyć środowisko i skonfigurować zasoby. Dane wyjściowe można wyświetlić zgodnie z definicją w określonym szablonie usługi Azure Resource Manager (szablon usługi ARM).

Uwaga

Tylko użytkownicy z rolą użytkownika środowiska wdrażania, rolą projektu DevCenter Administracja lub wbudowaną rolą, która ma odpowiednie uprawnienia, mogą utworzyć środowisko. Użytkownicy, którzy mają rolę Czytelnik środowisk wdrażania, mogą wyświetlać własne środowiska i środowiska utworzone przez inne osoby.

  1. Zaloguj się do interfejsu wiersza polecenia platformy Azure:

    az login

  2. Zainstaluj rozszerzenie azure Centrum deweloperów dla interfejsu wiersza polecenia.

    az extension add --name devcenter --upgrade

  3. Wyświetl listę wszystkich projektów środowisk wdrażania platformy Azure, do których masz dostęp:

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

  4. Skonfiguruj domyślną subskrypcję jako subskrypcję zawierającą projekt:

    az account set --subscription <subscriptionName>

  5. Skonfiguruj domyślną grupę zasobów jako grupę zasobów zawierającą projekt:

    az config set defaults.group=<resourceGroupName>

  6. Wyświetl listę typów środowisk, które można utworzyć w określonym projekcie:

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

  7. Wyświetl listę definicji środowiska, które są dostępne dla określonego projektu:

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

  8. Utwórz środowisko przy użyciu definicji środowiska (infrastruktury jako szablonu kodu zdefiniowanego w pliku environment.yaml ) z listy dostępnych definicji środowiska:

    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>

    Jeśli określona definicja środowiska wymaga żadnych parametrów, użyj --parameters parametrów i podaj je jako ciąg JSON lub plik JSON. Na przykład:

    $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

Uwaga

Aby wyświetlić więcej szczegółów na temat dowolnego polecenia, zaakceptowanych argumentów i przykładów, możesz użyć --help polecenia . Na przykład użyj polecenia az devcenter dev environment create --help , aby wyświetlić więcej szczegółów dotyczących tworzenia środowiska.

Rozwiązywanie problemów z błędem uprawnień

Musisz mieć rolę użytkownika środowiska wdrażania, rolę Administracja projektu DevCenter lub wbudowaną rolę, która ma wymagane uprawnienia do tworzenia środowiska.

Jeśli nie masz odpowiednich uprawnień, środowisko nie zostanie utworzone. Może zostać wyświetlony komunikat o błędzie podobny do poniższego przykładu:

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

Aby rozwiązać ten problem, przypisz odpowiednie uprawnienia: Nadaj zespołowi programistycznemu dostęp.

Uzyskiwanie dostępu do środowiska

Aby uzyskać dostęp do środowiska:

  1. Wyświetl listę istniejących środowisk dostępnych w określonym projekcie:

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

  2. Wyświetl punkty końcowe dostępu do różnych zasobów zgodnie z definicją w danych wyjściowych szablonu usługi ARM.

  3. Uzyskaj dostęp do określonych zasobów przy użyciu punktów końcowych.

Wdrażanie środowiska

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

Usuwanie środowiska

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

Powiązana zawartość