平素よりさくらのクラウドをご利用いただき、誠にありがとうございます。
このたび、さくらのクラウド向け Terraform プロバイダーの新メジャーバージョンである terraform-provider-sakura v3 を正式リリースしました。
本リリースにより、より将来を見据えた Terraform によるインフラ構成管理が可能になります。
terraform-provider-sakura v3 の正式リリースについて
terraform-provider-sakura v3 は、さくらのクラウド上のリソースを Terraform で操作・管理するための Terraform プロバイダーの新しいメジャーバージョンです。
従来の v2 系列では Terraform Plugin SDK v2 を用いて開発を行ってきましたが、Terraformの開発者向けドキュメントでは、今後のプロバイダー開発において Terraform Plugin Framework の利用が推奨されています。
Terraform Plugin Framework は、より拡張性の高い設計となっており、将来的な機能追加や改善を行いやすい点が特長です。
terraform-provider-sakura v3 では、この Terraform Plugin Framework を採用し、今後の機能拡充や改善を継続的に進めていくための新たな基盤として設計しています。
なお、正式リリース時点では、v2 に存在していたすべてのリソースを網羅することを目標としておらず、今後も必要に応じて随時リソース追加を進めてまいります。
v2 と v3 の共存・移行について
Terraform プロバイダー v2 は、当面の間、v3 と 並行して提供されます。
既存の v2 を利用して管理しているリソースは、引き続き v2 のまま利用可能であり、すぐに v3 へ移行する必要はありません。
また、v2 と v3 は Terraform Registry 上でそれぞれ別のプロバイダーとして公開されているため、従来 v2 で管理していた構成を維持したまま、新たに利用したいリソースのみ v3 を用いるといった段階的な利用も可能です。既存の v2 利用者が意図せず v3 へ更新されることはありません。
一方で、Terraform プロバイダー v3 では、一部のリソースにおいて Terraform 設定ファイル（.tf ファイル）の記法が v2 と異なる場合があります。
そのため、v2 から v3 へ移行する際には、対象となるリソースについて Terraform 設定ファイルの修正が必要となる場合があります。
v3 の正式リリース後も、v2 はメンテナンスを中心としたサポートを継続し、必要と判断されるリソースについては、引き続き v2 へのバックポートを行っていきます。
あわせて、v3 への移行を検討されている利用者向けに、マイグレーションガイドの提供をはじめとした、段階的な移行を支援するための情報整備も進めていく予定です。
今後の開発方針について
Terraform プロバイダー v3 では、正式リリース時点ではまだ v2 にのみ対応しているリソースが一部存在します。
現在、v2 のみで提供されているリソースは以下のとおりです。
・archive_share
・auto_backup
・auto_scale
・cdrom
・certificate_authority
・enhanced_db
・esme
・ipv4_ptr
・load_balancer
・mobile_gateway
・sim
・webaccel
・webaccel_activation
・webaccel_acl
・webaccel_certificate
これらのリソースについては、利用状況や優先度を踏まえながら、今後、順次 v3 への移植を進めていく予定です。
最新の移行状況については Terraform プロバイダー v3 のリポジトリのREADMEファイルを参照してください。
今後は Terraform プロバイダー v3 を開発の主軸とし、機能追加や改善、ドキュメント整備を継続的に行うことで、利用者が安心して段階的に移行できる環境の整備を進めてまいります。
推奨するご利用方法
Terraformをこれから利用される方には、v3 のご利用を推奨します。
既に v2 をご利用中の方は、運用状況を見ながら v3 への移行をご検討ください。
補足情報
Terraformレジストリ：https://registry.terraform.io/providers/sacloud/sakura/latest
v3のリポジトリ (ソースコード・ドキュメント)：https://github.com/sacloud/terraform-provider-sakura
v2のリポジトリ (ソースコード・ドキュメント)：https://github.com/sacloud/terraform-provider-sakuracloud
