klein2ms/base-devcontainer repository overview

⁠base-devcontainer

A base development container for Visual Studio Code.

⁠Motivation

The intention behind this project is to create a base development container that can be used as a starting point for language specific development environments. This centralizes common configuration that is language agnostic such as the shell and terminal setup.

The overall intention is to create out-of-the-box development experiences so that developers can get going quickly.

⁠Prerequisites

• Docker⁠ is installed and running
• Docker Compose⁠ is installed
• Visual Studio Code⁠ is installed
• Visual Studio Code Remote - Containers⁠ is installed

⁠Features

• Access and manage Docker on the Host machine from within the dev container
• Starship⁠ is installed as the default shell prompt
• GitHub CLI⁠ is installed

⁠Usage

This image is really intended for use as a base image for language specific container images.

⁠Customization

This image accepts build arguments that can be set when building a derived image to extend the base image with additional packages and configurations.

This prevents the need of having to author additional code in the Dockerfile for a derived image. But, obviously that can be done as well.

⁠Install additional Debian packages

Add DEBIAN_DEPS with a list of space separated packages to the list of build arguments.

# .devcontainer/docker-compose.yml
app:
    build:
        args:
            DEBIAN_DEPS: "nano tree"

⁠Install nodejs⁠ and npm⁠ packages

Add NPM_DEPS with a list of space separated packages to the list of build arguments.

# .devcontainer/docker-compose.yml
app:
    build:
        args:
            NPM_DEPS: "yarn gulp"

⁠Prior Art and Acknowledgements

• This project is highly influenced by the godevcontainer⁠ created by @qdm12.

⁠License

This repository is under an MIT license⁠ unless otherwise indicated.