Kubernetes · 3 min read · Dec 09, 2025

Criando seu primeiro deployment em um Cluster Kubernetes

** Neste artigo, veremos como criar seu primeiro deployment em um Cluster Kubernetes. Como exemplo, criaremos um deployment para o Nginx.

Uma vez que temos um cluster Kubernetes em funcionamento, podemos implantar nossas aplicações containerizadas sobre ele. Podemos criar uma configuração de Deployment do Kubernetes para alcançar isso.

Um Deployment fornece atualizações declarativas para Pods e ReplicaSets. Descrevemos um estado desejado no Deployment e o Controller de Deployment altera o estado atual para o estado desejado a uma taxa controlada.

Podemos criar e gerenciar um Deployment usando a interface de linha de comando “kubectl” do Kubernetes. O Kubectl usa a API do Kubernetes para interagir com o cluster.

Existem três estágios no ciclo de vida de um deployment:

  1. Progredindo: Kubernetes marca um Deployment como progredindo quando o Deployment cria um novo ReplicaSet, o Deployment está escalando seu novo ReplicaSet ou diminuindo seu ReplicaSet mais antigo ou novos Pods se tornam prontos ou disponíveis.
  2. Completo: Kubernetes marca um Deployment como completo quando todas as réplicas associadas ao Deployment foram atualizadas, estão disponíveis e nenhuma réplica antiga do Deployment está em execução.
  3. Falhou: Isso pode ocorrer devido a cota insuficiente, falhas em sondas de prontidão, erros de pull de imagem ou permissões insuficientes.

Pré-requisitos

  1. Conta AWS (Crie uma se você não tiver uma)
  2. Um Cluster Kubernetes

Nota: Você também pode usar VMs para criar um cluster se não quiser tentar em Instâncias EC2 da AWS.

O que faremos

  1. Criar um Deployment Kubernetes para Nginx.

Criar um Deployment Kubernetes para Nginx

Para criar nosso primeiro deployment, vamos apenas criar um novo diretório para criar nosso Arquivo de Objeto/Deployment. Use o seguinte comando para criar um novo diretório em seu sistema

mkdir my-first-deployment
cd my-first-deployment/

Antes de prosseguir, verifique o status do cluster.

Para verificar os Nós disponíveis no cluster e para verificar a versão do “kubectl“, use os seguintes comandos.

sudo kubectl version
sudo kubectl get nodes

Uma vez que você tenha Nós disponíveis em seu cluster, você está pronto para criar seu deployment.

Crie um arquivo “my-first-deployment.yml” com o seguinte bloco 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: 80

Aqui,

  • apiVersion: APIVersion define o esquema versionado desta representação de um objeto.
  • kind: O tipo de objeto que você deseja criar, como Deployment, Service, Configmap e mais.
  • name: O nome deve ser único dentro de um namespace.
  • labels: Mapa de chaves e valores de string que podem ser usados para organizar e categorizar objetos.
  • spec: Especificação do comportamento desejado do Deployment.
  • replicas: Número de pods desejados.
  • selector: Seletor de rótulo para pods. ReplicaSets existentes cujos pods são selecionados por isso serão os afetados por este deployment. Deve corresponder aos rótulos do template do pod.

Agora você está pronto para criar seu deployment usando os seguintes comandos.

sudo kubectl apply -f my-first-deployment.yml
sudo kubectl get deployments

kubectl apply

Na captura de tela acima, você pode ver que o deployment foi criado com dois pods que estão disponíveis para uso.

Você pode obter os detalhes dos pods usando o seguinte comando.

sudo kubectl get pods

kubectl get pods

Se você quiser saber mais sobre o deployment, pode usar este comando “kubectl describe” para obter os detalhes completos do deployment.

sudo kubectl get deployments
sudo kubectl describe deployments nginx-deployment

kubectl get deployments

Se você não precisar mais do deployment, pode excluí-lo usando o comando “kubectl delete”.

sudo kubectl get deployments
sudo kubectl delete deployments nginx-deployment
sudo kubectl get deployments

kubectl get deployments

Na captura de tela acima, você pode ver que o deployment não está mais disponível após ser excluído.

Uma vez que você exclui o deployment, os pods também são excluídos.

Você pode verificar a disponibilidade dos pods usando o seguinte comando.

sudo kubectl get pods

Na captura de tela acima, você pode ver que os pods foram excluídos após a exclusão do deployment e não estão disponíveis.

Conclusão

Neste artigo, vimos os passos para criar seu primeiro Deployment Nginx no Kubernetes. Também vimos como os detalhes sobre o deployment podem ser extraídos. Juntamente com isso, exploramos os comandos para excluir o deployment.

Share: X/Twitter LinkedIn

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.