2.4. サービスプリンシパルの作成

手順

1. 環境を登録します。

   Copy to Clipboard Toggle word wrap

   $ az cloud register -n AzureStackCloud --endpoint-resource-manager <endpoint> 

   1

   1

   Azure Resource Manager エンドポイント `https://management.<region>.<fqdn>/` を指定します。

   詳細は、Microsoft のドキュメント を参照してください。

2. アクティブな環境を設定します。

   Copy to Clipboard Toggle word wrap

   $ az cloud set -n AzureStackCloud

3. Azure Stack Hub に特定の API バージョンを使用するように、環境設定を更新します。

   Copy to Clipboard Toggle word wrap

   $ az cloud update --profile 2019-03-01-hybrid

4. Azure CLI にログインします。

   Copy to Clipboard Toggle word wrap

   $ az login

   マルチテナント環境の場合は、テナント ID も指定する必要があります。

5. Azure アカウントでサブスクリプションを使用している場合は、適切なサブスクリプションを使用していることを確認してください。

   1. 利用可能なアカウントの一覧を表示し、クラスターに使用するサブスクリプションの tenantId の値を記録します。

      Copy to Clipboard Toggle word wrap

      $ az account list --refresh

      出力例

      Copy to Clipboard Toggle word wrap

      [
        {
          "cloudName": AzureStackCloud",
          "id": "9bab1460-96d5-40b3-a78e-17b15e978a80",
          "isDefault": true,
          "name": "Subscription Name",
          "state": "Enabled",
          "tenantId": "6057c7e9-b3ae-489d-a54e-de3f6bf6a8ee",
          "user": {
            "name": "you@example.com",
            "type": "user"
          }
        }
      ]

   2. アクティブなアカウントの詳細を表示し、tenantId 値が使用するサブスクリプションと一致することを確認します。

      Copy to Clipboard Toggle word wrap

      $ az account show

      出力例

      Copy to Clipboard Toggle word wrap

      {
        "environmentName": AzureStackCloud",
        "id": "9bab1460-96d5-40b3-a78e-17b15e978a80",
        "isDefault": true,
        "name": "Subscription Name",
        "state": "Enabled",
        "tenantId": "6057c7e9-b3ae-489d-a54e-de3f6bf6a8ee", 

      1

      
        "user": {
          "name": "you@example.com",
          "type": "user"
        }
      }

      1

      tenantId パラメーターの値が正しいサブスクリプション ID であることを確認してください。

   3. 適切なサブスクリプションを使用していない場合には、アクティブなサブスクリプションを変更します。

      Copy to Clipboard Toggle word wrap

      $ az account set -s <subscription_id> 

      1

      1

      サブスクリプション ID を指定します。

   4. サブスクリプション ID の更新を確認します。

      Copy to Clipboard Toggle word wrap

      $ az account show

      出力例

      Copy to Clipboard Toggle word wrap

      {
        "environmentName": AzureStackCloud",
        "id": "33212d16-bdf6-45cb-b038-f6565b61edda",
        "isDefault": true,
        "name": "Subscription Name",
        "state": "Enabled",
        "tenantId": "8049c7e9-c3de-762d-a54e-dc3f6be6a7ee",
        "user": {
          "name": "you@example.com",
          "type": "user"
        }
      }

6. 出力から tenantId および id パラメーター値を記録します。OpenShift Container Platform のインストール時にこれらの値が必要になります。

7. アカウントのサービスプリンシパルを作成します。

   Copy to Clipboard Toggle word wrap

   $ az ad sp create-for-rbac --role Contributor --name <service_principal> \ 

   1

   
     --scopes /subscriptions/<subscription_id> 

   2

   
     --years <years> 

   3

   1

   サービスプリンシパル名を指定します。

   2

   サブスクリプション ID を指定します。

   3

   年数を指定します。デフォルトでは、サービスプリンシパルは 1 年で期限切れになります。--years オプションを使用すると、サービスプリンシパルの有効期間を延長できます。

   出力例

   Copy to Clipboard Toggle word wrap

   Creating 'Contributor' role assignment under scope '/subscriptions/<subscription_id>'
   The output includes credentials that you must protect. Be sure that you do not
   include these credentials in your code or check the credentials into your source
   control. For more information, see https://aka.ms/azadsp-cli
   {
     "appId": "ac461d78-bf4b-4387-ad16-7e32e328aec6",
     "displayName": <service_principal>",
     "password": "00000000-0000-0000-0000-000000000000",
     "tenantId": "8049c7e9-c3de-762d-a54e-dc3f6be6a7ee"
   }

8. 直前の出力の appId および password パラメーターの値を記録します。OpenShift Container Platform のインストール時にこれらの値が必要になります。