Troubleshooting

Terraform

Occassionally, the terraform command does not behave as expected. In certain situations it can be helpful to enable Terraform debugging giving detailed logs useful for troubleshooting.

To enable Terraform debugging against a Terrateam run, set up the following hooks in your Terrateam configuration file .terrateam/config.yml.

hooks:
  plan:
    pre:
      - type: env
        name: TF_LOG
        cmd: ['echo', 'DEBUG']
    post: []
  apply:
    pre:
      - type: env
        name: TF_LOG
        cmd: ['echo', 'DEBUG']
    post: []

Once these changes are pushed to your branch, Terrateam will execute terraform in debug mode TF_LOG=DEBUG exposing lots of information for the plan and apply.

For more information on debugging Terraform, please see the official Hashicorp Terraform documentation (opens in a new tab).

Terrateam

To view logs from a Terrateam operation:

1. Navigate to the main page of your Terraform repository on GitHub and select Actions

2. Select the Terrateam Workflow run you'd like to investigate

3. Select Terrateam Action

4. Expand Run Terrateam Action