マネージド ID を使用してアプリケーションを Microsoft Azure Service Fabric マネージドクラスターにデプロイする

[アーティクル]
10/15/2024

マネージド ID を持つ Service Fabric アプリケーションをデプロイするには、Azure Resource Manager からアプリケーションをデプロイする必要があり、通常は Azure Resource Manager テンプレートを使用します。 Service Fabric アプリケーションを Azure Resource Manager を介してデプロイする方法の詳細については、「Azure Resource Manager を使用してアプリケーションを管理対象クラスターにデプロイする」を参照してください。

Note

Azure リソースとしてデプロイされていないアプリケーションは、マネージド ID を持つことができません。

マネージド ID による Service Fabric アプリケーションのデプロイは、マネージドクラスターの API バージョン "2021-05-01" でサポートされています。

マネージドクラスターテンプレートのサンプルは、こちらの Service Fabric マネージドクラスターテンプレートで入手できます。

Service Fabric マネージドクラスターでのマネージド ID サポート

Service Fabric アプリケーションが Azure リソース用のマネージド ID で構成され、クラスターにデプロイされると、Service Fabric マネージドクラスターでマネージド ID トークンサービスの自動構成がトリガーされます。このサービスは、マネージド ID を使用して Service Fabric アプリケーションの認証を実行し、アクセストークンを代理で取得します。サービスが有効になると、Service Fabric Explorer の左側のウィンドウの [システム] セクションに表示され、fabric:/System/ManagedIdentityTokenService という名前で実行されます。

Note

マネージド ID を使用したアプリケーションのデプロイが初めて行われる場合は、クラスター構成の変更が自動的に行われるため、1 回のデプロイ時間が長くなると予想する必要があります。ゾーンクラスターの場合の 15 分から、ゾーンにまたがるクラスターの場合の 45 分までの時間を予想する必要があります。他に実行されているデプロイがある場合は、マネージド ID 構成は、それらのデプロイが先に完了するのを待機する必要があります。

アプリケーションリソースでは SystemAssigned および UserAssigned の両方の割り当てがサポートされ、割り当ては次のスニペットに示すように実行できます。

{
  "type": "Microsoft.ServiceFabric/managedclusters/applications",
  "apiVersion": "2021-05-01",
  "identity": {
    "type": "SystemAssigned",
    "userAssignedIdentities": {}
  },
}

完全な JSON リファレンス

ユーザー割り当て ID

ユーザー割り当て ID を持つアプリケーションを有効にするには、まず、userAssigned 型と参照されるユーザー割り当て ID でアプリケーションリソースに ID プロパティを追加します。次に、application リソースの properties セクション内に managedIdentities セクションを追加します。このセクションには、ユーザー割り当て ID ごとのフレンドリ名と principalId のマッピングの一覧が含まれます。ユーザー割り当て ID について詳しくは、ユーザー割り当てマネージド ID の作成、一覧表示、削除に関する記事をご覧ください。

アプリケーションテンプレート

ユーザー割り当て ID を持つアプリケーションを有効にするには、まず、userAssigned 型と参照されるユーザー割り当て ID でアプリケーションリソースに identity プロパティを追加し、次にユーザー割り当て ID ごとのフレンドリ名と principalId のマッピングの一覧を格納する managedIdentities オブジェクトを properties セクション内に追加します。

{
  "apiVersion": "2021-05-01",
  "type": "Microsoft.ServiceFabric/managedclusters/applications",
  "name": "[concat(parameters('clusterName'), '/', parameters('applicationName'))]",
  "location": "[resourceGroup().location]",
  "dependsOn": [
    "[parameters('applicationVersion')]",
    "[resourceId('Microsoft.ManagedIdentity/userAssignedIdentities/', parameters('userAssignedIdentityName'))]"
  ],
  "identity": {
    "type" : "userAssigned",
    "userAssignedIdentities": {
        "[resourceId('Microsoft.ManagedIdentity/userAssignedIdentities/', parameters('userAssignedIdentityName'))]": {}
    }
  },
  "properties": {
    "version": "[parameters('applicationVersion')]",
    "parameters": {
    },
    "managedIdentities": [
      {
        "name" : "[parameters('userAssignedIdentityName')]",
        "principalId" : "[reference(resourceId('Microsoft.ManagedIdentity/userAssignedIdentities/', parameters('userAssignedIdentityName')), '2018-11-30').principalId]"
      }
    ]
  }
}

上の例では、アプリケーションのマネージド ID のフレンドリ名として、ユーザー割り当て ID のリソース名が使用されています。次の例では、実際のフレンドリ名が "AdminUser" であるものとしています。

アプリケーションパッケージ

Azure Resource Manager テンプレートの managedIdentities セクションに定義されている ID ごとに、アプリケーションマニフェストの Principals セクションの下に <ManagedIdentity> タグを追加します。 Name 属性は、managedIdentities セクションに定義されている name プロパティと一致する必要があります。

ApplicationManifest.xml
```
  <Principals>
    <ManagedIdentities>
      <ManagedIdentity Name="AdminUser" />
    </ManagedIdentities>
  </Principals>
```
ServiceManifestImport セクションで、マネージド ID を使用するサービスに IdentityBindingPolicy を追加します。このポリシーによって、後でサービスマニフェストに追加する必要があるサービス固有の ID 名に AdminUser ID がマップされます。

ApplicationManifest.xml
```
  <ServiceManifestImport>
    <Policies>
      <IdentityBindingPolicy ServiceIdentityRef="WebAdmin" ApplicationIdentityRef="AdminUser" />
    </Policies>
  </ServiceManifestImport>
```
サービスマニフェストを更新して、Resources セクション内に、アプリケーションマニフェストの IdentityBindingPolicy 内の ServiceIdentityRef と一致する名前で ManagedIdentity を追加します。

ServiceManifest.xml
```
  <Resources>
    ...
    <ManagedIdentities DefaultIdentity="WebAdmin">
      <ManagedIdentity Name="WebAdmin" />
    </ManagedIdentities>
  </Resources>
```

システム割り当てマネージド ID

アプリケーションテンプレート

システム割り当てのマネージド ID を持つアプリケーションを有効にするには、以下の例に示すように、systemAssigned の種類で、identity プロパティをアプリケーションリソースに追加します。

    {
      "apiVersion": "2021-05-01",
      "type": "Microsoft.ServiceFabric/managedclusters/applications",
      "name": "[concat(parameters('clusterName'), '/', parameters('applicationName'))]",
      "location": "[resourceGroup().location]",
      "dependsOn": [
        "[concat('Microsoft.ServiceFabric/clusters/', parameters('clusterName'), '/applicationTypes/', parameters('applicationTypeName'), '/versions/', parameters('applicationTypeVersion'))]"
      ],
      "identity": {
        "type" : "systemAssigned"
      },
      "properties": {
        "typeName": "[parameters('applicationTypeName')]",
        "typeVersion": "[parameters('applicationTypeVersion')]",
        "parameters": {
        }
      }
    }

このプロパティは、Azure Resource Manager、および Managed Identity プロバイダーと Service Fabric Resource プロバイダーのそれぞれに対して、このリソースが暗黙的な (system assigned) マネージド ID を持つことを宣言します。

アプリケーションとサービスパッケージ

以下に示すように、アプリケーションマニフェストを更新して、1 つのエントリを含む ManagedIdentity 要素を Principals セクションに追加します。

ApplicationManifest.xml
```
<Principals>
  <ManagedIdentities>
    <ManagedIdentity Name="SystemAssigned" />
  </ManagedIdentities>
</Principals>
```
これにより、アプリケーションを構成するサービスへの今後の割り当てについては、リソースとしてアプリケーションに割り当てられた ID がフレンドリ名にマップされます。
以下に示すように、マネージド ID を割り当てるサービスに対応する ServiceManifestImport セクションに IdentityBindingPolicy 要素を追加します。

ApplicationManifest.xml
```
  <ServiceManifestImport>
    <Policies>
      <IdentityBindingPolicy ServiceIdentityRef="WebAdmin" ApplicationIdentityRef="SystemAssigned" />
    </Policies>
  </ServiceManifestImport>
```
この要素は、アプリケーションの ID をサービスに割り当てます。この割り当てがないと、サービスはアプリケーションの ID にアクセスできなくなります。上記のスニペットで、SystemAssigned ID (予約済みキーワード) は、フレンドリ名 WebAdmin でサービスの定義にマップされています。
サービスマニフェストを更新して、アプリケーションマニフェストの IdentityBindingPolicy 定義の ServiceIdentityRef 設定の値に一致する名前を使用して、ManagedIdentity 要素を Resources セクション内に追加します。

ServiceManifest.xml
```
  <Resources>
    ...
    <ManagedIdentities DefaultIdentity="WebAdmin">
      <ManagedIdentity Name="WebAdmin" />
    </ManagedIdentities>
  </Resources>
```
これは、前述の ID からサービスへのマッピングと同等ですが、サービス定義の観点からのものになります。 ID は、アプリケーションマニフェストで宣言されているように、ここではフレンドリ名 (WebAdmin) で参照されます。

次の方法で共有

マネージド ID を使用してアプリケーションを Microsoft Azure Service Fabric マネージドクラスターにデプロイする

Service Fabric マネージドクラスターでのマネージド ID サポート

ユーザー割り当て ID

アプリケーションテンプレート

アプリケーションパッケージ

システム割り当てマネージド ID

アプリケーションテンプレート

アプリケーションとサービスパッケージ

次のステップ

フィードバック

その他のリソース

次の方法で共有

マネージド ID を使用してアプリケーションを Microsoft Azure Service Fabric マネージド クラスターにデプロイする

Service Fabric マネージド クラスターでのマネージド ID サポート

ユーザー割り当て ID

アプリケーション テンプレート

アプリケーション パッケージ

システム割り当てマネージド ID

アプリケーション テンプレート

アプリケーションとサービス パッケージ

次のステップ

フィードバック

その他のリソース

マネージド ID を使用してアプリケーションを Microsoft Azure Service Fabric マネージドクラスターにデプロイする

Service Fabric マネージドクラスターでのマネージド ID サポート

アプリケーションテンプレート

アプリケーションパッケージ

アプリケーションテンプレート

アプリケーションとサービスパッケージ