Backup e Restauração#

Backup do Sherpa Orchestrator (Docker)#

Instruções para criar um backup da configuração e do banco de dados na versão Docker do Sherpa Orchestrator.

1. Preparação#

Abra um terminal no servidor e navegue até o diretório de instalação do projeto.

cd /opt/SherpaOrchestrator

Recomenda-se criar uma pasta separada para o backup com a data atual.

BACKUP_DIR=./backup_$(date +%Y%m%d_%H%M%S)
mkdir -p "$BACKUP_DIR"

2. Cópia do arquivo .env#

Copie o arquivo de variáveis de ambiente.

cp ./.env "$BACKUP_DIR"/.env

3. Cópia das configurações backend/config#

Copie a pasta de configuração do backend.

cp -r ./backend/config "$BACKUP_DIR"/backend_config

Por padrão, o caminho absoluto para este diretório é:

  • /opt/SherpaOrchestrator/backend/config

4. Cópia do nginx/config#

Copie a configuração do nginx.

cp -r ./nginx/config "$BACKUP_DIR"/nginx_config

5. Criação do dump do banco de dados MariaDB#

Se o perfil MariaDB for utilizado, crie o dump dentro do contêiner e copie-o para o host.

docker exec orchestrator-db sh -c 'mysqldump -u root --max-allowed-packet=1G --single-transaction orchestrator > /orchestrator_db_dump.sql'

Se as credenciais padrão do banco de dados tiverem sido alteradas, utilize seu próprio login e senha.

docker exec -it orchestrator-db sh
mysqldump -u seu_login -p --max-allowed-packet=1G --single-transaction orchestrator > /orchestrator_db_dump.sql
exit

Copie o dump para a máquina host.

docker cp orchestrator-db:/orchestrator_db_dump.sql "$BACKUP_DIR"/orchestrator_mariadb_dump.sql

6. Criação do dump do banco de dados PostgreSQL#

Se o perfil PostgreSQL for utilizado, crie o dump dentro do contêiner e copie-o para o host.

docker exec orchestrator-pg sh -c 'PGPASSWORD=$POSTGRES_PASSWORD pg_dump -U postgres -d orchestrator -Fc -f /orchestrator_pg_dump.dump'

Se forem utilizadas credenciais diferentes, especifique seu usuário e o banco de dados necessário.

docker exec -it orchestrator-pg sh
export PGPASSWORD=sua_senha
pg_dump -U seu_login -d orchestrator -Fc -f /orchestrator_pg_dump.dump
exit

Copie o dump para a máquina host.

docker cp orchestrator-pg:/orchestrator_pg_dump.dump "$BACKUP_DIR"/orchestrator_postgres_dump.dump

7. Verificação do conteúdo do backup#

Verifique se o diretório de backup contém:

  • arquivo .env
  • diretório backend_config
  • diretório nginx_config
  • dump do MariaDB ou dump do PostgreSQL (dependendo do perfil de banco de dados utilizado)

Exemplo de verificação:

ls -la "$BACKUP_DIR"