{"id":13539618,"url":"https://github.com/devcontainers/templates","last_synced_at":"2025-04-02T06:31:14.576Z","repository":{"id":63149034,"uuid":"490426137","full_name":"devcontainers/templates","owner":"devcontainers","description":"Repository for Dev Container Templates that are managed by Dev Container spec maintainers. See https://github.com/devcontainers/template-starter to create your own!","archived":false,"fork":false,"pushed_at":"2025-03-31T18:31:19.000Z","size":1143,"stargazers_count":1115,"open_issues_count":32,"forks_count":303,"subscribers_count":18,"default_branch":"main","last_synced_at":"2025-03-31T19:33:17.160Z","etag":null,"topics":["containers","devcontainers","templates"],"latest_commit_sha":null,"homepage":"https://containers.dev/templates","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devcontainers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-09T19:57:25.000Z","updated_at":"2025-03-31T18:31:08.000Z","dependencies_parsed_at":"2024-03-23T00:44:22.868Z","dependency_job_id":"2048f176-50c2-41d1-b737-aa250f021c07","html_url":"https://github.com/devcontainers/templates","commit_stats":null,"previous_names":[],"tags_count":112,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devcontainers%2Ftemplates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devcontainers%2Ftemplates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devcontainers%2Ftemplates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devcontainers%2Ftemplates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devcontainers","download_url":"https://codeload.github.com/devcontainers/templates/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246767834,"owners_count":20830564,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["containers","devcontainers","templates"],"created_at":"2024-08-01T09:01:29.557Z","updated_at":"2025-04-02T06:31:10.565Z","avatar_url":"https://github.com/devcontainers.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Development Container Templates\n\n\u003ctable style=\"width: 100%; border-style: none;\"\u003e\u003ctr\u003e\n\u003ctd style=\"width: 140px; text-align: center;\"\u003e\u003ca href=\"https://github.com/devcontainers\"\u003e\u003cimg width=\"128px\" src=\"https://raw.githubusercontent.com/microsoft/fluentui-system-icons/78c9587b995299d5bfc007a0077773556ecb0994/assets/Cube/SVG/ic_fluent_cube_32_filled.svg\" alt=\"devcontainers organization logo\"/\u003e\u003c/a\u003e\u003c/td\u003e\n\u003ctd\u003e\n\u003cstrong\u003eDevelopment Container Templates\u003c/strong\u003e\u003cbr /\u003e\nA simple set of dev container 'templates' to help get you up and running with a containerized environment.\n\u003c/td\u003e\n\u003c/tr\u003e\u003c/table\u003e\n\n\nA **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.\n\nThis repository contains a set of **Dev Container Templates** which are source files packaged together that encode configuration for a complete development environment. A Template can be used in a new or existing project, and a [supporting tool](https://containers.dev/supporting) will use the configuration from the template to build a development container.\n\n## Contents\n \n-   [`src`](src) - A collection of subfolders, each declaring a template. Each subfolder contains at least a\n    `devcontainer-template.json` and a [devcontainer.json](https://containers.dev/implementors/json_reference/).\n-   [`test`](test) - Mirroring `src`, a folder-per-template with at least a `test.sh` script. These tests are executed by the [CI](https://github.com/devcontainers/templates/blob/main/.github/workflows/test-pr.yaml).\n\n## How can I use the Templates?\n\n### 1. Using supporting tools\n\nA variety of tools and services [support](https://containers.dev/supporting) the Dev Container Spec, and they may provide direct integrations with the Templates in this repo. For instance, [Visual Studio Code](https://code.visualstudio.com/) and [GitHub Codespaces](https://docs.github.com/en/codespaces/overview) provide a user-friendly interface to configure the Templates hosted in this repository, as well as the [community-contributed Templates](https://containers.dev/templates). Additionally, you can customize your dev container with additional available [Features](https://containers.dev/features).\n\nFor more information, please refer to the following documents for [VS Code](https://code.visualstudio.com/docs/devcontainers/create-dev-container#_automate-dev-container-creation) and [Github Codespaces](https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#using-a-predefined-dev-container-configuration).\n\n### 2. Using the Dev Container CLI\n\nThe [@devcontainers/cli](https://containers.dev/supporting#devcontainer-cli) offers a `devcontainer templates apply` command to apply a Template hosted in the supported OCI registry.\n\n```\ndevcontainer templates apply\n\nApply a template to the project\n\nOptions:\n      --help              Show help                                                                            [boolean]\n      --version           Show version number                                                                  [boolean]\n  -w, --workspace-folder  Target workspace folder to apply Template                   [string] [required] [default: \".\"]\n  -t, --template-id       Reference to a Template in a supported OCI registry                        [string] [required]\n  -a, --template-args     Arguments to replace within the provided Template, provided as JSON   [string] [default: \"{}\"]\n  -f, --features          Features to add to the provided Template, provided as JSON.           [string] [default: \"[]\"]\n      --log-level         Log level.                               [choices: \"info\", \"debug\", \"trace\"] [default: \"info\"]\n      --tmp-dir           Directory to use for temporary files. If not provided, the system default will be inferred.\n                                                                                                                [string]\n```\n\n#### Example\n\n```\ndevcontainer templates apply --workspace-folder . \\\n    --template-id ghcr.io/devcontainers/templates/cpp:latest \\\n    --template-args '{ \"imageVariant\": \"debian-12\" }' \\\n    --features '[{ \"id\": \"ghcr.io/devcontainers/features/azure-cli:1\", \"options\": { \"version\" : \"1\" } }]'\n```\n\n## Contributions\n\n### Creating your own collection of templates\n\nThe [Dev Container Template specification](https://containers.dev/implementors/templates-distribution/#distribution) outlines a pattern for community members and organizations to self-author Templates in repositories they control.\n\nA starter repository [devcontainers/template-starter](https://github.com/devcontainers/template-starter) and [GitHub Action](https://github.com/devcontainers/action) are available to help bootstrap self-authored Templates.\n\nWe are eager to hear your feedback on self-authoring!  Please provide comments and feedback on [spec issue #71](https://github.com/devcontainers/spec/issues/71).\n\n### Contributing to this repository\n\nThis repository will accept improvement and bug fix contributions related to the\n[current set of maintained templates](./src).\n\n## Feedback\n\nIssues related to these templates can be reported in [an issue](https://github.com/devcontainers/templates/issues) in this repository.\n\n# License\nCopyright (c) Microsoft Corporation. All rights reserved. \u003cbr /\u003e\nLicensed under the MIT License. See [LICENSE](LICENSE).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevcontainers%2Ftemplates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevcontainers%2Ftemplates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevcontainers%2Ftemplates/lists"}