October 23, 2026

Terraformでリンクを管理する

The RedirHub Terraform provider

RedirHub に公式のTerraform プロバイダーが登場しました。リダイレクト、ウェブサイト移行、短縮リンク、QRコード、ドメインを Git で管理し、プルリクエスト内のプランとしてすべての変更を確認し、CI から適用できます。

hclresource "redirhub_link" "old_domain" {
  handler       = "redirect"
  url           = "old-site.com"
  destinations  = ["https://new-site.com"]
  type          = "301"
  forward_path  = true
  forward_query = true
}

管理できるもの#

あらゆる種類のリンクを、1つのリソースで: redirhub_link は、ドメインのリダイレクト、ウェブサイト移行のマッピング、ブランド付き短縮リンク、QRコードを API と同じフィールドで扱います。リポジトリ内の CSV から migration を for_each で読み込めます。
ドメインとその DNS: redirhub_domain はドメインを接続し、必要な DNS レコードを返します。DNS プロバイダーの Terraform リソースですぐ使える状態です。redirhub_domain_verification は、ドメインが RedirHub を指すまで待機するため、新しいリンクはすでに応答しているドメインで公開されます。
すでに持っているリンク: id で任意のリンクを、hostname で任意のドメインをインポートできます。redirhub_links データソースは、domain、kind、tag ごとに id を一覧表示します。
ダッシュボードで行った変更が反映されます: 次の plan にそれらが表示されるため、ファイルの内容とずれることはありません。

再実行しても安全#

タイムアウトして再実行される CI ジョブでも、同じものが二重に作成されることはありません。すべての create には Idempotency-Key が付与され、API はすべての POST でそれを尊重するようになりました。同じキーを 24 時間以内に使うと、2つ目のリンクではなく最初のレスポンスが返ります。独自のスクリプトからもこのヘッダーを送信できます。

始める#

設定 → APIトークンで API トークンを作成し、Terraform と CI を使ってコードとしてリダイレクトを管理するに従ってください。これには、各プルリクエストで plan を投稿する GitHub Actions ワークフローが含まれます。プロバイダーは GitHub でオープンソースとして公開されています。Core、Pro、Enterprise で動作します。