Skip to content

Add an earth migrate command to assist migration from earthly #634

Description

@kmannislands

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 earthlyearth 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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions