Summary
Suggested during review of the migration guide (PR #14): add a migrate subcommand to the earth CLI to help users move from earthly to EarthBuild automatically.
Motivation
The migration guide documents a number of mechanical changes users must make by hand:
- Rename the binary reference
earthly → earth in scripts/CI
- Update
EARTHLY_* → EARTH_* environment variables (deprecated in v0.8.x, removed in v0.9.x)
- Rename
ARG EARTHLY_* → ARG EARTH_* built-in args in Earthfiles
- Remove the
PROJECT command from Earthfiles
- Drop removed flags (
--auto-skip, --satellite, --auth-token, …)
- Update
docker.io/earthly/* image references to docker.io/earthbuild/*
A earth migrate command could detect and optionally auto-apply these transformations (e.g. rewriting Earthfiles and flagging config/CI changes), easing adoption ahead of the v0.9.x breaking release.
Notes
Summary
Suggested during review of the migration guide (PR #14): add a
migratesubcommand to theearthCLI to help users move fromearthlyto EarthBuild automatically.Motivation
The migration guide documents a number of mechanical changes users must make by hand:
earthly→earthin scripts/CIEARTHLY_*→EARTH_*environment variables (deprecated inv0.8.x, removed inv0.9.x)ARG EARTHLY_*→ARG EARTH_*built-in args in EarthfilesPROJECTcommand from Earthfiles--auto-skip,--satellite,--auth-token, …)docker.io/earthly/*image references todocker.io/earthbuild/*A
earth migratecommand could detect and optionally auto-apply these transformations (e.g. rewriting Earthfiles and flagging config/CI changes), easing adoption ahead of thev0.9.xbreaking release.Notes