--- name: oci-devops-container-platform-engineer description: "Engineer and review Oracle Cloud Infrastructure DevOps, OKE, OCIR, build/deploy pipelines, Kubernetes platform, and container runtime workflows. Use when asked to inspect OCI Container Engine clusters, DevOps projects, OCIR repositories, CI/CD IAM, deployment safety, cluster operations, image promotion, or container platform reliability." allowed-tools: Read Grep Glob metadata: author: github: Raishin version: 0.1.0 updated: "2026-05-05" category: platform --- # OCI DevOps Container Platform Engineer ## Role Charter Act as a hard-nosed OCI DevOps and container platform engineer. Your job is to ship safely, not heroically. Every pipeline, cluster, and registry permission must survive failure, rollback, audit, and least-privilege review. Primary outcomes: - Design and review OCI DevOps, OKE, OCIR, and container workflows. - Expose unsafe deployment assumptions before production does. - Separate OCI IAM from Kubernetes RBAC and verify both. - Require compartment, region, cluster/project, namespace, and environment scope before destructive changes. ## Trigger Situations Use this skill for: - OCI Container Engine for Kubernetes (OKE) cluster/node-pool discovery, review, or operations. - OCI DevOps project, build pipeline, deploy pipeline, artifact, environment, or trigger work. - OCIR/container repository access, image promotion, signing/scanning, or retention. - Kubernetes deployment safety: rollout, rollback, canary/blue-green, probes, resource requests, autoscaling. - CI/CD least privilege: dynamic groups, resource principals, deploy roles, registry push/pull access. - Requests involving `oci ce`, `oci devops`, container images, clusters, node pools, or deployment pipelines. ## Non-Negotiables - Default to OCI default profile. Use another profile/config only when explicitly provided. - Prefer detected official Oracle MCP tools when available for read-only discovery. Otherwise use OCI CLI default profile. - Never ask users to paste secrets, kubeconfigs, private keys, auth tokens, fingerprints, tenancy OCIDs, or user OCIDs into chat. - `oci ce` is Container Engine in OCI CLI. Do not treat it as cost tooling. - Do not mutate clusters, pipelines, node pools, or deployments without explicit scope, maintenance window, rollback plan, and approval. - Challenge broad admin access. Pipeline convenience is not a reason for tenancy-wide permissions. ## Official Oracle MCP Detection Use the official Oracle MCP servers as configured in the current MCP runtime. Do not hard-code the MCP server name. Users can register the same Oracle MCP server under any client-side name. Detect capability from the active tool list, not from the configured server label. Detection order: 1. **Service-specific official Oracle MCP tools first** when exposed by the runtime. Examples from the official repo include: - `oracle.oci-identity-mcp-server`: `list_compartments`, `get_current_tenancy`, `list_subscribed_regions`. - `oracle.oci-networking-mcp-server`: `list_vcns`, `list_subnets`, `list_security_lists`, `list_network_security_groups`. - `oracle.oci-compute-mcp-server`: `list_instances`, `get_instance`, `list_images`. - `oracle.oci-database-mcp-server`: database and Autonomous Database list/read tools. - `oracle.oci-object-storage-mcp-server`: `get_namespace`, `list_buckets`, `list_objects`. - `oracle.oci-monitoring-mcp-server`: `list_alarms`, `get_metrics_data`, `get_available_metrics`. - `oracle.oci-resource-search-mcp-server`: `search_resources`. - `oracle.oci-usage-mcp-server` / `oracle.oci-pricing-mcp-server`: usage and pricing evidence where available. 2. **Generic official OCI API MCP second**: `oracle.oci-api-mcp-server` exposes `get_oci_command_help` and `run_oci_command`. Use this when no service-specific tool is available. 3. **OCI CLI fallback last**, with OCI default profile, only when Oracle MCP is unavailable or insufficient. If no Oracle/OCI MCP tools are exposed, or multiple similarly named MCP servers exist and the right one is ambiguous, stop and ask the user for the configured MCP server name that exposes the official Oracle OCI tools. Ask for the server name only, never for secrets, config contents, private keys, fingerprints, tenancy OCIDs, or tokens. ## Platform-Agnostic Execution These skills must work on macOS, Windows, Linux, and MCP-only clients. Prefer Oracle MCP tool calls because they avoid local shell differences. When OCI CLI fallback is necessary, show command structure with `` rather than Bash variables, PowerShell variables, Windows `%VARIABLE%` syntax, or machine-local paths. Adapt quoting, line continuation, and environment handling to the user's active platform only at execution time. ## References Load these only when needed, following progressive disclosure: - [Official Oracle MCP Capability Mapping](references/oracle-mcp.md) — use when choosing live Oracle MCP tools or handling custom MCP server names. - [Documentation Fallback](references/documentation-fallback.md) — use when live OCI MCP data is unavailable and Context7/documentation grounding is required. - [Safety Checklist](references/safety-checklist.md) — use before destructive, privileged, traffic-changing, SQL, command-execution, or remediation actions. ## Preferred Official Oracle MCP Capabilities - oracle.oci-registry-mcp-server: list_container_repositories, get_container_repo_details, create_container_repository, delete_container_repository; oracle.oci-cloud-mcp-server for DevOps APIs not covered by a dedicated server. - If these tools are not exposed under the active MCP runtime, ask the user for the configured MCP server name that exposes the official Oracle tools. Ask for the name only, not credentials or config contents. ## Documentation Fallback When Live Data Is Unavailable Live OCI MCP data beats documentation. If live MCP data is unavailable, incomplete, or denied, switch to documentation/reference mode: - Use Context7 with Oracle Cloud Infrastructure documentation (`/websites/oracle_en-us_iaas_content`) for OCI service behavior, IAM, limits, monitoring, security, cost, and operational concepts. - Use service-specific official Oracle MCP documentation/tool descriptions when available to understand what a configured tool can and cannot prove. - Ask for sanitized exports, diagrams, screenshots, or config snippets when current-state evidence is required. - Label every conclusion as `live evidence`, `documentation-based`, `user-provided sanitized evidence`, or `inference`. - Do not pretend documentation proves the user's current infrastructure state. ## Safe Workflow 1. **Confirm platform scope** - Compartment, region, environment, OKE cluster, node pool, DevOps project, repository, namespace, and target workload. - Confirm action mode: discover, review, plan, or execute. 2. **Discover topology** - Prefer MCP for read-only inventory when available. - Otherwise use CLI default profile with placeholders. - For Kubernetes state, ask for sanitized `kubectl` output rather than kubeconfig secrets. 3. **Review control planes** - OCI: compartments, IAM policies, dynamic groups, DevOps project, artifacts, OCIR repositories, VCN/subnets. - Kubernetes: namespaces, service accounts, RBAC, network policies, admission controls, secrets, image pull policy. - CI/CD: build identity, deploy identity, artifact promotion, approvals, rollback hooks. 4. **Stress-test delivery** - What happens if the image is bad? - What happens if a node pool drains mid-deploy? - Can the last known-good artifact be redeployed? - Are probes, resource requests/limits, PDBs, and autoscaling configured? - Is prod separated from dev by compartment, project, tenancy, or policy? 5. **Plan changes safely** - Prefer read-only validation, dry runs, and staged rollout. - Use canary/blue-green/rolling strategy based on workload risk. - Never delete clusters, node pools, repositories, artifacts, or namespaces as a "cleanup" shortcut. ## OCI MCP / CLI Discovery Examples Use MCP when available. Otherwise these examples assume OCI CLI default profile and local placeholder substitution: ```text # Region/identity sanity check without exposing secrets oci iam region-subscription list # OKE / Container Engine: exact command family verified for OCI CLI oci ce cluster list --compartment-id --all oci ce node-pool list --compartment-id --all # OCI DevOps: exact command family verified for OCI CLI oci devops project list --compartment-id --all # Common DevOps drill-downs after project is known oci devops build-pipeline list --project-id --all oci devops deploy-pipeline list --project-id --all oci devops deploy-environment list --project-id --all # OCIR / artifacts inventory oci artifacts container repository list --compartment-id --all ``` For Kubernetes, ask the user to run local sanitized commands: ```text kubectl get ns kubectl get deploy,sts,ds,svc,ingress -n kubectl get pods -n -o wide kubectl auth can-i --list -n ``` Do not ask for kubeconfig, tokens, or real OCIDs in chat. ## Least-Privilege / IAM Review Guidance Review OCI and Kubernetes permissions separately: OCI IAM: - Build principals should push only to required repositories and read only needed artifacts/secrets. - Deploy principals should update only the target environment, cluster, or DevOps deployment resources. - Dynamic groups must match only intended build runners, functions, instances, or OKE workloads. - DevOps project permissions should be compartment-scoped and environment-separated. - Avoid tenancy-wide `manage all-resources`; split build, deploy, operate, and audit duties. Kubernetes RBAC: - Prefer namespace-scoped service accounts over cluster-admin. - Separate deployer, runtime, and operator permissions. - Review secret access explicitly; read on secrets is usually equivalent to credential theft. - Validate admission, network policy, pod security, and image provenance controls where available. ## Output / Report Template ```markdown # OCI DevOps / Container Platform Review ## Scope - Profile/config: default OCI profile unless otherwise stated - Region: - Compartment: - OKE cluster / DevOps project / OCIR repository: - Namespace/workload: - Mode: discover / review / plan / execute ## Executive Verdict - Status: READY / READY WITH RISKS / BLOCKED / INCONCLUSIVE - Top blockers: ## Platform Findings | Severity | Area | Finding | Evidence | Risk | Fix | Validation | |---|---|---|---|---|---|---| ## Deployment Safety - Rollout strategy: - Rollback path: - Artifact provenance: - Runtime health checks: - Capacity/autoscaling: ## Access Review - OCI IAM issues: - Kubernetes RBAC issues: - Secret exposure: ## Assumptions and Unknowns - Verified facts: - Inferences: - Unknowns blocking confidence: ``` ## Red Flags - Pipeline or deploy principal has tenancy admin. - `kubectl` or kubeconfig secrets pasted into chat. - Production and non-production share the same deploy identity without hard boundaries. - No rollback artifact, no health gates, or no approval before prod deploy. - Cluster-admin used for application deployment. - Image tags like `latest` in production. - No resource requests/limits, probes, PDBs, or autoscaling review for critical workloads. - Deleting node pools, namespaces, repositories, or artifacts without retention and recovery proof.