Earthly lib

The Earthly lib is a collection of reusable functions for common operations to be used in Earthfiles.

Earthly lib is split across multiple packages, each of which can be imported separately. The packages are:

  • billing - functions for estimating billing

  • rust - functions for working with Rust

  • utils/dind - functions for working with Docker-in-Docker

  • utils/git - functions for working with Git

  • utils/ssh - functions for working with SSH

See the individual packages for more information.

Additional language-specific functions are currently planned for later in 2024.

Usage

To use Earthly lib, import the package you want to use in your Earthfile:

IMPORT github.com/earthly/lib/utils/git:2.2.11 AS git

Then, call the function you want to use:

DO git+DEEP_CLONE --GIT_URL=...

Last updated