Pipelines Installation Overview

Pipelines integrates multiple technologies to deliver a comprehensive CI/CD solution. This guide outlines the available installation methods and their respective use cases.

Installation as part of DevOps Foundations

Customers using DevOps Foundations benefit from a guided setup process that includes the complete installation of Gruntwork Pipelines. This process is facilitated by a Gruntwork solutions engineer and includes the following steps:

1. Creating a new infrastructure-live-root repository from the infrastructure-live-root-template template.
2. (On GitHub) Installing the Gruntwork.io GitHub App on the infrastructure-live-root repository or across the entire organization. For detailed instructions, refer to this guide.
3. Running the Infrastructure Live Root Bootstrap workflow to customize the generated repository for infrastructure deployment.

Completing these steps results in a repository fully configured for automated infrastructure deployments using GitOps workflows.

Installation via manual setup

For users not leveraging DevOps Foundations or needing Gruntwork Pipelines for a standalone repository with existing Terragrunt configurations, Gruntwork Pipelines can be installed as an independent GitHub Actions or GitLab pipelines workflow.

To learn more about this process, consult the documentation for Adding Pipelines to an Existing Repository.

Platform differences

Gruntwork Pipelines supports both GitHub Actions and GitLab CI/CD. The installation process differs depending on your platform choice:

GitHub Actions

For GitHub Actions, you have two authentication options:

1. GitHub App Authentication (Recommended)
2. Machine User Authentication

GitLab CI/CD (Beta)

For GitLab CI/CD:

1. Machine User Authentication is the only supported method
2. Contact Gruntwork support to authorize your GitLab groups

note

Account Factory features are not currently available on GitLab