README
¶
Kubernetes Examples
Welcome to the official Kubernetes Examples repository! This curated collection, stewarded by SIG Apps, provides high-quality, educational examples for running a diverse range of applications and workloads on Kubernetes.
Our goal is to offer a central hub where you can:
- Discover practical implementations for various use cases.
- Learn common patterns and best practices for deploying applications on Kubernetes.
- Explore configurations for general-purpose applications as well as specialized ones like AI/ML workloads and platforms.
Browse Examples
We encourage you to explore the subdirectories to find examples relevant to your needs. Examples are organized into categories, such as:
- AI: Demonstrations of AI/ML model training, serving, end-to-end platform reference manifests, and MLOps toolchains.
- Web: Examples of web-based applications, from simple static sites to more complex multi-tier applications.
- Databases: Best practices and configurations for deploying various types of databases on Kubernetes.
- ... (and more as the collection grows!)
Each example includes its own detailed README.md file covering:
- Purpose and learning objectives
- Prerequisites (including Kubernetes version and hardware if applicable)
- Step-by-step deployment instructions
- Verification and cleanup commands
- Key Kubernetes concepts used
Contributing to Kubernetes Examples
We welcome contributions from the community! If you have an example that showcases how to run applications or workloads on Kubernetes effectively and educates users, please consider sharing it.
Before contributing, please thoroughly review our:
- Example Guidelines: These outline the standards, structure, and best practices all examples must follow.
- CONTRIBUTING.md: This provides instructions on the contribution process, including how to propose, submit, and review examples.
Your contributions help make Kubernetes more accessible and understandable for everyone.
Our Philosophy
We aim for these examples to be:
- Educational: Clearly explaining how and why things work.
- Practical: Demonstrating real-world (though possibly simplified) applications and platforms.
- Current: Reflecting modern Kubernetes features and best practices.
- Maintained: Kept up-to-date by the community and SIG Apps.
Directories
¶
| Path | Synopsis |
|---|---|
|
Examples contains sample applications for trying out the concepts in Kubernetes.
|
Examples contains sample applications for trying out the concepts in Kubernetes. |
|
explorer
command
A tiny web server for viewing the environment kubernetes creates for your containers.
|
A tiny web server for viewing the environment kubernetes creates for your containers. |
|
https-nginx
command
A small script that converts the given open ssl public/private keys to a secret that it writes to stdout as json.
|
A small script that converts the given open ssl public/private keys to a secret that it writes to stdout as json. |
|
sharing-clusters
command
A tiny script to help conver a given kubeconfig into a secret.
|
A tiny script to help conver a given kubeconfig into a secret. |
|
databases
|
|
|
cassandra/go
command
|
|
|
web
|
|
|
guestbook-go
command
|