Skip to content

docs: fix doc drift and update heading for MCP Server#2

Merged
jeremyeder merged 2 commits intomainfrom
feat/openshift-internal-registry
Mar 20, 2026
Merged

docs: fix doc drift and update heading for MCP Server#2
jeremyeder merged 2 commits intomainfrom
feat/openshift-internal-registry

Conversation

@jeremyeder
Copy link
Copy Markdown
Contributor

Summary

  • Update heading in README.md and CLAUDE.md: "GPS - Global Positioning System" → "GPS - Global Positioning System MCP Server"
  • Fix 6 stale gps/gps-mcp references in DEPLOYMENT.md to use gps-mcp-server
  • Document image command and OpenShift internal registry workflow in Deploy section
  • Add IMAGE_REGISTRY and IMAGE env vars to Environment section

Test plan

  • grep -n 'gps[^-/\._"]' docs/DEPLOYMENT.md returns only legitimate references
  • Headings render correctly in GitHub

🤖 Generated with Claude Code

jeremyeder and others added 2 commits March 20, 2026 15:31
Add `image` command to deploy.sh that builds and pushes to the OpenShift
internal registry (with IMAGE_REGISTRY env var override for non-admin
users who can't query the registry route). Add `IMAGE` support in
`cmd_apply` to set the correct internal pull URL. Namespace creation
uses `oc new-project` on OpenShift for proper RBAC.

- Containerfile: set UV_CACHE_DIR and chmod g+rwX for OpenShift's
  restricted SCC (arbitrary UID)
- Build with --platform=linux/amd64 and --provenance=false for
  cross-arch compat and registry compatibility
- Remove imagePullSecrets via JSON patch in OpenShift overlay
  (internal registry uses default SA token)
- Remove namespace.yaml from kustomize base (deploy.sh handles creation)
- Rename all resources from mcp-server to gps-mcp-server
- Rename namespace from gps to gps-mcp-server

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Update heading in README.md and CLAUDE.md to include "MCP Server"
- Fix stale gps-mcp → gps-mcp-server references in DEPLOYMENT.md
- Add docker build flags (--provenance=false --platform=linux/amd64)
- Document image command and OpenShift internal registry workflow
- Add IMAGE_REGISTRY and IMAGE env vars to Environment section

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 20, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: d2720d3c-d22f-41f3-9b72-c98d70984edd

📥 Commits

Reviewing files that changed from the base of the PR and between 15718d5 and 35681e4.

📒 Files selected for processing (14)
  • .claude/CLAUDE.md
  • .github/workflows/deploy.yml
  • Containerfile
  • README.md
  • deploy/deploy.sh
  • deploy/k8s/base/deployment.yaml
  • deploy/k8s/base/kustomization.yaml
  • deploy/k8s/base/namespace.yaml
  • deploy/k8s/base/pvcs.yaml
  • deploy/k8s/base/service.yaml
  • deploy/k8s/overlays/openshift/kustomization.yaml
  • deploy/k8s/overlays/openshift/remove-pull-secret.yaml
  • deploy/k8s/overlays/openshift/route.yaml
  • docs/DEPLOYMENT.md

Cache: Disabled due to data retention organization setting

Knowledge base: Disabled due to data retention organization setting


Walkthrough

This pull request rebrands the project to "GPS - Global Positioning System MCP Server," renames Kubernetes resources and deployments from mcp-server to gps-mcp-server, migrates the namespace from gps to gps-mcp-server, updates container configuration with cache and permission settings, enhances the deployment script with image build/push capabilities, and aligns GitHub Actions workflows and documentation accordingly.

Changes

Cohort / File(s) Summary
Documentation & Branding
.claude/CLAUDE.md, README.md
Updated project title to include "MCP Server" designation in headers.
Container Configuration
Containerfile
Added UV_CACHE_DIR environment variable and group write permissions (chmod -R g+rwX /app) for writable filesystem access under arbitrary UIDs.
Deployment Automation
deploy/deploy.sh
Changed default namespace from gps to gps-mcp-server, added new image command for building and pushing container images to a registry, enhanced apply to create namespace and support optional image overrides via kustomization.yaml patching, updated all command to include image build step, and changed deployment targets from deployment/mcp-server to deployment/gps-mcp-server.
Kubernetes Base Manifests
deploy/k8s/base/deployment.yaml, deploy/k8s/base/service.yaml, deploy/k8s/base/namespace.yaml, deploy/k8s/base/pvcs.yaml, deploy/k8s/base/kustomization.yaml
Renamed Deployment and Service from mcp-server to gps-mcp-server with matching label/selector updates across all resources; updated namespace metadata and references from gps to gps-mcp-server; removed namespace.yaml from kustomization resources list.
OpenShift Overlay Manifests
deploy/k8s/overlays/openshift/route.yaml, deploy/k8s/overlays/openshift/kustomization.yaml, deploy/k8s/overlays/openshift/remove-pull-secret.yaml
Updated OpenShift Route metadata and service target reference from mcp-server to gps-mcp-server with namespace change; added Kustomize patch to remove imagePullSecrets from the Deployment via remove-pull-secret.yaml.
CI/CD Workflow
.github/workflows/deploy.yml
Updated OpenShift deployment workflow to target gps-mcp-server namespace instead of gps for secret creation, kustomize apply, rollout status checks, and pod/route listing.
Deployment Documentation
docs/DEPLOYMENT.md
Updated Service name and selector, MCP client configuration URL, container build/run commands with explicit platform and provenance flags, deployment examples with deploy/deploy.sh image command, documented new environment variables (IMAGE_REGISTRY, IMAGE), and updated namespace references in release workflow instructions.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/openshift-internal-registry

Comment @coderabbitai help to get the list of available commands and usage tips.

@jeremyeder jeremyeder merged commit b99ff5c into main Mar 20, 2026
3 of 4 checks passed
@jeremyeder jeremyeder deleted the feat/openshift-internal-registry branch March 20, 2026 19:48
jeremyeder added a commit that referenced this pull request Mar 23, 2026
* feat: deploy GPS to OpenShift via internal registry

Add `image` command to deploy.sh that builds and pushes to the OpenShift
internal registry (with IMAGE_REGISTRY env var override for non-admin
users who can't query the registry route). Add `IMAGE` support in
`cmd_apply` to set the correct internal pull URL. Namespace creation
uses `oc new-project` on OpenShift for proper RBAC.

- Containerfile: set UV_CACHE_DIR and chmod g+rwX for OpenShift's
  restricted SCC (arbitrary UID)
- Build with --platform=linux/amd64 and --provenance=false for
  cross-arch compat and registry compatibility
- Remove imagePullSecrets via JSON patch in OpenShift overlay
  (internal registry uses default SA token)
- Remove namespace.yaml from kustomize base (deploy.sh handles creation)
- Rename all resources from mcp-server to gps-mcp-server
- Rename namespace from gps to gps-mcp-server

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* docs: fix stale references, add image/registry docs, update heading

- Update heading in README.md and CLAUDE.md to include "MCP Server"
- Fix stale gps-mcp → gps-mcp-server references in DEPLOYMENT.md
- Add docker build flags (--provenance=false --platform=linux/amd64)
- Document image command and OpenShift internal registry workflow
- Add IMAGE_REGISTRY and IMAGE env vars to Environment section

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant