「Terraform ProviderはGoだけ?」PHPで覗いてみた

Transcript

1. 「Terraform ProviderはGoだけ?」PHPで覗いてみた 2026/10/03 PHP カンファレンス愛媛2026 株式会社スリーシェイク / Fumiya Sakurai
2. 自己紹介 名前: Fumiya Sakurai / @fumiyan_e 所属: Sreake事業部 / Tech Branding Team 役割: SRE 出身地: 愛媛県松山市 2
3. 結論 で書いたproviderが terraform apply を通した PHP github.com/fumiya5863/terraform-provider-php 3
4. provider の役割 resource "aws_s3_bucket" と書いたとき、実際に AWS を叩いているのは Terraform 本体ではない terraform 計画を立てる provider → provider を叩く API → AWS / Datadog リソース は Terraform とは別のプログラム 4
5. Terraform の方針 "Go is currently the only programming language supported by HashiCorp for building Terraform providers." "...while it is technically possible to write providers in languages other than Go, our tooling, documentation, and ecosystem will all assume your provider is being written in and distributed as Go code for the time being." サポートする言語は Go だけ。ただし他の言語でも技術的には可能 出典: HashiCorp supported languages and libraries developer.hashicorp.com/terraform/plugin/best-practices/provider-code 5
6. で書くには、何が必要か PHP で起動 → ← 標準出力に1行 exec terraform terraform-provider-php PHP のプロセス gRPC over HTTP/2 → PHP の中では gRPC フレーム解析 → msgpack デコード → リソース操作 → エンコードして応答 6
7. provider Terraform は、ただの実行ファイル は provider を exec で起動する #!/usr/bin/env php <?php Go のバイナリである必要はない 7
8. 起動したら、標準出力に1行出すだけ 出すのはこの1行。 | 区切りの6フィールド 1|6|tcp|127.0.0.1:52341|grpc| 左から go-plugin のプロトコル版、Terraform のプラグインプロトコル版、ネットワーク種別、待ち受けアドレス、接続方式、証明書 証明書は base64。今回は空なので末尾が | で終わる 8
9. あとは gRPC でやりとりするだけ HTTP/2 の DATA フレームに、この形で載る バイトの圧縮フラグ ＋ 4バイトの長さ（ビッグエンディアン） ＋ protobuf 1 成否は trailer の grpc-status で返す 9
10. 値は msgpack で渡す リソースの値は、protobuf の上では ただの bytes message DynamicValue { bytes msgpack = 1; bytes json = 2; } 中身は msgpack。作ってみないと決まらない値（IDなど）を表せるのは msgpack だけ Terraform の型に合わせて、自分で組み立てる 10
11. 今回やらなかったこと AutoMTLS も OpenTofu も、既定で相互TLSを張る 今回は TF_DISABLE_PLUGIN_TLS=1 で切っている Terraform // This is not intended to be set by end-users. 11
12. まとまった仕様書は無い 公式に「Go以外でプラグインを書く方法」というガイドはある ガイド（全150行） TLS / cert / magic cookie という単語が 0件 ハンドシェイクの仕様 公式が「not currently documented」と明記 値の変換の規定 リポジトリの1ファイルだけ 読んだのは、散らばった公式のコードとドキュメント 12
13. まとめ Terraform provider の実体は、gRPC サーバーを立てる実行ファイルひとつ 中身を実装できれば、Go でなければならない理由は、無かった 覗いてみたら、手が届いた 13
14. ご清聴ありがとうございました
15. 参考文献 https://developer.hashicorp.com/terraform/plugin/best-practices/provider-code https://github.com/hashicorp/terraform/tree/main/docs/plugin-protocol https://github.com/hashicorp/terraform/blob/main/docs/plugin-protocol/object-wire-format.md https://github.com/hashicorp/terraform/blob/main/internal/command/meta_providers.go https://github.com/opentofu/opentofu/blob/main/internal/command/meta_providers.go https://github.com/hashicorp/go-plugin/blob/main/server.go https://github.com/hashicorp/go-plugin/blob/main/docs/guide-plugin-write-non-go.md https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md https://grpc.io/docs/languages/php/quickstart/ 15