Kubernetes · 3 min read · Dec 09, 2025
Creando tu primer despliegue en un clúster de Kubernetes

** En este artículo, veremos cómo crear tu primer despliegue en un clúster de Kubernetes. Como ejemplo, crearemos un despliegue para Nginx.
Una vez que tengamos un clúster de Kubernetes en funcionamiento, podemos desplegar nuestras aplicaciones en contenedores sobre él. Podemos crear una configuración de Despliegue de Kubernetes para lograr esto.
Un Despliegue proporciona actualizaciones declarativas para Pods y ReplicaSets. Describimos un estado deseado en el Despliegue y el Controlador de Despliegue cambia el estado actual al estado deseado a una tasa controlada.
Podemos crear y gestionar un Despliegue utilizando la interfaz de línea de comandos de Kubernetes “kubectl”. Kubectl utiliza la API de Kubernetes para interactuar con el clúster.
Hay tres etapas en el ciclo de vida de un despliegue:
- Progresando: Kubernetes marca un Despliegue como progresando cuando el Despliegue crea un nuevo ReplicaSet, el Despliegue está escalando su ReplicaSet más nuevo o escalando hacia abajo su ReplicaSet más antiguo o nuevos Pods se vuelven listos o disponibles.
- Completo: Kubernetes marca un Despliegue como completo cuando todas las réplicas asociadas con el Despliegue han sido actualizadas, están disponibles y no se están ejecutando réplicas antiguas del Despliegue.
- Fallido: Esto puede ocurrir debido a cuota insuficiente, fallos en las pruebas de disponibilidad, errores de extracción de imágenes o permisos insuficientes.
Requisitos previos
- Cuenta de AWS (Crea una si no tienes una)
- Un clúster de Kubernetes
Nota: También puedes usar VMs para crear un clúster si no deseas probar en instancias de AWS EC2.
Lo que haremos
- Crear un Despliegue de Kubernetes para Nginx.
Crear un Despliegue de Kubernetes para Nginx
Para crear nuestro primer despliegue, simplemente crearemos un nuevo directorio para crear nuestro Archivo de Objeto/Despliegue. Usa el siguiente comando para crear un nuevo directorio en tu sistema
mkdir my-first-deployment
cd my-first-deployment/
Antes de continuar, verifica el estado del clúster.
Para comprobar los Nodos disponibles en el clúster y verificar la versión de “ kubectl “, usa los siguientes comandos.
sudo kubectl version
sudo kubectl get nodes
Una vez que tengas Nodos disponibles en tu clúster, estás listo para crear tu despliegue.
Crea un archivo “ my-first-deployment.yml “ con el siguiente bloque de código
vim my-first-deployment.yml
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx-deployment
labels:
app: nginx
spec:
replicas: 2
selector:
matchLabels:
app: nginx
template:
metadata:
labels:
app: nginx
spec:
containers:
- name: nginx
image: nginx:1.7.9
ports:
- containerPort: 80Aquí,
- apiVersion: APIVersion define el esquema versionado de esta representación de un objeto.
- kind: El tipo de objeto que deseas crear, como Despliegue, Servicio, Configmap, y más.
- name: El nombre debe ser único dentro de un espacio de nombres.
- labels: Mapa de claves y valores de cadena que se pueden usar para organizar y categorizar objetos.
- spec: Especificación del comportamiento deseado del Despliegue.
- replicas: Número de pods deseados.
- selector: Selector de etiquetas para pods. Los ReplicaSets existentes cuyos pods son seleccionados por esto serán los afectados por este despliegue. Debe coincidir con las etiquetas de la plantilla del pod.
Ahora estás listo para crear tu despliegue usando los siguientes comandos.
sudo kubectl apply -f my-first-deployment.yml
sudo kubectl get deployments

En la captura de pantalla anterior, puedes ver que el despliegue ha sido creado con dos pods que están disponibles para usar.
Puedes obtener los detalles de los pods usando el siguiente comando.
sudo kubectl get pods

Si deseas saber más sobre el despliegue, puedes usar este comando “kubectl describe” para obtener los detalles completos del despliegue.
sudo kubectl get deployments
sudo kubectl describe deployments nginx-deployment

Si ya no necesitas el despliegue, puedes eliminarlo usando el comando “kubectl delete”.
sudo kubectl get deployments
sudo kubectl delete deployments nginx-deployment
sudo kubectl get deployments

En la captura de pantalla anterior, puedes ver que el despliegue ya no está disponible después de ser eliminado.
Una vez que eliminas el despliegue, los pods también se eliminan.
Puedes comprobar la disponibilidad de los pods usando el siguiente comando.
sudo kubectl get pods
En la captura de pantalla anterior, puedes ver que los pods han sido eliminados después de eliminar el despliegue y no están disponibles.
Conclusión
En este artículo, vimos los pasos para crear tu primer Despliegue de Nginx en Kubernetes. También vimos cómo se pueden extraer los detalles sobre el despliegue. Junto con esto, exploramos los comandos para eliminar el despliegue.
Recibe nuevas publicaciones en tu bandeja de entrada.
No spam. Cancela la suscripción en cualquier momento.