Como extrair um dump do container e salvá-lo na máquina host?

Para extrair um dump de um contêiner e guardá-lo na máquina host, podem ser utilizados vários métodos, dependendo do tipo de dump (por exemplo, base de dados, memória).

1. Uso de docker exec e redirecionamento de saída:

Este método é adequado se tiver um comando dentro do contêiner que gera o dump na saída padrão.

// Substitua <nome_do_conteiner> pelo nome ou ID do seu contêiner,
// <comando_de_dump> pelo comando que gera o dump (por exemplo, pg_dump, mysqldump),
// e <caminho_no_host> pelo caminho onde deseja guardar o arquivo na máquina host.
docker exec <nome_do_conteiner> <comando_de_dump> > <caminho_no_host>/dump.sql

Exemplo com PostgreSQL:

// Extrair o dump da base de dados 'mydatabase' do contêiner 'my-postgres-container'
// e guardá-lo na máquina host no arquivo /tmp/postgres_dump.sql.
docker exec my-postgres-container pg_dump -U myuser mydatabase > /tmp/postgres_dump.sql

Exemplo com MySQL:

// Extrair o dump da base de dados 'mydatabase' do contêiner 'my-mysql-container'
// e guardá-lo na máquina host no arquivo /tmp/mysql_dump.sql.
docker exec my-mysql-container mysqldump -u myuser -p mydatabase > /tmp/mysql_dump.sql

2. Uso de docker cp:

Este método é adequado se o dump puder ser guardado num arquivo temporário dentro do contêiner através de um comando, e depois copiado para a máquina host.

// Substitua <nome_do_conteiner> pelo nome ou ID do seu contêiner,
// <caminho_no_conteiner> pelo caminho onde o arquivo temporário será criado,
// e <caminho_no_host> pelo caminho onde deseja guardar o arquivo na máquina host.

// Passo 1: Gerar o dump num arquivo temporário dentro do contêiner
docker exec <nome_do_conteiner> <comando_de_dump> <caminho_no_conteiner>/temp_dump.sql

// Passo 2: Copiar o arquivo do dump para o host
docker cp <nome_do_conteiner>:<caminho_no_conteiner>/temp_dump.sql <caminho_no_host>/dump.sql

// Passo 3: (Opcional) Apagar o arquivo temporário dentro do contêiner
docker exec <nome_do_conteiner> rm <caminho_no_conteiner>/temp_dump.sql

Exemplo com PostgreSQL:

// Passo 1: Gerar o dump da base de dados 'mydatabase' no arquivo temporário /tmp/temp_dump.sql dentro do contêiner 'my-postgres-container'
docker exec my-postgres-container pg_dump -U myuser mydatabase > /tmp/temp_dump.sql

// Passo 2: Copiar o arquivo /tmp/temp_dump.sql do contêiner para o host em /tmp/postgres_dump.sql
docker cp my-postgres-container:/tmp/temp_dump.sql /tmp/postgres_dump.sql

// Passo 3: Apagar o arquivo temporário /tmp/temp_dump.sql dentro do contêiner
docker exec my-postgres-container rm /tmp/temp_dump.sql

3. Uso de Volumes:

Um método mais preferido e conveniente para criar dumps regulares é usar Volumes do Docker. Pode montar um diretório do host no contêiner e guardar os dumps diretamente nesse diretório.

// Exemplo de ficheiro Docker Compose com montagem de volume
services:
  mydb:
    image: my-database-image
    volumes:
      - ./dumps:/app/dumps // Monta o diretório 'dumps' do host em '/app/dumps' dentro do contêiner
    # ... outras configurações do serviço

Dentro do contêiner, o seu comando de geração do dump deve guardar no diretório montado (/app/dumps neste exemplo). Os ficheiros ficarão acessíveis automaticamente no host no diretório ./dumps (relativo à localização do ficheiro Docker Compose).

4. Dump de memória (Memory Dump):

Para tirar um dump de memória do contêiner, pode usar comandos do sistema operativo do host ou ferramentas especializadas como coredumpctl (em sistemas com systemd) ou gcore. Antes de usar esses métodos, assegure-se de que a criação de coredumps está ativada no contêiner e que os limites de recursos (ulimits) estão corretamente configurados.

// Exemplo para obter um coredump de um processo com PID 123 dentro do contêiner
// (requer permissões adequadas no host e configurações no contêiner)
sudo gcore -o /tmp/coredump 123

É importante notar que tirar um dump de memória é uma tarefa mais complexa e requer um entendimento profundo dos processos dentro do contêiner e da configuração do sistema operativo do host.

A escolha do método depende da tarefa específica, do tipo de dump e das suas preferências. Para dumps regulares de bases de dados, usar Volumes é a abordagem mais flexível e fiável. Para extrações únicas ou depuração, docker exec e docker cp também são opções eficazes.