Merge pull request IvorySQL#982 from rophy/feat/dev-container

feat: dev container

Author: gaoxueyu

.devcontainer/Dockerfile

@@ -0,0 +1,59 @@
+# IvorySQL Build and Test Container - Modern Ubuntu
+# Alternative to CentOS with same capabilities
+
+FROM ubuntu:22.04
+
+# Prevent interactive prompts
+ENV DEBIAN_FRONTEND=noninteractive
+
+# Install build dependencies matching the workflow requirements
+RUN apt-get update && apt-get install -y \
+    # Build tools
+    build-essential git lcov bison flex pkg-config cppcheck \
+    # Core dependencies
+    libkrb5-dev libssl-dev libldap-dev libpam-dev \
+    libxml2-dev libxslt-dev libreadline-dev libedit-dev \
+    zlib1g-dev uuid-dev libossp-uuid-dev libuuid1 e2fsprogs \
+    # ICU support
+    libicu-dev \
+    # Language support
+    python3-dev tcl-dev libperl-dev gettext \
+    # Perl test modules
+    libipc-run-perl libtime-hires-perl libtest-simple-perl \
+    # LLVM/Clang
+    llvm clang \
+    # LZ4 compression
+    liblz4-dev \
+    # System libraries
+    libselinux1-dev libsystemd-dev \
+    # GSSAPI
+    libgssapi-krb5-2 \
+    # Locale support
+    locales \
+    # For dev containers
+    sudo tini \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set up locale
+RUN locale-gen en_US.UTF-8
+ENV LANG=en_US.UTF-8 \
+    LANGUAGE=en_US:en \
+    LC_ALL=en_US.UTF-8
+
+# Create ivorysql user with matching host UID/GID (1000:1000)
+# and grant sudo privileges without password
+ARG USER_UID=1000
+ARG USER_GID=1000
+RUN groupadd -g ${USER_GID} ivorysql || true && \
+    useradd -m -u ${USER_UID} -g ${USER_GID} -d /home/ivorysql -s /bin/bash ivorysql && \
+    echo "ivorysql ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers
+
+# Set working directory
+WORKDIR /home/ivorysql/IvorySQL
+
+# Switch to ivorysql user for builds
+USER ivorysql
+
+# Default command
+ENTRYPOINT ["/usr/bin/tini", "--"]
+CMD ["/bin/bash"]

.devcontainer/devcontainer.json

@@ -0,0 +1,22 @@
+{
+  "name": "IvorySQL Dev",
+  "dockerComposeFile": "../docker-compose.yaml",
+  "service": "dev",
+  "workspaceFolder": "/home/ivorysql/IvorySQL",
+  "remoteUser": "ivorysql",
+  "customizations": {
+    "vscode": {
+      "settings": {
+        "terminal.integrated.defaultProfile.linux": "bash",
+        "C_Cpp.default.configurationProvider": "ms-vscode.makefile-tools"
+      },
+      "extensions": [
+        "ms-vscode.cpptools",
+        "ms-vscode.makefile-tools",
+        "twxs.cmake",
+        "mhutchie.git-graph",
+        "eamodio.gitlens"
+      ]
+    }
+  }
+}

README.md

@@ -31,6 +31,37 @@ Furthermore, for more detailed installation instructions, please refer to the [I
 - [Rpm installation](https://docs.ivorysql.org/en/ivorysql-doc/v5.0/v5.0/4.1#Rpm-installation)
 - [Source code installation](https://docs.ivorysql.org/en/ivorysql-doc/v5.0/v5.0/4.1#Source-code-installation)
 
+## Development with Docker
+
+For a consistent development environment, we provide a Docker-based setup that includes all build dependencies.
+
+### Quick Start
+
+```bash
+# Start the development containers
+docker compose up -d
+
+# Enter the development container
+docker compose exec dev bash
+
+# Configure and build IvorySQL
+./configure --prefix=/home/ivorysql/ivorysql \
+    --enable-debug --enable-cassert \
+    --with-uuid=e2fs --with-libxml
+
+make -j$(nproc)
+make install
+
+# Initialize database in Oracle mode
+initdb -D data_ora -m oracle
+
+# Start the server
+pg_ctl -D data_ora start
+
+# Run tests
+make oracle-check
+```
+
 ## Developer Formatting hooks and CI:
 - A pre-commit formatting hook is provided at `.githooks/pre-commit`. Enable it with `git config core.hooksPath .githooks`, or run `make code-format` (equivalently `bash tools/enable-git-hooks.sh`).
 - The hook depends only on in-tree tools `src/tools/pgindent` and `src/tools/pg_bsd_indent`. On commit it formats staged C/C++ files with pgindent and re-adds them to the staged area. 

docker-compose.yaml

@@ -0,0 +1,18 @@
+services:
+  dev:
+    build:
+      context: .
+      dockerfile: .devcontainer/Dockerfile
+    image: ivorysql-dev
+    container_name: ivorysql-dev
+    volumes:
+      - .:/home/ivorysql/IvorySQL:rw
+    working_dir: /home/ivorysql/IvorySQL
+    command: ["sleep", "infinity"]
+ 
+  # docker compose --profile ora up -d
+  oracle:
+    profiles: [ora]
+    image: container-registry.oracle.com/database/free:23.26.0.0-lite
+    environment:
+      ORACLE_PWD: orapwd