App Layering

ARM テンプレートのオーサリング

このセクションは、ARM テンプレートに精通しているユーザーを対象としています。App Layering Azure デプロイコネクタのオーサリングテンプレートに関する詳細情報を提供します。ARM テンプレートの一般的なオーサリング情報については、 Microsoft のマニュアルを参照してください

入力

すべてのデプロイタイプには、alという名前のオブジェクトという 1 つのパラメータが渡されます。このオブジェクトには、inputcontext 2 つのプロパティがあります。inputプロパティは各デプロイタイプに固有のオブジェクトで、そのプロパティはデプロイタイプによって変わります。contextプロパティは、すべてのデプロイタイプで同じです。App Layering タスク、アイテム (レイヤーまたはイメージテンプレート)、および現在のデプロイに関連するコネクタ構成に関するデータが含まれています。パラメータオブジェクトの詳細については、「 Azure Deployments テンプレートパラメータ」を参照してください。

各テンプレートは、次のようにalパラメータセクションでパラメータを宣言する必要があります。

{
    ...
    "parameters": {
        "al": {
            "type": "object"
        }
    },
    ...
}
<!--NeedCopy-->

テンプレートはより多くのパラメータを宣言できますが、パラメータはすべてデフォルト値でなければなりません。そうしないと、App Layering は彼らに価値を提供しません。これは、[utcNow] (https://learn.microsoft.com/en-us/azure/azure-resource-manager/templates/template-functions-date#utcnow) のように、パラメータのデフォルト値セクションでしか使用できない関数を使用する場合に便利です。

出力

すべての ARM テンプレートには出力があります。Azure Deployments コネクタを使用すると、テンプレート出力を使用して次のデプロイに情報を渡すことができます。また、一部のデフォルト動作をオーバーライドするためにも使用できます。

デプロイの出力は、al テンプレートパラメータinputプロパティを使用して次のデプロイに渡されます。

たとえば、 キャッシュディスクデプロイメントに次のような出力があるとします

{
    ...
    "outputs": {
        "generation": {
            "type": "string",
            "value": "[variables('generation')]"
        },
        "name": {
            "type": "string",
            "value": "[variables('name')]"
        },
    }
    ...
}
<!--NeedCopy-->

ブートイメージデプロイメントは次の入力を受け取ります

{
  "input":
  {
    "type": "BootImage",
    "source": {
        "generation": "V2",
        "name": "MyCoolDiskName"
    }
  },
  "context": {
    ...
  }
}
<!--NeedCopy-->

inputオブジェクトのsourceプロパティには、キャッシュディスクデプロイテンプレートで指定された各出力のプロパティがあることに注意してください 。各出力の生成元は、デプロイのタイプによって異なります。

デプロイタイプの詳細

デプロイの種類ごとに入出力のセットが異なり、App Layering 操作の動作が変わる可能性があります。これらのデプロイメント固有の詳細は、このセクションで説明されています。

これらすべての概念を使用する実際の例については、「 スターターテンプレート」を参照してください。

キャッシュディスク

キャッシュディスクデプロイメントでは、マネージドディスクリソースを作成する必要があります。オプションで、ディスクに加えて他のリソースを作成できます。App Layering アプライアンスには、SAS トークン(アプライアンスによって生成された)を使用してディスクに書き込む権限が必要です。App Layering 合成エンジンを含むブートイメージは、作成後にディスクにアップロードされます。

キャッシュディスク要件

  • 管理対象ディスクリソースを作成する必要があります
  • 管理ディスクのcreateOption"Upload"に設定する必要があります
  • 管理ディスクは、uploadSizeBytes"[parameters('al').input.uploadSize]"のように入力で指定されたuploadSizeに設定する必要があります。
  • App Layering アプライアンスは SAS トークンを使用して管理ディスクに書き込める必要があります
{
    ...
    "resources": [
        {
            "type": "Microsoft.Compute/disks",
            ...
            "properties": {
                ...
                "creationData": {
                    "createOption": "Upload",
                    "uploadSizeBytes": "[parameters('al').input.uploadSize]"
                }
                ...
            }
        }
    ]
    ...
}
<!--NeedCopy-->

キャッシュディスク入力

入力オブジェクトには、sizeおよびuploadSizeプロパティが含まれます。このオブジェクトには、別のデプロイメントからの出力は含まれません。

キャッシュディスク出力

デプロイの出力は、 ブートイメージデプロイメントが指定されている場合 、そのデプロイに渡されます。それ以外の場合は、 マシンデプロイメントに渡されます

diskIdという名前の出力を指定して、App Layering にどのディスクを使用するかを明示的に伝えることができます。diskId出力を指定しない場合、App Layering は自動的に出力を追加し、デプロイによって作成された最初の管理対象ディスクリソースのリソース ID に設定します。diskIdで指定されたディスクには、App Layering 合成エンジンのブートイメージがアップロードされています。

ブートイメージ

このデプロイでは、 キャッシュディスクデプロイによって作成された管理ディスクからリソースが作成されます 。作成するリソースの種類に関する厳しい要件はありません。ただし、仮想マシンの作成時に OS ディスクのソースとして使用できるリソース (コンピュートギャラリーのイメージバージョンなど) を作成する必要があります。

ブートイメージディスク要件

  • 入力として渡された ID のディスクと同じ内容の VM の OS ディスクを作成するために使用できるリソースを作成する必要があります。

例として、入力diskIdをソースとして使用するコンピュートギャラリーの画像バージョン:

{
    ...
    "resources": [
        {
            "type": "Microsoft.Compute/galleries/images/versions",
            ...
            "properties": {
                ...
                "storageProfile": {
                    "osDiskImage": {
                        "source": {
                            "id": "[parameters('al').input.source.diskId]"
                        }
                    }
                }
                ...
            }
        }
    ]
    ...
}
<!--NeedCopy-->

ブートイメージ入力

入力オブジェクトにはsourceプロパティが含まれます 。sourceは、キャッシュディスクデプロイメントの出力を表し 、各出力のプロパティが指定されています。作成するリソースのソースのdiskIdプロパティを使用してください。

ブートイメージ出力

ブートイメージデプロイの出力はマシンデプロイに渡されます 。特別な出力や必要な出力はありません。ただし、作成したリソースから VM を作成するために必要なデータ(リソース ID など)を含める必要があります。

マシン

マシンデプロイでは 、仮想マシンリソースを作成する必要があります。仮想マシンには、 コンポジットマシンのファイアウォールポート内部接続に従って、App Layering アプライアンスにアクセスできるネットワークに接続し、その逆も接続できるネットワークに接続する必要があります

重要:

キャッシュディスクのデプロイで作成されたディスクを仮想マシンに接続しないでくださいキャッシュディスクは共有リソースであり 、読み取り専用と見なされます。 ブートイメージデプロイメントを使用しない場合は 、ディスクのコピーを作成して代わりに添付してください。

マシン要件

  • 仮想マシンリソースを作成する必要があります
  • 仮想マシンは、App Layering アプライアンスとの通信が可能なネットワークに接続されている必要があります。
  • 仮想マシンの OS ディスクは、 **ブートイメージまたはキャッシュディスクリソースをソースとして使用して作成する必要があります** 。
  • 仮想マシンの OS ディスクサイズを"[parameters('al').input.disk.size]"に設定する必要があります
  • 仮想マシンのuserDataプロパティを"[parameters('al').input.vm.userData]"に設定する必要があります
{
    ...
    "resources": [
        {
            "type": "Microsoft.Compute/disks",
            "name": "[variables('diskName')]",
            ...
            "properties": {
                ...
                "creationData": {
                    "createOption": "Copy",
                    "sourceResourceId": "[parameters('al').input.disk.image.diskId]"
                },
                "diskSizeGB": "[parameters('al').input.disk.size]",
                ...
            }
        },
        {
            "type": "Microsoft.Compute/virtualMachines",
            ...
            "dependsOn": [
                "[resourceId('Microsoft.Compute/disks', variables('diskName'))]"
            ],
            ...
            "properties": {
                ...
                "storageProfile": {
                    "osDisk": {
                        ...
                        "createOption": "Attach",
                        "managedDisk": {
                            "id": "[resourceId('Microsoft.Compute/disks', variables('diskName'))]"
                        }
                    },
                    "dataDisks": []
                },
                ...
                "userData": "[parameters('al').input.vm.userData]"
                ...
            }
        }
    ]
    ...
}
<!--NeedCopy-->

マシン入力

入力オブジェクトには、diskおよびvmプロパティが含まれます。

disk.imageプロパティには、 ブートイメージデプロイメントからの出力が指定されている場合 、その出力が含まれます。それ以外の場合は、 キャッシュディスクデプロイメントの出力が含まれますdisk.sizeプロパティには、ディスクのサイズが GB 単位で格納されます。

vm.userDataプロパティには、作成した仮想マシンに割り当てる必要があるユーザーデータが含まれています。

マシン出力

マシン展開の出力はレイヤー化されたイメージ展開が指定されている場合 、その展開に渡されます。 Layered Image デプロイを使用している場合は、 Layered Image デプロイで参照できるように、出力に VM または OS ディスクの ID を含める必要があります。

machineIdという名前の出力を指定して、どの仮想マシンを使用するかをApp Layering に明示的に伝えることができます。machineId出力を指定しない場合、App Layering は自動的に出力を追加し、デプロイによって作成された最初の仮想マシンリソースのリソース ID に設定します。

ipAddressという名前の出力を指定して、マシンとの通信にどの IP アドレスを使用するかをApp Layering に明示的に伝えることができます。ipAddress出力を指定しない場合、App Layering は仮想マシンリソースに接続されたプライマリネットワークカードのプライマリプライベートアドレスを使用します。

messageという名前の出力を指定すると、App Layering UI のイメージ公開タスクの最終ステータスにメッセージを追加できます。このメッセージは、 Layered Image デプロイメントが指定されていない場合にのみ使用されます。

レイヤードイメージ

Layered Image デプロイでは、 仮想マシンまたはマシンデプロイによって作成された他のリソースからリソースを作成します 。作成するリソースの種類に関する厳しい要件はありません。ただし、マシン作成サービス(MCS)などのプロビジョニングサービスへの入力として使用できるリソースが作成されます。コンピュートギャラリーの画像リソースはその良い例です。

レイヤードイメージディスク要件

  • プロビジョニングサービスが仮想マシンを作成するために使用できるリソースを作成します。

例として、次のコードブロックは、入力diskIdをソースとして使用してコンピュートギャラリーの画像バージョンを作成します。これは、 マシンのデプロイに 、マシンのOSディスクのIDに設定されたdiskIdという名前の出力が含まれていることを前提としています。

{
    ...
"resources": [
        {
            "type": "Microsoft.Compute/galleries/images",
            "name": "[format('{0}/{1}', variables('galleryName'), variables('name'))]",
            ...
            "resources": [
                {
                    "type": "versions",
                    ...
                    "dependsOn": [
                        "[resourceId('Microsoft.Compute/galleries/images', variables('galleryName'), variables('name'))]"
                    ],
                    ...
                    "properties": {
                        ...
                        "storageProfile": {
                            "osDiskImage": {
                                "source": {
                                    "id": "[parameters('al').input.source.diskId]"
                                }
                            }
                        }
                        ...
                    }
                }
            ]
        }
    ],
    ...
}
<!--NeedCopy-->

レイヤード画像入力

入力オブジェクトには、sourceおよびdiskNameプロパティが含まれます。sourceは、 マシンデプロイメントの出力を表し 、各出力のプロパティが指定されています。diskNameプロパティは、App Layering イメージテンプレートで指定されたディスクの名前です。

レイヤードイメージ出力

デプロイメントの出力は、他のデプロイメントには渡されません。ただし、 message という名前の出力を指定すると、App Layering UI のイメージ公開タスクの最終ステータスにメッセージを追加できます。

ARM テンプレートのオーサリング