{"id":8466,"date":"2026-05-22T08:46:38","date_gmt":"2026-05-22T06:46:38","guid":{"rendered":"https:\/\/mybox.com\/help\/?post_type=manual_kb&#038;p=8466"},"modified":"2026-06-14T18:52:41","modified_gmt":"2026-06-14T16:52:41","slug":"example-kubernetes-configuration-file-yaml-deployment-manifest","status":"publish","type":"manual_kb","link":"https:\/\/mybox.com\/help\/en\/knowledgebase\/example-kubernetes-configuration-file-yaml-deployment-manifest\/","title":{"rendered":"Sample Kubernetes Configuration File"},"content":{"rendered":"\n<div class=\"translation-block translation-block-merged\">\n<p class=\"wp-block-paragraph\">Kubernetes uses configuration files called <strong>manifests<\/strong> to define how applications, containers, and services should run within a cluster. These files are typically written in YAML format and allow administrators and developers to deploy infrastructure consistently and automatically.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A Kubernetes manifest can describe many different resources, including:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Pods<\/li>\n\n\n\n<li>Deployments<\/li>\n\n\n\n<li>Services<\/li>\n\n\n\n<li>ConfigMaps<\/li>\n\n\n\n<li>Secrets<\/li>\n\n\n\n<li>Ingress rules<\/li>\n\n\n\n<li>Persistent Volumes<\/li>\n<\/ul>\n\n\n\n<\/div>\n\n<div id=\"mybox-922929810\" class=\"mybox-content mybox-entity-placement\"><div class=\"early-access-banner-inpost\">\r\n  <div class=\"banner-left-inpost\">\r\n    <div class=\"icon-box-inpost\">\r\n      <img decoding=\"async\" src=\"https:\/\/mybox.com\/help\/wp-content\/uploads\/2026\/02\/square-info-icon.svg\" alt=\"Info\">\r\n    <\/div>\r\n    <div class=\"text-box-inpost\">\r\n      <span class=\"label-inpost\"><span class=\"translation-block translation-block-banner-text\">Early access<\/span><\/span>\r\n      <h4><span class=\"translation-block translation-block-banner-text\">Still need help?<\/span><\/h4>\r\n      <p><span class=\"translation-block translation-block-banner-text\">Contact our customer service team.<\/span><\/p>\r\n    <\/div>\r\n  <\/div>\r\n\r\n  <div class=\"banner-right-inpost\">\r\n    <a href=\"https:\/\/panel.mybox.com\/helpdesk2\/v\/list\/\" class=\"banner-button-inpost\"><span class=\"translation-block translation-block-banner-text\">Message us<\/span><\/a>\r\n  <\/div>\r\n<\/div><\/div>\n\n<div class=\"translation-block translation-block-merged\"><p class=\"wp-block-paragraph\">Below is a simple example of a Kubernetes Pod configuration.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>apiVersion: v1\nkind: Pod\nmetadata:\n  name: example-pod\n  labels:\n    app: my-application\n\nspec:\n  containers:\n    - name: application-container\n      image: my-application:latest\n      ports:\n        - containerPort: 80\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_86 ez-toc-wrap-left counter-hierarchy ez-toc-counter ez-toc-custom ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Table of Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/example-kubernetes-configuration-file-yaml-deployment-manifest\/#Understanding_the_Configuration\" >Understanding the Configuration<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/example-kubernetes-configuration-file-yaml-deployment-manifest\/#apiVersion\" >apiVersion<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/example-kubernetes-configuration-file-yaml-deployment-manifest\/#kind\" >kind<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/example-kubernetes-configuration-file-yaml-deployment-manifest\/#metadata\" >metadata<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/example-kubernetes-configuration-file-yaml-deployment-manifest\/#spec\" >spec<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/example-kubernetes-configuration-file-yaml-deployment-manifest\/#containers\" >containers<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/example-kubernetes-configuration-file-yaml-deployment-manifest\/#name\" >name<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-8\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/example-kubernetes-configuration-file-yaml-deployment-manifest\/#image\" >image<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-9\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/example-kubernetes-configuration-file-yaml-deployment-manifest\/#ports\" >ports<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-10\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/example-kubernetes-configuration-file-yaml-deployment-manifest\/#Deploying_the_Manifest\" >Deploying the Manifest<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-11\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/example-kubernetes-configuration-file-yaml-deployment-manifest\/#Checking_the_Pod_Status\" >Checking the Pod Status<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-12\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/example-kubernetes-configuration-file-yaml-deployment-manifest\/#Why_Deployments_Are_Usually_Preferred\" >Why Deployments Are Usually Preferred<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-13\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/example-kubernetes-configuration-file-yaml-deployment-manifest\/#Example_Deployment_Manifest\" >Example Deployment Manifest<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-14\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/example-kubernetes-configuration-file-yaml-deployment-manifest\/#Summary\" >Summary<\/a><\/li><\/ul><\/nav><\/div>\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Understanding_the_Configuration\"><\/span>Understanding the Configuration<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"apiVersion\"><\/span>apiVersion<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The <code>apiVersion<\/code> field specifies which Kubernetes API version should be used for the resource.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>apiVersion: v1\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">For basic resources such as Pods, the most commonly used version is <code>v1<\/code>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"kind\"><\/span>kind<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The <code>kind<\/code> field defines the type of Kubernetes resource being created.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>kind: Pod\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">In this example, Kubernetes will create a single Pod.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"metadata\"><\/span>metadata<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The metadata section contains identifying information about the resource.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>metadata:\n  name: example-pod\n  labels:\n    app: my-application\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Common metadata values include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Resource name<\/li>\n\n\n\n<li>Labels<\/li>\n\n\n\n<li>Annotations<\/li>\n\n\n\n<li>Namespace information<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Labels are particularly useful because they allow other Kubernetes resources to identify and interact with the Pod.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"spec\"><\/span>spec<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The specification section defines the desired state of the resource.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>spec:\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">This is where you configure containers, storage, networking, and other runtime settings.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"containers\"><\/span>containers<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">A Pod can contain one or multiple containers.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>containers:\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Each container requires its own configuration.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"name\"><\/span>name<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The container name is used internally by Kubernetes.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>name: application-container\n<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"image\"><\/span>image<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The image field specifies which container image should be downloaded and executed.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>image: my-application:latest\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">In production environments, it is often recommended to use specific image versions instead of the <code>latest<\/code> tag.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Example:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>image: my-application:v1.2.0\n<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"ports\"><\/span>ports<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The ports section defines which container ports should be exposed.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>ports:\n  - containerPort: 80\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">In this example, the application listens on port 80 inside the container.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Deploying_the_Manifest\"><\/span>Deploying the Manifest<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Save the configuration to a file such as:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>pod.yaml\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Then deploy it using:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>kubectl apply -f pod.yaml\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Kubernetes will create the Pod according to the configuration.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Checking_the_Pod_Status\"><\/span>Checking the Pod Status<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">To verify that the Pod is running correctly:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>kubectl get pods\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">To view detailed information:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>kubectl describe pod example-pod\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">To view application logs:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>kubectl logs example-pod\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Why_Deployments_Are_Usually_Preferred\"><\/span>Why Deployments Are Usually Preferred<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Although Pods can be created directly, production environments typically use <strong>Deployments<\/strong> instead.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Deployments provide:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Automatic recovery<\/li>\n\n\n\n<li>Rolling updates<\/li>\n\n\n\n<li>Easy scaling<\/li>\n\n\n\n<li>Replica management<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">A Deployment automatically recreates failed Pods and helps ensure application availability.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Example_Deployment_Manifest\"><\/span>Example Deployment Manifest<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<pre class=\"wp-block-code\"><code>apiVersion: apps\/v1\nkind: Deployment\nmetadata:\n  name: my-application\n\nspec:\n  replicas: 3\n\n  selector:\n    matchLabels:\n      app: my-application\n\n  template:\n    metadata:\n      labels:\n        app: my-application\n\n    spec:\n      containers:\n        - name: application-container\n          image: my-application:v1.0\n          ports:\n            - containerPort: 80\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">This configuration launches three identical Pods and automatically replaces any Pod that becomes unavailable.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Summary\"><\/span>Summary<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Kubernetes manifests are configuration files that define how resources should operate within a cluster. The example above demonstrates a simple Pod configuration, including metadata, container definitions, and networking settings.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">While direct Pod creation is useful for testing and learning Kubernetes, most production environments rely on Deployments and Services to provide scalability, resilience, and easier application management.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n<\/div>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"template":"","format":"standard","manualknowledgebasecat":[25],"manual_kb_tag":[7425,7426,7427,7428,7429,7430,7431,7432,7433,4348],"class_list":["post-8466","manual_kb","type-manual_kb","status-publish","format-standard","hentry","manualknowledgebasecat-hosting","manual_kb_tag-kubernetes-manifests","manual_kb_tag-pod-configuration","manual_kb_tag-kubernetes-pod","manual_kb_tag-deployment-manifest","manual_kb_tag-kubernetes-deployment","manual_kb_tag-services","manual_kb_tag-configmaps","manual_kb_tag-secrets","manual_kb_tag-ingress-rules","manual_kb_tag-kubernetes"],"_links":{"self":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/8466","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb"}],"about":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/types\/manual_kb"}],"author":[{"embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":2,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/8466\/revisions"}],"predecessor-version":[{"id":8467,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/8466\/revisions\/8467"}],"wp:attachment":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/media?parent=8466"}],"wp:term":[{"taxonomy":"manualknowledgebasecat","embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manualknowledgebasecat?post=8466"},{"taxonomy":"manual_kb_tag","embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb_tag?post=8466"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}