やらかし
現在担当しているプロダクトではterraformでリソース管理をしており、CircleCIを用いてCI/CDを行っています。
ある日dev環境への反映ということもあり、CircleCIを使わずにローカルからterraform applyをした所、そのapply自体は通ったのですがその後のCircleCIからのterraform実行がエラーとなってしまいました。原因を確認した所、CircleCIで利用しているterrformバージョンより新しいバージョンでローカルから実行してしまったことが原因でした。terraformの仕様上、terraform apply時に更新されるtfstateファイルに定義されているterraformバージョンを下回るバージョンでのterraform実行はできないようです。
この時はCircleCI側のterraformバージョンを上げることで解決しました。対応策としてローカルからのterraform applyは気安く行わないことが上げられますが、ローカルとCircleCIのterraformバージョンを揃えといた方が良いかとも思います。そこでterraformバージョンを管理するtfenvが利用できます。
tfenvとは
tfenvは簡単にterraformのバージョンを切り替えられるパッケージマネージャです。詳しくは作成者の方の記事をご覧ください。
.terraform-versionファイル
tfenvの特徴として.terraform-versionファイルを置いておくとファイルに書かれたバージョンを利用します。こちらをリポジトリ上で管理することで、ローカルとCI/CD実行環境側にtfenvを導入することでterrafromバージョンを揃えることができます。
最後に
今回はtfenvを紹介しました。tfenvを使って開発環境と実行環境のバージョン差異を無くしましょう！