Terraform Integration Plugin for Spinnaker and Armory CD

Overview of Terraform Integration

Armory’s Terraform Integration feature integrates your infrastructure-as-code Terraform workflow into your SDLC. The integration interacts with a source repository you specify to deploy your infrastructure as part of a Spinnaker pipeline.

Terraform Integration has two components - the plugin and the standalone service.

• Terraformer service

  • Stores Terraform jobs in an execution queue
  • Execute those jobs
  • Exposes an API to monitor jobs executions

• Spinnaker plugin

  • Extends Orca with a new stage and 3 tasks - run terraform, monitor terraform run, bind produced artifacts
  • Extends Deck with new component
  • Extends Gate with new API

Additionally, Terraform Integration requires a Redis instance to store Terraform logs and plans. For production, you should have a dedicated external Redis instance to ensure that you do not encounter scaling or stability issues.

Spinnaker compatibility matrix

Supported Terraform versions

Not all patch versions are included for each release. Although other Terraform versions may be usable with Spinnaker/Armory CD and Terraform Integration, Armory only supports the versions listed here.

Armory ships several versions of Terraform as part of the Terraform Integration feature. The Terraform binaries are verified by checksum and with Hashicorp’s GPG key before being installed.

When creating a Terraform Integration stage, pipeline creators select a specific available version from a list of available versions:

![Terraform version to use](/images/plugins/terraform/terraform_version.png" >}}

All Terraform stages within a pipeline that affects state must use the same Terraform version.

Supported Terraform features

The following table lists the Terraform Integration features and their supported versions:

Installation paths

Terraform Integration is a feature in Armory CD, so you only need to enable the service. For Spinnaker, however, you need to install both the Terraform Integration service and the Spinnaker plugin.