Logo

Cloud-native workflow automation

View the Project on GitHub lyraproj/lyra

Documentation

Lyra logo

What is Lyra?

Lyra (“lee-ruh”) is an open source workflow engine for provisioning and managing cloud native infrastructure. Using infrastructure as code, Lyra enables you to declaratively provision and manage public cloud, private cloud, and other API-backed resources as well as orchestrate imperative actions. For more information, see the README.md in the main project repository.

Getting started

The fastest way to get started is with the official Lyra Docker container. You can browse all the available tags and builds on the Lyra org on dockerhub or just grab the latest image:

  1. Create a lyra-local directory to save your work locally.

    cd
    mkdir lyra-local
    
  2. Pull the Lyra container:

    docker pull lyraproj/lyra:latest
    
  3. Run the container in interactive mode and mount the directory at /src/lyra/local to your local-lyra directory.

    docker run -it \
    --mount type=bind,src=$HOME/lyra-local,dst=/src/lyra/local \
    lyraproj/lyra:latest /bin/ash
    

Homebrew support is available with:

brew install lyraproj/lyra/lyra

On other platforms, or if you’re interested in hacking on the codebase directly, follow the build instructions in the README.

Check out the example workflows to get an idea of what Lyra can do. In particular the “foobernetes.yaml” has a heavily annotated workflow that describes the deployment of infrastructure to a simple Kubernetes-like service.

Lyra compared to $tool

There are a number of similar projects and products in this space. The following comparisons are not meant to judge the relative merits of Lyra against them, but rather to provide a frame of reference for users who might be familiar with one or more of them.

Lyra compared to Terraform

Lyra compared to Pulumi

Lyra compared to Helm