Devcontainers + plugin VSCode

W pracy nad wieloma projektami infrastrukturalnymi (OpenTofu, Ansible, Vault, GitLab CI) szybko pojawia się ten sam problem: jak zapewnić powtarzalne, gotowe do pracy środowisko developerskie — bez ręcznego konfigurowania systemu na każdym laptopie czy VM. Artykuł pokazuje konkretne rozwiązanie, które sprawdza się w codziennej pracy.

Co daje to podejście:

Powtarzalność: identyczne środowisko na każdym hoście — koniec z „u mnie działa”
Izolacja: narzędzia nie brudzą systemu hosta — kontener można zniszczyć i postawić od nowa
Konfiguracja użytkownika: katalog /userfiles z kluczami SSH, .gitconfig, .zshrc montowany jako bind-mount
Automatyzacja: postCreateCommand uruchamia bootstrap przy każdym starcie kontenera
Wersjonowanie obrazu: gotowy kontener publikowany w GitLab Container Registry

Dlaczego Dev Container zamiast Vagranta?

Oba podejścia rozwiązują ten sam problem, ale w różny sposób:

Dev Container: ściślejsza integracja z VSCode, szybszy start (Docker vs VirtualBox), lżejszy (kontener vs VM)
Vagrant: lepsza izolacja sieciowa, pełny OS, przydatny przy testach infrastruktury wymagających VM
W praktyce: Dev Containery sprawdzają się przy pracy z kodem (IaC, skrypty, CI), Vagrant przy testach infrastruktury

⚙️ devcontainer

Środowisko developerskie w kontenerze Docker

Zawartość konfiguracji:

devcontainer.json — konfiguracja kontenera
Dockerfile — własny obraz bazowy
.userfiles/ — symlink do katalogu konfiguracji
bootstrap.sh — skrypt inicjalizacyjny

🔗 Dokumentacja VSCode

🗄️ GitLab Container Registry

Rejestr obrazów dla gotowych kontenerów

Przechowuje:

Obraz deweloperski (opentofu:0.0.1)
Wersjonowanie przez semver
Dostęp z tokenem GitLab
Gotowy do pobrania przez docker pull

🔗 Odwiedź

Krok po kroku

Instalacja Dockera
Instalacja pluginu do VSCode
Utworzenie katalogu /userfiles
Utworzenie dowiązania symbolicznego .userfiles
Konfiguracja .devcontainer/devcontainer.json
Przygotowanie Dockerfile
Przygotowanie skryptu bootstrap

Konfiguracja środowiska

Instalacja Dockera

Docker jest wymagany jako backend dla Dev Containerów. Zainstaluj go zgodnie z oficjalną dokumentacją dla swojego systemu:

# Ubuntu/Debian
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

Plugin VSCode

Zainstaluj oficjalny plugin Dev Containers z marketplace VSCode:

ID pluginu: ms-vscode-remote.remote-containers
Po instalacji w palecie komend pojawi się Dev Containers: Reopen in Container

Katalog `/userfiles`

Katalog /userfiles zawiera konfigurację użytkownika montowaną do każdego kontenera — klucze SSH, aliasy shell, konfigurację git:

/userfiles
├── bootstrap.bash
├── configure_user.bash
├── .zshrc
├── .gitconfig
├── .gitignore_global
└── .ssh/
    ├── priv
    ├── priv.pub
    └── known_hosts

Dzięki bind-mountowi pliki z /userfiles są dostępne wewnątrz kontenera pod tą samą ścieżką — bootstrap kopiuje je do $HOME użytkownika w kontenerze.

Symlink `.userfiles`

W katalogu repozytorium tworzysz symlink wskazujący na /userfiles:

ln -s /userfiles .userfiles

`devcontainer.json`

Plik .devcontainer/devcontainer.json definiuje konfigurację kontenera deweloperskiego:

{
  "name": "iac-gitlab",
  "build": {
    "dockerfile": "Dockerfile"
  },
  "workspaceMount": "source=${localWorkspaceFolder},target=/workspaces/${localWorkspaceFolderBasename},type=bind,consistency=cached",
  "workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
  "runArgs": [
    "--network=host"
  ],
  "mounts": [
    "source=/userfiles,target=/userfiles,type=bind"
  ],
  "customizations": {
    "vscode": {
      "extensions": []
    }
  }
}

Kluczowe elementy:

mounts: bind-mount katalogu /userfiles z hosta do kontenera
runArgs: --network=host przydatne przy testach sieciowych
customizations.vscode.extensions: lista rozszerzeń VSCode instalowanych automatycznie

`Dockerfile`

Własny obraz oparty na Ubuntu 24.04 z minimalistycznym zestawem narzędzi:

FROM ubuntu:24.04

RUN apt-get update \
  && apt-get install -y --no-install-recommends \
    ca-certificates \
    curl \
    direnv \
    git \
    openssh-client \
    sudo \
    tar \
    unzip \
    zsh \
  && rm -rf /var/lib/apt/lists/*

Narzędzia dobrane pod pracę z IaC:

direnv: automatyczne ładowanie zmiennych środowiskowych z .envrc
zsh: shell z możliwością użycia konfiguracji z .userfiles/.zshrc
openssh-client: klucze SSH z /userfiles/.ssh/

Skrypt bootstrap

Skrypt .userfiles/bootstrap.sh uruchamiany przez postCreateCommand przy tworzeniu kontenera:

#!/bin/bash
cp -fr /userfiles/.* $HOME/
source ~/.zshrc
direnv allow

Trzy kroki:

Kopiuje pliki dotfiles z /userfiles do $HOME w kontenerze
Ładuje konfigurację zsh
Aktywuje direnv dla bieżącego katalogu roboczego

Publikacja kontenera

Jeśli chcesz udostępnić gotowy obraz zespołowi, możesz opublikować go w GitLab Container Registry.

Zaloguj się do rejestru
```
docker login registry.gitlab.com
```

Znajdź identyfikator kontenera

VSCode buduje obraz z automatycznie generowaną nazwą — znajdź go poleceniem:

docker images

Przykładowy wynik:

IMAGE                                                                                      ID             DISK USAGE
vsc-iac-gitlab-72c45f5e1ed25a8c0d801e27eec2c072c6ed78470b8589b0d63eefc43917013a:latest    9832794997dc        432MB

Nadaj właściwą nazwę i tag

docker tag vsc-iac-gitlab-72c45f5e1ed25a8c0d801e27eec2c072c6ed78470b8589b0d63eefc43917013a \
  registry.gitlab.com/pl.rachuna-net/artifacts/containers/opentofu:0.0.1

Opublikuj obraz

docker push registry.gitlab.com/pl.rachuna-net/artifacts/containers/opentofu:0.0.1

Zasoby & Linki

Zasób	Czego się nauczysz
Dev Containers Spec	Specyfikacja formatu devcontainer.json
VSCode Dev Containers	Integracja z VSCode
Docker Docs	Budowanie i zarządzanie obrazami
GitLab Container Registry	Publikowanie obrazów
Nasze kontenery	Gotowe obrazy deweloperskie

Maciej Rachuna | rachuna-net.pl

Artykuł opisuje realne środowisko deweloperskie używane przy projektach IaC. Konfiguracja devcontainer.json, Dockerfile i skrypty bootstrap bazują na praktyce, a nie na teorii.