Terraform の概要 - Simple Log Service - Alibaba Cloud ドキュメントセンター

Terraform は、宣言的な設定ファイルを使用して Simple Log Service (SLS) のリソースを定義、プロビジョニング、管理するための、コードとしてのインフラストラクチャ (IaC) ツールです。コンソールで手動でリソースを作成する代わりに、Terraform を通じて SLS インフラストラクチャの設定をバージョン管理、再利用、共有できます。

中核となる概念

Terraform は、構成要素としてプロバイダーとモジュールを使用します。Alibaba Cloud は、SLS 関連のプロバイダーとモジュールを Terraform Registry で公開しています。

プロバイダー

プロバイダーは、クラウドプラットフォームの API と連携する Terraform のプラグインです。SLS リソースを管理するには、Alibaba Cloud プロバイダー (alicloud) を使用します。このプロバイダーは、SLS のプロジェクト、Logstore、マシングループ、Logtail 構成、ダッシュボード、アラート、およびその他のリソースの作成と管理をサポートしています。

モジュール

モジュールは、関連するリソースのセットをカプセル化した、再利用可能な Terraform 構成ファイルのパッケージです。モジュールを使用すると、SLS インフラストラクチャの設定を標準化し、チーム間で構成を共有できます。利用可能な SLS モジュールは Terraform Registry で参照できます。

ワークフロー

以下の手順では、Terraform を使用して SLS リソースを管理するための一般的なワークフローを説明します。

Terraform のインストール

ローカルマシンに Terraform コマンドラインインターフェイス (CLI) をインストールするか、ブラウザベースの環境として Terraform Explorer または Cloud Shell を使用します。詳細については、「Terraform のローカルへのインストールと設定」をご参照ください。
構成ファイルの作成

構成ファイル (例：main.tf) を作成し、作成したいプロバイダーと SLS リソースを定義します。次の例では、Alibaba Cloud プロバイダーを宣言し、SLS プロジェクトを作成します。
```
provider "alicloud" {
  region = "cn-hangzhou"
}

resource "alicloud_log_project" "example" {
  project_name = "my-sls-project"
  description  = "Terraform で管理される SLS プロジェクト"
}
```
作業ディレクトリの初期化

構成ファイルが含まれているディレクトリで terraform init を実行します。Terraform は、指定されたプロバイダープラグインをダウンロードし、作業ディレクトリを初期化します。
変更のプレビュー

現在の状態と構成を比較するために terraform plan を実行します。Terraform は、実際には変更を行わずに、実行するアクション (リソースの作成、変更、または破棄) を表示します。
変更の適用

計画された変更を実行するために terraform apply を実行します。Terraform は Alibaba Cloud API を呼び出して、指定された SLS リソースを作成または変更します。

前提条件

Terraform を使用して SLS リソースを管理する前に、以下の前提条件が満たされていることを確認してください。

SLS が有効化されていること。詳細については、「リソース管理の概要」をご参照ください。
Terraform ランタイム環境が準備できていること。以下のいずれかの方法で Terraform をセットアップできます。
- Terraform Explorer：Alibaba Cloud が提供するオンライン環境。インストールは不要です。簡単な実験やデバッグに適しています。
- Cloud Shell：Terraform がプリインストールされており、ID 認証情報が事前設定されています。Terraform に迅速かつ低コストでアクセスするのに適しています。
- Terraform のローカルへのインストールと設定：ネットワーク接続が制限されている場合や、カスタム開発環境が必要な場合に適しています。

サポートされている SLS リソース

Alibaba Cloud プロバイダーは、以下の SLS リソースをサポートしています。完全なリストと詳細なパラメーターリファレンスについては、Terraform Registry の Alibaba Cloud プロバイダーのドキュメントをご参照ください。

Terraform リソース	説明
`alicloud_log_project`	SLS プロジェクト。
`alicloud_log_store`	プロジェクト内の Logstore。
`alicloud_log_machine_group`	Logtail ログ収集用のマシングループ。
`alicloud_logtail_config`	ログ収集ルールを定義する Logtail 構成。
`alicloud_logtail_attachment`	Logtail 構成とマシングループのアタッチ。
`alicloud_log_alert`	SLS プロジェクトのアラートルール。
`alicloud_log_dashboard`	ログデータを可視化するためのダッシュボード。
`alicloud_log_audit`	ログ監査サービス (Log Audit Service) の構成。

Simple Log Service:Terraform の概要