Earthly Versions Save

Added

• Support for using HTTP(S) proxies when connecting to satellites.

Fixed

• Backwards compatability issue where WITH DOCKER would fail with EARTHLY_DOCKERD_CACHE_DATA: parameter not set when using an older version of the earthly in combination with a satellite running v0.8.10.

Additional Info

• This release includes changes to buildkit

Added

• New Github Actions Workflow commands integration --github-annotations flag or GITHUB_ACTIONS=true env. #2189
• Added a new --oidc flag to RUN command which allows authentication to AWS via OIDC. Enable with the VERSION --run-with-aws-oidc feature flag. #3804
• Experimental WITH DOCKER --cache-id=<key> feature, which will cache the contents of the docker data root, resulting in faster --load and --pull execution. Enabled with the VERSION --docker-cache feature flag. #3399
• New SAVE IMAGE --without-earthly-labels feature, which will prevent any dev.earthly.* labels from being saved to the image. Enable with the VERSION --allow-without-earthly-labels feature flag. Thanks to @3manuek for the contribution!

Fixed

• WITH DOCKER load time calculation. #3485
• The earthly cli was not correctly setting the exit status on failures when executing a RUN on a satellite which reached the max execution time limit.
• Self-hosted satellite connection issue.

Changed

• Earthly will now use source link format when displaying errors, e.g. <path>:<line>:<col> rather than <path> line <line>:<col>.
• Improved error messages for cases where a shell is required to run a command such as IF, FOR, etc.
• Earthly will now show a warning when earthly anonymously connects to a registry (which increases the chance of being rate-limited).

Additional Info

• This release includes changes to buildkit

Fixed

• BUILD --auto-skip was recording failed steps as complete, which would lead to them being skipped on subsequent runs. #4054

Additional Info

• This release has no changes to buildkit

Added

• New experimental wildcard-based copy, e.g. COPY ./services/*+artifact/* . which would invoke COPY for ./services/foo+artifact, and ./services/bar+artifact (assuming two services foo and bar, both having a artifact target in their respective Earthfile). Enable with the VERSION --wildcard-copy feature flag. #3966.
• New built-in ARGs - EARTHLY_GIT_AUTHOR_EMAIL and EARTHLY_GIT_AUTHOR_NAME will contain the author email and author name respectively. Enable with the VERSION --git-author-email-name-args feature flag.
• New --raw-output flag available on RUN that outputs line without target name. Enable with VERSION --raw-output. #3713

Changed

• EARTHLY_GIT_AUTHOR built-in ARG will now contain both name and email, when enabled with the VERSION --git-author-email-name-args feature flag. Previously it only contained the email. #3822

Fixed

• Make LET/SET commands block parallel commands such as BUILD until the former are processed, similar to the behavior of ARG. #3997
• LET/SET commands were not properly handled with the use of Auto-skip. #3996

Additional Info

• This release has no changes to buildkit

Added

• Warning log when resolving remote references using a git image that doesn't match Buildkit's architecture.
• New experimental --exec-stats-summary=<path> cli flag, which will display a summary of memory and cpu stats when earthly exits.
• A notice is now displayed when unnecessary feature flags are set (but already enabled by default by the VERSION number). Thanks to @danqixu for the contribution! #3641
• A warning is displayed if the local buildkit image architecture does not match the host architecture. #3937

Fixed

• Warning logs during HTTP retries are only displayed in --debug mode.
• The HOST command will now expand variables. Thanks to @pbecotte for the contribution! #1743
• runc has been updated to 1.1.12 in the buildkit fork

Additional Info

• This release includes changes to buildkit

Added

• Ability to set arbitrary attributes which certain registries require to support explicit remote caching (via the earthly --remote-cache flag). #3714 and #3868

Fixed

• Fixed an issue in Auto-skip where a +base target's ARGs were not accounted for when calculating the cache. #3895

Additional Info

• This release has no changes to buildkit

Added

• Added --aws flag to RUN command which makes AWS environment variables or ~/.aws available. Enable with the VERSION --run-with-aws feature flag. #3803
• Added --allow-privileged flag to FROM DOCKERFILE command. Enable with the VERSION --allow-privileged-from-dockerfile feature flag. Thanks to @dustyhorizon for the contribution! #3706

Fixed

• Fixes an issue where wildcard BUILD's are invoked from a relative directory (e.g., an Earthfile containing BUILD ./*+test invoked with earthly ./rel-dir+target). #3840
• --pass-args will no longer pass builtin args, which would result in `value cannot be specified for built-in build arge errors. #3775
• Fixes a parsing issue with BUILD flag arguments and wildcard targets #3862
• BUILD --auto-skip was silently ignored when the feature flag (VERSION --build-auto-skip) was missing #3870
• Fix an issue where COPY --if-exists would fail if the non-existing directory includes a wildcard. #3875
• Fixes an issue with passing the correct org value to Logstream which resulted in missing logs in the web builds view (https://cloud.earthly.dev/your-org/builds).
• Rename UDC to FUNCTION in hint when a secret is not found.

Additional Info

• This release includes changes to buildkit

Added

• The internal dockerd-wrapper.sh script, which is used to implement WITH DOCKER, will execute /usr/share/earthly/dockerd-wrapper-pre-script, if present, prior to starting the inner dockerd process. This can be used to configure options that depend on the host's kernel at run-time.
• Auto-skip can now be used directly on BUILD commands with BUILD --auto-skip; this feature can be enabled with VERSION --build-auto-skip 0.8. #3581

Changed

• Satellite rm requires a --force flag if it's running. This should help protect users from accidental deletes.

Fixed

• Fixes an issue with the registry proxy (used for faster image & artifact exporting) on Docker Desktop for Windows/WSL. #3769
• Fixes a problem with cache IDs not being expanded. For example: CACHE --id $MY_ARG was not using the assigned value of $MY_ARG.

Additional Info

• This release includes changes to buildkit

Fixed

• EARTHLY_GIT_REFS was incorrectly returning all references which contained the commit rather than pointed to the current commit. This also increases performance of looking up the branches. #3752
• Fixes an issue where earthly account login --token was leading to partially created auth config files. 3761

Additional Info

• This release includes changes to buildkit

Added

• Added a --force flag to the satellite update command, which forces a satellite to sleep before starting the update process. This may forcibly kill ongoing builds currently running on the satellite.

Changed

• Changed the default buildkit cache size to be adaptively set to 20GB, which is then clamped between the range of 10%-55% of the disk size. This logic can expressed as min(55%, max(10%, 20GB)).
• Satellites are now put to sleep before updating via earthly sat update <satellite-name>.

Fixed

• Fixed an intermittent issue with the registry proxy support container failing immediately on Mac. 3740
• Fixed a problem with parsing empty results when cleaning up old registry proxy support containers on Mac.
• Fixed a case where a suggested command would incorrectly contain both --interative and --ci. 3746
• Disabled the registry proxy server when Earthly is run from within a container. 3736

Additional Info

• This release has no changes to buildkit