Edit

Share via

Create and delete pods

  • Article

Applies to: AKS on Azure Stack HCI 22H2, AKS on Windows Server

Kubernetes uses pods to run an instance of your application. This article describes how to create and delete pods when managing your workloads in AKS enabled by Azure Arc.

A pod represents a single instance of an application. Each pod has one or more containers deployed together on a single host. A pod is the smallest unit of execution in Kubernetes. An internal IP address and port are assigned to a pod, through which containers within the pod can share a common storage and network. Like a service, volume, and namespace, a pod is a basic Kubernetes object. Pods run on nodes and have a definite lifecycle, during which they run until their containers are removed.

Create a pod

Before you create a pod, you must set up an AKS host and create AKS clusters using Windows PowerShell. You can also use Windows Admin Center to set up the host and create the clusters.

To make sure you are connected to the Kubernetes cluster, run the following command:

kubectl get nodes

To create a pod, run the following command. In this example, a pod is created using an nginx image:

kubectl run nginx --image=nginx --restart=Never

When you set the parameter -restart=Never, Kubernetes creates a single pod instead of creating a deployment.

To see the status of your pod, run the following command:

kubectl get pods

To view the entire configuration of the pod, run the following command:

kubectl describe pod nginx

Delete a pod

To delete a pod you created, run the following command:

kubectl delete pod

Example pod configuration

The following YAML example describes the features of a pod, and shows how it's the smallest unit of Kubernetes that can be defined, deployed, and managed:

apiVersion: v1 
kind: Pod 
metadata: 
      labels: 
         app: nginx 
      name: nginx 
      namespace: calico-demo 
spec: 
      containers: 
      - name: nginx 
         image: nginx:1.8 
         ports: 
         - containerPort: 80 
      nodeSelector: 
          beta.kubernetes.io/os: linux

Next steps