Azure CLI を使用してプロジェクトを作成して構成する

2025-04-18

このクイックスタートでは、Azure デプロイ環境でプロジェクトを作成します。次に、「 Azure CLI を使用してデベロッパーセンターを作成して構成する」で作成したデベロッパーセンターにプロジェクトを関連付けます。

プラットフォームエンジニアリングチームは通常、プロジェクトを作成し、開発チームへのプロジェクトアクセスを提供します。その後、開発チームは、環境定義を使用して環境を作成し、個々のリソースに接続してアプリケーションをデプロイします。

前提条件

カテゴリ	要件
サブスクリプション	アクティブなサブスクリプションを持つ Azure アカウント。無料でアカウントを作成できます。
アクセス許可	サブスクリプション内のリソースを作成および管理するためのアクセス許可を使用した Azure ロールベースのアクセス制御 (共同作成者や所有者など)。
リソース	- デベロッパーセンター。

プロジェクトを作成する

デベロッパーセンターでプロジェクトを作成するには:

Azure CLI にサインインします。
```
az login
```
Azure CLI Devcenter 拡張機能をインストールします。
```
az extension add --name devcenter --upgrade
```
既定のサブスクリプションを、デベロッパーセンターが存在するサブスクリプションとして構成します。
```
az account set --subscription <subscriptionName>
```
既定のリソースグループを、デベロッパーセンターが存在するリソースグループとして構成します。
```
az configure --defaults group=<resourceGroupName>
```
デベロッパーセンターが存在する場所として既定の場所を構成します。プロジェクトの場所は、デベロッパーセンターの場所と一致している必要があります。
```
az configure --defaults ___location=eastus
```

デベロッパーセンターのリソース ID を取得します。

$DEVCID = az devcenter admin devcenter show -n <devcenterName> --query id -o tsv
Write-Output $DEVCID

デベロッパーセンターでプロジェクトを作成します。

az devcenter admin project create -n <projectName> `
--description "My first project." `
--dev-center-id $DEVCID

プロジェクトが正常に作成されたことを確認します。
```
az devcenter admin project show -n <projectName>
```

マネージド ID に所有者ロールを割り当てる

環境の種類を作成する前に、デベロッパーセンターを表すマネージド ID に、プロジェクト環境の種類を構成するサブスクリプションへのアクセス権を付与する必要があります。

このクイックスタートでは、以前に構成したシステム割り当てマネージド ID に「所有者」ロールを割り当てます。次に、システム割り当てマネージド ID をアタッチします。

サブスクリプション ID を取得します。

$SUBID = az account show --name <subscriptionName> --query id -o tsv
Write-Output $SUBID

デベロッパーセンターリソースの名前を使用して、デベロッパーセンターのアイデンティティのオブジェクトIDを取得します。
```
$OID = az ad sp list --display-name <devcenterName> --query [].id -o tsv
Write-Output $OID
```
サブスクリプションの開発センターにオーナーの役割を割り当てます。
```
az role assignment create --assignee $OID `
--role "Owner" `
--scope "/subscriptions/$SUBID"
```

プロジェクトを構成する

プロジェクトを構成するには、プロジェクト環境の種類を追加します。

サブスクリプションの所有者のロール ID を取得します。

# Remove the group default scope for next the command. 
az configure --defaults group=

$ROID = az role definition list -n "Owner" --scope /subscriptions/$SUBID --query [].name -o tsv
Write-Output $ROID

# Set the default resource group again.
az configure --defaults group=<resourceGroupName>

プロジェクトで許可されている環境の種類を表示します。

az devcenter admin project-allowed-environment-type list --project <projectName> --query [].name

環境の種類を選択し、プロジェクト用に作成します。

$roles = "{`"$($ROID)`":{}}"
az devcenter admin project-environment-type create `
    -n <availableEnvironmentType> `
    --project <projectName> `
    --identity-type "SystemAssigned" `
    --roles $roles `
    --deployment-target-id "/subscriptions/$SUBID" `
    --status Enabled

注

デプロイ ID として少なくとも 1 つの ID (システム割り当てまたはユーザー割り当て) を有効にする必要があります。 ID は、開発者に代わって環境のデプロイを実行するために使用されます。さらに、デベロッパーセンターにアタッチされている ID には、環境の種類ごとにデプロイサブスクリプションにアクセスするための所有者ロールが割り当てられている必要があります。

環境アクセスの割り当て

このクイックスタートでは、自分の ID にアクセス権を付与します。必要に応じて、次のコマンドの --assignee の値を別のメンバーのオブジェクト ID に置き換えることができます。

独自のオブジェクト ID を取得します。

$MYOID = az ad signed-in-user show --query id -o tsv
Write-Output $MYOID

管理者アクセス権を割り当てる:

az role assignment create --assignee $MYOID `
--role "DevCenter Project Admin" `
--scope "/subscriptions/$SUBID"

必要に応じて、開発環境ユーザーロールを割り当てることができます。

az role assignment create --assignee $MYOID `
--role "Deployment Environments User" `
--scope "/subscriptions/$SUBID"

注

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

次のステップ

このクイックスタートでは、プロジェクトを作成し、開発チームへのプロジェクトアクセスを許可しました。開発チームメンバーが環境を作成する方法については、次のクイックスタートに進んでください。

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