Skip to content

Commit 01e742d

Browse files
authoredNov 6, 2024··
docs(hermetic-build): indicate usage of Docker Buildkit in development guide (#3337)
1 parent 6372eee commit 01e742d

File tree

1 file changed

+8
-3
lines changed

1 file changed

+8
-3
lines changed
 

‎hermetic_build/DEVELOPMENT.md

+8-3
Original file line numberDiff line numberDiff line change
@@ -160,13 +160,18 @@ python hermetic_build/library_generation/cli/entry_point.py generate \
160160
1. Run the following command to build the image from source
161161

162162
```shell
163-
docker build \
163+
DOCKER_BUILDKIT=1 docker build \
164164
-f .cloudbuild/library_generation/library_generation.Dockerfile \
165165
-t local:image-tag \
166166
.
167167
```
168+
Please note that the build only works when using the new
169+
[Docker BuildKit](https://docs.docker.com/build/buildkit/) (enabled through the `DOCKER_BUILDKIT` variable).
170+
This is meant for local development only (in CloudTops) - GH Actions' Ubuntu-22.04 \
171+
[comes with the latest Docker version](https://github.com/actions/runner-images/blob/e74605cd6d5407469cf224802f25057bafc23d70/images/ubuntu/Ubuntu2204-Readme.md?plain=1#L81-L83)
172+
and is able to handle the build properly using the (updated) legacy builder.
168173

169-
2. Set the version of gapic-generator-java
174+
3. Set the version of gapic-generator-java
170175

171176
```shell
172177
LOCAL_GENERATOR_VERSION=$(mvn \
@@ -177,7 +182,7 @@ python hermetic_build/library_generation/cli/entry_point.py generate \
177182
-q)
178183
```
179184

180-
3. Run the image
185+
4. Run the image
181186

182187
```shell
183188
# Assume you want to generate the library in the current working directory

0 commit comments

Comments
 (0)
Please sign in to comment.