feat: add DevContainer setup (#28)

Author: pashagolub

.devcontainer/Dockerfile

@@ -0,0 +1,57 @@
+FROM debian:bookworm-slim
+
+ENV DEBIAN_FRONTEND=noninteractive
+ENV PG_MAJOR=17
+
+# Install system dependencies
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+        ca-certificates curl gnupg apt-transport-https \
+        build-essential git pkg-config \
+        libreadline-dev zlib1g-dev flex bison \
+        libxml2-dev libxslt-dev libssl-dev \
+        libxml2-utils xsltproc ccache \
+        clang libclang-dev \
+        protobuf-compiler libprotobuf-dev \
+        sudo \
+    && update-ca-certificates \
+    && sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt bookworm-pgdg main" > /etc/apt/sources.list.d/pgdg.list' \
+    && curl -fsSL https://www.postgresql.org/media/keys/ACCC4CF8.asc | gpg --dearmor -o /etc/apt/trusted.gpg.d/postgresql.gpg \
+    && apt-get update \
+    && apt-get install -y --no-install-recommends \
+        postgresql-$PG_MAJOR \
+        postgresql-server-dev-$PG_MAJOR \
+        postgresql-common \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create vscode user with sudo access
+RUN groupadd --gid 1000 vscode \
+    && useradd --uid 1000 --gid 1000 -m -s /bin/bash vscode \
+    && echo "vscode ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers.d/vscode \
+    && chmod 0440 /etc/sudoers.d/vscode \
+    && chown -R vscode:vscode /usr/share/postgresql /usr/lib/postgresql
+
+# Switch to vscode user
+USER vscode
+WORKDIR /home/vscode
+
+# Set up Rust environment for vscode user
+ENV RUSTUP_HOME=/home/vscode/.rustup
+ENV CARGO_HOME=/home/vscode/.cargo
+ENV PATH="/home/vscode/.cargo/bin:/usr/lib/postgresql/$PG_MAJOR/bin:${PATH}"
+
+# Install Rust
+RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain stable \
+    && . "$CARGO_HOME/env" \
+    && rustup component add clippy rustfmt rust-src
+
+# Install cargo-pgrx
+ENV CARGO_PGRX_VERSION=0.16.1
+RUN . "$CARGO_HOME/env" \
+    && cargo install --force --locked cargo-pgrx@"${CARGO_PGRX_VERSION}"
+
+# Initialize pgrx
+RUN . "$CARGO_HOME/env" \
+    && cargo pgrx init --pg$PG_MAJOR $(which pg_config)
+

.devcontainer/devcontainer.json

@@ -0,0 +1,28 @@
+{
+    "name": "rust-dev",
+    "build": {
+        "dockerfile": "Dockerfile"
+    },
+    "features": {
+        "ghcr.io/devcontainers/features/common-utils:2": {},
+        "ghcr.io/devcontainers/features/docker-outside-of-docker:1": {},
+        "ghcr.io/devcontainers/features/git:1": {},
+        "ghcr.io/devcontainers/features/github-cli:1": {}
+    },
+    "customizations": {
+        "vscode": {
+            "settings": {
+                "terminal.integrated.shell.linux": "/bin/bash"
+            },            
+            "extensions": [
+                "rust-lang.rust-analyzer",
+                "fill-labs.dependi",
+                "mk12.better-git-line-blame"
+            ]
+        }
+    },
+    "remoteUser": "vscode",
+    "mounts": [
+        "source=cargo-registry,target=/usr/local/cargo/registry,type=volume"
+    ]
+}

README.md

@@ -2,7 +2,27 @@
 
 A foreign data wrapper around etcd for postgres
 
-## Setup
+## Development Setup
+
+### Option 1: Using DevContainer
+
+The easiest way to get started is using the provided DevContainer configuration:
+
+1. **Prerequisites**
+   - [Docker Desktop](https://www.docker.com/products/docker-desktop/) or Docker Engine
+   - [VS Code](https://code.visualstudio.com/) with the [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
+
+2. **Open in DevContainer**
+   - Open this project in VS Code
+   - Press `F1` and select "Dev Containers: Reopen in Container"
+   - Wait for the container to build (~4 minutes first time)
+
+3. **Start Developing**
+   - All dependencies are pre-installed (Rust, cargo-pgrx, PostgreSQL 17, protobuf)
+   - Cargo cache volumes ensure fast rebuilds
+   - Run `cargo pgrx run` to build and test
+
+### Option 2: Manual Setup
 
 - Install pgrx on your machine `cargo install --locked cargo-pgrx --version 0.16.1`
 - Setup pgrx `cargo pgrx init`