Name		Name	Last commit message	Last commit date
parent directory ..
aws-sso		aws-sso
bazel		bazel
c		c
cache-command		cache-command
clojure		clojure
cloud-secrets		cloud-secrets
cobol		cobol
cpp		cpp
cutoff-optimization		cutoff-optimization
dotnet		dotnet
elixir		elixir
go-monorepo		go-monorepo
go		go
grpc		grpc
import		import
integration-test		integration-test
java		java
js		js
mkdocs		mkdocs
monorepo		monorepo
multiplatform-cross-compile		multiplatform-cross-compile
multiplatform		multiplatform
multirepo		multirepo
next-js-netlify		next-js-netlify
python		python
react		react
readme		readme
ruby-on-rails		ruby-on-rails
ruby		ruby
rust		rust
scala		scala
secrets		secrets
terraform		terraform
tutorial		tutorial
typescript-node		typescript-node
zig		zig
README.md		README.md

README.md

Earthly examples

This folder contains a series of examples to help you familiarize yourself with Earthly.

If you are new to Earthly, you may find the Basics tutorial helpful.

Please note that these examples, although similar, are distinct from the ones used in the tutorial.

integration-test - shows how WITH DOCKER and docker-compose can be used to start up services and then run an integration test suite.
monorepo - shows how multiple sub-projects can be co-located in a single repository and how the build can be fragmented across these.
multirepo - shows how artifacts from multiple repositories can be referenced in a single build. See also the grpc example for a more extensive use-case.

import - shows how to use the IMPORT command to alias Earthfile references.
cutoff-optimization - shows that if an intermediate artifact does not change, then the rest of the build will use the cache, even if the source has changed.
multiplatform - shows how Earthly can execute builds and create images for multiple platforms, using QEMU emulation.
multiplatform-cross-compile - shows has through the use of cross-compilation, you can create images for multiple platforms, without using QEMU emulation.

grpc - shows how to use Earthly to compile a protobuf grpc definition into protobuf code for both a Go-based server, and a python-based client, in a multirepo setup.
terraform - shows how Terraform could be used from Earthly.

readme - some sample code we used in our README.
tests - a suite of tests Earthly uses to ensure that its features are working correctly.