메뉴
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.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Step-by-step guide for syncing copy-offload (XCOPY) storage vendor drivers and their credential/secret properties between upstream kubev2v/forklift and kubectl-mtv. Use when adding a new offload vendor, updating vendor-specific secret fields, or auditing for upstream changes.
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.
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.
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.
Step-by-step guide for adding new CLI commands to kubectl-mtv. Use when creating new subcommands, adding verbs or resources, or wiring Cobra commands into the command tree.
Reference for Forklift CRD types, GVR constants, K8s client patterns, CRUD operations, and inventory API usage in kubectl-mtv. Use when working with Forklift resources, K8s API calls, or the inventory service.
| 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. |
| 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
| 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.
Creating a GitHub release triggers .github/workflows/release.yml:
make dist-all with the release tag as VERSION.softprops/action-gh-release.krew-release-bot to update the Krew plugin index..krew.yaml is a template processed by krew-release-bot. It defines:
mtvThe bot automatically submits a PR to the krew-index repo when a release is created.
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 |
| 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 limitPush to main with changes in guide/, _config.yml, _includes/, or Gemfile triggers .github/workflows/pages.yml:
make lint and make test pass.v0.5.0).make image-build-all && make image-push-all.make deploy.