Development Container Images Published docker images for use as development containers

A development container is a running Docker container with a well-defined tool/runtime stack and its prerequisites. It allows you to use a container as a full-featured development environment which can be used to run an application, to separate tools, libraries, or runtimes needed for working with a codebase, and to aid in continuous integration and testing.

This repository contains a set of dev container images which are Docker images built with dev container features.

• src - Contains reusable dev container images.

The Development Containers Specification seeks to find ways to enrich existing formats with common development specific settings, tools, and configuration while still providing a simplified, un-orchestrated single container option – so that they can be used as coding environments or for continuous integration and testing. You may review the spec and learn more about it in the devcontainers/spec repo and containers.dev.

This repository supplies images that may be used in dev container configurations that follow the spec.

A devcontainer.json file is similar to launch.json for debugging, but designed to launch (or attach to) a development container instead. At its simplest, all you need is a .devcontainer/devcontainer.json file in your project that references an image, Dockerfile, or docker-compose.yml, and a few properties.

Each RUN statement creates a Docker image "layer". If one RUN statement adds temporary contents, these contents remain in this layer in the image even if they are deleted in a subsequent RUN. This means the image takes more storage locally and results in slower image download times if you publish the image to a registry. You can resolve this problem by using a RUN statement that includes any clean up steps (separated by &&) after a given operation. You can find more tips here.

If you want to create your own image or add functionality on top of the images available in this repository, then see How to write Dockerfiles and the dev container features reference.

Use semantic versioning when changing an existing image. Every contributor PR that changes an image must bump its manifest.json: for breaking changes, such as a base OS change, increment the major component and reset minor and patch components (3.4.0 -> 4.0.0); for new features, increment minor and reset patch (3.4.0 -> 3.5.0); and for security or bug fixes, increment only patch (3.4.0 -> 3.4.1). Release preparation applies its own +0.0.1 bump and updates the README version references. Contributors must update README version pins for major or minor changes, while patch PRs must not update those pins, leaving them out of sync until release preparation; unrelated README documentation edits remain valid.

This repository contains a select set of images, and we encourage the community to host and share additional images, and features rather than adding them here. You may learn more about this process in the guidance in our spec repo. You may also check out the features repo for additional customizations you may adopt or modify for your dev containers.

Issues related to these images can be reported in an issue in this repository.

Copyright (c) Microsoft Corporation. All rights reserved.
Licensed under the MIT License. See LICENSE.

For images generated from this repository, see LICENSE and NOTICE.txt.