Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Clarify DinD usage on newer k8s versions #10778

Merged
merged 5 commits into from
Mar 30, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .spelling
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,7 @@ J.P.
Jemison
JetBrains
KNative
Kaniko
Katacoda
Kerberos
Killercoda
Expand Down Expand Up @@ -134,6 +135,7 @@ cron
daemoned
dev-container
dinever
dockershim
dropdown
e.g.
e2e
Expand Down
4 changes: 4 additions & 0 deletions docs/walk-through/docker-in-docker-using-sidecars.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Docker-in-Docker Using Sidecars

Note: It is increasingly unlikely that the below example will work for you on your version of Kubernetes. [Since Kubernetes 1.24, the dockershim has been unavailable as part of Kubernetes](https://kubernetes.io/blog/2022/02/17/dockershim-faq/), rendering Docker-in-Docker unworkable. It is recommended to seek alternative methods of building containers, such as [Kaniko](https://github.com/GoogleContainerTools/kaniko) or [Buildkit](https://github.com/moby/buildkit). A [Buildkit Workflow example](https://raw.githubusercontent.com/argoproj/argo-workflows/master/examples/buildkit-template.yaml) is available in the examples directory of the Argo Workflows repository.

---

An application of sidecars is to implement Docker-in-Docker (DIND). DIND is useful when you want to run Docker commands from inside a container. For example, you may want to build and push a container image from inside your build container. In the following example, we use the `docker:dind` image to run a Docker daemon in a sidecar and give the main container access to the daemon.

```yaml
Expand Down