HashCore Docs
Gerenciamento do Sistema

Atualização

Recomenda-se seguir o repositório HashCore Proxy no Github para receber notificações sobre o lançamento de novas versões. Se você fez alguma alteração nos arquivos de configuração, é recomendável salvá-los em uma pasta de backup antes de atualizar.

  1. Vá para a pasta do projeto:
    cd /opt/stratum-proxy
    
  2. Pare os serviços:
    docker compose down
    
  3. Puxe as alterações do repositório:
    git pull
    
  4. Baixe as imagens atualizadas:
    docker compose pull
    

⚠️ Risco de perda de dados de monitoramento. Grafana e Prometheus usam a tag latest — ao atualizar, pode ocorrer uma transição de versão principal (por exemplo, Prometheus v2→v3), incompatível com os dados existentes nos volumes. Antes desta etapa, certifique-se de que os dados de monitoramento acumulados não são necessários ou faça um backup dos volumes. Se o monitoramento parar de funcionar após a atualização — consulte a seção 9.1. Como evitar o problema no futuro: fixe as versões do Grafana e Prometheus em docker-compose.yml em vez da tag latest. Mais detalhes — na seção abaixo.

  1. Inicie os serviços com as atualizações:
    docker compose up -d
    

Migração

Ao atualizar de versões do stratum-proxy abaixo de 1.2.0, é necessário realizar as seguintes ações:

  1. Renomeie o arquivo de configuração farm-proxy.yaml para stratum-proxy.yaml
  2. No arquivo stratum-proxy.yaml, atualize as portas de acordo com o novo esquema

Como evitar a perda de dados de monitoramento

Se os dados históricos de monitoramento forem importantes, fixe as versões do Grafana e Prometheus em docker-compose.yml em vez da tag latest. Por exemplo:

image: prom/prometheus:v2.53.0
image: grafana/grafana:11.1.0

Com esta abordagem, docker compose pull não atualizará as imagens além da versão especificada e uma transição de versão principal não ocorrerá. Atualize as versões manualmente — verificando previamente a compatibilidade nas notas de lançamento oficiais do Prometheus e Grafana.