pulumi-arm-to-pulumi

概要pulumi-arm-to-pulumi

Azure ARM（Azure Resource Manager）テンプレート、Bicep、またはAzureコードをPulumiに変換または移行するための体系的なワークフローです。これには、既存のAzureリソースをPulumi管理環境にインポートすることも含まれます。 このスキルは、そのような移行、変換、またはインポートが要求されるたびに読み込まれることを想定しており、スキルが読み込まれる前にすでに作成されていた移行計画があれば、その要件に合わせて修正を行います。

成功基準は厳格です。すべてのARMリソースは、Pulumiプログラム内に含まれているか、レポート内で明示的にその理由が説明されている必要があります。 出力は構造的に有効であり、Pulumi プレビューが正常に実行できるものでなければなりません；また、既存リソースをインポートする場合、プレビューでは差分がゼロ（作成、更新、置換、削除がない）であることが求められ、差異がある場合は「プレビュー解決ワークフロー」を通じて解決される必要があります。 プルリクエストに適した正式な移行レポートが常に生成され、ARMからPulumiへのリソースのマッピング、プロバイダーの決定、動作上の違い、および手動手順が網羅されます。

ワークフローは順序通りに進行します。情報収集では、Azure 認証情報（ESC 環境と `az login` を使用）を検証し、jq を使用して ARM テンプレートを解析して、リソースタイプ、パラメータ、変数、`dependsOn` 配列、コピーループ、および条件分岐を抽出します。オプションで、`az resource list` および `show` を使用してリソースインベントリを構築します。 自動化されたARMコンバーターが存在しないため、コードの変換は手動で行われます。デフォルトではazure-nativeプロバイダーが使用され、フォールバックとしてclassic azureプロバイダーが使用されます。これにより、ユーザーが選択した言語で、すべての条件分岐、ループ、および依存関係が保持されます。 オプションのリソースインポートでは、予測可能なサブスクリプション、リソースグループ、プロバイダーのパスに従った Azure リソース ID を使用して、インラインの import resource オプションを利用し、差分がゼロであることを検証します。 最後に、スタック構成は ARM パラメータに合わせて設定されます。関連ドキュメントである `arm-conversion-patterns.md` および `arm-import.md` には、詳細なマッピングパターン、インポート手順、および差分ゼロのデバッグ手順が記載されています。

よくある質問

ARM テンプレートを変換する自動化ツールはありますか？

いいえ。このスキルでは、ARM から Pulumi への変換には手動での変換が必要であり、参照パターンがマッピングの指針となるものの、変換の全工程はユーザー自身の責任で行っていただく必要があります。

どの Pulumi プロバイダーを使用すべきですか？

Azure Resource Manager API を完全にカバーするには、デフォルトで @pulumi/azure-native を使用し、azure-native に機能が不足している場合や、よりシンプルな抽象化が必要な場合は、従来の @pulumi/azure プロバイダーに切り替えてください。

「差分なしのインポート検証」とはどういう意味ですか？

既存のリソースをインポートした後、pulumiのプレビュー画面には「作成」「更新」「置換」「削除」が一切表示されない必要があります。差異がある場合は、arm-import.mdに記載されている「プレビュー解決ワークフロー」によって解決されます。

Azureの認証情報はどのように設定しますか？

資格情報を提供する ESC 環境を通じて、`pulumi env run` に `az login`（サービスプリンシパルおよびフェデレーショントークン）を指定して実行し、`az account show` で確認します。環境が指定されていない場合、スキルは使用する ESC 環境を尋ねます。

移行の完了時には何が提供されますか？

プルリクエストに適した正式な移行レポートが提供されます。これには、ARMからPulumiへのリソースのマッピング、プロバイダーの決定事項、動作上の相違点、欠落している手順や手動で実行する必要がある手順、および検証手順が含まれます。

すべてのファイル