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

[アーティクル]
11/29/2023

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

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

前提条件

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

プロジェクトの作成

デベロッパーセンターでプロジェクトを作成するには、次のようにします。

Azure CLI にサインインします。
```
az login
```
Azure CLI 開発センター 拡張機能をインストールします。
```
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)
echo $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)
echo $SUBID

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

プロジェクトを構成する

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

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

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

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

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

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

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

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

az devcenter admin project-environment-type create -n <availableEnvironmentType> \
--project <projectName> \
--identity-type "SystemAssigned" \
--roles "{\"${ROID}\":{}}" \
--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)
echo $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"

Note

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

次のステップ

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

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

Share via