wils@web ~ $ cat ~/ajuda/como-implementar-um-pipeline-ci-cd-completo-com-gitlab-ci-e-kubernetes-1-26-guia-passo-a-passo.md

DevOps

Como implementar um pipeline CI/CD completo com GitLab CI e Kubernetes 1.26: Guia passo a passo

atualizado em 02/09/2026

Este guia fornece um passo a passo sobre como implementar um pipeline CI/CD completo utilizando GitLab CI e Kubernetes 1.26.

Introdução

O CI/CD (Integração Contínua e Entrega Contínua) é uma prática essencial para automatizar o processo de desenvolvimento e implantação de software. Neste guia, vamos configurar um pipeline CI/CD usando GitLab CI para orquestrar o processo e Kubernetes para gerenciar a implantação.

Pré-requisitos

  • Conta no GitLab
  • Cluster Kubernetes 1.26 em funcionamento
  • kubectl instalado e configurado
  • Docker instalado

Passo a Passo

1. Criar um repositório no GitLab

Crie um novo projeto no GitLab e clone o repositório localmente:

git clone https://gitlab.com/username/nome-do-repositorio.git

2. Criar um Dockerfile

No diretório do seu projeto, crie um arquivo chamado Dockerfile:

FROM node:14
WORKDIR /app
COPY . .
RUN npm install
CMD ["npm", "start"]

3. Configurar o GitLab CI

No diretório do seu projeto, crie um arquivo chamado .gitlab-ci.yml:

image: docker:latest

services:
  - docker:dind

stages:
  - build
  - deploy

build:
  stage: build
  script:
    - docker build -t registry.gitlab.com/username/nome-do-repositorio:latest .
    - docker push registry.gitlab.com/username/nome-do-repositorio:latest

deploy:
  stage: deploy
  script:
    - kubectl set image deployment/nome-do-deployment nome-do-container=registry.gitlab.com/username/nome-do-repositorio:latest
    - kubectl rollout status deployment/nome-do-deployment

4. Configurar o acesso ao Kubernetes

Adicione as credenciais do Kubernetes nas variáveis de ambiente do GitLab:

  • KUBE_CONFIG: Configuração do kubeconfig
  • KUBE_CONTEXT: Contexto do cluster

5. Testar o pipeline

Faça um commit e envie para o repositório:

git add .
git commit -m "Configuração do pipeline CI/CD"
git push origin main

Conclusão

Com isso, você terá um pipeline CI/CD funcional que constrói e implanta sua aplicação automaticamente. Lembre-se de monitorar os logs do GitLab CI para garantir que tudo esteja funcionando corretamente. Uma dica importante é sempre manter suas imagens Docker atualizadas e testar suas implantações em um ambiente de staging antes de ir para produção.

Precisa de ajuda com isso no seu servidor? A gente resolve pra você.

falar no WhatsApp

// deu erro ou não funcionou?

Achou algo errado neste manual?

Conta pra gente o que deu errado ou qual erro apareceu — a gente corrige. Se quiser retorno, deixe seu contato.