Share via

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

  • [アーティクル]

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

前提条件

環境の作成

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

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

Note

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

  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 <devcenterName> --project-name <projectName> -o table

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

    az devcenter dev environment-definition list --dev-center <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

Note

コマンド、受け入れ可能な引数、および例の詳細を表示するには、--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.

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

環境へのアクセス

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

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

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

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

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

環境をデプロイする

az devcenter dev environment deploy-action --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"

関連するコンテンツ