Terraform 1.13で追加された terraform stacks コマンド使ってみた

# インストール
% tfenv install 1.13.0 # 私は Terraformのversion管理に tfenvを使っています。
% tfenv use 1.13.0

% terraform stacks -usage

Usage: terraform stacks [global options] <command> [args]

The available commands for execution are listed below.

Primary Commands:
  init              Prepare the configuration directory for further commands
  providers-lock    Write out dependency locks for the configured providers
  validate          Check whether the configuration is valid
  version           Show the current Stacks Plugin version
  fmt               Reformat your Terraform Stacks configuration to a canonical format

Sub-commands:

Global options (use these before the subcommand, if any):
  -chdir=DIR              Switch to a different working directory before executing the
                          given subcommand.
  -plugin-cache-dir=DIR   Override the default directory where the stack plugin binary is cached.
  -stacks-version         An alias for the "version" subcommand.
  -no-color=BOOL          Disable color output. Must be explicitly set to true or false.

Usage help:
  -usage                  Show this usage output or the usage for a specified subcommand.
                          Use after the command: terraform stacks <command> -usage

% ls -a
.                   ..
% terraform stacks init
Success! Configuration has been initialized and more commands can now be executed.
% ls -a               
.                   ..                  .terraform          .terraform.lock.hcl

# This file is maintained automatically by "terraform stacks providers lock".
# Manual edits may be lost in future updates.

% terraform stacks init
Provider "hashicorp/random" already locked at "3.5.1".
Provider "hashicorp/archive" already locked at "2.4.2".
Provider "hashicorp/local" already locked at "2.4.1".
Provider "hashicorp/aws" already locked at "5.72.1".
Downloading "hashicorp/archive"@"2.4.2"....
Downloading "hashicorp/aws"@"5.72.1"....
Downloading "hashicorp/local"@"2.4.1"....
Downloading "hashicorp/random"@"3.5.1"....
Success! Configuration has been initialized and more commands can now be executed.

% terraform stacks providers-lock
Provider "hashicorp/random" already locked at "3.5.1".
Provider "hashicorp/archive" already locked at "2.4.2".
Provider "hashicorp/local" already locked at "2.4.1".
Provider "hashicorp/aws" already locked at "5.72.1".
Downloading "hashicorp/archive"@"2.4.2"....
Downloading "hashicorp/aws"@"5.72.1"....
Downloading "hashicorp/local"@"2.4.1"....
Downloading "hashicorp/random"@"3.5.1"....
Success! .terraform.lock.hcl has been created and/or updated.

% terraform stacks providers-lock -platform=linux_arm64
Provider "hashicorp/local" already locked at "2.4.1".
Provider "hashicorp/aws" already locked at "5.72.1".
Provider "hashicorp/random" already locked at "3.5.1".
Provider "hashicorp/archive" already locked at "2.4.2".
Downloading "hashicorp/archive"@"2.4.2"....
Downloading "hashicorp/aws"@"5.72.1"....
Downloading "hashicorp/local"@"2.4.1"....
Downloading "hashicorp/random"@"3.5.1"....
Success! .terraform.lock.hcl has been created and/or updated.

% terraform stacks version
Terraform Stacks Plugin version: v1.0.0
on darwin_arm64

% terraform stacks validate                            
╷
│ Warning: Deprecated filename usage
│
│ This configuration is using the deprecated .tfstack.hcl or .tfstack.json file extensions. This will not be supported in a future version of Terraform, please update your files to use the latest .tfcomponent.hcl or .tfcomponent.json file extensions.
╵
Success! Terraform Stacks configuration is valid and ready for use within HCP Terraform.

Some warnings were produced by the validation process, and are rendered above.

% terraform stacks validate
╷
│ Warning: Deprecated filename usage
│
│ This configuration is using the deprecated .tfstack.hcl or .tfstack.json file extensions. This will not be supported in a future version of Terraform, please update your files to use the latest .tfcomponent.hcl or .tfcomponent.json file extensions.
╵
╷
│ Error: Reference to undeclared component
│
│   on ./outputs.tfstack.hcl line 4, in output "lambda_urls":
│    4:   value = [ for x in component.api_gateway: x.hello_url ]
│
│ There is no component "api_gateway" block declared in this stack.
╵
Failure! Terraform Stacks configuration is not valid, please check and fix the errors printed above.

% terraform stacks fmt
components.tfstack.hcl
deployments.tfdeploy.hcl
outputs.tfstack.hcl
providers.tfstack.hcl
variables.tfstack.hcl

  output "lambda_urls" {
-   type = list(string)
+   type        = list(string)
    description = "URLs to invoke lambda functions"
-   value = [ for x in component.api_gateway: x.hello_url ]
+   value       = [for x in component.api_gateway : x.hello_url]
  }