Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/devcontainers/images

Repository for pre-built dev container images published under mcr.microsoft.com/devcontainers
https://github.com/devcontainers/images

containers devcontainers

Last synced: about 2 months ago
JSON representation

Repository for pre-built dev container images published under mcr.microsoft.com/devcontainers

Host: GitHub
URL: https://github.com/devcontainers/images
Owner: devcontainers
License: mit
Created: 2022-05-09T14:11:11.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2024-05-21T21:09:46.000Z (4 months ago)
Last Synced: 2024-05-21T22:24:30.321Z (4 months ago)
Topics: containers, devcontainers
Language: JavaScript
Homepage: https://containers.dev
Size: 7.06 MB
Stars: 1,053
Watchers: 31
Forks: 385
Open Issues: 56
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: CODEOWNERS

Awesome Lists containing this project

README

# Development Containers Images

Development Container Images

Published docker images for use as development containers

A **development container** is a running [Docker](https://www.docker.com) 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](https://github.com/devcontainers/features).

## Contents

- [`src`](src) - Contains reusable dev container images.

## Common Questions
### How does this repo relate to the dev container spec? What is the dev container specification?

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](https://github.com/devcontainers/spec) repo and [containers.dev](https://containers.dev/).

This repository supplies images that may be used in dev container configurations that follow the spec.
### What is the goal of `devcontainer.json`?

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.

### Why do Dockerfiles in this repo use `RUN` statements with commands separated by `&&`?

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](./docs/TIPS.md/#why-do-dockerfiles-in-this-repository-use-run-statements-with-commands-separated-by).

### How can I contribute?

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](https://docs.docker.com/develop/develop-images/dockerfile_best-practices/) and the [dev container features reference](https://containers.dev/implementors/features/).

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](https://containers.dev/implementors/features-distribution/) in our spec repo. You may also check out the [features](https://github.com/devcontainers/features) repo for additional customizations you may adopt or modify for your dev containers.

## Feedback

Issues related to these images can be reported in [an issue](https://github.com/devcontainers/images/issues) in this repository.

For images generated from this repository, see [LICENSE](https://github.com/microsoft/containerregistry/blob/main/legal/Container-Images-Legal-Notice.md) and [NOTICE.txt](NOTICE.txt).