release: v1.0.0 - Zabbix GPON API distribuição cliente

This commit is contained in:
2026-10-02 21:14:01 -03:00
commit bfc9831040
14 changed files with 1943 additions and 0 deletions
+211
View File
@@ -0,0 +1,211 @@
#!/usr/bin/env bash
# ==============================================================================
# Script de Backup Automático e Completo - Zabbix GPON API
# Cobre: MariaDB (dados/tabelas), Grafana (grafana.db + dashboards), Licença e .env
# Executa 100% como usuário comum (sem necessidade de privilégios root)
# ==============================================================================
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
BACKUP_DIR="$PROJECT_ROOT/backups"
TIMESTAMP="$(date +%Y-%m-%d_%H%M%S)"
TARGET_DIR="$BACKUP_DIR/$TIMESTAMP"
mkdir -p "$TARGET_DIR"
chmod 700 "$TARGET_DIR"
echo "================================================================"
echo " Zabbix GPON API - Rotina de Backup Completo e Seguro"
echo "================================================================"
echo "Data/Hora : $TIMESTAMP"
echo "Destino : $TARGET_DIR"
# 1. Carrega variáveis de ambiente se o .env existir
if [ -f "$PROJECT_ROOT/.env" ]; then
set -a
# shellcheck disable=SC1090
. <(grep -E '^(MYSQL_|DB_|APP_|COMPOSE_|GRAFANA_)' "$PROJECT_ROOT/.env" | sed 's/␍$//') 2>/dev/null || true
set +a
fi
DB_USER="${MYSQL_USER:-zabbix_gpon_api}"
DB_PASS="${MYSQL_PASSWORD:-telemetria123}"
ROOT_PASS="${MYSQL_ROOT_PASSWORD:-srcc2030}"
DB_NAME="${MYSQL_DATABASE:-zabbix_gpon_api}"
DB_CONTAINER="${DB_CONTAINER:-zbx_gpon_api_db}"
APP_CONTAINER="${APP_CONTAINER:-zbx_gpon_api_app}"
GRAFANA_CONTAINER="${GRAFANA_CONTAINER:-zbx_gpon_api_grafana}"
PROJECT_NAME="${COMPOSE_PROJECT_NAME:-gpon-api}"
BACKUP_ERRORS=0
# ------------------------------------------------------------------------------
# 2. BACKUP DO BANCO DE DADOS (MariaDB / MySQL)
# ------------------------------------------------------------------------------
echo ""
echo "[1/4] 📦 Realizando backup do Banco de Dados MariaDB..."
# Detecta nome do container do banco se não for o padrão
if ! docker ps --format '{{.Names}}' | grep -q "^${DB_CONTAINER}$"; then
if docker ps --format '{{.Names}}' | grep -q "^zabbix_telemetry_db$"; then
DB_CONTAINER="zabbix_telemetry_db"
fi
fi
if docker ps --format '{{.Names}}' | grep -q "^${DB_CONTAINER}$"; then
DUMP_FILE="$TARGET_DIR/dump_${DB_NAME}_${TIMESTAMP}.sql.gz"
echo " 👉 Extraindo banco '$DB_NAME' via container '$DB_CONTAINER'..."
if docker exec -i "$DB_CONTAINER" mariadb-dump -u root -p"$ROOT_PASS" --single-transaction --quick --routines --triggers --databases "$DB_NAME" 2>/dev/null | gzip > "$DUMP_FILE"; then
DUMP_SIZE=$(du -h "$DUMP_FILE" | cut -f1)
echo " ✅ Dump do banco '$DB_NAME' concluído com sucesso ($DUMP_SIZE)."
else
echo " ⚠️ Tentativa com root falhou. Tentando com usuário '$DB_USER'..."
if docker exec -i "$DB_CONTAINER" mariadb-dump -u "$DB_USER" -p"$DB_PASS" --single-transaction --quick --routines --triggers --databases "$DB_NAME" 2>/dev/null | gzip > "$DUMP_FILE"; then
DUMP_SIZE=$(du -h "$DUMP_FILE" | cut -f1)
echo " ✅ Dump do banco '$DB_NAME' concluído com sucesso ($DUMP_SIZE)."
else
echo " ❌ ERRO CRÍTICO: Falha ao exportar banco '$DB_NAME'!"
BACKUP_ERRORS=$((BACKUP_ERRORS + 1))
fi
fi
# Se existir banco zabbix compartilhado, faz dump opcional também
if docker exec -i "$DB_CONTAINER" mariadb -u root -p"$ROOT_PASS" -e "USE zabbix;" 2>/dev/null; then
echo " 👉 Extraindo banco Zabbix Server ('zabbix')..."
ZBX_DUMP_FILE="$TARGET_DIR/dump_zabbix_server_${TIMESTAMP}.sql.gz"
docker exec -i "$DB_CONTAINER" mariadb-dump -u root -p"$ROOT_PASS" --single-transaction --quick --databases zabbix 2>/dev/null | gzip > "$ZBX_DUMP_FILE" || true
echo " ✅ Dump do banco Zabbix concluído."
fi
else
echo " ❌ ERRO: Container MariaDB '$DB_CONTAINER' não está rodando. O banco NÃO foi salvo!"
BACKUP_ERRORS=$((BACKUP_ERRORS + 1))
fi
# ------------------------------------------------------------------------------
# 3. BACKUP DO GRAFANA (grafana.db + dashboards locais)
# ------------------------------------------------------------------------------
echo ""
echo "[2/4] 📊 Realizando backup das configurações e dashboards do Grafana..."
# Detecta se container do grafana está rodando
if ! docker ps --format '{{.Names}}' | grep -q "^${GRAFANA_CONTAINER}$"; then
if docker ps --format '{{.Names}}' | grep -q "^zabbix_telemetry_grafana$"; then
GRAFANA_CONTAINER="zabbix_telemetry_grafana"
fi
fi
GRAFANA_SAVED=false
if docker ps --format '{{.Names}}' | grep -q "^${GRAFANA_CONTAINER}$"; then
echo " 👉 Copiando banco interno do Grafana (usuários, preferências, dashboards UI)..."
if docker cp "$GRAFANA_CONTAINER:/var/lib/grafana/grafana.db" "$TARGET_DIR/grafana.db" 2>/dev/null; then
GF_SIZE=$(du -h "$TARGET_DIR/grafana.db" | cut -f1)
echo " ✅ grafana.db copiado com sucesso ($GF_SIZE)."
GRAFANA_SAVED=true
fi
fi
# Se não conseguiu pelo container ativo, tenta pelo volume nomeado
if [ "$GRAFANA_SAVED" = false ]; then
GF_VOLUME="${PROJECT_NAME}_grafana_data"
if docker volume inspect "$GF_VOLUME" >/dev/null 2>&1; then
echo " 👉 Container inativo. Extraindo grafana.db do volume '$GF_VOLUME'..."
docker run --rm -v "$GF_VOLUME:/from:ro" -v "$TARGET_DIR:/to" alpine cp /from/grafana.db /to/ 2>/dev/null || true
if [ -f "$TARGET_DIR/grafana.db" ]; then
echo " ✅ grafana.db extraído do volume com sucesso."
GRAFANA_SAVED=true
fi
fi
fi
# Backup dos arquivos locais de dashboards se existirem
if [ -d "$PROJECT_ROOT/grafana/dashboards" ]; then
echo " 👉 Compactando arquivos de dashboards locais (grafana/dashboards/)..."
tar -czf "$TARGET_DIR/dashboards_backup_${TIMESTAMP}.tar.gz" -C "$PROJECT_ROOT/grafana" dashboards 2>/dev/null || true
echo " ✅ Dashboards locais arquivados com sucesso."
fi
if [ "$GRAFANA_SAVED" = false ]; then
echo " ℹ️ Nenhum dado do Grafana encontrado para backup (Grafana pode não estar ativo nesta stack)."
fi
# ------------------------------------------------------------------------------
# 4. BACKUP DO ARQUIVO DE LICENÇA (.license.lic)
# ------------------------------------------------------------------------------
echo ""
echo "[3/4] 🔑 Realizando backup da Licença Ativa (.license.lic)..."
LICENSE_SAVED=false
# Tenta copiar do container da aplicação
if docker ps --format '{{.Names}}' | grep -q "^${APP_CONTAINER}$"; then
if docker exec -i "$APP_CONTAINER" test -f /app/data/.license.lic 2>/dev/null; then
docker exec -i "$APP_CONTAINER" cat /app/data/.license.lic > "$TARGET_DIR/.license.lic" 2>/dev/null || true
if [ -s "$TARGET_DIR/.license.lic" ]; then
echo " ✅ Licença copiada com sucesso do container '$APP_CONTAINER'."
LICENSE_SAVED=true
fi
fi
fi
# Tenta copiar do host local se não copiou do container
if [ "$LICENSE_SAVED" = false ] && [ -f "$PROJECT_ROOT/data/.license.lic" ]; then
cp "$PROJECT_ROOT/data/.license.lic" "$TARGET_DIR/.license.lic"
echo " ✅ Licença copiada com sucesso da pasta local data/.license.lic."
LICENSE_SAVED=true
fi
if [ "$LICENSE_SAVED" = false ]; then
echo " ℹ️ Nenhuma licença ativa encontrada no momento."
fi
# ------------------------------------------------------------------------------
# 5. BACKUP DAS CONFIGURAÇÕES DE AMBIENTE (.env)
# ------------------------------------------------------------------------------
echo ""
echo "[4/4] ⚙️ Realizando backup das Configurações de Ambiente (.env)..."
if [ -f "$PROJECT_ROOT/.env" ]; then
cp "$PROJECT_ROOT/.env" "$TARGET_DIR/.env"
chmod 600 "$TARGET_DIR/.env"
echo " ✅ Arquivo .env arquivado com permissões protegidas (chmod 600)."
else
echo " ℹ️ Arquivo .env não encontrado no diretório raiz."
fi
# ------------------------------------------------------------------------------
# 6. CRIAÇÃO DO MANIFESTO DE BACKUP
# ------------------------------------------------------------------------------
cat <<EOF > "$TARGET_DIR/manifest.json"
{
"timestamp": "$TIMESTAMP",
"database": "$DB_NAME",
"db_container": "$DB_CONTAINER",
"files": [
$(find "$TARGET_DIR" -type f -printf ' {"file": "%f", "size": "%s"},
' 2>/dev/null | sed '$ s/,$//')
]
}
EOF
# ------------------------------------------------------------------------------
# 7. POLÍTICA DE RETENÇÃO (Remove backups com mais de 15 dias)
# ------------------------------------------------------------------------------
echo ""
echo "🧹 Verificando retenção de backups (removendo pastas com mais de 15 dias)..."
find "$BACKUP_DIR" -mindepth 1 -maxdepth 1 -type d -mtime +15 -exec rm -rf {} + 2>/dev/null || true
# ------------------------------------------------------------------------------
# 8. VERIFICAÇÃO FINAL
# ------------------------------------------------------------------------------
echo ""
echo "================================================================"
if [ $BACKUP_ERRORS -gt 0 ]; then
echo "❌ ATENÇÃO: O backup foi concluído com erros! Revise as mensagens acima."
exit 1
else
echo "🎉 BACKUP COMPLETO CONCLUÍDO COM 100% DE SUCESSO!"
echo "📁 Arquivos salvos em: $TARGET_DIR"
ls -lh "$TARGET_DIR"
echo "================================================================"
exit 0
fi