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

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

前提条件

環境を作成する

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

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

1. Azure CLI にサインインします。

   az login
   

2. CLI 用の Azure デベロッパー センター拡張機能をインストールまたはアップグレードします。

   az extension add --name devcenter --upgrade
   

3. アクセス許可を持つすべての Azure Deployment Environments プロジェクトを一覧表示します。

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

4. 既定のサブスクリプションを、プロジェクトを含むサブスクリプションとして構成します。

   az account set --subscription <subscriptionName>
   

5. 既定のリソース グループを、プロジェクトを含むリソース グループとして構成します。

   az config set defaults.group=<resourceGroupName>
   

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

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

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

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

8. 環境定義は、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>
   

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

   $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
   

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

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

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

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

問題を解決するには、適切なアクセス許可を割り当てます。 開発チームへのアクセス権の付与を参照してください。

環境へのアクセス

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

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

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

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

3. エンドポイントを使用して特定のリソースにアクセスします。

環境をデプロイする

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"

関連コンテンツ

• GitHub または Azure DevOps からカタログを追加して構成する
• 環境定義を構成して追加する