Skip to content

Announcing Enhanced VCS Integration ๐ŸŽ‰ ๐ŸŽ‰

Read more here โ†’

Getting Startedยป

Warning

Terragrunt support is currently in beta and has some important limitations to take into consideration. Please see our documentation here for more information.

This documentation will be using an example repository Spacelift provides here. This repository contains 2 different examples, but for getting started we will be using the single-stack example.

Creating a new stackยป

In Spacelift, go ahead and click the Add Stack button to create a new Stack.

Naming the stackยป

Once in the stack creation wizard, Give your stack a name such as terragrunt-example then press Continue to configure our VCS settings for the stack.

Stack Creation - Naming the stack

Linking to the Terragrunt codeยป

On this VCS configuration screen, Select Raw Git as your Provider, and provide the following URL: https://github.com/spacelift-io-examples/terragrunt-examples.git and a Project Root of single-project.

Stack Creation - Connecting to VCS

Pressing next on this page will take you through to the backend configuration page.

This page has quite a few options but the ones that we will be using for this example are as follows:

Stack Creation - Connecting to VCS

Press Continue to finish the backend configuration and move through to defining stack behavior. For this example nothing needs to be edited here so be sure to hit Save Stack to complete the process.

Deploying the stackยป

Spacelift will take you to the Runs view for the Stack you've just created. Once on this page, press the Trigger button to trigger a new Run.

Stack Deployment - Trigger run button

You should now be taken through the process of deploying your stack. This takes you through multiple stages of a run, moving through initialization, planning and ending up in an unconfirmed state.

Examining the planned changesยป

In this unconfirmed state we have time to review what is going to change if we were to continue and confirm and apply. By pressing the changes +2 button at the top of the page, we are taken to an overview of the planned changes.

Stack Deployment - Reviewing the changes

For this stack we should see that 2 resources are being created and we can see what values these resources and outputs are expected to have. This is a very useful view to see at a glance, what is going to happen in as a result of your deployment.

Confirming and applying the changesยป

Info

Due to security reasons and limitations of Terragrunt and its mocked outputs, Spacelift does not use the planfile in the applying as there is a possibility to deploy mock values.

Once you're happy with the changes, press the Confirm button to allow the run to continue and begin the applying phase of the run.

Conclusionยป

You have now successfully deployed a Terragrunt stack using Spacelift! Congratulations.

For further reading, we recommend looking into using the Run all setting to enable you to deploy multiple projects using terragrunt run-all by reading our documentation here. We also recommend that if you are looking into using Terragrunt with Spacelift that you read our page on the Limitations of Terragrunt.