Merge pull request #61 from stbenjam/docker

Add container image with marketplace pre-installed for CI

Author: openshift-merge-bot[bot]

README.md

@@ -32,6 +32,61 @@ $ git clone [email protected]:openshift-eng/ai-helpers.git
 $ ln -s ai-helpers ~/.cursor/commands/ai-helpers
 ```
 
+## Using the Docker Container
+
+A container is available with Claude Code and all plugins pre-installed.
+
+### Building the Container
+
+```bash
+podman build -f images/Dockerfile -t ai-helpers .
+```
+
+### Running with Vertex AI and gcloud Authentication
+
+To use Claude Code with Google Cloud's Vertex AI, you need to pass through your gcloud credentials and set the required environment variables:
+
+```bash
+podman run -it \
+  -e CLAUDE_CODE_USE_VERTEX=1 \
+  -e CLOUD_ML_REGION=your-ml-region \
+  -e ANTHROPIC_VERTEX_PROJECT_ID=your-project-id \
+  -v ~/.config/gcloud:/home/claude/.config/gcloud:ro \
+  -v $(pwd):/workspace \
+  -w /workspace \
+  ai-helpers
+```
+
+**Environment Variables:**
+- `CLAUDE_CODE_USE_VERTEX=1` - Enable Vertex AI integration
+- `CLOUD_ML_REGION` - Your GCP region (e.g., `us-east5`)
+- `ANTHROPIC_VERTEX_PROJECT_ID` - Your GCP project ID
+
+**Volume Mounts:**
+- `-v ~/.config/gcloud:/home/claude/.config/gcloud:ro` - Passes through your gcloud authentication (read-only)
+- `-v $(pwd):/workspace` - Mounts your current directory into the container
+
+### Running Commands Non-Interactively
+
+You can execute Claude Code commands directly without entering an interactive session using the `-p` or `--print` flag:
+
+```bash
+podman run -it \
+  -e CLAUDE_CODE_USE_VERTEX=1 \
+  -e CLOUD_ML_REGION=your-ml-region \
+  -e ANTHROPIC_VERTEX_PROJECT_ID=your-project-id \
+  -v ~/.config/gcloud:/home/claude/.config/gcloud:ro \
+  -v $(pwd):/workspace \
+  -w /workspace \
+  ai-helpers \
+  --print "/hello-world:echo Hello from Claude Code!"
+```
+
+This will:
+1. Start the container with your gcloud credentials
+2. Execute the `/hello-world:echo` command with the provided message
+3. Print the response and exit when complete
+
 ## Available Plugins
 
 ### JIRA Plugin

images/Dockerfile

@@ -0,0 +1,48 @@
+FROM registry.ci.openshift.org/ocp/builder:rhel-9-golang-1.24-openshift-4.21
+
+# Install Node.js and NPM from yum repositories
+RUN dnf install -y nodejs npm \
+    && dnf clean all
+
+# Install Python 3 and development tools
+RUN dnf install -y \
+    python3 \
+    python3-pip \
+    python3-devel \
+    && dnf clean all
+
+# Install Claude Code CLI globally
+RUN npm install -g @anthropic-ai/claude-code
+
+# Install common Python tools
+RUN pip3 install --no-cache-dir \
+    pytest \
+    requests \
+    pyyaml
+
+# Create claude user
+RUN useradd -m -u 1000 -s /bin/bash claude
+
+# Copy ai-helpers repository to /opt/ai-helpers
+COPY . /opt/ai-helpers
+RUN chown -R claude:claude /opt/ai-helpers
+
+# Create Claude configuration directory and copy settings
+#   Note: We pre-configure known_marketplaces.json because extraKnownMarketplaces doesn't seem to work in non-interactive mode.
+RUN mkdir -p /home/claude/.claude/plugins
+COPY images/claude-settings.json /home/claude/.claude/settings.json
+COPY images/known_marketplaces.json /home/claude/.claude/plugins/known_marketplaces.json
+RUN chown -R claude:claude /home/claude/.claude
+
+# Create workspace directory
+RUN mkdir -p /workspace && chown -R claude:claude /workspace
+WORKDIR /workspace
+
+# Switch to claude user
+USER claude
+
+# Set Claude Code as the default command
+ENTRYPOINT ["claude"]
+
+# Default to showing help
+CMD ["--help"]

images/claude-settings.json

@@ -0,0 +1,15 @@
+{
+  "extraKnownMarketplaces": {
+    "ai-helpers": {
+      "source": {
+        "source": "directory",
+        "path": "/opt/ai-helpers"
+      }
+    }
+  },
+  "enabledPlugins": {
+    "hello-world@ai-helpers": true,
+    "jira@ai-helpers": true,
+    "ci@ai-helpers": true
+  }
+}

images/known_marketplaces.json

@@ -0,0 +1,10 @@
+{
+  "ai-helpers": {
+    "source": {
+      "source": "directory",
+      "path": "/opt/ai-helpers"
+    },
+    "installLocation": "/opt/ai-helpers",
+    "lastUpdated": "2025-10-27T12:00:00.000Z"
+  }
+}