diff --git a/hermetic_build/DEVELOPMENT.md b/hermetic_build/DEVELOPMENT.md index b6e78389dc..e54c57e9ec 100644 --- a/hermetic_build/DEVELOPMENT.md +++ b/hermetic_build/DEVELOPMENT.md @@ -160,13 +160,18 @@ python hermetic_build/library_generation/cli/entry_point.py generate \ 1. Run the following command to build the image from source ```shell - docker build \ + DOCKER_BUILDKIT=1 docker build \ -f .cloudbuild/library_generation/library_generation.Dockerfile \ -t local:image-tag \ . ``` + Please note that the build only works when using the new + [Docker BuildKit](https://docs.docker.com/build/buildkit/) (enabled through the `DOCKER_BUILDKIT` variable). + This is meant for local development only (in CloudTops) - GH Actions' Ubuntu-22.04 \ + [comes with the latest Docker version](https://github.com/actions/runner-images/blob/e74605cd6d5407469cf224802f25057bafc23d70/images/ubuntu/Ubuntu2204-Readme.md?plain=1#L81-L83) + and is able to handle the build properly using the (updated) legacy builder. -2. Set the version of gapic-generator-java +3. Set the version of gapic-generator-java ```shell LOCAL_GENERATOR_VERSION=$(mvn \ @@ -177,7 +182,7 @@ python hermetic_build/library_generation/cli/entry_point.py generate \ -q) ``` -3. Run the image +4. Run the image ```shell # Assume you want to generate the library in the current working directory