Atualizar Instal-Proxy-Sinc.sh
This commit is contained in:
parent
bf59708a43
commit
ae48136481
|
|
@ -1,25 +1,25 @@
|
|||
#!/bin/bash
|
||||
|
||||
# ==============================================================================#
|
||||
# INSTALADOR DO SERVIÇO PROXY-SINC #
|
||||
# #
|
||||
# Descrição: Instala e configura um serviço de versionamento robusto e #
|
||||
# auto-documentado para configurações de servidor. #
|
||||
# ==============================================================================#
|
||||
# ==============================================================================
|
||||
# INSTALADOR INTELIGENTE DO SERVIÇO PROXY-SINC (VERSÃO PROFISSIONAL)
|
||||
#
|
||||
# Autor: A sua IA Assistente & Equipa de Infraestrutura iT Guys
|
||||
# Descrição: Instala ou atualiza o serviço de versionamento, guardando as
|
||||
# configurações de forma persistente.
|
||||
# ==============================================================================
|
||||
|
||||
set -e
|
||||
|
||||
# --- Variáveis de Configuração ---
|
||||
# Define os caminhos de instalação padrão para os componentes do serviço.
|
||||
REPO_DIR="/opt/config_repo"
|
||||
SCRIPT_INSTALL_DIR="/usr/local/sbin"
|
||||
SYSTEMD_DIR="/etc/systemd/system"
|
||||
MAN_DIR="/usr/share/man/man8"
|
||||
CONFIG_DIR="/etc/proxy-sinc"
|
||||
# Ficheiro para guardar as credenciais do Git de forma persistente.
|
||||
CREDENTIALS_FILE="${CONFIG_DIR}/git.conf"
|
||||
PATHS_FILE="${CONFIG_DIR}/paths.conf"
|
||||
# URL do repositório onde o script de instalação (este ficheiro) está guardado.
|
||||
# Usado pelo comando de auto-atualização 'proxy-sinc-update'.
|
||||
UPDATE_REPO_URL="http://git.itguys.com.br/joao.goncalves/NgixProxy_Pathfinder/raw/branch/main/Instal-Proxy-Sinc.sh"
|
||||
UPDATE_SCRIPT_URL="http://git.itguys.com.br/joao.goncalves/NgixProxy_Pathfinder/raw/branch/main/Instal-Proxy-Sinc.sh"
|
||||
|
||||
# --- Funções de Ajuda ---
|
||||
info() { echo -e "\e[32m[INFO]\e[0m $1"; }
|
||||
|
|
@ -28,67 +28,76 @@ warn() { echo -e "\e[33m[AVISO]\e[0m $1"; }
|
|||
|
||||
# --- Início da Execução ---
|
||||
info "Iniciando a instalação/atualização do serviço Proxy-Sinc..."
|
||||
|
||||
# Garante que o script está a ser executado como root.
|
||||
if [ "$EUID" -ne 0 ]; then
|
||||
error "Este script precisa de ser executado como root."
|
||||
fi
|
||||
if [ "$EUID" -ne 0 ]; then error "Este script precisa de ser executado como root."; fi
|
||||
|
||||
# --- 1. Verificação de Dependências ---
|
||||
info "A verificar as dependências..."
|
||||
info "A verificar as dependências (git, rsync)..."
|
||||
apt-get update > /dev/null
|
||||
# Garante que as ferramentas essenciais (git, rsync) estão instaladas.
|
||||
apt-get install -y git rsync > /dev/null
|
||||
# Verifica se o leitor de man pages está instalado e, se não estiver, instala-o.
|
||||
if ! command -v man &> /dev/null; then
|
||||
warn "O comando 'man' não foi encontrado. A instalar 'man-db'..."
|
||||
apt-get install -y man-db > /dev/null
|
||||
fi
|
||||
info "Dependências satisfeitas."
|
||||
|
||||
# --- 2. Configuração das Credenciais e do Repositório ---
|
||||
info "Configurando a autenticação para o Gitea..."
|
||||
# --- 2. Lógica de Instalação vs. Atualização ---
|
||||
mkdir -p "$CONFIG_DIR"
|
||||
|
||||
# Recolhe as informações necessárias do utilizador.
|
||||
read -p "Por favor, insira a URL HTTP ou HTTPS do seu repositório Gitea: " GIT_URL
|
||||
read -p "Por favor, insira o seu NOME DE UTILIZADOR do Gitea: " GITEA_USERNAME
|
||||
read -s -p "Por favor, insira o seu TOKEN DE ACESSO do Gitea (ficará oculto): " GITEA_TOKEN
|
||||
echo ""
|
||||
# REQUISITO 4: Pede a identificação do colaborador para o registo de deploy.
|
||||
read -p "Identificação do Colaborador para o registo (Login AD/Email): " DEPLOYER_ID
|
||||
if [ -f "$CREDENTIALS_FILE" ]; then
|
||||
# MODO DE ATUALIZAÇÃO: Carrega as credenciais existentes.
|
||||
info "Ficheiro de configuração encontrado. A executar em modo de atualização."
|
||||
source "$CREDENTIALS_FILE"
|
||||
read -p "Identificação do Colaborador para o registo de ATUALIZAÇÃO: " DEPLOYER_ID
|
||||
ACTION_TYPE="Atualização Manual"
|
||||
else
|
||||
# MODO DE INSTALAÇÃO: Pede as credenciais pela primeira vez.
|
||||
info "Nenhum ficheiro de configuração encontrado. A executar em modo de instalação inicial."
|
||||
read -p "Por favor, insira a URL HTTP ou HTTPS do seu repositório Gitea: " GIT_URL
|
||||
read -p "Por favor, insira o seu NOME DE UTILIZADOR do Gitea: " GITEA_USERNAME
|
||||
read -s -p "Por favor, insira o seu TOKEN DE ACESSO do Gitea (ficará oculto): " GITEA_TOKEN
|
||||
echo ""
|
||||
read -p "Identificação do Colaborador para o registo de INSTALAÇÃO: " DEPLOYER_ID
|
||||
ACTION_TYPE="Instalação Manual Inicial"
|
||||
|
||||
if [ -z "$GIT_URL" ] || [ -z "$GITEA_USERNAME" ] || [ -z "$GITEA_TOKEN" ] || [ -z "$DEPLOYER_ID" ]; then
|
||||
error "Todos os campos (URL, Utilizador, Token, Colaborador) são obrigatórios."
|
||||
if [ -z "$GIT_URL" ] || [ -z "$GITEA_USERNAME" ] || [ -z "$GITEA_TOKEN" ] || [ -z "$DEPLOYER_ID" ]; then
|
||||
error "Todos os campos são obrigatórios."
|
||||
fi
|
||||
|
||||
# Guarda as credenciais para uso futuro.
|
||||
info "A guardar as credenciais em ${CREDENTIALS_FILE}..."
|
||||
(
|
||||
echo "GIT_URL=\"$GIT_URL\""
|
||||
echo "GITEA_USERNAME=\"$GITEA_USERNAME\""
|
||||
echo "GITEA_TOKEN=\"$GITEA_TOKEN\""
|
||||
) > "$CREDENTIALS_FILE"
|
||||
chmod 600 "$CREDENTIALS_FILE" # Torna o ficheiro legível apenas pelo root.
|
||||
fi
|
||||
|
||||
# Constrói a URL de autenticação para o Git.
|
||||
# --- 3. Configuração do Repositório Git ---
|
||||
GIT_PROTOCOL=$(echo "$GIT_URL" | grep -o '^https\?://')
|
||||
GIT_DOMAIN_PATH=$(echo "$GIT_URL" | sed -e 's|https\?://||')
|
||||
AUTH_GIT_URL="${GIT_PROTOCOL}${GITEA_USERNAME}:${GITEA_TOKEN}@${GIT_DOMAIN_PATH}"
|
||||
|
||||
# Gera a identidade para os commits automaticamente com base no hostname.
|
||||
SERVER_HOSTNAME=$(hostname -f)
|
||||
GIT_COMMIT_NAME="$SERVER_HOSTNAME"
|
||||
GIT_COMMIT_EMAIL="${SERVER_HOSTNAME%%.*}@itguys.com.br"
|
||||
info "O autor dos commits será definido como: $GIT_COMMIT_NAME <$GIT_COMMIT_EMAIL>"
|
||||
|
||||
# --- 3. Teste de Conexão SSL e Configuração do Git ---
|
||||
info "A testar a conexão com o Gitea..."
|
||||
# Testa a conexão SSL de forma inteligente.
|
||||
SSL_VERIFY="true"
|
||||
# REQUISITO 2: Testa a conexão com e sem verificação SSL e configura o Git de acordo.
|
||||
if ! git -c http.sslVerify=true ls-remote "$GIT_URL" &> /dev/null; then
|
||||
warn "A conexão com verificação SSL falhou. A tentar novamente sem verificação..."
|
||||
if ! git -c http.sslVerify=false ls-remote "$GIT_URL" &> /dev/null; then
|
||||
if git -c http.sslVerify=false ls-remote "$GIT_URL" &> /dev/null; then
|
||||
warn "Conexão bem-sucedida sem verificação SSL. O repositório será configurado para ignorar os erros de certificado."
|
||||
SSL_VERIFY="false"
|
||||
else
|
||||
error "Não foi possível conectar ao repositório Git. Verifique a URL, o token e a conectividade de rede."
|
||||
error "Não foi possível conectar ao repositório Git."
|
||||
fi
|
||||
else
|
||||
info "Conexão com verificação SSL bem-sucedida."
|
||||
fi
|
||||
|
||||
# --- 4. Clonar/Atualizar o Repositório ---
|
||||
# CORREÇÃO DO ERRO: Verifica se o diretório existe ANTES de tentar clonar.
|
||||
if [ -d "$REPO_DIR/.git" ]; then
|
||||
warn "O diretório do repositório $REPO_DIR já existe. A reconfigurar..."
|
||||
cd "$REPO_DIR"
|
||||
|
|
@ -96,6 +105,8 @@ if [ -d "$REPO_DIR/.git" ]; then
|
|||
info "URL do remoto 'origin' atualizada."
|
||||
else
|
||||
info "A clonar o repositório para $REPO_DIR..."
|
||||
# Remove o diretório se ele existir mas não for um repo, para evitar o erro.
|
||||
rm -rf "$REPO_DIR"
|
||||
git clone "$GIT_URL" "$REPO_DIR"
|
||||
cd "$REPO_DIR"
|
||||
info "A configurar a URL do remoto com as credenciais..."
|
||||
|
|
@ -107,22 +118,15 @@ git config user.email "$GIT_COMMIT_EMAIL"
|
|||
git config http.sslVerify "$SSL_VERIFY"
|
||||
info "Repositório configurado com sucesso."
|
||||
|
||||
# --- 5. Gerar Ficheiro de Deploy (com identificação do colaborador) ---
|
||||
# --- 4. Gerar Ficheiro de Deploy ---
|
||||
DEPLOY_LOG_DIR="$REPO_DIR/_deployment_logs"
|
||||
DEPLOY_LOG_FILE="${DEPLOY_LOG_DIR}/${SERVER_HOSTNAME}.md"
|
||||
# REQUISITO 4: Identifica se é uma instalação ou uma atualização.
|
||||
ACTION_TYPE="Instalação Manual"
|
||||
if [ -f "$SYSTEMD_DIR/proxy-sinc.service" ]; then
|
||||
ACTION_TYPE="Atualização Manual"
|
||||
fi
|
||||
|
||||
info "A criar/atualizar o registo de deploy..."
|
||||
mkdir -p "$DEPLOY_LOG_DIR"
|
||||
# Cria o ficheiro se ele não existir.
|
||||
if [ ! -f "$DEPLOY_LOG_FILE" ]; then
|
||||
echo "# Registo de Deploy do Proxy-Sinc para ${SERVER_HOSTNAME}" > "$DEPLOY_LOG_FILE"
|
||||
fi
|
||||
# Adiciona a nova entrada de log.
|
||||
echo "" >> "$DEPLOY_LOG_FILE"
|
||||
echo "---" >> "$DEPLOY_LOG_FILE"
|
||||
echo "**Tipo de Ação:** ${ACTION_TYPE}" >> "$DEPLOY_LOG_FILE"
|
||||
|
|
@ -130,88 +134,58 @@ echo "**Executado por:** ${DEPLOYER_ID}" >> "$DEPLOY_LOG_FILE"
|
|||
echo "**Data:** $(date)" >> "$DEPLOY_LOG_FILE"
|
||||
|
||||
git add "$DEPLOY_LOG_FILE"
|
||||
git commit -m "[Deploy] ${ACTION_TYPE} do serviço por ${DEPLOYER_ID} em ${SERVER_HOSTNAME}"
|
||||
git commit -m "[Deploy] ${ACTION_TYPE} por ${DEPLOYER_ID} em ${SERVER_HOSTNAME}"
|
||||
git push origin main
|
||||
info "Registo de deploy enviado para o Gitea."
|
||||
|
||||
# --- 6. Instalar os Ficheiros do Serviço ---
|
||||
info "A instalar/atualizar os ficheiros do serviço..."
|
||||
# --- 5. Instalar/Atualizar os Ficheiros de Serviço ---
|
||||
info "A gerar e a instalar os ficheiros do serviço..."
|
||||
|
||||
# REQUISITO 1: Cria o diretório de configuração e o ficheiro de caminhos.
|
||||
mkdir -p "$CONFIG_DIR"
|
||||
if [ ! -f "$PATHS_FILE" ]; then
|
||||
info "A criar o ficheiro de caminhos padrão em $PATHS_FILE"
|
||||
echo "# Adicione aqui os caminhos completos para os ficheiros e diretórios que deseja versionar, um por linha." > "$PATHS_FILE"
|
||||
echo "# Linhas que começam com '#' são ignoradas." >> "$PATHS_FILE"
|
||||
echo "# Adicione aqui os caminhos completos para os ficheiros e diretórios que deseja versionar." > "$PATHS_FILE"
|
||||
echo "/etc/nginx" >> "$PATHS_FILE"
|
||||
echo "/etc/fail2ban" >> "$PATHS_FILE"
|
||||
fi
|
||||
|
||||
# REQUISITO 2 e 5: Gera o script principal de commit, agora mais comentado.
|
||||
# Gera o script principal de commit
|
||||
cat > "$SCRIPT_INSTALL_DIR/commit_configs.sh" << 'EOF'
|
||||
#!/bin/bash
|
||||
# Este script é executado pelo systemd.timer para sincronizar as configurações.
|
||||
set -e
|
||||
|
||||
# --- Variáveis ---
|
||||
# Diretório local do repositório Git.
|
||||
REPO_PATH="/opt/config_repo"
|
||||
# Diretório de configuração do próprio serviço de sincronização.
|
||||
CONFIG_DIR="/etc/proxy-sinc"
|
||||
# Ficheiro que contém a lista de ficheiros/pastas a serem versionados.
|
||||
PATHS_FILE="${CONFIG_DIR}/paths.conf"
|
||||
# Lista dos ficheiros da própria automação, para serem auto-versionados.
|
||||
AUTOMATION_FILES_SOURCE=("/usr/local/sbin/commit_configs.sh" "/usr/local/sbin/proxy-sinc-update" "/etc/systemd/system/proxy-sinc.service" "/etc/systemd/system/proxy-sinc.timer" "/etc/systemd/system/proxy-sinc-update.service" "/etc/systemd/system/proxy-sinc-update.timer" "/usr/share/man/man8/proxy-sinc.8.gz" "${PATHS_FILE}")
|
||||
# Destino dos ficheiros de automação dentro do repositório Git.
|
||||
AUTOMATION_FILES_SOURCE=("/usr/local/sbin/commit_configs.sh" "/usr/local/sbin/proxy-sinc-update" "/etc/systemd/system/proxy-sinc.service" "/etc/systemd/system/proxy-sinc.timer" "/etc/systemd/system/proxy-sinc-update.service" "/etc/systemd/system/proxy-sinc-update.timer" "/usr/share/man/man8/proxy-sinc.8.gz" "${PATHS_FILE}" "${CONFIG_DIR}/git.conf")
|
||||
AUTOMATION_FILES_DEST="$REPO_PATH/_automation_scripts/"
|
||||
|
||||
log_info() { echo "[INFO] $1"; }
|
||||
log_warn() { echo "[AVISO] $1"; }
|
||||
|
||||
log_info "--- Iniciando a verificação de sincronização [$(date)] ---"
|
||||
# Verifica se o script está a ser executado como root.
|
||||
if [ "$EUID" -ne 0 ]; then echo "[ERRO] O script deve ser executado como root." >&2; exit 1; fi
|
||||
# Verifica se o repositório foi clonado corretamente.
|
||||
if [ ! -d "$REPO_PATH/.git" ]; then echo "[ERRO] O diretório $REPO_PATH não é um repositório Git válido." >&2; exit 1; fi
|
||||
|
||||
# --- Sincronização dos Ficheiros de Configuração ---
|
||||
log_info "Sincronizando ficheiros de configuração definidos em $PATHS_FILE..."
|
||||
if [ ! -f "$PATHS_FILE" ]; then
|
||||
log_warn "O ficheiro de caminhos $PATHS_FILE não foi encontrado. Nenhum ficheiro de configuração foi sincronizado."
|
||||
echo "[AVISO] O ficheiro de caminhos $PATHS_FILE não foi encontrado."
|
||||
else
|
||||
# Lê cada linha do ficheiro paths.conf.
|
||||
while IFS= read -r path_to_sync || [ -n "$path_to_sync" ]; do
|
||||
# Ignora linhas vazias e comentários.
|
||||
if [ -z "$path_to_sync" ] || [[ "$path_to_sync" =~ ^# ]]; then
|
||||
continue
|
||||
fi
|
||||
|
||||
if [ -z "$path_to_sync" ] || [[ "$path_to_sync" =~ ^# ]]; then continue; fi
|
||||
if [ -e "$path_to_sync" ]; then
|
||||
log_info "A sincronizar '$path_to_sync'..."
|
||||
# O rsync é eficiente e só copia ficheiros alterados.
|
||||
rsync -avz --delete --exclude='*.swp' --exclude='*.bak' --exclude='sites-enabled/' --exclude='modules-enabled/' --exclude='/var/log/' --exclude='/var/run/' --exclude='/var/cache/' "$path_to_sync" "$REPO_PATH/"
|
||||
else
|
||||
log_warn "O caminho '$path_to_sync' definido em $PATHS_FILE não existe. A ignorar."
|
||||
echo "[AVISO] O caminho '$path_to_sync' não existe. A ignorar."
|
||||
fi
|
||||
done < "$PATHS_FILE"
|
||||
fi
|
||||
|
||||
# --- Sincronização dos Ficheiros de Automação (Auto-Versionamento) ---
|
||||
log_info "Sincronizando ficheiros de automação..."
|
||||
mkdir -p "$AUTOMATION_FILES_DEST"
|
||||
for file in "${AUTOMATION_FILES_SOURCE[@]}"; do
|
||||
if [ -f "$file" ]; then
|
||||
# O -R preserva a estrutura de pastas (ex: /etc/proxy-sinc/paths.conf).
|
||||
rsync -aR "$file" "$AUTOMATION_FILES_DEST"
|
||||
fi
|
||||
if [ -f "$file" ]; then rsync -aR "$file" "$AUTOMATION_FILES_DEST"; fi
|
||||
done
|
||||
|
||||
cd "$REPO_PATH"
|
||||
# GARANTE A SEGURANÇA: Cria/atualiza o .gitignore para NUNCA versionar o ficheiro de credenciais.
|
||||
echo "_automation_scripts/etc/proxy-sinc/git.conf" > .gitignore
|
||||
log_info "A verificar o status do repositório Git..."
|
||||
# Se existirem alterações, faz o commit e o push.
|
||||
if [ -n "$(git status --porcelain)" ]; then
|
||||
log_info "Alterações detetadas. A preparar o commit."
|
||||
git pull --ff-only # Sincroniza com o remoto para evitar conflitos.
|
||||
log_info "Alterações detetadas."
|
||||
git pull --ff-only
|
||||
git add .
|
||||
COMMIT_MESSAGE="[Auto-Sync] Atualização das configurações em $(hostname -f) - $(date +'%Y-%m-%d %H:%M:%S')"
|
||||
log_info "A fazer o commit com a mensagem: $COMMIT_MESSAGE"
|
||||
|
|
@ -220,7 +194,7 @@ if [ -n "$(git status --porcelain)" ]; then
|
|||
git push origin main
|
||||
echo "[SUCESSO] As alterações foram enviadas para o repositório remoto!"
|
||||
else
|
||||
log_info "Nenhuma alteração de configuração detetada. O repositório está atualizado."
|
||||
log_info "Nenhuma alteração de configuração detetada."
|
||||
fi
|
||||
log_info "--- Verificação de sincronização concluída [$(date)] ---"
|
||||
exit 0
|
||||
|
|
@ -229,22 +203,17 @@ EOF
|
|||
# Gera o script de atualização
|
||||
cat > "$SCRIPT_INSTALL_DIR/proxy-sinc-update" << EOF
|
||||
#!/bin/bash
|
||||
# Este script permite a atualização manual do serviço.
|
||||
set -e
|
||||
echo "A procurar por atualizações para o serviço Proxy-Sinc..."
|
||||
UPDATE_SCRIPT_URL="${UPDATE_SCRIPT_URL}"
|
||||
TEMP_SCRIPT="/tmp/setup_latest.sh"
|
||||
|
||||
echo "A baixar a versão mais recente do instalador de: \$UPDATE_SCRIPT_URL"
|
||||
|
||||
# Usa o modo inseguro para o download se o repositório estiver configurado assim.
|
||||
SSL_VERIFY_FLAG=""
|
||||
if [ -d "/opt/config_repo/.git" ] && [ "\$(cd /opt/config_repo && git config --get http.sslVerify)" == "false" ]; then
|
||||
SSL_VERIFY_FLAG="--insecure"
|
||||
echo "[AVISO] A usar o modo inseguro para baixar a atualização."
|
||||
if [ -f "/etc/proxy-sinc/git.conf" ] && [ -d "/opt/config_repo/.git" ]; then
|
||||
if [ "\$(cd /opt/config_repo && git config --get http.sslVerify)" == "false" ]; then
|
||||
SSL_VERIFY_FLAG="--insecure"
|
||||
fi
|
||||
fi
|
||||
|
||||
# Baixa e executa a versão mais recente do instalador.
|
||||
if curl \$SSL_VERIFY_FLAG -L "\$UPDATE_SCRIPT_URL" -o "\$TEMP_SCRIPT"; then
|
||||
chmod +x "\$TEMP_SCRIPT"
|
||||
echo "Instalador baixado com sucesso. A executar a atualização..."
|
||||
|
|
@ -252,13 +221,12 @@ if curl \$SSL_VERIFY_FLAG -L "\$UPDATE_SCRIPT_URL" -o "\$TEMP_SCRIPT"; then
|
|||
rm "\$TEMP_SCRIPT"
|
||||
echo "Atualização concluída!"
|
||||
else
|
||||
echo "ERRO: Falha ao baixar o script de atualização." >&2
|
||||
exit 1
|
||||
echo "ERRO: Falha ao baixar o script de atualização." >&2; exit 1
|
||||
fi
|
||||
exit 0
|
||||
EOF
|
||||
|
||||
# Gera os ficheiros de serviço do systemd para a SINCRONIZAÇÃO A CADA MINUTO
|
||||
# Gera os ficheiros de serviço do systemd
|
||||
cat > "$SYSTEMD_DIR/proxy-sinc.service" << 'EOF'
|
||||
[Unit]
|
||||
Description=Serviço de Sincronização de Configurações do Nginx para o Git
|
||||
|
|
@ -278,7 +246,7 @@ Unit=proxy-sinc.service
|
|||
WantedBy=timers.target
|
||||
EOF
|
||||
|
||||
# REQUISITO 3: Gera os ficheiros de serviço para a VERIFICAÇÃO DE ATUALIZAÇÕES SEMANAL
|
||||
# Gera os ficheiros de serviço para a verificação de atualizações semanal
|
||||
cat > "$SYSTEMD_DIR/proxy-sinc-update.service" << 'EOF'
|
||||
[Unit]
|
||||
Description=Serviço de Verificação Semanal de Atualizações para o Proxy-Sinc
|
||||
|
|
@ -291,8 +259,6 @@ cat > "$SYSTEMD_DIR/proxy-sinc-update.timer" << 'EOF'
|
|||
[Unit]
|
||||
Description=Executa a verificação de atualizações do Proxy-Sinc toda Segunda-feira
|
||||
[Timer]
|
||||
# OnCalendar=dayofweek hour:minute:second
|
||||
# Executa toda Segunda-feira às 03:00 da manhã.
|
||||
OnCalendar=Mon *-*-* 03:00:00
|
||||
RandomizedDelaySec=1h
|
||||
Unit=proxy-sinc-update.service
|
||||
|
|
@ -300,7 +266,7 @@ Unit=proxy-sinc-update.service
|
|||
WantedBy=timers.target
|
||||
EOF
|
||||
|
||||
# REQUISITO 5: Gera a nova man page, mais completa
|
||||
# Gera a nova man page
|
||||
cat > "/tmp/proxy-sinc.8" << 'EOF'
|
||||
.TH PROXY-SINC 8 "Setembro 2025" "iT Guys - Equipa de Infraestrutura" "Ferramentas de Sistema"
|
||||
.SH NAME
|
||||
|
|
@ -315,47 +281,34 @@ proxy-sinc \- Serviço de versionamento automático de configurações de servid
|
|||
.B man proxy-sinc
|
||||
.SH DESCRIPTION
|
||||
.B proxy-sinc
|
||||
é um serviço de sistema que automatiza o controlo de versões de ficheiros de configuração críticos. A cada minuto, ele executa um script que sincroniza os ficheiros e diretórios definidos em \fI/etc/proxy-sinc/paths.conf\fR para um repositório Git. Se forem detetadas alterações, ele cria um commit e envia as alterações para um repositório Git remoto (Gitea).
|
||||
é um serviço de sistema que automatiza o controlo de versões de ficheiros de configuração críticos. A cada minuto, ele executa um script que sincroniza os ficheiros definidos em \fI/etc/proxy-sinc/paths.conf\fR para um repositório Git e envia as alterações para um repositório remoto.
|
||||
.PP
|
||||
Esta abordagem garante um histórico completo de todas as alterações, facilita a recuperação de desastres e serve como um backup centralizado.
|
||||
A autenticação e outras configurações são guardadas em \fI/etc/proxy-sinc/git.conf\fR durante a primeira instalação.
|
||||
.SH CONFIGURAÇÃO
|
||||
A gestão dos ficheiros e diretórios a serem sincronizados é feita através do ficheiro de texto:
|
||||
A gestão dos ficheiros e diretórios a serem sincronizados é feita através do ficheiro:
|
||||
.TP
|
||||
\fB/etc/proxy-sinc/paths.conf\fR
|
||||
Este ficheiro contém a lista de caminhos absolutos a serem versionados. Adicione um caminho por linha. Linhas vazias ou que começam com '#' são ignoradas. O script irá sincronizar cada caminho para a raiz do repositório Git.
|
||||
.sp
|
||||
Exemplo de conteúdo para \fI/etc/proxy-sinc/paths.conf\fR:
|
||||
.nf
|
||||
# Ficheiros e diretórios a serem versionados
|
||||
/etc/nginx
|
||||
/etc/fail2ban
|
||||
/etc/zabbix/zabbix_agentd.d/meu_parametro.conf
|
||||
.fi
|
||||
Adicione um caminho absoluto por linha. Linhas vazias ou que começam com '#' são ignoradas.
|
||||
.SH ATUALIZAÇÃO
|
||||
.SS ATUALIZAÇÃO MANUAL
|
||||
Para forçar uma atualização do serviço e dos seus scripts para a versão mais recente, execute o seguinte comando como root:
|
||||
Para forçar uma atualização, execute: \fBproxy-sinc-update\fR
|
||||
.sp
|
||||
\fBproxy-sinc-update\fR
|
||||
.sp
|
||||
Este comando irá baixar e executar a versão mais recente do script de instalação a partir do repositório Git oficial. Ele irá pedir as suas credenciais novamente para reconfigurar a autenticação e irá registar a atualização no log de deploy do repositório.
|
||||
Este comando baixa e executa a versão mais recente do script de instalação. Ele irá ler as suas credenciais guardadas e pedir apenas a sua identificação de colaborador para o registo de deploy.
|
||||
.SS ATUALIZAÇÃO AUTOMÁTICA
|
||||
O sistema inclui um timer do systemd (\fIproxy-sinc-update.timer\fR) que executa o comando \fBproxy-sinc-update\fR automaticamente uma vez por semana (toda Segunda-feira às 3 da manhã) para garantir que a ferramenta de automação se mantém atualizada.
|
||||
O sistema inclui um timer (\fIproxy-sinc-update.timer\fR) que executa o comando \fBproxy-sinc-update\fR automaticamente uma vez por semana.
|
||||
.SH FICHEIROS
|
||||
.TP
|
||||
\fB/etc/proxy-sinc/git.conf\fR
|
||||
Ficheiro seguro (apenas root) que guarda as credenciais do Git (URL, utilizador, token).
|
||||
.TP
|
||||
\fB/etc/proxy-sinc/paths.conf\fR
|
||||
A lista de ficheiros e pastas a serem versionados.
|
||||
.TP
|
||||
\fB/usr/local/sbin/commit_configs.sh\fR
|
||||
O script principal que executa a lógica de sincronização a cada minuto.
|
||||
O script principal que executa a sincronização.
|
||||
.TP
|
||||
\fB/usr/local/sbin/proxy-sinc-update\fR
|
||||
O script que gere a auto-atualização do serviço.
|
||||
.TP
|
||||
\fB/etc/systemd/system/proxy-sinc.timer\fR
|
||||
O timer que define a frequência da SINCRONIZAÇÃO (a cada minuto).
|
||||
.TP
|
||||
\fB/etc/systemd/system/proxy-sinc-update.timer\fR
|
||||
O timer que define a frequência da VERIFICAÇÃO DE ATUALIZAÇÕES (semanal).
|
||||
.TP
|
||||
\fB/opt/config_repo\fR
|
||||
O diretório local onde o repositório Git é clonado.
|
||||
.SH SEE ALSO
|
||||
.BR git (1),
|
||||
.BR rsync (1),
|
||||
|
|
@ -363,10 +316,9 @@ O diretório local onde o repositório Git é clonado.
|
|||
.BR systemd.timer (5)
|
||||
EOF
|
||||
|
||||
# --- 7. Mover ficheiros para os locais corretos e instalar ---
|
||||
info "A mover os ficheiros para os seus destinos..."
|
||||
mkdir -p "$SCRIPT_INSTALL_DIR" "$SYSTEMD_DIR" "$MAN_DIR"
|
||||
|
||||
# --- 7. Mover e Instalar ---
|
||||
chmod +x ./commit_configs.sh
|
||||
chmod +x ./proxy-sinc-update
|
||||
mv ./commit_configs.sh "$SCRIPT_INSTALL_DIR/"
|
||||
mv ./proxy-sinc-update "$SCRIPT_INSTALL_DIR/"
|
||||
mv ./proxy-sinc.service "$SYSTEMD_DIR/"
|
||||
|
|
@ -374,16 +326,12 @@ mv ./proxy-sinc.timer "$SYSTEMD_DIR/"
|
|||
mv ./proxy-sinc-update.service "$SYSTEMD_DIR/"
|
||||
mv ./proxy-sinc-update.timer "$SYSTEMD_DIR/"
|
||||
mv "/tmp/proxy-sinc.8" "$MAN_DIR/"
|
||||
|
||||
chmod +x "$SCRIPT_INSTALL_DIR/commit_configs.sh"
|
||||
chmod +x "$SCRIPT_INSTALL_DIR/proxy-sinc-update"
|
||||
gzip -f "$MAN_DIR/proxy-sinc.8"
|
||||
info "Ficheiros instalados com sucesso."
|
||||
|
||||
# --- 8. Ativar os Serviços ---
|
||||
info "A recarregar o systemd e a ativar os timers..."
|
||||
systemctl daemon-reload
|
||||
# Ativa e inicia os dois timers
|
||||
systemctl enable --now proxy-sinc.timer
|
||||
systemctl enable --now proxy-sinc-update.timer
|
||||
info "Serviços ativados e a correr!"
|
||||
|
|
@ -393,17 +341,12 @@ echo ""
|
|||
info "======================================================================"
|
||||
info " Instalação/Atualização Concluída!"
|
||||
info "======================================================================"
|
||||
info "O serviço 'proxy-sinc' está agora ativo e irá sincronizar as suas"
|
||||
info "configurações para o Gitea a cada minuto."
|
||||
info "O serviço 'proxy-sinc' está agora ativo."
|
||||
info ""
|
||||
info "Comandos úteis:"
|
||||
info " Ver o status do timer de sincronização: systemctl status proxy-sinc.timer"
|
||||
info " Ver o status do timer de atualização: systemctl status proxy-sinc-update.timer"
|
||||
info " Ver os logs da última execução: systemctl status proxy-sinc.service"
|
||||
info " Ler o manual de ajuda: man proxy-sinc"
|
||||
info " Ver os logs da última execução: journalctl -u proxy-sinc.service"
|
||||
info " Para forçar uma atualização agora: sudo proxy-sinc-update"
|
||||
info " Ler o manual de ajuda: man proxy-sinc"
|
||||
info " Para adicionar novos ficheiros/pastas, edite: /etc/proxy-sinc/paths.conf"
|
||||
info ""
|
||||
info "Para adicionar novos ficheiros/pastas à sincronização, edite:"
|
||||
info " /etc/proxy-sinc/paths.conf"
|
||||
info ""
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue