Udostępnij za pomocą

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

W tym artykule 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

Kategoria Wymaganie
Instalacja Rozszerzenie interfejsu wiersza polecenia platformy Azure dla środowisk wdrażania platformy Azure.
Procedura Ukończenie tworzenia i konfigurowania centrum deweloperskiego przy użyciu interfejsu wiersza polecenia platformy Azure.
Procedura Ukończenie tworzenia i konfigurowania projektu przy użyciu interfejsu wiersza polecenia platformy Azure.
Uprawnienia Aby utworzyć środowisko: rola użytkownika środowiska wdrażania , rola administratora projektu DevCenter lub wbudowana rola, która ma odpowiednie uprawnienia.

Tworzenie środowiska

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ą administratora projektu DevCenter lub wbudowaną rolą, która ma odpowiednie uprawnienia, mogą utworzyć środowisko. Użytkownicy mający rolę Czytelnik środowisk wdrażania mogą wyświetlać swoje środowiska oraz te utworzone przez innych.

  1. Zaloguj się do Azure CLI:

    az login

  2. Zainstaluj lub uaktualnij rozszerzenie Centrum deweloperów platformy Azure dla interfejsu wiersza polecenia:

    az extension add --name devcenter --upgrade

  3. Wyświetl listę wszystkich projektów środowiska 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 (szablonu infrastruktury jako 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 jakichkolwiek parametrów, użyj --parameters i podaj parametry 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

Możesz użyć --help, aby wyświetlić więcej szczegółów na temat dowolnego polecenia, przyjmowanych argumentów i przykładów. 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ę administratora 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.

Dostęp 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 określone w wynikach szablonu 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-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ść

  • Last updated on