Firefly Documentation Portal
  • Welcome to the Documentation Portal
  • Contacting Firefly support
  • User Guides
    • QuickStart Guide
      • Onboarding
      • Dashboard
      • FAQ
      • Glossary
        • IaC status
    • Exploring the Inventory
    • Compose: Generating new configuration
    • Navigating the IaC Explorer
    • Workflows
      • Guardrails
    • Integrations
      • Integrate your providers and tools
        • Integrate your data sources
          • Integrate PagerDuty
          • Integrate MongoDB Atlas
          • Integrate AWS
            • Integrate AWS using Terraform
            • Integrate AWS using CloudFormation
            • Upgrading AWS integration to event-driven
            • AWS Discovery Status
          • Integrate Google Cloud
            • Integrate Google Cloud using a service account key
            • Integrate Google Cloud using Terraform
            • Google Cloud Discovery Status
          • Integrate Kubernetes
          • Integrate Datadog
          • Integrate New Relic
          • Integrate Okta
          • Integrate GitHub service
          • Integrate Cloudflare
          • Integrate NS1
          • Integrate Microsoft Azure
            • Integrate Microsoft Azure using Terraform
            • Azure Discovery Status
          • Integrate HashiCorp Vault
        • Integrate your IaC remote states
          • Integrate Terraform Cloud
          • Integrate Terraform Enterprise
          • Integrate HashiCorp Consul
          • Integrate remote stacks in Google Cloud Storage
          • Integrate env0
        • Integrate your version control system
          • Integrate GitHub
          • Integrate GitLab
          • Integrate Bitbucket
            • Integrate Bitbucket Data Center
            • Integrate Bitbucket Cloud
          • Integrate AWS CodeCommit
          • Integrate Azure DevOps
        • Send Firefly notifications to your messaging tools
          • Send Firefly notifications to Slack
            • Send notifications to Slack using the Slack App
            • Sending notifications to Slack using a webhook
          • Send Firefly notifications to Microsoft Teams
          • Send Firefly notifications to Torq
          • Send Firefly notifications to webhooks
          • Send Firefly notifications to Opsgenie
          • Send Firefly notifications to PagerDuty
            • Integration Key
            • General Access REST API Key
          • Send Firefly notifications to Google Chat
        • Integrate project management tools
          • Integrate Jira
    • Governance
    • Event-Center
    • How-to Guides
      • Manage assets
        • Codify assets
          • Codify assets to Config Connector
          • Codify assets to Manifest
          • Codify assets to Helm
          • Codify assets to CDK8S
          • Codify assets to Terraform
          • Codify assets to Pulumi
          • Codify assets to CloudFormation
          • Codify assets to CDK
          • Codify assets to Crossplane
          • Codify assets to Ansible
        • Delete unmanaged assets
        • Fix drifts
        • Remove asset Terraform code
        • Excluded drifts
        • IaC-Ignored assets
      • Monitor events
      • Manage notifications
      • Manage user roles
    • Deep Dive articles
      • Disaster recovery
      • Drifts
      • Codification
      • Notifications
      • Governance
      • Event-driven
      • IaC-Ignored assets
  • Appendix
    • Migrating CloudFormation resources to Terraform
    • Terraform Cloud Run Tasks
    • Creating a key pair
    • SSO Configuration
    • Firefly API Documentation
    • Support Matrix
    • Data privacy and AI usage
  • Firefly MCP
  • Firefly Backstage Plugin
Powered by GitBook
On this page
  • Terraform Cloud Overview
  • Integrating Terraform Cloud with Firefly

Was this helpful?

  1. Appendix

Terraform Cloud Run Tasks

PreviousMigrating CloudFormation resources to TerraformNextCreating a key pair

Last updated 2 years ago

Was this helpful?

Terraform Cloud Overview

(TFC) is a SaaS paid platform provided by HashiCorp that provides production-ready state management with continuous delivery for its users. Teams managing their cloud infrastructure with Terraform benefit from:

  • Terraform Cloud remote state out-of-the-box management with built-in versioning

  • A centralized location for the team to collaborate on infrastructure, in order to review and approve changes.

Last year at HashiConf Europe, HashiCorp previewed a new feature called run tasks for HashiCorp Terraform Cloud. The run tasks feature enables organizations to integrate third-party tools within a Terraform run, specifically between the plan and apply stages of the Terraform Cloud workflow.

In April 2022, Firefly created the capability to scan the Terraform cloud footprint and automatically codify unmanaged and drifted assets. In addition, Firefly used the run task integration to anticipate how changes in the Terraform plan affect other assets in the environment, regardless of whether those assets are managed by Terraform.

If you are a Terraform Cloud user, sign up with Firefly to integrate and connect your workspaces in Terraform Cloud. Anticipating changes before deployment avoids costly mistakes in your software development lifecycle with Terraform Cloud.

Note: This feature is only available for HashiCorp Business tier users.

Integrating Terraform Cloud with Firefly

Before you begin

You must be the administrator of your Firefly account to configure the Terraform Cloud integration.

Procedure

  1. .

  2. Copy the token.

  3. In Firefly, select Settings > Integrations.

  4. Select Add New > Terraform Cloud.

  5. Enter a descriptive name in the Nickname field.

  6. Paste the token in the API token field.

  7. Select Next.

  8. Copy the Endpoint URL and HMAC key created by Firefly.

  9. .

  10. Select Create a run task from the Terraform console.

  11. From the Workspaces tab, select Settings > Run Tasks. The newly created run task appears in the Run Task window.

  12. Select the add icon to add the run task to your workspace.

  13. Select the Enforcement Level of the run task. (Only the Advisory level is supported by Firefly):

    1. Advisory (Informs the user of a failure without interrupting the run).

    2. Mandatory (The run is terminated, and applied when the failure is resolved).

  14. To start a new run, select Actions > Start new run.

Viewing integration results

  • Select Details to go to Firefly’s Inventory table, which displays asset configuration and IaC status.

After the run tasks is completed, you can view the results and the number of assets affected by Firefly integration in .

Terraform Cloud
Create an API token
Paste the Endpoint URL and HMAC key
Tasks Passed