Compare commits
15 Commits
5f5db08ad4
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
| 1be1b4f606 | |||
| 1e6787eb30 | |||
| 050e9c0205 | |||
| 6502b9a2ab | |||
| 688d4ca6d7 | |||
| f284cb118f | |||
| 64cc8cee13 | |||
| b168025ba1 | |||
| 92e09fe29c | |||
| 754fa84a5e | |||
| 3bb88ec54e | |||
| feb7d4c9f8 | |||
| a65f2983f1 | |||
| 35dcc67e6a | |||
| e95d6fa3bd |
+2
-1
@@ -1,4 +1,5 @@
|
|||||||
.git
|
.git
|
||||||
.gitignore
|
.gitignore
|
||||||
README.md
|
|
||||||
*.log
|
*.log
|
||||||
|
README.md
|
||||||
|
certs/README.md
|
||||||
|
|||||||
@@ -0,0 +1 @@
|
|||||||
|
.idea
|
||||||
+26
-33
@@ -4,15 +4,13 @@ ARG UBUNTU_VERSION=26.04
|
|||||||
FROM ubuntu:${UBUNTU_VERSION}
|
FROM ubuntu:${UBUNTU_VERSION}
|
||||||
|
|
||||||
ARG NODE_VERSION=24.21.0
|
ARG NODE_VERSION=24.21.0
|
||||||
ARG OPENCODE_VERSION=2.0.3
|
ARG OPENCODE_VERSION=2.0.22
|
||||||
|
|
||||||
|
ARG EXTRA_APT_PACKAGES=""
|
||||||
|
|
||||||
ARG DEV_UID=1000
|
ARG DEV_UID=1000
|
||||||
ARG DEV_GID=1000
|
ARG DEV_GID=1000
|
||||||
|
|
||||||
# Move the pre-existing ubuntu user/group away from 1000:1000
|
|
||||||
RUN groupmod --gid 1234 ubuntu \
|
|
||||||
&& usermod --uid 1234 --gid 1234 ubuntu
|
|
||||||
|
|
||||||
ENV DEBIAN_FRONTEND=noninteractive
|
ENV DEBIAN_FRONTEND=noninteractive
|
||||||
SHELL ["/bin/bash", "-o", "pipefail", "-c"]
|
SHELL ["/bin/bash", "-o", "pipefail", "-c"]
|
||||||
|
|
||||||
@@ -51,39 +49,41 @@ RUN apt-get update \
|
|||||||
wget \
|
wget \
|
||||||
xz-utils \
|
xz-utils \
|
||||||
zip \
|
zip \
|
||||||
&& update-alternatives --set java /usr/lib/jvm/java-17-openjdk-amd64/bin/java \
|
|
||||||
&& update-alternatives --set javac /usr/lib/jvm/java-17-openjdk-amd64/bin/javac \
|
|
||||||
# && rm -rf /var/lib/apt/lists/*
|
|
||||||
&& echo 'en_US.UTF-8 UTF-8' > /etc/locale.gen \
|
&& echo 'en_US.UTF-8 UTF-8' > /etc/locale.gen \
|
||||||
&& locale-gen
|
&& locale-gen \
|
||||||
|
&& ln -s "$(command -v fdfind)" /usr/local/bin/fd
|
||||||
|
|
||||||
|
RUN if [ -n "${EXTRA_APT_PACKAGES}" ]; then \
|
||||||
|
echo "Installing extra packages: ${EXTRA_APT_PACKAGES}" \
|
||||||
|
&& apt-get install -y --no-install-recommends ${EXTRA_APT_PACKAGES}; \
|
||||||
|
fi
|
||||||
|
|
||||||
|
RUN rm -rf /var/lib/apt/lists/*
|
||||||
|
|
||||||
COPY ./certs /usr/local/share/ca-certificates
|
COPY ./certs /usr/local/share/ca-certificates
|
||||||
RUN update-ca-certificates
|
RUN update-ca-certificates
|
||||||
ENV NODE_EXTRA_CA_CERTS=/etc/ssl/certs/ca-certificates.crt
|
ENV NODE_EXTRA_CA_CERTS=/etc/ssl/certs/ca-certificates.crt
|
||||||
|
|
||||||
# Runtime user
|
# Remove ubuntu user and create the dev one with host uid and gid
|
||||||
RUN groupadd --gid "${DEV_GID}" dev \
|
RUN (userdel -r ubuntu 2>/dev/null || true) \
|
||||||
&& useradd \
|
&& (groupdel ubuntu 2>/dev/null || true) \
|
||||||
--uid "${DEV_UID}" \
|
&& groupadd --gid "${DEV_GID}" dev \
|
||||||
--gid "${DEV_GID}" \
|
&& useradd --uid "${DEV_UID}" --gid "${DEV_GID}" --create-home --shell /bin/bash dev
|
||||||
--create-home \
|
|
||||||
--shell /bin/bash dev
|
|
||||||
|
|
||||||
# Node.js + OpenCode
|
# Node.js + OpenCode
|
||||||
RUN curl -fsSLO \
|
RUN f="node-v${NODE_VERSION}-linux-x64.tar.xz" \
|
||||||
"https://nodejs.org/dist/v${NODE_VERSION}/node-v${NODE_VERSION}-linux-x64.tar.xz" \
|
&& curl -fsSLO "https://nodejs.org/dist/v${NODE_VERSION}/${f}" \
|
||||||
&& tar -xJf \
|
&& curl -fsSLO "https://nodejs.org/dist/v${NODE_VERSION}/SHASUMS256.txt" \
|
||||||
"node-v${NODE_VERSION}-linux-x64.tar.xz" \
|
&& grep " ${f}\$" SHASUMS256.txt | sha256sum -c - \
|
||||||
-C /usr/local \
|
&& tar -xJf "node-v${NODE_VERSION}-linux-x64.tar.xz" -C /usr/local --strip-components=1 \
|
||||||
--strip-components=1 \
|
&& rm -f "${f}" SHASUMS256.txt \
|
||||||
&& rm "node-v${NODE_VERSION}-linux-x64.tar.xz" \
|
|
||||||
&& echo -n "node version: " && node --version \
|
&& echo -n "node version: " && node --version \
|
||||||
&& echo -n "npm version: " && npm --version \
|
&& echo -n "npm version: " && npm --version \
|
||||||
&& npm install -g "@opencode/cli@${OPENCODE_VERSION}" \
|
&& npm install -g "@opencode/cli@${OPENCODE_VERSION}" \
|
||||||
&& echo -n "opencode version: " && opencode --version \
|
&& echo -n "opencode version: " && opencode --version \
|
||||||
&& npm cache clean --force
|
&& npm cache clean --force
|
||||||
|
|
||||||
# User directories
|
# User directories and dot expansion
|
||||||
RUN mkdir -p \
|
RUN mkdir -p \
|
||||||
/workspace \
|
/workspace \
|
||||||
/home/dev/.config/opencode \
|
/home/dev/.config/opencode \
|
||||||
@@ -92,11 +92,8 @@ RUN mkdir -p \
|
|||||||
/home/dev/.cache/pip \
|
/home/dev/.cache/pip \
|
||||||
/home/dev/.npm \
|
/home/dev/.npm \
|
||||||
/home/dev/.m2 \
|
/home/dev/.m2 \
|
||||||
&& chown -R dev:dev \
|
&& chown -R dev:dev /workspace /home/dev \
|
||||||
/workspace \
|
&& printf '%s\n' 'shopt -s dotglob' >> /etc/bash.bashrc
|
||||||
/home/dev
|
|
||||||
|
|
||||||
RUN printf '%s\n' 'shopt -s dotglob' >> /etc/bash.bashrc
|
|
||||||
|
|
||||||
# Runtime
|
# Runtime
|
||||||
USER dev
|
USER dev
|
||||||
@@ -107,10 +104,6 @@ ENV HOME=/home/dev \
|
|||||||
PIP_CACHE_DIR=/home/dev/.cache/pip \
|
PIP_CACHE_DIR=/home/dev/.cache/pip \
|
||||||
NPM_CONFIG_CACHE=/home/dev/.npm
|
NPM_CONFIG_CACHE=/home/dev/.npm
|
||||||
|
|
||||||
RUN echo 'for f in /host-bash/*; do [ -r "$f" ] && source "$f"; done' >> ~/.bashrc
|
|
||||||
|
|
||||||
WORKDIR /workspace
|
WORKDIR /workspace
|
||||||
|
|
||||||
ENTRYPOINT ["/usr/local/bin/opencode-dev-entrypoint"]
|
|
||||||
|
|
||||||
CMD ["bash"]
|
CMD ["bash"]
|
||||||
|
|||||||
@@ -1,5 +1,7 @@
|
|||||||
# OpenCode Development Container
|
# OpenCode Development Container
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
This repository provides a Podman-based development container for running an AI coding agent in an isolated and reproducible environment.
|
This repository provides a Podman-based development container for running an AI coding agent in an isolated and reproducible environment.
|
||||||
|
|
||||||
The container includes common software development tools, Node.js, OpenCode, Python, Java, Maven, Git, Neovim, and other command-line utilities.
|
The container includes common software development tools, Node.js, OpenCode, Python, Java, Maven, Git, Neovim, and other command-line utilities.
|
||||||
@@ -17,9 +19,9 @@ The host project directory and selected development caches/configuration directo
|
|||||||
## Files
|
## Files
|
||||||
|
|
||||||
* `Dockerfile` — builds the development image.
|
* `Dockerfile` — builds the development image.
|
||||||
* `build.sh` — builds or updates the image.
|
* `build.sh` — builds, updates, removes, or prunes the image.
|
||||||
* `dev.sh` — starts the development container.
|
* `run.sh` — starts the development container.
|
||||||
* `entrypoint.sh` — initializes the runtime environment.
|
* `certs/README.md` — rules for custom CA certificates.
|
||||||
|
|
||||||
## Build the image
|
## Build the image
|
||||||
|
|
||||||
@@ -49,12 +51,37 @@ The build uses the current host UID and GID for the `dev` user, so files created
|
|||||||
./build.sh --update
|
./build.sh --update
|
||||||
```
|
```
|
||||||
|
|
||||||
|
This is equivalent to `--no-cache --pull=newer`, so the Ubuntu base image is refreshed and every package layer is reinstalled.
|
||||||
|
|
||||||
### Show the build command without running it
|
### Show the build command without running it
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
./build.sh --dry-run
|
./build.sh --dry-run
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Remove or prune images
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./build.sh --remove # delete the development image
|
||||||
|
./build.sh --prune # delete dangling images left by previous builds
|
||||||
|
```
|
||||||
|
|
||||||
|
Both options exit immediately without building, and can be combined.
|
||||||
|
|
||||||
|
### Install extra system packages
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./build.sh --apt-packages="libpq-dev postgresql-client"
|
||||||
|
```
|
||||||
|
|
||||||
|
The list is forwarded to the image build as `EXTRA_APT_PACKAGES` and installed with `apt-get install --no-install-recommends`.
|
||||||
|
|
||||||
|
### Show usage
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./build.sh --help
|
||||||
|
```
|
||||||
|
|
||||||
## Build arguments
|
## Build arguments
|
||||||
|
|
||||||
The following environment variables can be used to customize the image:
|
The following environment variables can be used to customize the image:
|
||||||
@@ -62,27 +89,28 @@ The following environment variables can be used to customize the image:
|
|||||||
```bash
|
```bash
|
||||||
UBUNTU_VERSION=26.04
|
UBUNTU_VERSION=26.04
|
||||||
NODE_VERSION=24.21.0
|
NODE_VERSION=24.21.0
|
||||||
OPENCODE_VERSION=2.0.3
|
OPENCODE_VERSION=2.0.22
|
||||||
IMAGE_REPO=localhost/opencode-dev
|
IMAGE_REPO=localhost/opencode-dev
|
||||||
```
|
```
|
||||||
|
|
||||||
For example:
|
For example:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
NODE_VERSION=24.21.0 OPENCODE_VERSION=2.0.3 ./build.sh --no-cache
|
NODE_VERSION=24.21.0 OPENCODE_VERSION=2.0.22 ./build.sh --no-cache
|
||||||
```
|
```
|
||||||
|
|
||||||
|
`build.sh` passes the versions above to `podman build` as `--build-arg`. The same values are declared as `ARG` defaults at the top of the `Dockerfile`, so keep both in sync when changing a version.
|
||||||
|
|
||||||
|
Two more build arguments are set automatically:
|
||||||
|
|
||||||
|
* `DEV_UID` / `DEV_GID` — taken from `id -u` / `id -g` on the host.
|
||||||
|
* `EXTRA_APT_PACKAGES` — taken from the `--apt-packages` option.
|
||||||
|
|
||||||
## Custom CA certificates
|
## Custom CA certificates
|
||||||
|
|
||||||
Custom CA certificates must be placed in the repository `certs/` directory before building the image.
|
Custom CA certificates must be placed in the repository `certs/` directory before building the image. See [`certs/README.md`](certs/README.md) for accepted formats and rules.
|
||||||
|
|
||||||
Example:
|
Git cannot track empty directories, so `certs/README.md` itself is the placeholder that keeps `certs/` present in a fresh clone, and the build does not fail on a missing directory. That placeholder is listed in `.dockerignore`, so only real certificate files are copied into the image.
|
||||||
|
|
||||||
```text
|
|
||||||
certs/
|
|
||||||
├── company-root.crt
|
|
||||||
└── company-intermediate.crt
|
|
||||||
```
|
|
||||||
|
|
||||||
The Dockerfile copies this directory to:
|
The Dockerfile copies this directory to:
|
||||||
|
|
||||||
@@ -104,14 +132,14 @@ NODE_EXTRA_CA_CERTS=/etc/ssl/certs/ca-certificates.crt
|
|||||||
|
|
||||||
This allows both system tools and Node.js applications to trust the additional certificates.
|
This allows both system tools and Node.js applications to trust the additional certificates.
|
||||||
|
|
||||||
**Important:** CA certificates need to be present when the image is built. The runtime container does not install certificates from the host.
|
**Important:** CA certificates need to be present when the image is built. The runtime container does not install certificates from the host. After adding or removing a certificate, rebuild with `./build.sh --no-cache --update`.
|
||||||
|
|
||||||
## Run the container
|
## Run the container
|
||||||
|
|
||||||
Run:
|
Run:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
./dev.sh
|
./run.sh
|
||||||
```
|
```
|
||||||
|
|
||||||
By default, the host directory is:
|
By default, the host directory is:
|
||||||
@@ -126,21 +154,9 @@ and projects are stored in:
|
|||||||
$HOME/opencode-dev/projects
|
$HOME/opencode-dev/projects
|
||||||
```
|
```
|
||||||
|
|
||||||
The container starts in `/workspace`.
|
`run.sh` creates every directory it mounts, so it can be run on a clean checkout. If the image does not exist yet, the script exits with an error asking you to build it first.
|
||||||
|
|
||||||
To start in a specific project:
|
The container starts in `/workspace`, which is the mounted `projects/` directory. Open the project you want to work on inside the shell, or mount additional host directories with `--mount`.
|
||||||
|
|
||||||
```bash
|
|
||||||
./dev.sh my-project
|
|
||||||
```
|
|
||||||
|
|
||||||
or:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
./dev.sh /path/to/opencode-dev/projects/my-project
|
|
||||||
```
|
|
||||||
|
|
||||||
Absolute paths outside the projects directory are not accepted as the initial working directory.
|
|
||||||
|
|
||||||
## Mounted directories
|
## Mounted directories
|
||||||
|
|
||||||
@@ -155,10 +171,9 @@ The following host directories are mounted into the container:
|
|||||||
| `m2/` | `/home/dev/.m2` | Maven cache |
|
| `m2/` | `/home/dev/.m2` | Maven cache |
|
||||||
| `npm-cache/` | `/home/dev/.npm` | npm cache |
|
| `npm-cache/` | `/home/dev/.npm` | npm cache |
|
||||||
| `pip-cache/` | `/home/dev/.cache/pip` | pip cache |
|
| `pip-cache/` | `/home/dev/.cache/pip` | pip cache |
|
||||||
| `bash/` | `/host-bash` | Host-provided Bash configuration |
|
|
||||||
| `$HOME/.gitconfig` | `/home/dev/.gitconfig` | Git configuration |
|
| `$HOME/.gitconfig` | `/home/dev/.gitconfig` | Git configuration |
|
||||||
|
|
||||||
All standard development directories are created automatically by `dev.sh`.
|
All mounted development directories are created automatically by `run.sh`.
|
||||||
|
|
||||||
## Additional mounts
|
## Additional mounts
|
||||||
|
|
||||||
@@ -167,23 +182,25 @@ Additional host directories can be mounted with `--mount`.
|
|||||||
Example:
|
Example:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
./dev.sh my-project --mount "$HOME/other:/extra"
|
./run.sh --mount "$HOME/other:/extra"
|
||||||
```
|
```
|
||||||
|
|
||||||
Read-only mounts are also supported:
|
Read-only mounts are also supported:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
./dev.sh my-project --mount "$HOME/data:/data:ro"
|
./run.sh --mount "$HOME/data:/data:ro"
|
||||||
```
|
```
|
||||||
|
|
||||||
Multiple mounts can be specified:
|
Multiple mounts can be specified:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
./dev.sh my-project \
|
./run.sh \
|
||||||
--mount "$HOME/data:/data:ro" \
|
--mount "$HOME/data:/data:ro" \
|
||||||
--mount "$HOME/tools:/tools:rw"
|
--mount "$HOME/tools:/tools:rw"
|
||||||
```
|
```
|
||||||
|
|
||||||
|
`--mount` is the only option accepted by `run.sh`; any other argument stops the script with an error.
|
||||||
|
|
||||||
## Environment variables
|
## Environment variables
|
||||||
|
|
||||||
The main runtime paths can be customized:
|
The main runtime paths can be customized:
|
||||||
@@ -197,14 +214,15 @@ OPENCODE_CACHE
|
|||||||
M2_FOLDER
|
M2_FOLDER
|
||||||
NPM_CACHE
|
NPM_CACHE
|
||||||
PIP_CACHE
|
PIP_CACHE
|
||||||
BASH_FOLDER
|
|
||||||
IMAGE_REPO
|
IMAGE_REPO
|
||||||
```
|
```
|
||||||
|
|
||||||
|
`IMAGE_REPO` is read by both scripts, so it selects the same image for `build.sh` and `run.sh`.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
OPENCODE_DEV_HOME="$HOME/my-opencode" ./dev.sh
|
OPENCODE_DEV_HOME="$HOME/my-opencode" ./run.sh
|
||||||
```
|
```
|
||||||
|
|
||||||
## Git configuration
|
## Git configuration
|
||||||
@@ -217,38 +235,35 @@ $HOME/.gitconfig -> /home/dev/.gitconfig
|
|||||||
|
|
||||||
If the file does not exist, the script prints a warning and Git uses the container defaults.
|
If the file does not exist, the script prints a warning and Git uses the container defaults.
|
||||||
|
|
||||||
SSH configuration and SSH agent forwarding are currently disabled in the script. They can be enabled by uncommenting the corresponding sections in `dev.sh`.
|
SSH configuration and SSH agent forwarding are not mounted. If they are needed, pass them explicitly:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./run.sh --mount "$HOME/.ssh:/home/dev/.ssh:ro"
|
||||||
|
```
|
||||||
|
|
||||||
## Security
|
## Security
|
||||||
|
|
||||||
The container runs with several restrictions:
|
The container runs with several restrictions:
|
||||||
|
|
||||||
* Runs as the `dev` user.
|
* Runs as the `dev` user with host UID/GID (`--user dev --userns=keep-id`).
|
||||||
* Uses the host UID/GID.
|
* Drops all Linux capabilities (`--cap-drop=ALL`).
|
||||||
* Drops all Linux capabilities.
|
|
||||||
* Uses `no-new-privileges`.
|
* Uses `no-new-privileges`.
|
||||||
* Uses a temporary container (`--rm`).
|
* Uses the host timezone (`--tz=local`).
|
||||||
|
* Uses a temporary, named container (`--name opencode-dev --rm`).
|
||||||
* Does not run as root.
|
* Does not run as root.
|
||||||
* Uses the default Podman network.
|
* Uses the default Podman network.
|
||||||
|
|
||||||
The project directory is mounted read/write because the AI agent needs to create and modify source files.
|
The project directory is mounted read/write because the AI agent needs to create and modify source files. The host Git configuration is mounted read-only.
|
||||||
|
|
||||||
## Locale
|
## Locale
|
||||||
|
|
||||||
The host locale is passed to the container through:
|
The image generates the `en_US.UTF-8` locale during the build:
|
||||||
|
|
||||||
```text
|
```dockerfile
|
||||||
HOST_LANG
|
echo 'en_US.UTF-8 UTF-8' > /etc/locale.gen && locale-gen
|
||||||
HOST_LC_ALL
|
|
||||||
```
|
```
|
||||||
|
|
||||||
The entrypoint generates the requested UTF-8 locale when necessary.
|
The host timezone is applied at runtime through `--tz=local`. The host `LANG`/`LC_ALL` values are not forwarded; export them inside the container if a different locale is needed.
|
||||||
|
|
||||||
For example, the host locale is automatically passed when running:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
./dev.sh
|
|
||||||
```
|
|
||||||
|
|
||||||
## Typical workflow
|
## Typical workflow
|
||||||
|
|
||||||
@@ -261,22 +276,16 @@ Build the image:
|
|||||||
Start the development environment:
|
Start the development environment:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
./dev.sh
|
./run.sh
|
||||||
```
|
```
|
||||||
|
|
||||||
Or start directly in a project:
|
Inside the container, the projects directory is available under:
|
||||||
|
|
||||||
```bash
|
|
||||||
./dev.sh my-project
|
|
||||||
```
|
|
||||||
|
|
||||||
Inside the container, the project is available under:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
/workspace
|
/workspace
|
||||||
```
|
```
|
||||||
|
|
||||||
OpenCode can then be started normally:
|
Move into the project you want to work on, then start OpenCode normally:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
opencode
|
opencode
|
||||||
@@ -286,14 +295,14 @@ The container is removed when the shell exits, while source code, OpenCode data,
|
|||||||
|
|
||||||
## Customization
|
## Customization
|
||||||
|
|
||||||
Most image versions are defined at the top of the `Dockerfile`:
|
Image versions are defined at the top of the `Dockerfile`:
|
||||||
|
|
||||||
```dockerfile
|
```dockerfile
|
||||||
ARG UBUNTU_VERSION=26.04
|
ARG UBUNTU_VERSION=26.04
|
||||||
ARG NODE_VERSION=24.21.0
|
ARG NODE_VERSION=24.21.0
|
||||||
ARG OPENCODE_VERSION=2.0.3
|
ARG OPENCODE_VERSION=2.0.22
|
||||||
```
|
```
|
||||||
|
|
||||||
Runtime paths and container options are defined in `dev.sh`.
|
Runtime paths, mounts, and container options are defined in `run.sh`, while `build.sh` controls how the image is built and maintained.
|
||||||
|
|
||||||
This separation allows the image to contain the stable development environment while projects, configuration, caches, and other working data remain outside the container.
|
This separation allows the image to contain the stable development environment while projects, configuration, caches, and other working data remain outside the container.
|
||||||
|
|||||||
@@ -5,59 +5,73 @@ SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
|
|||||||
cd "$SCRIPT_DIR"
|
cd "$SCRIPT_DIR"
|
||||||
|
|
||||||
UBUNTU_VERSION="${UBUNTU_VERSION:-26.04}"
|
UBUNTU_VERSION="${UBUNTU_VERSION:-26.04}"
|
||||||
# OPENCODE_VERSION=$(curl -fsSI https://github.com/anomalyco/opencode/releases/latest | sed -n 's/^location:.*\/tag\/v\{0,1\}\(.*\)\r$/\1/ip')
|
|
||||||
NODE_VERSION="${NODE_VERSION:-24.21.0}"
|
NODE_VERSION="${NODE_VERSION:-24.21.0}"
|
||||||
OPENCODE_VERSION="${OPENCODE_VERSION:-2.0.3}"
|
OPENCODE_VERSION="${OPENCODE_VERSION:-2.0.22}"
|
||||||
|
IMAGE="${IMAGE_REPO:-localhost/opencode-dev}"
|
||||||
|
|
||||||
IMAGE_REPO="${IMAGE_REPO:-localhost/opencode-dev}"
|
usage() {
|
||||||
# IMAGE_TAG="${IMAGE_TAG:-${OPENCODE_VERSION}}"
|
echo 'Usage: $0 [--no-cache] [--update] [--dry-run] [--remove] [--prune] [--apt-packages="pack1 pack2"]'
|
||||||
# IMAGE="${IMAGE_REPO}:${IMAGE_TAG}"
|
exit "${1:-0}"
|
||||||
IMAGE="${IMAGE_REPO}"
|
}
|
||||||
|
|
||||||
NO_CACHE=()
|
BUILD_OPTS=()
|
||||||
if [[ "${1:-}" == "--no-cache" ]]; then
|
DRY_RUN=0
|
||||||
NO_CACHE+=(--no-cache)
|
REMOVE=0
|
||||||
|
PRUNE=0
|
||||||
|
EXTRA_APT_PACKAGES=()
|
||||||
|
|
||||||
|
while (($#)); do
|
||||||
|
case "$1" in
|
||||||
|
--no-cache) BUILD_OPTS+=(--no-cache) ;;
|
||||||
|
--update) BUILD_OPTS+=(--no-cache --pull=newer) ;;
|
||||||
|
--dry-run) DRY_RUN=1 ;;
|
||||||
|
--remove) REMOVE=1 ;;
|
||||||
|
--prune) PRUNE=1 ;;
|
||||||
|
--apt-packages=*)
|
||||||
|
read -ra _pkgs <<< "${1#*=}"
|
||||||
|
EXTRA_APT_PACKAGES="${_pkgs[@]}" ;;
|
||||||
|
-h|--help) usage ;;
|
||||||
|
*) echo "Unknown option: $1" >&2; usage 2 ;;
|
||||||
|
esac
|
||||||
shift
|
shift
|
||||||
|
done
|
||||||
|
|
||||||
|
if [[ -n "${EXTRA_APT_PACKAGES[@]}" ]]; then
|
||||||
|
echo "--> Apt extra pkg: ${EXTRA_APT_PACKAGES[*]}"
|
||||||
fi
|
fi
|
||||||
|
|
||||||
UPDATE=0
|
if ((REMOVE || PRUNE)); then
|
||||||
if [[ "${1:-}" == "--update" ]]; then
|
if ((REMOVE)); then
|
||||||
UPDATE=1
|
if podman image exists "$IMAGE"; then
|
||||||
shift
|
podman image rm "${IMAGE}" || echo "WARNING: could not remove $IMAGE" >&2
|
||||||
|
else
|
||||||
|
echo "$IMAGE does not exist, nothing to remove"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
if ((PRUNE)); then
|
||||||
|
podman image prune -f || echo "WARNING: prune failed" >&2
|
||||||
|
fi
|
||||||
|
exit 0
|
||||||
fi
|
fi
|
||||||
|
|
||||||
DRY_RUN=false
|
CMD=(
|
||||||
if [[ "${1:-}" == "--dry-run" ]]; then
|
podman build
|
||||||
DRY_RUN=true
|
"${BUILD_OPTS[@]}"
|
||||||
shift
|
--build-arg "UBUNTU_VERSION=${UBUNTU_VERSION}"
|
||||||
|
--build-arg "NODE_VERSION=${NODE_VERSION}"
|
||||||
|
--build-arg "OPENCODE_VERSION=${OPENCODE_VERSION}"
|
||||||
|
--build-arg "EXTRA_APT_PACKAGES=${EXTRA_APT_PACKAGES[*]}"
|
||||||
|
--build-arg "DEV_UID=$(id -u)"
|
||||||
|
--build-arg "DEV_GID=$(id -g)"
|
||||||
|
-t "$IMAGE"
|
||||||
|
.
|
||||||
|
)
|
||||||
|
|
||||||
|
if ((DRY_RUN)); then
|
||||||
|
printf 'running:'; printf ' %q' "${CMD[@]}"; echo
|
||||||
|
exit 0
|
||||||
fi
|
fi
|
||||||
|
|
||||||
if (($#)); then
|
"${CMD[@]}"
|
||||||
echo "Usage: $0 [--no-cache] [--update] [--dry-run]" >&2
|
echo
|
||||||
exit 2
|
echo "Built: $IMAGE"
|
||||||
fi
|
|
||||||
|
|
||||||
if ((UPDATE)); then
|
|
||||||
echo "Update requested: rebuilding ${IMAGE} with current Ubuntu package metadata."
|
|
||||||
podman rmi $(podman images -q ${IMAGE_REPO})
|
|
||||||
fi
|
|
||||||
|
|
||||||
DEV_UID="$(id -u)"
|
|
||||||
DEV_GID="$(id -g)"
|
|
||||||
|
|
||||||
if [ ${DRY_RUN} == false ]; then
|
|
||||||
podman build \
|
|
||||||
"${NO_CACHE[@]}" \
|
|
||||||
--build-arg "UBUNTU_VERSION=${UBUNTU_VERSION}" \
|
|
||||||
--build-arg "NODE_VERSION=${NODE_VERSION}" \
|
|
||||||
--build-arg "OPENCODE_VERSION=${OPENCODE_VERSION}" \
|
|
||||||
--build-arg "DEV_UID=${DEV_UID}" \
|
|
||||||
--build-arg "DEV_GID=${DEV_GID}" \
|
|
||||||
-t "$IMAGE" \
|
|
||||||
.
|
|
||||||
|
|
||||||
echo
|
|
||||||
echo "Built: $IMAGE"
|
|
||||||
else
|
|
||||||
echo "running: podman build ${NO_CACHE[@]} --build-arg UBUNTU_VERSION=${UBUNTU_VERSION} --build-arg NODE_VERSION=${NODE_VERSION} -t $IMAGE"
|
|
||||||
fi
|
|
||||||
|
|||||||
@@ -0,0 +1,78 @@
|
|||||||
|
# Custom CA certificates
|
||||||
|
|
||||||
|
Place any **additional CA certificates** needed to reach internal HTTPS services
|
||||||
|
in this directory, as PEM files with a `.crt` extension:
|
||||||
|
|
||||||
|
```text
|
||||||
|
certs/
|
||||||
|
├── README.md
|
||||||
|
├── company-root.crt
|
||||||
|
└── company-intermediate.crt
|
||||||
|
```
|
||||||
|
|
||||||
|
This file also guarantees the directory exists in a fresh clone. The build
|
||||||
|
copies `certs/` into the image and runs `update-ca-certificates`, so it fails if
|
||||||
|
the directory is missing.
|
||||||
|
|
||||||
|
## How they are installed
|
||||||
|
|
||||||
|
`Dockerfile` copies this directory to:
|
||||||
|
|
||||||
|
```text
|
||||||
|
/usr/local/share/ca-certificates
|
||||||
|
```
|
||||||
|
|
||||||
|
and runs:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
update-ca-certificates
|
||||||
|
```
|
||||||
|
|
||||||
|
The resulting system CA bundle is also exposed to Node.js through:
|
||||||
|
|
||||||
|
```text
|
||||||
|
NODE_EXTRA_CA_CERTS=/etc/ssl/certs/ca-certificates.crt
|
||||||
|
```
|
||||||
|
|
||||||
|
so both system tools and Node.js applications trust the added certificates.
|
||||||
|
|
||||||
|
## Rules
|
||||||
|
|
||||||
|
* Certificates are baked in at **build time**. The runtime container does not
|
||||||
|
install certificates from the host, so there is no need to mount this
|
||||||
|
directory into the container.
|
||||||
|
* Rebuild after any change:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./build.sh --no-cache --update
|
||||||
|
```
|
||||||
|
|
||||||
|
* Only **public** CA certificates belong here. Never commit private material
|
||||||
|
(`*.key`, `*.p12`, `*.pfx`) — everything matched here is copied into the image
|
||||||
|
verbatim.
|
||||||
|
* Files must be PEM encoded and use the `.crt` extension. Any other extension
|
||||||
|
(`.pem`, `.cer`, …) is **silently ignored** by `update-ca-certificates`, so
|
||||||
|
rename it to `.crt`. Convert DER with:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
openssl x509 -inform der -in cert.der -out cert.crt
|
||||||
|
```
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
If a certificate seems ignored, the most likely cause is the extension: only
|
||||||
|
files ending in `.crt` are installed. A `.pem` file produces no error and no
|
||||||
|
warning, it is simply skipped. Rename it:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mv company-root.pem company-root.crt
|
||||||
|
```
|
||||||
|
|
||||||
|
Otherwise check that the file parses as a certificate:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
openssl x509 -in company-root.crt -noout -subject -issuer -dates
|
||||||
|
```
|
||||||
|
|
||||||
|
A build that prints warnings from `update-ca-certificates` means a `.crt` file
|
||||||
|
is present but is not valid PEM certificate data.
|
||||||
@@ -1,54 +0,0 @@
|
|||||||
#!/bin/bash
|
|
||||||
set -euo pipefail
|
|
||||||
|
|
||||||
# CERT_DIR="${CERT_DIR:-/host-certs}"
|
|
||||||
#
|
|
||||||
# if [[ -d "$CERT_DIR" ]]; then
|
|
||||||
# shopt -s nullglob
|
|
||||||
# certs=("$CERT_DIR"/*.crt "$CERT_DIR"/*.pem)
|
|
||||||
# if ((${#certs[@]})); then
|
|
||||||
# mkdir -p /usr/local/share/ca-certificates/opencode-host
|
|
||||||
# for cert in "${certs[@]}"; do
|
|
||||||
# target="/usr/local/share/ca-certificates/opencode-host/$(basename "${cert%.*}").crt"
|
|
||||||
# if openssl x509 -in "$cert" -noout >/dev/null 2>&1; then
|
|
||||||
# cp -f "$cert" "$target"
|
|
||||||
# else
|
|
||||||
# echo "WARNING: ignoring invalid CA certificate: $cert" >&2
|
|
||||||
# fi
|
|
||||||
# done
|
|
||||||
# if update-ca-certificates >/tmp/opencode-ca.log 2>&1; then
|
|
||||||
# :
|
|
||||||
# else
|
|
||||||
# echo "WARNING: update-ca-certificates failed; continuing." >&2
|
|
||||||
# cat /tmp/opencode-ca.log >&2 || true
|
|
||||||
# fi
|
|
||||||
# fi
|
|
||||||
# fi
|
|
||||||
|
|
||||||
host_lang="${HOST_LANG:-${LANG:-C.UTF-8}}"
|
|
||||||
host_lc_all="${HOST_LC_ALL:-${LC_ALL:-}}"
|
|
||||||
|
|
||||||
# Generate a host locale when it is a valid UTF-8 locale and not already present.
|
|
||||||
if [[ "$host_lang" == *.UTF-8 && "$host_lang" != "C.UTF-8" ]]; then
|
|
||||||
if ! locale -a | grep -Fxqi "${host_lang//UTF-8/utf8}"; then
|
|
||||||
if [[ "$host_lang" =~ ^([A-Za-z_]+)\.UTF-8$ ]]; then
|
|
||||||
locale_name="${BASH_REMATCH[1]}.UTF-8"
|
|
||||||
if grep -qE "^#?[[:space:]]*${locale_name}[[:space:]]+UTF-8" /etc/locale.gen 2>/dev/null; then
|
|
||||||
sed -i -E "s/^#[[:space:]]*(${locale_name}[[:space:]]+UTF-8)/\1/" /etc/locale.gen
|
|
||||||
else
|
|
||||||
printf '%s UTF-8\n' "$locale_name" >> /etc/locale.gen
|
|
||||||
fi
|
|
||||||
locale-gen "$locale_name" >/dev/null 2>&1 || \
|
|
||||||
echo "WARNING: could not generate locale $host_lang; continuing." >&2
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
export LANG="$host_lang"
|
|
||||||
if [[ -n "$host_lc_all" ]]; then
|
|
||||||
export LC_ALL="$host_lc_all"
|
|
||||||
fi
|
|
||||||
|
|
||||||
# exec su -s /bin/bash dev -c 'cd "${START_DIR:-/workspace}" && exec "$@"' -- "$@"
|
|
||||||
cd "${START_DIR:-/workspace}"
|
|
||||||
exec "$@"
|
|
||||||
Binary file not shown.
|
After Width: | Height: | Size: 206 KiB |
+15
-55
@@ -1,24 +1,24 @@
|
|||||||
#!/usr/bin/env bash
|
#!/usr/bin/env bash
|
||||||
set -euo pipefail
|
set -euo pipefail
|
||||||
|
|
||||||
SCRIPT_DIR=$(realpath -- "$(dirname -- "${BASH_SOURCE[0]}")")
|
|
||||||
|
|
||||||
BASE_DIR="${OPENCODE_DEV_HOME:-$HOME/opencode-dev}"
|
|
||||||
IMAGE_REPO="${IMAGE_REPO:-localhost/opencode-dev}"
|
IMAGE_REPO="${IMAGE_REPO:-localhost/opencode-dev}"
|
||||||
# OPENCODE_VERSION="${OPENCODE_VERSION:-1.18.32}"
|
|
||||||
# IMAGE_TAG="${IMAGE_TAG:-${OPENCODE_VERSION}}"
|
|
||||||
IMAGE="${IMAGE_REPO}"
|
IMAGE="${IMAGE_REPO}"
|
||||||
|
CONTAINER_NAME="${CONTAINER_NAME:-opencode-dev}"
|
||||||
|
|
||||||
|
if ! podman image exists "$IMAGE"; then
|
||||||
|
echo "Image $IMAGE does not exist. Build it first with ./build.sh" >&2
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
# Folders
|
# Folders
|
||||||
|
BASE_DIR="${OPENCODE_DEV_HOME:-$HOME/opencode-dev}"
|
||||||
PROJECTS_DIR="${PROJECT_DIR:-$BASE_DIR/projects}"
|
PROJECTS_DIR="${PROJECT_DIR:-$BASE_DIR/projects}"
|
||||||
OPC_CONFIG="${OPENCODE_CONFIG:-$BASE_DIR/opencode-config}"
|
OPC_CONFIG="${OPENCODE_CONFIG:-$BASE_DIR/opencode-config}"
|
||||||
OPC_DATA="${OPENCODE_SHARE_DATA:-$BASE_DIR/opencode-data}"
|
OPC_DATA="${OPENCODE_SHARE_DATA:-$BASE_DIR/opencode-data}"
|
||||||
OPC_CACHE="${OPENCODE_CACHE:-$BASE_DIR/opencode-cache}"
|
OPC_CACHE="${OPENCODE_CACHE:-$BASE_DIR/opencode-cache}"
|
||||||
M2_FOLDER="${M2_FOLDER:-$BASE_DIR/m2}"
|
M2_FOLDER="${M2_FOLDER:-$BASE_DIR/m2}"
|
||||||
NPM_MODULES="${NPM_MODULES:-$BASE_DIR/npm-modules}"
|
|
||||||
NPM_CACHE="${NPM_CACHE:-$BASE_DIR/npm-cache}"
|
NPM_CACHE="${NPM_CACHE:-$BASE_DIR/npm-cache}"
|
||||||
PIP_CACHE="${PIP_CACHE:-$BASE_DIR/pip-cache}"
|
PIP_CACHE="${PIP_CACHE:-$BASE_DIR/pip-cache}"
|
||||||
BASH_FOLDER="${BASH_FOLDER:-$BASE_DIR/bash}"
|
|
||||||
|
|
||||||
mkdir -p \
|
mkdir -p \
|
||||||
"$BASE_DIR" \
|
"$BASE_DIR" \
|
||||||
@@ -27,43 +27,12 @@ mkdir -p \
|
|||||||
"$OPC_DATA" \
|
"$OPC_DATA" \
|
||||||
"$OPC_CACHE" \
|
"$OPC_CACHE" \
|
||||||
"$M2_FOLDER" \
|
"$M2_FOLDER" \
|
||||||
"$NPM_MODULES" \
|
|
||||||
"$NPM_CACHE" \
|
"$NPM_CACHE" \
|
||||||
"$PIP_CACHE" \
|
"$PIP_CACHE"
|
||||||
"$BASH_FOLDER"
|
|
||||||
|
|
||||||
if [[ ! -f "$HOME/.gitconfig" ]]; then
|
|
||||||
echo "WARNING: $HOME/.gitconfig does not exist; Git will use container defaults." >&2
|
|
||||||
fi
|
|
||||||
|
|
||||||
if ! podman image exists "$IMAGE"; then
|
|
||||||
echo "Image $IMAGE does not exist. Build it first with ./build.sh" >&2
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
START_DIR="${1:-$PROJECTS_DIR}"
|
|
||||||
shift || true
|
|
||||||
|
|
||||||
if [[ "$START_DIR" = /* ]]; then
|
|
||||||
if [[ "$START_DIR" == "$PROJECTS_DIR"* ]]; then
|
|
||||||
REL="${START_DIR#"$PROJECTS_DIR"}"
|
|
||||||
START_DIR="/workspace${REL}"
|
|
||||||
else
|
|
||||||
echo "Absolute paths outside $PROJECTS_DIR require --mount and are not accepted as the initial directory." >&2
|
|
||||||
exit 2
|
|
||||||
fi
|
|
||||||
else
|
|
||||||
START_DIR="/workspace/${START_DIR#./}"
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [[ ! -d "$PROJECTS_DIR" ]]; then
|
|
||||||
echo "Project directory missing: $PROJECTS_DIR" >&2
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
ARGS=(
|
ARGS=(
|
||||||
run --rm -it
|
run --rm -it
|
||||||
--name opencode-dev
|
--name "${CONTAINER_NAME}"
|
||||||
--user dev
|
--user dev
|
||||||
--userns=keep-id
|
--userns=keep-id
|
||||||
--network=default
|
--network=default
|
||||||
@@ -72,10 +41,6 @@ ARGS=(
|
|||||||
--security-opt=no-new-privileges
|
--security-opt=no-new-privileges
|
||||||
--cap-drop=ALL
|
--cap-drop=ALL
|
||||||
|
|
||||||
-e "HOST_LANG=${LANG:-C.UTF-8}"
|
|
||||||
-e "HOST_LC_ALL=${LC_ALL:-}"
|
|
||||||
-e "START_DIR=${START_DIR}"
|
|
||||||
|
|
||||||
-v "$OPC_CONFIG:/home/dev/.config/opencode:rw"
|
-v "$OPC_CONFIG:/home/dev/.config/opencode:rw"
|
||||||
-v "$OPC_DATA:/home/dev/.local/share/opencode:rw"
|
-v "$OPC_DATA:/home/dev/.local/share/opencode:rw"
|
||||||
-v "$OPC_CACHE:/home/dev/.cache/opencode:rw"
|
-v "$OPC_CACHE:/home/dev/.cache/opencode:rw"
|
||||||
@@ -83,21 +48,16 @@ ARGS=(
|
|||||||
-v "$NPM_CACHE:/home/dev/.npm:rw"
|
-v "$NPM_CACHE:/home/dev/.npm:rw"
|
||||||
-v "$PIP_CACHE:/home/dev/.cache/pip:rw"
|
-v "$PIP_CACHE:/home/dev/.cache/pip:rw"
|
||||||
-v "$PROJECTS_DIR:/workspace:rw"
|
-v "$PROJECTS_DIR:/workspace:rw"
|
||||||
-v "$HOME/.gitconfig:/home/dev/.gitconfig:ro"
|
|
||||||
# -v "$HOME/.ssh:/home/dev/.ssh:ro"
|
|
||||||
-v "$BASH_FOLDER:/host-bash:ro"
|
|
||||||
-v "$SCRIPT_DIR/entrypoint.sh:/usr/local/bin/opencode-dev-entrypoint:ro"
|
|
||||||
)
|
)
|
||||||
|
|
||||||
# if [[ -n "${SSH_AUTH_SOCK:-}" && -S "$SSH_AUTH_SOCK" ]]; then
|
if [[ -f "$HOME/.gitconfig" ]]; then
|
||||||
# ARGS+=(
|
ARGS+=(-v "$HOME/.gitconfig:/home/dev/.gitconfig:ro")
|
||||||
# -e SSH_AUTH_SOCK=/tmp/ssh-agent.sock
|
else
|
||||||
# -v "$SSH_AUTH_SOCK:/tmp/ssh-agent.sock"
|
echo "WARNING: host .gitconfig not found, using container inner configuration"
|
||||||
# )
|
fi
|
||||||
# fi
|
|
||||||
|
|
||||||
# Additional bind mounts:
|
# Additional bind mounts:
|
||||||
# ./dev.sh /project --mount "$HOME/other:/extra"
|
# ./run.sh --mount "$HOME/other:/extra"
|
||||||
while (($#)); do
|
while (($#)); do
|
||||||
case "$1" in
|
case "$1" in
|
||||||
--mount)
|
--mount)
|
||||||
Reference in New Issue
Block a user