Merged
Conversation
mikenomitch
requested review from
a team,
ghostwriternr and
whoiskatrin
as code owners
Contributor
|
This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:
|
mikenomitch
force-pushed
the
nomitch/sandbox-did
branch
from
dc504aa to
a55e32f
Compare
Contributor
Collaborator
|
/bonk do a quick review pass for style and clarity |
Co-authored-by: elithrar <elithrar@users.noreply.github.com>
Contributor
Summary of changes made
Not fixed (author judgment call)
|
Contributor
Author
|
/bonk update the DIND changelog date (in the file and the file name) to today |
Co-authored-by: mikenomitch <mikenomitch@users.noreply.github.com>
Contributor
|
Done. Updated the DIND changelog from
|
Updated the Docker-in-Docker section to clarify support for developing applications and running test environments.
Maddy-Cloudflare
approved these changes
Feb 17, 2026
| - Build container images as part of CI/CD workflows | ||
| - Deploy arbitrary images supplied at runtime within a container | ||
|
|
||
| For [Sandbox SDK](/sandbox/) users, see the [Docker-in-Docker guide](/sandbox/guides/docker-in-docker/) for instructions on combining Docker with the SandboxSDK. For general Containers usage, see the [Containers FAQ](/containers/faq/#can-i-run-docker-inside-a-container-docker-in-docker). |
Contributor
There was a problem hiding this comment.
Suggested change
| For [Sandbox SDK](/sandbox/) users, see the [Docker-in-Docker guide](/sandbox/guides/docker-in-docker/) for instructions on combining Docker with the SandboxSDK. For general Containers usage, see the [Containers FAQ](/containers/faq/#can-i-run-docker-inside-a-container-docker-in-docker). | |
| For [Sandbox SDK](/sandbox/) users, refer to the [Docker-in-Docker guide](/sandbox/guides/docker-in-docker/) for instructions on combining Docker with the SandboxSDK. For general Containers usage, refer to the [Containers FAQ](/containers/faq/#can-i-run-docker-inside-a-container-docker-in-docker). |
|
|
||
| Use Docker-in-Docker when you need to: | ||
|
|
||
| - **Develop containerized applications** - Run `docker build` to create images from Dockerfiles |
Contributor
There was a problem hiding this comment.
Suggested change
| - **Develop containerized applications** - Run `docker build` to create images from Dockerfiles | |
| - **Develop containerized applications**: Run `docker build` to create images from Dockerfiles |
| Use Docker-in-Docker when you need to: | ||
|
|
||
| - **Develop containerized applications** - Run `docker build` to create images from Dockerfiles | ||
| - **Run Docker as part of CI/CD** - Respond to code changes and build and push images using Cloudflare Containers |
Contributor
There was a problem hiding this comment.
Suggested change
| - **Run Docker as part of CI/CD** - Respond to code changes and build and push images using Cloudflare Containers | |
| - **Run Docker as part of CI/CD**: Respond to code changes and build and push images using Cloudflare Containers |
|
|
||
| - **Develop containerized applications** - Run `docker build` to create images from Dockerfiles | ||
| - **Run Docker as part of CI/CD** - Respond to code changes and build and push images using Cloudflare Containers | ||
| - **Run arbitrary container images** - Start containers from an end-user provided image |
Contributor
There was a problem hiding this comment.
Suggested change
| - **Run arbitrary container images** - Start containers from an end-user provided image | |
| - **Run arbitrary container images**: Start containers from an end-user provided image |
|
|
||
| Docker-in-Docker in Cloudflare Containers has the following limitations: | ||
|
|
||
| - **No iptables** - Network isolation features that rely on iptables are not available |
Contributor
There was a problem hiding this comment.
Suggested change
| - **No iptables** - Network isolation features that rely on iptables are not available | |
| - **No iptables**: Network isolation features that rely on iptables are not available. |
| Docker-in-Docker in Cloudflare Containers has the following limitations: | ||
|
|
||
| - **No iptables** - Network isolation features that rely on iptables are not available | ||
| - **Rootless mode only** - You cannot use privileged containers or features requiring root |
Contributor
There was a problem hiding this comment.
Suggested change
| - **Rootless mode only** - You cannot use privileged containers or features requiring root | |
| - **Rootless mode only**: You cannot use privileged containers or features requiring root. |
|
|
||
| - **No iptables** - Network isolation features that rely on iptables are not available | ||
| - **Rootless mode only** - You cannot use privileged containers or features requiring root | ||
| - **Ephemeral storage** - Built images and containers are lost when the sandbox sleeps. You must persist them manually. |
Contributor
There was a problem hiding this comment.
Suggested change
| - **Ephemeral storage** - Built images and containers are lost when the sandbox sleeps. You must persist them manually. | |
| - **Ephemeral storage**: Built images and containers are lost when the sandbox sleeps. You must persist them manually. |
|
|
||
| ## Related resources | ||
|
|
||
| - [Dockerfile reference](/sandbox/configuration/dockerfile/) - Customize your sandbox image |
Contributor
There was a problem hiding this comment.
Suggested change
| - [Dockerfile reference](/sandbox/configuration/dockerfile/) - Customize your sandbox image | |
| - [Dockerfile reference](/sandbox/configuration/dockerfile/): Customize your sandbox image |
| ## Related resources | ||
|
|
||
| - [Dockerfile reference](/sandbox/configuration/dockerfile/) - Customize your sandbox image | ||
| - [Execute commands](/sandbox/guides/execute-commands/) - Run commands in the sandbox |
Contributor
There was a problem hiding this comment.
Suggested change
| - [Execute commands](/sandbox/guides/execute-commands/) - Run commands in the sandbox | |
| - [Execute commands](/sandbox/guides/execute-commands/): Run commands in the sandbox |
|
|
||
| - [Dockerfile reference](/sandbox/configuration/dockerfile/) - Customize your sandbox image | ||
| - [Execute commands](/sandbox/guides/execute-commands/) - Run commands in the sandbox | ||
| - [Background processes](/sandbox/guides/background-processes/) - Manage long-running processes |
Contributor
There was a problem hiding this comment.
Suggested change
| - [Background processes](/sandbox/guides/background-processes/) - Manage long-running processes | |
| - [Background processes](/sandbox/guides/background-processes/): Manage long-running processes |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
5 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds Docker-in-Docker docs for SandboxSDK and a changelog
Documentation checklist