Azure CLI を使用して環境を作成してアクセスする

2025-04-12

この記事では、Azure CLI を使用して、既存の Azure Deployment Environments プロジェクトで環境を作成してアクセスする方法について説明します。

前提条件

カテゴリ	要件
取り付け	Azure Deployment Environments の Azure CLI 拡張機能。
プロシージャ	Azure CLI を使用したデベロッパーセンターの作成と構成の完了。
プロシージャ	Azure CLI を使用したプロジェクトの作成と構成の完了。
権限	環境を作成するには: Deployment Environments ユーザーロール、DevCenter プロジェクト管理者ロール、または適切なアクセス許可を持つ組み込みロール。

環境を作成する

環境を作成すると、必要なリソースと、それらを格納するためのリソースグループが自動的に作成されます。リソースグループ名は、{projectName}-{environmentName} のパターンに従います。 Azure portal でリソースグループを表示できます。

環境を作成し、リソースを構成するには Azure CLI で次の手順を完了します。特定の Azure Resource Manage テンプレート (ARM テンプレート) で定義されている出力を表示できます。

注

Deployment Environments ユーザーロール、DevCenter プロジェクト管理者ロール、または適切な権限を持つ組み込みロールを持つユーザーのみが環境を作成できます。展開環境閲覧者ロールを持つユーザーは、他のユーザーによって作成された独自の環境と環境を表示できます。

Azure CLI にサインインします。
```
az login
```
CLI 用の Azure デベロッパーセンター拡張機能をインストールまたはアップグレードします。
```
az extension add --name devcenter --upgrade
```
アクセス許可を持つすべての Azure Deployment Environments プロジェクトを一覧表示します。
```
az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects'" -o table
```
既定のサブスクリプションを、プロジェクトを含むサブスクリプションとして構成します。
```
az account set --subscription <subscriptionName>
```
既定のリソースグループを、プロジェクトを含むリソースグループとして構成します。
```
az config set defaults.group=<resourceGroupName>
```

特定のプロジェクトで作成できる環境の種類を一覧表示します。

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

次のように特定のプロジェクトで使用できる環境定義を一覧表示します。

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

使用可能な環境定義の一覧から、"environment-definition" (environment.yaml ファイルで定義されているコードとしてのインフラストラクチャテンプレート) を使用して環境を作成します。

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>

特定の "環境定義" に何らかのパラメーターが必要な場合は、を使用し、パラメーターを JSON 文字列または JSON ファイルとして指定します。--parameters 例えば次が挙げられます。

$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

注

コマンド、受け入れ可能な引数、例の詳細を表示するには、--help を使用します。たとえば、az devcenter dev environment create --help を使用して、環境の作成に関する詳細を表示します。

アクセス許可エラーのトラブルシューティング

Deployment Environments ユーザーロール、DevCenter プロジェクト管理者ロール、または環境を作成できる適切な権限を持つ組み込みロールが必要です。

正しいアクセス許可がない場合、環境は作成されません。次の例のようなエラーメッセージが表示される場合があります。

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

この問題を解決するには、適切なアクセス許可を割り当てます: 開発チームにアクセス権を付与する。

環境へのアクセス

環境にアクセスするには:

特定のプロジェクトで使用できる既存の環境を一覧表示します。

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

ARM テンプレートの出力で定義されているように、さまざまなリソースへのアクセスエンドポイントを表示します。
エンドポイントを使用して特定のリソースにアクセスします。

環境をデプロイする

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

環境を削除する

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

次の方法で共有