Skip to content

Build and Deploy modular landing zones with collie on AWS, Azure & GCP

License

Notifications You must be signed in to change notification settings

meshcloud/collie-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

1dbc982 ยท Aug 28, 2024
May 19, 2022
Aug 28, 2024
May 10, 2022
Aug 28, 2024
Aug 28, 2024
Oct 16, 2023
Jul 9, 2023
Aug 27, 2024
Jun 28, 2021
Jul 4, 2023
Mar 25, 2024
Mar 25, 2024
Sep 29, 2022
Aug 27, 2024
Aug 27, 2024
Sep 25, 2023
Sep 25, 2023

Repository files navigation

Collie CLI


Collie is a tool for building and managing landing zones for AWS, Azure or GCP as terraform modules.

Use collie to

  • define your core cloud architecture and landing zone(s) using maintainable terraform modules
  • discover and leverage ready-to-use modules implementing best-practice solutions to common landing zone challenges from Collie Hub
  • leverage an efficient, opinionated terraform workflow that eliminates boilerplate and produces great documentation for application and security teams

๐Ÿฅœ Collie in a nutshell

Collie is a tool to streamline building and managing landing zones using terraform for AWS, Azure and GCP. Think of collie like a wrapper around terraform to scaffold, develop and deploy terraform modules.

  • platform engineers use collie to manage a structured git repository containing all code defining their landing zone(s)
  • collie leverages a terraform workflow (powered by terragrunt) to break down complex landing zones into modular, logically structured kit modules
  • kit modules are standard terraform modules following minimal conventions
  • collie lets you import community-maintained modules from Collie Hub and customize them in a fork & own approach

๐Ÿ•น Installation

Binary downloads of collie can be found on the Releases page.

Unpack the collie binary and add it to your PATH and you are good to go!

We also provide installation scripts:

Linux

curl -sf -L https://raw.githubusercontent.com/meshcloud/collie-cli/main/install.sh | sudo bash

macOS

curl -sf -L https://raw.githubusercontent.com/meshcloud/collie-cli/main/install.sh | sh

Windows

irm https://raw.githubusercontent.com/meshcloud/collie-cli/main/install.ps1 | iex

โ˜๏ธ Prerequisites

To use collie, you'll need to have the following tools installed.

  • terraform to define landing zones using infrastructure as code
  • terragrunt to build and deploy terraform
  • terraform-docs to generate terraform module documentation
  • (optional) node.js to preview your cloud foundation documentation in a local webserver

For each cloud platform you want to manage, you'll need the cloud CLI installed.

  • For AWS, this is the aws CLI. Install it here. Do not use the Docker install method.
  • For Azure, this is the az CLI. Install it here.
  • For Google Cloud, this is the gcloud CLI. Install it here.

๐Ÿ“š Documentation

Get started with the Tutorial or browse the complete documentation.

Community, Discussion, Support

Collie is a ๐ŸŒค๏ธ cloudfoundation.org community project. Reach out to us on the cloudfoundation.org slack.

For contributers, please review CONTRIBUTING.md.