Terraform 特定moduleのみを指定して実行する

普通に terraform apply を実行すると適用されているすべてのモジュールが処理されます。

モジュールが少ないときはまだ良いのですが、次第に増えてくると一部の修正のみでも実際にその修正部分が処理されるまで、時間がかかる場合があります。

そこで処理するモジュールを指定することで、Terraformの実行時間を短縮できるメリットがあります。

ただ注意点として、特定moduleのみ実行しているとソースコードと実際のインフラが乖離していく恐れがあるため、日常的に使用するものではなくミスした部分の修正など例外的に使用するものとされています。

本番環境での使用は控えたほうがいいかもしれませんが、開発環境で試行錯誤しているときなどはかなり便利です。

特定moduleのみを指定して実行
参考

特定moduleのみを指定して実行

基本構文・実行例

構文は以下になります。

terraform [plan|apply|destroy] -target=module.[モジュール名]

例として前回の記事のソースコードを元にplanを実行してみたいと思います。

このモジュール群は、network → security → hello-app-server の順番で依存関係を張っています。

% cd environments/dev
% 
## モジュールの確認
% grep ^module main.tf
module "network" {
module "security" {
module "hello-app-server" {
%

ここでnetworkモジュールのみを指定してplanを確認すると、networkモジュールのみが実行計画として表示されます。

 % terraform plan -target=module.network | grep module  
  # module.network.aws_internet_gateway.test-gw will be created
  # module.network.aws_route_table.test-route will be created
...
%

また依存関係の最後のモジュールである hello-app-server を指定すると、明示的に指定したhello-app-server だけでなく依存関係が張られている network、security のモジュールも実行されることが確認できます。

% terraform plan -target=module.hello-app-server | grep module
  # module.hello-app-server.aws_instance.test-server-east will be created
  # module.hello-app-server.aws_instance.test-server-west will be created
...
  # module.network.aws_subnet.test-sub-east will be created
  # module.network.aws_subnet.test-sub-west will be created
  # module.network.aws_vpc.test-vpc will be created
  # module.security.aws_security_group.test-sg-lb will be created
  # module.security.aws_security_group.test-sg-server will be created
%

複数ターゲットの指定

-targetを繰り返し記述してください。

% terraform plan -target=module.network -target=module.security  | grep module  
  # module.network.aws_internet_gateway.test-gw will be created
  # module.network.aws_route_table.test-route will be created
...
  # module.security.aws_security_group.test-sg-lb will be created
  # module.security.aws_security_group.test-sg-server will be created
%

リソースまで指定

更に以下のようにモジュールの中のリソースまで指定できます。

terraform [plan|apply|destroy] -target=module.[モジュール名].[リソースタイプ].[リソース名]

% terraform plan -target=module.hello-app-server.aws_instance.test-server-east | grep module 
  # module.hello-app-server.aws_instance.test-server-east will be created
  # module.network.aws_subnet.test-sub-east will be created
  # module.network.aws_vpc.test-vpc will be created
  # module.security.aws_security_group.test-sg-lb will be created
  # module.security.aws_security_group.test-sg-server will be created
%

今回は以上です〜ﾉｼ

参考

(о￣∇￣)／ぁざ~~っす

公式ドキュメント Resource Targeting
公式ドキュメント Resource Addressing

リンク