From 9509f9581788c25fa0526c70b0273aa37bb6e7cf Mon Sep 17 00:00:00 2001 From: Marvin Gajek Date: Fri, 16 Jan 2026 14:14:36 +0000 Subject: [PATCH 1/2] feat(Containerization): Update devcontainer to Ubuntu 24.04 with build tools Switch from Debian Bullseye to Ubuntu 24.04 for CI alignment. Install mdl for markdown linting, Python dependencies from tools/requirements.txt, pre-commit hooks and yarn dependencies for website build. Add VS Code markdown linting extension to devcontainer configuration. Configure port forwarding for Docusaurus dev server on port 3000 to enable local browser access from host machine. Update README with quick start information for developers using the devcontainer with IDEs supporting the devcontainer specification. Closes: #623 --- .devcontainer/devcontainer.json | 13 +++++++++++-- README.md | 3 +++ 2 files changed, 14 insertions(+), 2 deletions(-) diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json index 0b7f483195e..dcc6e27b637 100644 --- a/.devcontainer/devcontainer.json +++ b/.devcontainer/devcontainer.json @@ -1,6 +1,6 @@ { "name": "Rucio-Docs", - "image": "mcr.microsoft.com/devcontainers/base:bullseye", + "image": "mcr.microsoft.com/devcontainers/base:ubuntu-24.04", "features": { "ghcr.io/devcontainers/features/docker-in-docker:2": { "version": "latest", @@ -10,5 +10,14 @@ "ghcr.io/devcontainers/features/node:1": {}, "ghcr.io/devcontainers/features/python:1": {}, "ghcr.io/devcontainers/features/ruby:1": {} + }, + "forwardPorts": [3000], + "postCreateCommand": "gem install mdl && python3 -m pip install --break-system-packages -r tools/requirements.txt pre-commit && cd website && yarn install", + "customizations": { + "vscode": { + "extensions": [ + "davidanson.vscode-markdownlint" + ] + } } -} +} \ No newline at end of file diff --git a/README.md b/README.md index a9e62ad2511..271fc63dffe 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,9 @@ links](https://github.com/rucio/documentation/actions/workflows/check_external_l This project contains the documentation for the **[Rucio](https://github.com/rucio/rucio)** data-management software. +> **Quick Start**: A [devcontainer](.devcontainer/devcontainer.json) is available with all tools pre-installed. Open in IDEs supporting devcontainers (e.g. VS Code with Dev Containers extension). +> +> **Running the dev server**: Inside the devcontainer, run `cd website && yarn start --host 0.0.0.0` then access http://localhost:3000/documentation/ in your browser. ## Contribution From 4ddec870aaf8d41f5a76995209d29ef22ef80277 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Thu, 29 Jan 2026 11:49:23 +0000 Subject: [PATCH 2/2] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- .devcontainer/devcontainer.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json index dcc6e27b637..396e8d9819b 100644 --- a/.devcontainer/devcontainer.json +++ b/.devcontainer/devcontainer.json @@ -20,4 +20,4 @@ ] } } -} \ No newline at end of file +}