Página inicial da VPSie

Voltar para a base de conhecimento

O Docker permite empacotar um aplicativo e tudo o que ele precisa em um contêiner leve e portátil que funciona da mesma forma em qualquer máquina. O Docker Compose se baseia nisso, permitindo definir e executar um aplicativo multi-contêiner inteiro a partir de um único arquivo YAML. Este guia mostra como instalar ambos em um VPS Ubuntu 24.04 LTS novo e implantar sua primeira pilha real.

O Docker Compose executa múltiplos serviços em uma única rede em um host Ubuntu 24.04

Pré-requisitos

Etapa 1 — Atualize o sistema

Comece com um índice de pacotes atualizado e instale as poucas ferramentas necessárias para adicionar o repositório do Docker com segurança:

sudo apt-get update
sudo apt-get install -y ca-certificates curl

Etapa 2 — Adicione a chave GPG oficial e o repositório do Docker

Os repositórios padrão do Ubuntu geralmente incluem uma versão mais antiga do Docker. Instalar a partir do repositório próprio do Docker garante que você obtenha a versão estável mais recente e o plugin Compose.

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo 
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu 
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | 
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Etapa 3 — Instale o Docker Engine e o plugin Compose

sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

O pacote docker-compose-plugin fornece o comando moderno docker compose (note o espaço — o binário antigo com hífen docker-compose está obsoleto).

Etapa 4 — Verifique a instalação

sudo docker run hello-world
docker --version
docker compose version

Se o Docker estiver funcionando, você verá a mensagem “Hello from Docker!” confirmando que o engine baixou uma imagem e executou um container.

Etapa 5 — Executar o Docker sem sudo (opcional)

Adicione seu usuário ao grupo docker para não precisar prefixar cada comando com sudo:

sudo usermod -aG docker $USER
newgrp docker

Nota de segurança: membros do grupo docker têm efetivamente privilégios de root no host. Adicione apenas usuários confiáveis.

Etapa 6 — Implantar sua primeira stack com Docker Compose

Vamos lançar um site WordPress completo (web + banco de dados) com um único comando. Crie uma pasta de projeto e um arquivo compose.yaml:

mkdir ~/wordpress && cd ~/wordpress
nano compose.yaml

Cole o seguinte, alterando as senhas para valores fortes de sua escolha:

services:
  db:
    image: mariadb:11
    restart: always
    environment:
      MARIADB_DATABASE: wordpress
      MARIADB_USER: wp_user
      MARIADB_PASSWORD: change_this_password
      MARIADB_ROOT_PASSWORD: change_this_root_password
    volumes:
      - db_data:/var/lib/mysql

  wordpress:
    image: wordpress:latest
    depends_on:
      - db
    restart: always
    ports:
      - "8080:80"
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: wp_user
      WORDPRESS_DB_PASSWORD: change_this_password
      WORDPRESS_DB_NAME: wordpress
    volumes:
      - wp_data:/var/www/html

volumes:
  db_data:
  wp_data:

Inicie a stack em segundo plano:

docker compose up -d

Abra http://your_server_ip:8080 em um navegador e você será recebido pelo instalador do WordPress — dois containers, uma rede, zero configuração manual.

Etapa 7 — Gerenciar sua stack

docker compose ps        # list running services
docker compose logs -f   # follow logs
docker compose stop      # stop without removing
docker compose down      # stop and remove containers (named volumes are kept)

Próximos passos

Conclusão

Agora você tem o Docker Engine e o Docker Compose em execução no Ubuntu 24.04 e implantou um aplicativo real de múltiplos contêineres. A partir daqui, você pode descrever qualquer stack — servidores de aplicativo, bancos de dados, caches, filas — em um único arquivo e reproduzi-lo em qualquer lugar em segundos.

Voltar para a base de conhecimento