yaacov/release-workflow
.cursor/skills/release-workflow/SKILL.md
Reference for building, releasing, publishing images, and deploying kubectl-mtv. Use when creating releases, building binaries or container images, deploying to OpenShift, or updating the Krew plugin index.
$ install --global
skillsauthnpx skillsauth add yaacov/kubectl-mtv release-workflowInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 10:22 AM4.8s1 file scanned
SKILL.md
- name:
- release-workflow
- description:
- Reference for building, releasing, publishing images, and deploying kubectl-mtv. Use when creating releases, building binaries or container images, deploying to OpenShift, or updating the Krew plugin index.
Release Workflow
Build
| Command | Purpose |
|---------|---------|
| make kubectl-mtv | Build for current platform |
| make build-all | Build all platforms (linux/darwin amd64+arm64, windows/amd64) |
| make dist-all | Build all + create .tar.gz/.zip archives + .sha256sum checksums |
| make dist | Build + tarball for current platform only |
Version is set via VERSION env var or defaults to git describe:
make dist-all VERSION=v0.5.0
Container Images
| Command | Purpose |
|---------|---------|
| make image-build-all | Build container images (amd64 + arm64) |
| make image-push-all | Push images + create multi-arch manifest |
Default image: quay.io/yaacov/kubectl-mtv-mcp-server.
The Containerfile is a multi-stage build that compiles the Go binary and produces a minimal image.
GitHub Release
Creating a GitHub release triggers .github/workflows/release.yml:
- Checks if assets already exist (idempotent).
- Runs
make dist-allwith the release tag asVERSION. - Uploads archives and checksums via
softprops/action-gh-release. - Verifies all assets are downloadable.
- Runs
krew-release-botto update the Krew plugin index.
Krew Plugin
.krew.yaml is a template processed by krew-release-bot. It defines:
- Plugin name:
mtv - Platforms: linux/amd64, linux/arm64, darwin/amd64, darwin/arm64, windows/amd64
- Download URLs point to GitHub release assets
The bot automatically submits a PR to the krew-index repo when a release is created.
OpenShift Deployment
Deploy manifests live in deploy/:
| File | Purpose |
|------|---------|
| mcp-server.yaml | ServiceAccount + Deployment + Service for MCP server |
| mcp-route.yaml | OpenShift Route with TLS edge termination |
| olsconfig-patch.yaml | Registers MCP server with OpenShift Lightspeed |
Deploy Targets
| Command | Purpose |
|---------|---------|
| make deploy | Deploy MCP server (SA + Deployment + Service) |
| make undeploy | Remove MCP server |
| make deploy-route | Create the Route |
| make undeploy-route | Remove the Route |
| make deploy-olsconfig | Register with Lightspeed |
| make undeploy-olsconfig | Unregister from Lightspeed |
| make deploy-all | Deploy everything |
| make undeploy-all | Remove everything |
The MCP server deploys to the openshift-mtv namespace. Key environment variables in the Deployment:
MCP_HOST,MCP_PORT-- listen addressMCP_KUBE_SERVER-- K8s API server URLMCP_READ_ONLY-- disable write operationsMCP_OUTPUT_FORMAT-- default output format (json/text)MCP_MAX_RESPONSE_CHARS-- truncation limit
GitHub Pages (Guide)
Push to main with changes in guide/, _config.yml, _includes/, or Gemfile triggers .github/workflows/pages.yml:
- Build Jekyll site.
- Deploy to GitHub Pages.
Release Checklist
- Ensure
make lintandmake testpass. - Create a GitHub release with a tag (e.g.
v0.5.0). - The release workflow builds, uploads, and publishes automatically.
- Verify the Krew plugin update PR is submitted.
- Optionally update the container image:
make image-build-all && make image-push-all. - Update OpenShift deployment if needed:
make deploy.
Related Skills
yaacov/update-forklift-version
development
VerifiedTrustedCommunity
Step-by-step guide for updating the kubev2v/forklift Go dependency in kubectl-mtv. Use when bumping the forklift version, syncing settings or CRD types, or checking for upstream changes.
12SKILL.mdUpdated Apr 17, 2026
yaacov/project-testing
tools
VerifiedTrustedCommunity
Guide for writing and running tests in kubectl-mtv, including Go unit tests, MCP e2e tests (Python/pytest), and linting. Use when adding tests, running the test suite, or debugging test failures.
12SKILL.mdUpdated Apr 17, 2026
yaacov/mcp-tool-development
tools
VerifiedTrustedCommunity
Guide for adding or modifying MCP tools and understanding command discovery in kubectl-mtv. Use when working on the MCP server, adding new tools, or changing how commands are exposed to AI assistants.
12SKILL.mdUpdated Apr 17, 2026
yaacov/guide-authoring
documentation
VerifiedTrustedCommunity
Guide for adding and editing chapters in the kubectl-mtv technical guide (Jekyll + GitHub Pages). Use when writing documentation, adding chapters, or updating the guide table of contents.
12SKILL.mdUpdated Apr 17, 2026