From b11c5d940ddd8336a45862f6f71d16e37e350138 Mon Sep 17 00:00:00 2001 From: github-actions Date: Thu, 30 Jul 2026 14:26:48 +0000 Subject: [PATCH] Automated documentation update [skip ci] --- src/alpine/README.md | 2 +- src/cpp-mariadb/README.md | 4 ++-- src/cpp/README.md | 4 ++-- src/debian/README.md | 1 + src/docker-existing-dockerfile/README.md | 2 +- src/java-postgres/README.md | 11 +++-------- src/java/README.md | 2 +- src/javascript-node-mongo/README.md | 2 +- src/javascript-node-postgres/README.md | 4 ++-- src/javascript-node/README.md | 2 +- src/php-mariadb/README.md | 2 +- src/php/README.md | 2 +- src/postgres/README.md | 2 +- src/python/README.md | 2 +- src/ruby-rails-postgres/README.md | 2 +- src/ruby/README.md | 2 +- src/rust-postgres/README.md | 2 +- src/typescript-node/README.md | 2 +- src/ubuntu/README.md | 2 +- 19 files changed, 24 insertions(+), 28 deletions(-) diff --git a/src/alpine/README.md b/src/alpine/README.md index 64cca402..20c8df09 100644 --- a/src/alpine/README.md +++ b/src/alpine/README.md @@ -7,7 +7,7 @@ Simple Alpine container with Git installed. | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | Alpine version: | string | 3.22 | +| imageVariant | Alpine version: | string | 3.23 | This template references an image that was [pre-built](https://containers.dev/implementors/reference/#prebuilding) to automatically include needed devcontainer.json metadata. diff --git a/src/cpp-mariadb/README.md b/src/cpp-mariadb/README.md index 9cd4dd30..f61009e4 100644 --- a/src/cpp-mariadb/README.md +++ b/src/cpp-mariadb/README.md @@ -1,5 +1,5 @@ -# C++ & MariaDB (cpp-mariadb) +# cpp-mariadb Develop C++ applications on Linux. Includes Debian C++ build tools. @@ -7,7 +7,7 @@ Develop C++ applications on Linux. Includes Debian C++ build tools. | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | Debian / Ubuntu version (use Debian 12, Debian 11, Ubuntu 24.04, and Ubuntu 22.04 on local arm64/Apple Silicon): | string | debian12 | +| imageVariant | Debian / Ubuntu version (use Debian 13, Debian 12, Ubuntu 24.04, and Ubuntu 22.04 on local arm64/Apple Silicon): | string | debian13 | | reinstallCmakeVersionFromSource | Install CMake version different from what base image has already installed. | string | none | This template references an image that was [pre-built](https://containers.dev/implementors/reference/#prebuilding) to automatically include needed devcontainer.json metadata. diff --git a/src/cpp/README.md b/src/cpp/README.md index 8c0e24ac..1a0a90bf 100644 --- a/src/cpp/README.md +++ b/src/cpp/README.md @@ -1,5 +1,5 @@ -# C++ (cpp) +# cpp Develop C++ applications on Linux. Includes Debian C++ build tools. @@ -7,7 +7,7 @@ Develop C++ applications on Linux. Includes Debian C++ build tools. | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | Debian / Ubuntu version (use debian12, debian11, ubuntu24.04, and ubuntu22.04 on local arm64/Apple Silicon): | string | debian12 | +| imageVariant | Debian / Ubuntu version (use Debian 13, Debian 12, Ubuntu 24.04, and Ubuntu 22.04 on local arm64/Apple Silicon): | string | debian13 | | reinstallCmakeVersionFromSource | Install CMake version different from what base image has already installed. | string | none | This template references an image that was [pre-built](https://containers.dev/implementors/reference/#prebuilding) to automatically include needed devcontainer.json metadata. diff --git a/src/debian/README.md b/src/debian/README.md index 419cf291..95d881cf 100644 --- a/src/debian/README.md +++ b/src/debian/README.md @@ -14,6 +14,7 @@ This template references an image that was [pre-built](https://containers.dev/im * **Image**: mcr.microsoft.com/devcontainers/base:debian ([source](https://github.com/devcontainers/images/tree/main/src/base-debian)) * **Applies devcontainer.json contents from image**: Yes ([source](https://github.com/devcontainers/images/blob/main/src/base-debian/.devcontainer/devcontainer.json)) + --- _Note: This file was auto-generated from the [devcontainer-template.json](https://github.com/devcontainers/templates/blob/main/src/debian/devcontainer-template.json). Add additional notes to a `NOTES.md`._ diff --git a/src/docker-existing-dockerfile/README.md b/src/docker-existing-dockerfile/README.md index 5c5fdd76..c9fe9344 100644 --- a/src/docker-existing-dockerfile/README.md +++ b/src/docker-existing-dockerfile/README.md @@ -1,7 +1,7 @@ # Existing Dockerfile (docker-existing-dockerfile) -Sample illustrating reuse of an existing Dockefile. +Sample illustrating reuse of an existing Dockerfile. diff --git a/src/java-postgres/README.md b/src/java-postgres/README.md index b06733bb..db582543 100644 --- a/src/java-postgres/README.md +++ b/src/java-postgres/README.md @@ -7,7 +7,7 @@ Develop applications with Java and PostgreSQL. Includes a Java application conta | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | Java version (use -bookworm, or -bullseye variants on local arm64/Apple Silicon): | string | 21-bullseye | +| imageVariant | Java version (use -trixie, or -bookworm variants on local arm64/Apple Silicon): | string | 25-trixie | | installMaven | Install Maven, a management tool for Java | boolean | false | | installGradle | Install Gradle, a build automation tool for multi-language software development | boolean | false | @@ -18,7 +18,7 @@ This template references an image that was [pre-built](https://containers.dev/im ## Using this template -This template creates two containers, one for Java and one for PostgreSQL. You will be connected to the Java container, and from within that container the PostgreSQL container will be available on **`localhost`** port 5432. The default database is named `postgres` with a user of `postgres` whose password is `postgres`, and if desired this may be changed in `.devcontainer/docker-compose.yml`. Data is stored in a volume named `postgres-data`. +This template creates two containers, one for Java and one for PostgreSQL. You will be connected to the Java container, and from within that container the PostgreSQL container will be available on the hostname **`db`** port 5432. The default database is named `postgres` with a user of `postgres` whose password is `postgres`, and if desired this may be changed in `.devcontainer/docker-compose.yml`. Data is stored in a volume named `postgres-data`. While the template itself works unmodified, it uses the `mcr.microsoft.com/devcontainers/java` image which includes `git`, a non-root `vscode` user with `sudo` access, and a set of common dependencies and Java tools for development. @@ -41,12 +41,7 @@ If needed, you can use `postCreateCommand` to run commands after the container i ### Adding another service -You can add other services to your `.devcontainer/docker-compose.yml` file [as described in Docker's documentation](https://docs.docker.com/compose/compose-file/#service-configuration-reference). However, if you want anything running in this service to be available in the container on localhost, or want to forward the service locally, be sure to add this line to the service config: - -```yaml -# Runs the service on the same network as the database container, allows "forwardPorts" in devcontainer.json function. -network_mode: service:db -``` +You can add other services to your `.devcontainer/docker-compose.yml` file [as described in Docker's documentation](https://docs.docker.com/compose/compose-file/#service-configuration-reference). For inter-service communication, attach new services to the `app-network` bridge network configured in the compose file. ### Using the forwardPorts property diff --git a/src/java/README.md b/src/java/README.md index 96977c3d..a6d48c47 100644 --- a/src/java/README.md +++ b/src/java/README.md @@ -7,7 +7,7 @@ Develop Java applications. Includes the JDK and Java extensions. | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | Java version (use -bookworm, or -bullseye variants on local arm64/Apple Silicon): | string | 21-bullseye | +| imageVariant | Java version (use -trixie, or -bookworm variants on local arm64/Apple Silicon): | string | 25-trixie | | installMaven | Install Maven, a management tool for Java | boolean | false | | installGradle | Install Gradle, a build automation tool for multi-language software development | boolean | false | diff --git a/src/javascript-node-mongo/README.md b/src/javascript-node-mongo/README.md index a719bc15..a47bb4a9 100644 --- a/src/javascript-node-mongo/README.md +++ b/src/javascript-node-mongo/README.md @@ -7,7 +7,7 @@ Develop applications in Node.js and Mongo DB. Includes Node.js, eslint, and yarn | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | Node.js version (use -bullseye variants on local arm64/Apple Silicon): | string | 22-bookworm | +| imageVariant | Node.js version (use -bookworm or -bullseye variants on local arm64/Apple Silicon): | string | 24-bookworm | This template references an image that was [pre-built](https://containers.dev/implementors/reference/#prebuilding) to automatically include needed devcontainer.json metadata. diff --git a/src/javascript-node-postgres/README.md b/src/javascript-node-postgres/README.md index b71867e9..c8ba7a97 100644 --- a/src/javascript-node-postgres/README.md +++ b/src/javascript-node-postgres/README.md @@ -7,7 +7,7 @@ Develop applications in Node.js and PostgreSQL. Includes Node.js, eslint, and ya | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | Node.js version (use -bookworm, -bullseye variants on local arm64/Apple Silicon): | string | 22-bookworm | +| imageVariant | Node.js version (use -trixie, -bookworm, or -bullseye variants on local arm64/Apple Silicon): | string | 24-trixie | This template references an image that was [pre-built](https://containers.dev/implementors/reference/#prebuilding) to automatically include needed devcontainer.json metadata. @@ -16,7 +16,7 @@ This template references an image that was [pre-built](https://containers.dev/im ## Using this template -This definition creates two containers, one for Node.js and one for PostgreSQL. You will be connected to the Node.js container, and from within that container the PostgreSQL container will be available on **`localhost`** port 5432. The default database is named `postgres` with a user of `postgres` whose password is `postgres`, and if desired this may be changed in `docker-compose.yml`. Data is stored in a volume named `postgres-data`. +This definition creates two containers, one for Node.js and one for PostgreSQL. You will be connected to the Node.js container, and from within that container the PostgreSQL container will be available on **`db`** port 5432. The default database is named `postgres` with a user of `postgres` whose password is `postgres`, and if desired this may be changed in `docker-compose.yml`. Data is stored in a volume named `postgres-data`. While the definition itself works unmodified, it uses the `mcr.microsoft.com/devcontainers/javascript-node` image which includes `git`, `eslint`, `zsh`, [Oh My Zsh!](https://ohmyz.sh/), a non-root `vscode` user with `sudo` access, and a set of common dependencies for development. diff --git a/src/javascript-node/README.md b/src/javascript-node/README.md index 7f5f564b..8bcc8910 100644 --- a/src/javascript-node/README.md +++ b/src/javascript-node/README.md @@ -7,7 +7,7 @@ Develop Node.js based applications. Includes Node.js, eslint, nvm, and yarn. | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | Node.js version (use -bookworm, -bullseye variants on local arm64/Apple Silicon): | string | 22-bookworm | +| imageVariant | Node.js version (use -trixie, -bookworm, or -bullseye variants on local arm64/Apple Silicon): | string | 24-trixie | This template references an image that was [pre-built](https://containers.dev/implementors/reference/#prebuilding) to automatically include needed devcontainer.json metadata. diff --git a/src/php-mariadb/README.md b/src/php-mariadb/README.md index 4ef91199..896af629 100644 --- a/src/php-mariadb/README.md +++ b/src/php-mariadb/README.md @@ -7,7 +7,7 @@ Develop PHP applications with MariaDB (MySQL Compatible). | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | PHP version (use -bookworm, -bullseye variants on local arm64/Apple Silicon): | string | 8.5-trixie | +| imageVariant | PHP version (use -trixie, -bookworm, -bullseye variants on local arm64/Apple Silicon): | string | 8.5-trixie | This template references an image that was [pre-built](https://containers.dev/implementors/reference/#prebuilding) to automatically include needed devcontainer.json metadata. diff --git a/src/php/README.md b/src/php/README.md index 7b23cdfa..981fe8ee 100644 --- a/src/php/README.md +++ b/src/php/README.md @@ -7,7 +7,7 @@ Develop PHP based applications. Includes needed tools, extensions, and dependenc | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | PHP version (use -bookworm, -bullseye variants on local arm64/Apple Silicon): | string | 8.5-trixie| +| imageVariant | PHP version (use -trixie, -bookworm, -bullseye variants on local arm64/Apple Silicon): | string | 8.5-trixie | This template references an image that was [pre-built](https://containers.dev/implementors/reference/#prebuilding) to automatically include needed devcontainer.json metadata. diff --git a/src/postgres/README.md b/src/postgres/README.md index d8c3fb0a..7e950f0b 100644 --- a/src/postgres/README.md +++ b/src/postgres/README.md @@ -7,7 +7,7 @@ Develop applications with Python 3 and PostgreSQL. Includes a Python application | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | Python version (use -bookworm, or -bullseye variants on local arm64/Apple Silicon): | string | 3.11-bullseye | +| imageVariant | Python version (use -trixie, -bookworm, or -bullseye variants on local arm64/Apple Silicon): | string | 3.14-trixie | This template references an image that was [pre-built](https://containers.dev/implementors/reference/#prebuilding) to automatically include needed devcontainer.json metadata. diff --git a/src/python/README.md b/src/python/README.md index 8e3add14..353394b3 100644 --- a/src/python/README.md +++ b/src/python/README.md @@ -7,7 +7,7 @@ Develop Python 3 applications. | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | Python version (use -trixie, -bookworm, or -bullseye variants on local arm64/Apple Silicon): | string | 3.13-trixie | +| imageVariant | Python version (use -trixie, or -bookworm variants on local arm64/Apple Silicon): | string | 3.14-trixie | This template references an image that was [pre-built](https://containers.dev/implementors/reference/#prebuilding) to automatically include needed devcontainer.json metadata. diff --git a/src/ruby-rails-postgres/README.md b/src/ruby-rails-postgres/README.md index c37b7784..c48b57d0 100644 --- a/src/ruby-rails-postgres/README.md +++ b/src/ruby-rails-postgres/README.md @@ -7,7 +7,7 @@ Develop Ruby on Rails applications with Postgres. Includes a Rails application c | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | Ruby version (use -trixie, -bookworm, -bullseye variants on local arm64/Apple Silicon) : | string |4-trixie | +| imageVariant | Ruby version (use - trixie, -bookworm, -bullseye variants on local arm64/Apple Silicon): | string | 4-trixie | This template references an image that was [pre-built](https://containers.dev/implementors/reference/#prebuilding) to automatically include needed devcontainer.json metadata. diff --git a/src/ruby/README.md b/src/ruby/README.md index de614eac..054a52b6 100644 --- a/src/ruby/README.md +++ b/src/ruby/README.md @@ -7,7 +7,7 @@ Develop Ruby based applications. includes everything you need to get up and runn | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | Ruby version (use -trixie, -bookworm, -bullseye variants on local arm64/Apple Silicon) : | string |4-trixie | +| imageVariant | Ruby version (use -trixie, -bookworm, -bullseye variants on local arm64/Apple Silicon): | string | 4-trixie | This template references an image that was [pre-built](https://containers.dev/implementors/reference/#prebuilding) to automatically include needed devcontainer.json metadata. diff --git a/src/rust-postgres/README.md b/src/rust-postgres/README.md index 169ca3f8..2a6877cf 100644 --- a/src/rust-postgres/README.md +++ b/src/rust-postgres/README.md @@ -7,7 +7,7 @@ Develop applications with Rust and PostgreSQL. Includes a Rust application conta | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | Debian OS version (use trixie, bookworm, or bullseye on local arm64/Apple Silicon): | string | trixie | +| imageVariant | Debian OS version (use bookworm, or bullseye on local arm64/Apple Silicon): | string | trixie | This template references an image that was [pre-built](https://containers.dev/implementors/reference/#prebuilding) to automatically include needed devcontainer.json metadata. diff --git a/src/typescript-node/README.md b/src/typescript-node/README.md index 3d309eb9..56ad869a 100644 --- a/src/typescript-node/README.md +++ b/src/typescript-node/README.md @@ -7,7 +7,7 @@ Develop Node.js based applications in TypeScript. Includes Node.js, eslint, nvm, | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | Node.js version (use -bookworm, -bullseye variants on local arm64/Apple Silicon): | string | 22-bookworm | +| imageVariant | Node.js version (use -trixie, -bookworm, or -bullseye variants on local arm64/Apple Silicon): | string | 24-trixie | This template references an image that was [pre-built](https://containers.dev/implementors/reference/#prebuilding) to automatically include needed devcontainer.json metadata. diff --git a/src/ubuntu/README.md b/src/ubuntu/README.md index ef7b1140..41cd1b54 100644 --- a/src/ubuntu/README.md +++ b/src/ubuntu/README.md @@ -7,7 +7,7 @@ A simple Ubuntu container with Git and other common utilities installed. | Options Id | Description | Type | Default Value | |-----|-----|-----|-----| -| imageVariant | Ubuntu version (use ubuntu 26.04 or ubuntu24.04 or ubuntu22.04 on local arm64/Apple Silicon): | string | resolute | noble | jammy +| imageVariant | Ubuntu version (use ubuntu-26.04 or ubuntu-24.04 or ubuntu-22.04 on local arm64/Apple Silicon): | string | resolute | This template references an image that was [pre-built](https://containers.dev/implementors/reference/#prebuilding) to automatically include needed devcontainer.json metadata.