wils@web ~ $ cat ~/ajuda/como-implementar-ci-cd-com-gitlab-ci-15-0-e-docker-para-aplicacoes-net-guia-passo-a-passo.md

DevOps

Como implementar CI/CD com GitLab CI 15.0 e Docker para aplicações .NET: Guia passo a passo

atualizado em 25/08/2026

Implementar CI/CD com GitLab CI e Docker para aplicações .NET é uma maneira eficaz de automatizar o processo de desenvolvimento e entrega. Este guia passo a passo irá orientá-lo através do processo.

Pré-requisitos

  • Conta no GitLab
  • Docker instalado
  • GitLab Runner configurado
  • Aplicação .NET pronta para ser containerizada

Passo 1: Criar o Dockerfile

O primeiro passo é criar um Dockerfile na raiz do seu projeto .NET. Este arquivo define como a imagem do Docker será construída.

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["SeuProjeto.csproj", "./"]
RUN dotnet restore "SeuProjeto.csproj"
COPY . .
WORKDIR "/src/"
RUN dotnet build "SeuProjeto.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "SeuProjeto.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "SeuProjeto.dll"]

Passo 2: Configurar o GitLab CI

Crie um arquivo chamado .gitlab-ci.yml na raiz do seu repositório. Este arquivo define as etapas do CI/CD.

stages:
  - build
  - deploy

build:
  stage: build
  image: mcr.microsoft.com/dotnet/sdk:6.0
  script:
    - dotnet build
    - docker build -t seu_usuario/seu_projeto:latest .
  artifacts:
    paths:
      - bin/

deploy:
  stage: deploy
  image: docker:latest
  services:
    - docker:dind
  script:
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
    - docker push seu_usuario/seu_projeto:latest

Passo 3: Configurar variáveis de ambiente

No GitLab, vá até as configurações do seu projeto e adicione as seguintes variáveis de ambiente:

  • CI_REGISTRY_USER: seu usuário do Docker Hub
  • CI_REGISTRY_PASSWORD: sua senha do Docker Hub

Passo 4: Executar o Pipeline

Após configurar tudo, faça um commit e envie para o repositório. O GitLab CI iniciará automaticamente o pipeline. Você pode acompanhar o progresso na aba CI/CD.

Conclusão

Agora você tem um pipeline CI/CD funcional para sua aplicação .NET usando GitLab CI e Docker. Lembre-se de testar seu pipeline e ajustar conforme necessário para atender às suas necessidades específicas.

Dica: Sempre revise os logs do pipeline para identificar e corrigir problemas rapidamente.

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.