ポータルのテンプレート ギャラリーをテンプレート スペックに変換する

  • [アーティクル]

Azure portal には、お使いのアカウントに Azure Resource Manager テンプレート (ARM テンプレート) を格納する方法が用意されています。 ただし、テンプレート スペックを使用すると、より簡単な方法で、テンプレートを組織内のユーザーと共有でき、他のテンプレートとリンクできます。 この記事では、テンプレート ギャラリーの既存のテンプレートをテンプレート スペックに変換する方法について説明します。

変換するテンプレートがあるかどうかを確認するには、ポータルでテンプレート ギャラリーを表示します。 これらのテンプレートのリソースの種類は Microsoft.Gallery/myareas/galleryitems です。

非推奨のポータル機能

ポータルのテンプレート ギャラリーは、2025 年 3 月 31 日に非推奨となります。 テンプレート ギャラリーでテンプレートを引き続き使用するには、テンプレート スペックに移行する必要があります。テンプレートを移行するには、この記事に示されている方法のいずれかを使用します。

PowerShell スクリプトを使用して変換する

テンプレート ギャラリー内のテンプレートの変換を簡略化するには、Azure クイックスタート テンプレート リポジトリから PowerShell スクリプトを使用します。 スクリプトを実行するときは、テンプレートごとに新しいテンプレート スペックを作成するか、テンプレート スペックを作成するテンプレートをダウンロードすることができます。このスクリプトでは、テンプレート ギャラリーからテンプレートは削除されません。

  1. 移行スクリプトをコピーします。 Migrate-GalleryItems.ps1 という名前でローカル コピーを保存します。

  2. 新しいテンプレート スペックを作成するには、-ResourceGroupName および -Location の各パラメーターの値を指定します。

    テンプレートをエクスポートするには、ItemsToExport を MyGalleryItems に設定します。 アクセスできるすべてのテンプレートをエクスポートするには、AllGalleryItems に設定します。

    次の例では、migratedRG という名前のリソース グループ内のテンプレートごとに新しいテンプレート スペックを作成します。 リソース グループが存在しない場合は、スクリプトによって作成されます。

    .\Migrate-GalleryItems.ps1 -ResourceGroupName migratedRG -Location westus2 -ItemsToExport MyGalleryItems

  3. テンプレート スペックの作成に使用できるテンプレートをダウンロードするには、リソース グループまたは場所の値を指定しないでください。 代わりに、-ExportToFile を指定します。 このテンプレートは、ギャラリーのテンプレートと同じではありません。 代わりに、テンプレートのテンプレート スペックを作成するテンプレート スペッ ク リソースが含まれています。

    次の例では、テンプレート スペックを作成せずにテンプレートをダウンロードします。

    .\Migrate-GalleryItems.ps1 -ItemsToExport MyGalleryItems -ExportToFile

    テンプレート スペックを作成するテンプレートをデプロイする方法については、「クイックスタート: テンプレート スペックの作成とデプロイ」を参照してください。

スクリプトとそのパラメーターの詳細については、「テンプレート ギャラリーのテンプレートから TemplateSpecs を作成する」を参照してください。

ポータルを使用して手動で変換する

ギャラリーから新しいテンプレート スペックにテンプレートを手動でコピーできます。

  1. ポータルで、[テンプレート (プレビュー)] を開きます。
  2. 移行するテンプレートを選択します。
  3. [テンプレートの表示] を選択します。
  4. テンプレートの内容をコピーします。
  5. ポータルの検索バーで、テンプレート スペックを検索します。 そのオプションを選択します。
  6. [Create template spec](テンプレート スペックの作成) を選択します。
  7. 名前、サブスクリプション、リソース グループ、場所、およびバージョンの値を入力します。
  8. Next:テンプレートの編集 を選択します。
  9. テンプレートの内容には、テンプレート ギャラリーからコピーしたテンプレートを貼り付けます。
  10. [確認および作成] を選択します。
  11. 検証が正常に完了したら、 [作成] を選択します。

テンプレート スペックを組織内の他のユーザーと共有する必要がある場合は、アクセス権が必要なグループやユーザーにロールベースのアクセス制御を設定します。

次のステップ

テンプレート スペックの詳細については、テンプレート スペックの作成とデプロイに関する記事を参照してください。