Skip to content

Latest commit

 

History

History
56 lines (36 loc) · 2.96 KB

README.md

File metadata and controls

56 lines (36 loc) · 2.96 KB

Docker (Docker-in-Docker) (docker-in-docker)

Create child containers inside a container, independent from the host's docker instance. Installs Docker extension in the container along with needed CLIs.

Example Usage

"features": {
    "ghcr.io/bartventer/arch-devcontainer-features/docker-in-docker:1": {}
}

Options

Options Id Description Type Default Value
version Select or enter a Docker/Moby Engine version. (Availability can vary by OS version.) string latest
dockerDashComposeVersion Compose version to use for docker-compose (v1 or v2 or none) string v2
azureDnsAutoDetection Allow automatically setting the dockerd DNS server when the installation script detects it is running in Azure boolean true
dockerDefaultAddressPool Define default address pools for Docker networks. e.g. base=192.168.0.0/16,size=24 string -
installDockerBuildx Install Docker Buildx boolean true
installDockerComposeSwitch Install Compose Switch (provided docker compose is available) which is a replacement to the Compose V1 docker-compose (python) executable. It translates the command line into Compose V2 docker compose then runs the latter. boolean true
enableDockerAutocompletion Enable Docker CLI autocompletion boolean true

Customizations

VS Code Extensions

  • ms-azuretools.vscode-docker

Limitations

This docker-in-docker Dev Container Feature is roughly based on the official docker-in-docker wrapper script that is part of the Moby project. With this in mind:

  • As the name implies, the Feature is expected to work when the host is running Docker (or the OSS Moby container engine it is built on). It may be possible to get running in other container engines, but it has not been tested with them.
  • The host and the container must be running on the same chip architecture. You will not be able to use it with an emulated x86 image with Docker Desktop on an Apple Silicon Mac, like in this example: 
    FROM --platform=linux/amd64 mcr.microsoft.com/devcontainers/typescript-node:16
    See Issue #219 for more details.

OS Support

This Feature should work on recent versions of Arch Linux-based distributions with the pacman package manager installed.

bash is required to execute the install.sh script.

Acknowledgments

This project makes use of code from the devcontainers/features project. We thank the authors of devcontainers/features for their work and for making their code available for reuse.

Note: This file was auto-generated from the devcontainer-feature.json. Add additional notes to a NOTES.md.