Oracle Container Host for Kubernetes Image Builder
- Product:
- Oracle Cloud Native Environment
- Document Type:
- Developer Guide
- Version:
- G17139-05
- Last Publish Date:
- August 2025
- Tools Used:
- DITA XML, Oxygen XML Editor, Git
Overview
The Oracle Container Host for Kubernetes (OCK) Image Builder Guide documents procedures for creating custom node images for Oracle CNE clusters. OCK is the specialized Oracle Linux-based operating system image optimized for Kubernetes node deployment, based on OSTree. The guide covers OCK image architecture and components, image building prerequisites and environment setup, creating custom OCK images with additional software, image customization options (packages, configurations, scripts), testing and validating custom images, deploying clusters using custom OCK images, and troubleshooting image build issues.
Target Audience
Platform engineers, security teams, and system administrators who need to customize Kubernetes node images to meet organizational requirements. Assumes strong Linux system administration knowledge and familiarity with image building concepts.
Key Documentation Features
Customization Workflows: While Oracle provides pre-built OCK images, many enterprise deployments require customization for security agents, monitoring tools, or corporate standards. This guide documents the complete customization workflow.
Build Process: Detailed documentation of the image build process, including required tools, build environment setup, and build configuration options.
Integration with Cluster Deployment: Shows how custom OCK images integrate with standard Oracle CNE cluster deployment workflows across all provider types.
Documentation Challenge
OCK image customization involves multiple technologies: Oracle Linux, image building tools, Kubernetes node requirements, and various provider-specific image formats. Documentation needed to guide users through this complexity while preventing image builds that would produce non-functional Kubernetes nodes.
Solution: Provided tested examples for common customization scenarios. Provided clear CLI installation and configuration, and added explanations for all CLI command options.