📖 Kubernetes Glossary
LaraKube speaks the language of Kubernetes, the industry-standard orchestrator for containers. While we handle the "plumbing" for you, understanding these core concepts will help you master your cluster.
For deep dives, we recommend the Official Kubernetes Documentation.
🏗 Cluster & Organization
Cluster
A set of node machines for running containerized applications. LaraKube orchestrates your app within this cluster.
Namespace
A virtual partition in your cluster. LaraKube creates a dedicated namespace for every project (e.g., my-app-local), keeping your environments isolated.
📦 Workloads & Running Code
Pod
The smallest unit in Kubernetes. A Pod runs one or more containers (like your PHP app or a MySQL database). When you run larakube up, you are launching Pods.
Deployment
Describes the "desired state" of your application. It manages the creation and scaling of Pods. If a Pod crashes, the Deployment automatically replaces it.
CronJob
Manages time-based tasks. LaraKube uses this to orchestrate the Laravel Task Scheduler.
🌍 Networking & Access
Service
An abstract way to expose your Pods as a network service. This is how your PHP app talks to your Database (e.g., DB_HOST=mysql).
Ingress
The "Front Door" of your cluster. It manages external access to your services, typically HTTP. This allows you to visit your app at my-app.local.
💾 Storage & Persistence
PersistentVolume (PV)
A piece of storage in the cluster that has been provisioned by an administrator or dynamically provisioned using Storage Classes.
PersistentVolumeClaim (PVC)
A request for storage by a user. Think of it like a "Ticket" to use a piece of a PersistentVolume.
emptyDir
A simple volume that is created when a Pod is assigned to a node and exists as long as that Pod is running. LaraKube uses this for Local Databases to ensure speed and stability without permission issues.
🛠 Configuration & Customization
ConfigMap & Secret
Objects used to store non-confidential and sensitive data (like your .env values). LaraKube automatically syncs these into your cluster.
Kustomize
A tool for customizing Kubernetes manifests without templates. LaraKube uses this to manage Base configurations and Overlays (like Local vs. Production).
Overlay
A set of Kustomize patches that modify a base configuration for a specific environment.