Azure Export for Terraform の概要

  • [アーティクル]

Azure Export for Terraform は、Azure と Terraform の概念間の翻訳の摩擦を軽減するために設計されたツールです。

メリット

Azure Export for Terraform を使用すると、次のことが可能になります。

  • Azure 上の Terraform への移行を簡略化します。 Azure Export for Terraform を使用すると、単一のコマンドで Azure リソースを Terraform に移行できます。
  • 単一のコマンドで、ユーザー指定のリソース セットを Terraform HCL コードと状態にエクスポートします。 Azure Export for Terraform を使用すると、事前に定義されたエキスポート範囲を指定できます。 範囲は、単一のリソースと同等にきめ細かくできます。 また、リソース グループとその入れ子になったリソースをエクスポートすることができます。 最後に、サブスクリプション全体をエクスポートできます。
  • 公開されているすべてのプロパティを使用して、既存のインフラストラクチャを検査します。 新しくリリースされたリソースを学習する場合も、運用環境で問題を調査する場合でも、Azure Export for Terraform では、構成可能なすべてのリソース プロパティを公開するオプションを含む読み取り専用エクスポートがサポートされます。
  • 計画/適用ワークフローに従って、Terraform 以外のインフラストラクチャを Terraform に統合します。 HCL コードをエクスポートし、Terraform 以外のリソースを検査し、運用インフラストラクチャとリモート バックエンドに簡単に統合します。

インストール

Azure Export for Terraform GitHub ページには、ツールのリリースと、さまざまなプラットフォーム (Windows MSI、Homebrew、Linux インストール) のインストールへのリンクとソース コードが一覧表示されます。

使用法

最も抽象的に言えば、Azure Export は次のように呼び出されます。

aztfexport [command] [option] <scope>

範囲は、使用可能なオプション フラグのセットと同様に、実行されているコマンドに応じて変わります。 エクスポートしようとしている内容に基づいて、次の 3 つのコマンドを使用する必要があります。

タスク 説明 例
単一のリソースをエクスポートします。 単一のリソースをエクスポートするには、リソースに関連付けられている Azure resourceID を指定します。 aztfexport resource [option] <resource id>
リソース グループをエクスポートします。 リソース グループ (およびその入れ子になったリソース) をエクスポートするには、リソース グループ名を指定します。ID ではありません。 aztfexport resource-group [option] <resource group name>
クエリを使用してエクスポートします。 このツールでは、Azure Resource Graph クエリを使用したエクスポートがサポートされています。 aztfexport query [option] <ARG where predicate>

データ収集の開示

既定では、Azure Export for Terraform はテレメトリ データを収集します。 ただし、このプロセスは簡単に無効にすることができます。

Microsoft は、使用パターンの特定、一般的な問題の特定、および Azure Export for Terraform のエクスペリエンスの向上を目的として、収集されたデータを集計します。 たとえば、使用状況データは、成功率が低いコマンドなどの問題を特定し、Microsoft による作業の優先順位を決めるのに役立ちます。 Azure Export for Terraform は、あらゆるプライベートデータや個人データを収集することはありません。

データ収集を無効にする場合は、ツールのインストール後に次のコマンドを実行します。

aztfexport config set telemetry_enabled false

次のステップ

概念:

Azure Export for Terraform の概念: Azure Export for Terraform のワークフローと、そのベスト プラクティスと現在の設計上の制限事項について説明します。

クイック スタートの記事:

ハウツー記事:

ハウツー記事では、より複雑なシナリオと説明とオプションについて説明します。