Terraform プロバイダープラグイン
HashiCorp の Terraform でインフラストラクチャをプロビジョニングしていて、その一環として Transloadit もデプロイしたい場合は、Transloadit の Template を Terraform の管理下に置けます。これにより、アプリとともにエンコード設定も再現可能な形でプロビジョニングできます。
インストール
最新の Terraform CLI をインストールします。Terraform は、使用しているプラットフォーム用のプロバイダーパッケージを Registry から選択します。
作業ディレクトリを作成します。
mkdir -p transloadit-terraform
cd transloadit-terraform
そのディレクトリに、versions.tf を作成し、Transloadit の Registry プロバイダーの要件を指定します。
terraform {
required_providers {
transloadit = {
source = "transloadit/transloadit"
version = "~> 0.8.0"
}
}
}
この制約では、0.8 系列の互換性のあるパッチリリースが選択されます。以下の terraform init はプロバイダーをインストールし、選択されたバージョンを .terraform.lock.hcl に記録します。再現可能なインストールのため、このロックファイルを設定とともにコミットしてください。バージョンの選択とアップグレードについては、Terraform のプロバイダー要件を参照してください。
使い方
簡単な例を紹介します。詳細な手順は website ディレクトリにあります。Transloadit 内で複数のアプリを使用する場合は、サンプルを参照して、アプリごとにプロバイダーエイリアスを設定する方法を確認してください。
main.tf に以下を記述します。
provider "transloadit" {
auth_key = "<TRANSLOADIT-AUTH-KEY>"
auth_secret = "<TRANSLOADIT-AUTH-SECRET>"
}
resource "transloadit_template" "my-terraform-template" {
name = "my-terraform-template"
template = <<EOT
{
"steps": {
":original": {
"robot": "/upload/handle"
},
"encoded": {
"use": ":original",
"robot": "/video/encode",
"preset": "ipad-high",
"ffmpeg_stack": "v7"
},
"thumbed": {
"use": ":original",
"robot": "/video/thumbs",
"count": 4,
"ffmpeg_stack": "v7"
},
"exported": {
"use": [ ":original", "encoded", "thumbed"],
"credentials": "YOUR_S3_CREDENTIALS",
"robot": "/s3/store"
}
}
}
EOT
}
output "my-terraform-template-id" {
value = transloadit_template.my-terraform-template.id
}
同じディレクトリでプロバイダーを初期化し、変更内容をプレビューします。
terraform init
terraform plan
ドキュメント
ドキュメントの全文は GitHub を参照してください。