Skip to content

Commit 5df0b35

Browse files
Update docs-dependencies
1 parent fd47400 commit 5df0b35

8 files changed

Lines changed: 29 additions & 29 deletions

File tree

docs/basics/part-6-using-docker-with-earthly.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -10,14 +10,14 @@ Examples in [Python](#more-examples), [JavaScript](#more-examples) and [Java](#m
1010

1111
You may find that you need to run Docker commands inside a target. For those cases Earthly offers `WITH DOCKER`. `WITH DOCKER` will initialize a Docker daemon that can be used in the context of a `RUN` command.
1212

13-
Whenever you need to use `WITH DOCKER` we recommend (though it is not required) that you use Earthly's own Docker in Docker (dind) image: `earthly/dind:alpine-3.19-docker-25.0.2-r0`.
13+
Whenever you need to use `WITH DOCKER` we recommend (though it is not required) that you use Earthly's own Docker in Docker (dind) image: `earthly/dind:alpine-3.20-docker-26.1.3-r1`.
1414

15-
Notice `WITH DOCKER` creates a block of code that has an `END` keyword. Everything that happens within this block is going to take place within our `earthly/dind:alpine-3.19-docker-25.0.2-r0` container.
15+
Notice `WITH DOCKER` creates a block of code that has an `END` keyword. Everything that happens within this block is going to take place within our `earthly/dind:alpine-3.20-docker-26.1.3-r1` container.
1616

1717
### Pulling an Image
1818
```Dockerfile
1919
hello:
20-
FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
20+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
2121
WITH DOCKER --pull hello-world
2222
RUN docker run hello-world
2323
END
@@ -35,7 +35,7 @@ my-hello-world:
3535
SAVE IMAGE my-hello:latest
3636

3737
hello:
38-
FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
38+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
3939
WITH DOCKER --load hello:latest=+my-hello-world
4040
RUN docker run hello:latest
4141
END
@@ -137,7 +137,7 @@ test-setup:
137137
SAVE IMAGE test:latest
138138
139139
integration-tests:
140-
FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
140+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
141141
COPY docker-compose.yml ./
142142
WITH DOCKER --compose docker-compose.yml --load tests:latest=+test-setup
143143
RUN docker run --network=default_go/part6_default tests:latest
@@ -346,7 +346,7 @@ api-docker:
346346

347347
# Run your app and api side by side
348348
app-with-api:
349-
FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
349+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
350350
RUN apk add curl
351351
WITH DOCKER \
352352
--load app:latest=+app-docker \
@@ -401,7 +401,7 @@ docker:
401401
SAVE IMAGE java-example:$tag
402402

403403
with-postgresql:
404-
FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
404+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
405405
COPY ./docker-compose.yml .
406406
RUN apk update
407407
RUN apk add postgresql-client
@@ -559,7 +559,7 @@ build:
559559
COPY . .
560560
561561
run-tests:
562-
FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
562+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
563563
COPY ./docker-compose.yml .
564564
COPY ./tests ./tests
565565
RUN apk update

docs/docker-images/dind.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ This image supports 3 linux distributions:
1010
* ubuntu:23.04
1111

1212
For which the current latest tags (respectively) are:
13-
* `alpine-3.19-docker-25.0.2-r0`
14-
* `ubuntu-20.04-docker-24.0.5-1`
15-
* `ubuntu-23.04-docker-24.0.5-1`
13+
* `alpine-3.20-docker-26.1.3-r1`
14+
* `ubuntu-20.04-docker-26.1.3-1`
15+
* `ubuntu-23.04-docker-25.0.2-1`
1616

1717
For other available tags, please check out https://hub.docker.com/r/earthly/dind/tags
1818

@@ -41,7 +41,7 @@ dind:
4141
ARG SMALLEST_VERSION="$(echo -e "$EARTHLY_VERSION\nv0.7.14" | sort -V | head -n 1)"
4242
IF [ "$SMALLEST_VERSION" = "v0.7.14" ]
4343
# earthly is at v0.7.14 or newer, and must use the more recent dind:alpine-3.19-docker-25.0.2-r0 image
44-
FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
44+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
4545
END
4646
4747
test:

docs/earthfile/earthfile.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1100,7 +1100,7 @@ The `WITH DOCKER` clause only supports the command [`RUN`](#run). Other commands
11001100
A typical example of a `WITH DOCKER` clause might be:
11011101

11021102
```Dockerfile
1103-
FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
1103+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
11041104
WORKDIR /test
11051105
COPY docker-compose.yml ./
11061106
WITH DOCKER \
@@ -1122,7 +1122,7 @@ For information on using `WITH DOCKER` with podman see the [Podman guide](../gui
11221122
##### Note
11231123
For performance reasons, it is recommended to use a Docker image that already contains `dockerd`. If `dockerd` is not found, Earthly will attempt to install it.
11241124

1125-
Earthly provides officially supported images such as `earthly/dind:alpine-3.19-docker-25.0.2-r0` and `earthly/dind:ubuntu-23.04-docker-24.0.5-1` to be used together with `WITH DOCKER`.
1125+
Earthly provides officially supported images such as `earthly/dind:alpine-3.20-docker-26.1.3-r1` and `earthly/dind:ubuntu-23.04-docker-25.0.2-1` to be used together with `WITH DOCKER`.
11261126
{% endhint %}
11271127

11281128
{% hint style='info' %}

docs/guides/best-practices.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -304,7 +304,7 @@ In certain cases, it may be desirable to execute certain targets on the host mac
304304
Suppose we wanted the following target to be executed on against the host's Docker daemon:
305305

306306
```Dockerfile
307-
FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
307+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
308308
WORKDIR /app
309309
COPY docker-compose.yml ./
310310
WITH DOCKER --compose docker-compose.yml \
@@ -335,7 +335,7 @@ ARG run_locally=false
335335
IF [ "$run_locally" = "true" ]
336336
LOCALLY
337337
ELSE
338-
FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
338+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
339339
WORKDIR /app
340340
COPY docker-compose.yml ./
341341
END
@@ -1062,7 +1062,7 @@ The best supported option, however, is to use the `earthly/dind` image, if possi
10621062
```Dockerfile
10631063
# Best - if possible
10641064
integration-test:
1065-
FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
1065+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
10661066
COPY docker-compose.yml ./
10671067
WITH DOCKER --compose docker-compose.yml
10681068
RUN ...

docs/guides/docker-in-earthly.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -11,15 +11,15 @@ Here is a quick example of running a `hello-world` docker container via `docker
1111

1212
```Dockerfile
1313
hello:
14-
FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
14+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
1515
WITH DOCKER --pull hello-world
1616
RUN docker run hello-world
1717
END
1818
```
1919

2020
Let's break it down.
2121

22-
`FROM earthly/dind:alpine-3.19-docker-25.0.2-r0` inherits from an Earthly-supported docker-in-docker (dind) image. This is recommended, because `WITH DOCKER` requires all the Docker binaries (not just the client) to be present in the build environment.
22+
`FROM earthly/dind:alpine-3.20-docker-26.1.3-r1` inherits from an Earthly-supported docker-in-docker (dind) image. This is recommended, because `WITH DOCKER` requires all the Docker binaries (not just the client) to be present in the build environment.
2323

2424
`WITH DOCKER ... END` starts a Docker daemon for the purpose of running Docker commands against it. At the end of the execution, this also terminates the daemon and permanently deletes all of its data (e.g. daemon cached images).
2525

@@ -38,7 +38,7 @@ build:
3838
SAVE IMAGE my-image:latest
3939

4040
smoke-test:
41-
FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
41+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
4242
WITH DOCKER --load test:latest=+build
4343
RUN docker run test:latest
4444
FROM earthly/dind:alpine
@@ -54,7 +54,7 @@ smoke-test:
5454
It is possible to run `docker-compose` via `WITH DOCKER`, either explicitly, simply by running the `docker-compose` tool, or implicitly, via the `--compose` flag. The `--compose` flag allows you to specify a Docker compose stack that needs to be brought up before the execution of the `RUN` command. For example:
5555

5656
```Dockerfile
57-
FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
57+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
5858
COPY docker-compose.yml ./
5959
WITH DOCKER \
6060
--compose docker-compose.yml \
@@ -68,7 +68,7 @@ Using the `--compose` flag has the added benefit that any images needed by the c
6868

6969
## Performance
7070

71-
It's recommended to use the `earthly/dind:alpine-3.19-docker-25.0.2-r0` image for running docker-in-docker. See the best-practices' section on using [with docker](../guides/best-practices.md#use-earthly-dind) for more details.
71+
It's recommended to use the `earthly/dind:alpine-3.20-docker-26.1.3-r1` image for running docker-in-docker. See the best-practices' section on using [with docker](../guides/best-practices.md#use-earthly-dind) for more details.
7272

7373
In cases when using `earthly/dind` is not possible, Earthly will attempt to install Docker in the image you have chosen. This has the drawback of not being able to use cache efficiently and is not recommended for performance reasons.
7474

@@ -102,7 +102,7 @@ The current implementation of Docker in Earthly has a number of limitations:
102102
...
103103
END
104104
```
105-
* It is recommended that the target containing the `WITH DOCKER` clause inherits from a supported Docker-in-Docker (dind) image such as `earthly/dind:alpine-3.19-docker-25.0.2-r0` or `earthly/dind:ubuntu-23.04-docker-24.0.5-1`. If your build requires the use of an alternative environment as part of a test (e.g. to run commands like `sbt test` or `go test` together with a docker-compose stack), consider placing the test itself in a Docker image, then loading that image via `--load` and running the test as a Docker container.
105+
* It is recommended that the target containing the `WITH DOCKER` clause inherits from a supported Docker-in-Docker (dind) image such as `earthly/dind:alpine-3.20-docker-26.1.3-r1` or `earthly/dind:ubuntu-23.04-docker-25.0.2-1`. If your build requires the use of an alternative environment as part of a test (e.g. to run commands like `sbt test` or `go test` together with a docker-compose stack), consider placing the test itself in a Docker image, then loading that image via `--load` and running the test as a Docker container.
106106
* If you do not use an officially supported Docker-in-Docker image, Earthly will attempt to install Docker in whatever image you have chosen. This has the drawback of not being able to use cache efficiently and is not recommended for performance reasons.
107107
* To maximize the use of cache, all external images used should be declared via the options `--pull` or `--compose`. Even though commands such as `docker run` automatically pull an image if it is not found locally, it will do so every single time the `WITH DOCKER` clause is executed, due to Docker caching not being preserved between runs. Pre-declaring the images ensures that they are properly cached by Earthly to minimize unnecessary redownloads.
108108
* `docker build` cannot be used to build Dockerfiles. However, the Earthly command `FROM DOCKERFILE` can be used instead. See [alternative to docker build](#alternative-to-docker-build) below.

docs/guides/integration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -133,7 +133,7 @@ We start with a simple Earthfile that can build and create a docker image for ou
133133
We start from an appropriate docker image and set up a working directory.
134134
``` Dockerfile
135135
VERSION 0.8
136-
FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
136+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
137137
WORKDIR /scala-example
138138
RUN apk add openjdk11 bash wget postgresql-client
139139
```

docs/guides/registries/aws-ecr.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ Loaded image: <aws_account_id>.dkr.ecr.<region>.amazonaws.com/hello-earthly:with
9696
Using this credential helper; you can also pull images without any special handling in an Earthfile:
9797

9898
```
99-
FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
99+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
100100
101101
run:
102102
WITH DOCKER --pull <aws_account_id>.dkr.ecr.<region>.amazonaws.com/hello-earthly:with-love
@@ -109,12 +109,12 @@ And here is how you would run it:
109109
```
110110
❯ earthly -P +run
111111
buildkitd | Found buildkit daemon as docker container (earthly-buildkitd)
112-
earthly/dind:alpine-3.19-docker-25.0.2-r0 | --> Load metadata linux/amd64
112+
earthly/dind:alpine-3.20-docker-26.1.3-r1 | --> Load metadata linux/amd64
113113
4/hello-earthly:with-love | --> Load metadata linux/amd64
114114
4/hello-earthly:with-love | --> DOCKER PULL <aws_account_id>.dkr.ecr.<region>.amazonaws.com/hello-earthly:with-love
115115
4/hello-earthly:with-love | [██████████] resolve <aws_account_id>.dkr.ecr.<region>.amazonaws.com/hello-earthly:with-love@sha256:9ab4df74dafa2a71d71e39e1af133d110186698c78554ab000159cfa92081de4 ... 100%
116-
+base | --> FROM earthly/dind:alpine-3.19-docker-25.0.2-r0
117-
+base | [██████████] resolve docker.io/earthly/dind:alpine-3.19-docker-25.0.2-r0@sha256:2cef4089960efe028de40721749e3ec6eba9f471562bf10681de729287bd78fb ... 100%
116+
+base | --> FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
117+
+base | [██████████] resolve docker.io/earthly/dind:alpine-3.20-docker-26.1.3-r1@sha256:2cef4089960efe028de40721749e3ec6eba9f471562bf10681de729287bd78fb ... 100%
118118
+run | *cached* --> WITH DOCKER (install deps)
119119
+run | *cached* --> WITH DOCKER RUN docker run <aws_account_id>.dkr.ecr.<region>.amazonaws.com/hello-earthly:with-love
120120
output | --> exporting outputs

examples/integration-test/Earthfile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
VERSION 0.8
2-
FROM earthly/dind:alpine-3.18-docker-25.0.1-r0
2+
FROM earthly/dind:alpine-3.20-docker-26.1.3-r1
33
WORKDIR /scala-example
44
RUN apk add openjdk11 bash wget postgresql-client
55

0 commit comments

Comments
 (0)