順序は参照から生まれる — 依存グラフと並列適用

宣言には「これを先に」と書く欄がありません。それでも Terraform は、参照される側を先に作ります。順番はどこから来るのでしょうか。

Terraform の文書 Dependency Graph はこう書きます。

References to resource attributes are turned into dependencies from the resource with the interpolation to the resource being referenced.

terraform_data.a.id と書けば、書いた側から a へ辺が1本張られます。この構成では、順序の材料はこの辺だけで、ファイルに書いた順は使われません。

辿り方も同じ文書にあります。

Graph walking is done in parallel: a node is walked as soon as all of its dependencies are walked.

依存が済んだ節から順に処理され、待つ相手の無い節はすぐに始まります。同時に動く数には上限があり、By default, up to 10 nodes in the graph will be processed concurrently. です。

ここから言えるのは、順序が構成全体に付いているのではなく、辺の1本1本に付いているということです。辺の無い所には順序がありません。実演でも Creating... の表示順は 1回目で b が先、2回目で a が先でした。

では参照に現れない依存はどうするのか。たとえばアプリが別の資源の振る舞いに頼っているが、値は何も受け取っていない場合です。そのための depends_on について、文書は You only need to explicitly specify a dependency when a resource or module relies on another resource's behavior but does not access any of that resource's data in its arguments. と書き、as a last resort とも書きます。まず参照で表せないかを考える、が文書の順番です。

-parallelism は同時に動く数の上限であって、順序を決めるものではありません。CLI 文書は Limit the number of concurrent operations as Terraform walks the graph. Defaults to 10. と書き、グラフの文書は considered an advanced operation and should not be necessary for normal usage と書きます。

グラフの循環について、文書は Validate the graph has no cycles and has a single root. と書きます。深さ優先で辿るという点は、第11期で扱う ES モジュールの import と同じです。ただ、ESM の仕様は循環を許すのに対し、Terraform はグラフに循環が無いことを検証すると書いています。同じ「グラフ」でも規則は逆です。なお本期では、循環を書いてエラーを出す実演はしていません。