Como executar o Hermes Agent num servidor doméstico sem perder dados

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

Resposta rápida

Para executar o Hermes Agent num servidor doméstico sem perder dados, não dependa do sistema de ficheiros interno do contentor como único local para guardar configurações, competências, registos, ficheiros gerados ou definições do gateway. Planeie primeiro uma pasta persistente no anfitrião ou um volume Docker, monte-o no caminho do contentor efetivamente utilizado pela aplicação, verifique a propriedade dos ficheiros e confirme que os dados continuam presentes após um reinício ou uma reconfiguração. Este artigo centra-se no problema comum em que um contentor não consegue encontrar uma pasta devido a problemas de montagem de volumes, permissões ou mapeamento de caminhos.

O fluxo de trabalho mais seguro para principiantes é:

  1. Identifique os dados do Hermes Agent que têm de ser preservados.
  2. Escolha uma pasta dedicada no anfitrião ou um volume gerido pelo Docker.
  3. Mapeie esse armazenamento para o caminho correto no contentor.
  4. Confirme que o utilizador da aplicação pode escrever nessa localização.
  5. Salvaguarde as configurações importantes antes de atualizações ou reconstruções.
  6. Reinicie e confirme que as configurações, os registos, os ficheiros gerados e as definições do gateway continuam presentes.

Um contentor em execução não significa automaticamente que os seus dados estão seguros. Os dados só estão seguros quando são armazenados numa localização persistente, podem ser escritos pelo utilizador correto, são salvaguardados quando necessário e são validados após o reinício.

Porque é que os dados do Hermes Agent podem desaparecer numa configuração com contentores

As aplicações em contentores são muitas vezes fáceis de iniciar e substituir. Isso é útil para atualizações, testes e recuperação, mas também significa que tudo o que estiver armazenado apenas na camada descartável do contentor poderá perder-se quando este for removido, recriado ou reconstruído.

Num agente de IA autoalojado, isto pode afetar mais do que as definições básicas. Dependendo da utilização que faz do agente, poderá querer preservar a configuração dos modelos, as competências, os ficheiros gerados, os registos, as definições do gateway de mensagens e outros dados da aplicação.

Reinícios de contentores vs. dados persistentes da aplicação

Um reinício normal do contentor nem sempre remove os dados. Se estes estiverem armazenados num volume persistente ou numa pasta do anfitrião corretamente mapeada, deverão continuar disponíveis após o reinício.

O risco surge quando ficheiros importantes estão apenas na camada gravável do contentor. Essa camada não é o mesmo que uma localização de dados persistente planeada. Se recriar o contentor sem preservar ou voltar a montar o caminho correto, a aplicação poderá iniciar sem dados ou não encontrar os ficheiros anteriores.

Porque é que eliminar ou recriar um contentor pode remover o estado não guardado

Eliminar ou recriar um contentor é diferente de o reiniciar. Um contentor recriado pode usar um novo sistema de ficheiros interno, novas variáveis de ambiente ou um mapeamento de montagem diferente.

Se as definições, competências, registos ou ficheiros gerados pelo Hermes Agent nunca foram guardados numa pasta ou num volume persistente do anfitrião, poderão não transitar para o novo contentor. É por isso que «a aplicação funcionava ontem» e «a aplicação foi reposta após a atualização» podem ser ambos verdade.

O hábito mais seguro é tratar a substituição de um contentor como um evento que implica risco para os dados, a menos que tenha confirmado onde os dados da aplicação estão armazenados.

Porque devem os caminhos do anfitrião e do contentor ser planeados primeiro

O caminho do anfitrião é onde os dados se encontram no servidor doméstico. O caminho do contentor é onde a aplicação vê esses dados a partir do interior do contentor. Uma montagem de volume ou uma montagem vinculada liga estes dois mundos.

Se o caminho do anfitrião estiver correto, mas montado no caminho errado do contentor, a aplicação pode continuar a comportar-se como se a pasta não existisse. Se o caminho do contentor estiver correto, mas o caminho do anfitrião for descartável, a aplicação pode gravar dados num local que não pretendia.

Planeie o mapeamento antes de executar a aplicação, não depois de perder dados.

Que dados deve proteger antes de executar o Hermes Agent?

Antes de alterar um contentor, atualizar uma imagem ou reconfigurar um gateway, faça uma lista dos dados que seria difícil recriar. Nem todos os ficheiros precisam da mesma proteção, mas deve saber quais são críticos.

Uma regra útil é proteger tudo o que armazene identidade, acesso, configuração, fluxos de trabalho aprendidos ou resultados que não consiga gerar facilmente de novo.

Configuração do agente e definições do fornecedor do modelo

As definições do modelo incluem normalmente a escolha do fornecedor, os valores dos endpoints, os nomes dos modelos, as opções relacionadas com o contexto e o acesso à API. Se estas definições se perderem, o agente pode iniciar, mas não responder corretamente.

Guarde a configuração do modelo num caminho persistente dos dados da aplicação, não numa sessão de shell temporária. Se a configuração for fornecida através de variáveis de ambiente, guarde uma cópia segura do ficheiro compose, do ficheiro env ou das notas de implementação.

Proteja também quaisquer opções de configuração que determinem como o agente utiliza ferramentas de terminal ou gateways de mensagens.

Memória da aplicação, sessões, competências e estado de execução

Os dados do Hermes Agent podem incluir mais do que um ficheiro de configuração. A estrutura de dados das competências do Hermes explica que as competências se encontram em ~/.hermes/skills/, que é a fonte principal de verdade para competências incluídas, instaladas a partir do hub e criadas pelo agente. Também descreve estados relacionados, como manifestos incluídos, pacotes de competências, configuração do hub tap, escritas de competências pendentes e definições de configuração.

Isto é importante porque as competências criadas pelo agente podem tornar-se memória processual reutilizável. Se for montado o caminho errado, pode perder não só as definições, mas também os fluxos de trabalho que o agente aprendeu ou as competências que instalou.

Trate as competências, os pacotes, as escritas pendentes e o estado relacionado com o perfil como dados persistentes do agente.

Transferências, ficheiros gerados, registos e resultados das ferramentas

É fácil não reparar nos ficheiros gerados. Durante a utilização normal, um agente pode criar planos, scripts, relatórios, capturas de ecrã, registos ou ficheiros transferidos.

Estes ficheiros podem ser guardados no espaço de trabalho ativo, no diretório de trabalho do backend, no diretório inicial da aplicação ou num caminho de saída montado. Se essa localização estiver apenas dentro do contentor, os ficheiros podem desaparecer quando o contentor for removido.

Para uma utilização prática, decida onde os ficheiros gerados devem aparecer no servidor anfitrião e verifique se o contentor os grava aí.

Chaves de API, tokens de bots e variáveis de ambiente

Os segredos não são dados comuns da aplicação. As chaves de API, os tokens de bots, as palavras-passe do painel e as variáveis de ambiente precisam tanto de persistência como de proteção.

Não guarde segredos em pastas aleatórias de ficheiros gerados nem em diretórios partilhados com acesso amplo. Mantenha-os num caminho de configuração controlado e com acesso limitado.

Uma boa configuração para a gestão de segredos deve responder a estas perguntas:

  • onde o segredo está armazenado;
  • que utilizador o consegue ler;
  • se está incluído nas cópias de segurança;
  • se a cópia de segurança está encriptada ou protegida por controlos de acesso;
  • como rodar o segredo se for exposto.

Caminhos do anfitrião e do contentor e montagens de volumes

Este é o conceito-chave por detrás da maioria dos problemas de «o contentor não consegue encontrar a pasta» e «os dados desapareceram após o reinício». Um contentor só consegue ver o que existe no seu próprio sistema de ficheiros ou o que foi montado nele.

Use O mapa de preservação dos dados do agente para organizar a configuração antes de resolver problemas.

Módulo da estrutura Pergunta-chave O que ajuda a decidir Foco na configuração / resolução de problemas
Inventário de dados Que dados têm de sobreviver ao reinício ou à recriação do contentor? Que configurações, competências, registos, transferências, tokens e ficheiros gerados precisam de proteção Evita tratar dados importantes do agente como estado descartável
Caminho de persistência Onde devem ficar os dados persistentes no anfitrião? Se deve usar uma pasta dedicada no anfitrião, um volume Docker ou uma montagem com bind Evita a reposição dos dados após a recriação do contentor
Mapeamento das montagens O caminho do anfitrião está corretamente associado ao caminho do contentor? Se a aplicação consegue realmente ver a pasta pretendida Ajuda a diagnosticar erros de pasta inexistente e caminho de destino incorreto
Limites das permissões Que utilizador é proprietário dos dados montados e que utilizador lhes escreve? Se os ficheiros pertencem ao utilizador do anfitrião, ao utilizador do contentor, ao utilizador da aplicação ou ao utilizador root Ajuda a corrigir erros de permissão negada sem tornar tudo propriedade do utilizador root
Limites da cópia de segurança O que deve ser salvaguardado antes das atualizações ou reconfigurações? Que dados são críticos e quais são temporários Evita perder configurações, competências, sessões, tokens e definições do gateway
Validação do reinício Os dados continuam a existir após um reinício ou uma atualização? Se a configuração é realmente persistente Transforma «está a funcionar» numa verificação de segurança repetível

O que o servidor anfitrião armazena

O servidor anfitrião armazena as pastas reais, os discos e as localizações de armazenamento geridas pelo Docker. Se usar uma montagem com bind, escolhe uma pasta específica do anfitrião. Se usar um volume Docker com nome, o Docker escolhe e gere a localização de armazenamento.

Esta distinção é importante porque a visibilidade no anfitrião afeta as cópias de segurança e a migração. Uma pasta montada com bind pode ser mais fácil de localizar e copiar para um principiante. Um volume com nome pode ser mais organizado para os dados da aplicação geridos pelo Docker, mas continua a ser necessário saber como inspecioná-lo ou fazer uma cópia de segurança.

Escolha o tipo de armazenamento consoante precise de pastas do anfitrião legíveis por pessoas, de persistência da aplicação gerida pelo Docker ou de um caminho de cópia de segurança controlado.

O que o contentor consegue ver

O contentor vê o seu próprio sistema de ficheiros interno e quaisquer caminhos montados. Não vê automaticamente todas as pastas do seu servidor doméstico.

O guia passo a passo de montagens bind do Docker mostra como um diretório do anfitrião pode aparecer dentro de um contentor num caminho de destino e como as alterações aos ficheiros podem ser refletidas entre o anfitrião e o contentor quando a montagem está correta.

Essa é a ideia central: a aplicação não se importa com o local onde um ficheiro existe no anfitrião, a menos que este seja montado no caminho utilizado pela aplicação.

Como as montagens de volumes mantêm os dados da aplicação persistentes

Uma montagem persistente dá à aplicação um local estável para guardar dados para além do ciclo de vida de um único contentor. Para os dados da aplicação, esta é muitas vezes a diferença entre «seguro após reinício» e «apenas durante o ciclo de vida do contentor».

A montagem tem de corresponder ao caminho de dados esperado pela aplicação. Se a aplicação escrever numa pasta interna e montar uma pasta diferente, os dados poderão continuar a ser guardados em armazenamento descartável.

Uma boa configuração persistente deve definir:

  • a pasta no anfitrião ou o volume com nome;
  • o caminho de destino no contentor;
  • se a montagem é de leitura e escrita ou apenas de leitura;
  • quais os dados da aplicação que pertencem a essa pasta;
  • como será feita a cópia de segurança do caminho.

Porque é que o mapeamento de caminho incorreto causa erros de pasta em falta

Um mapeamento de caminho incorreto parece muitas vezes um problema de pasta em falta. A pasta pode existir no anfitrião, mas o contentor não consegue vê-la. Ou o contentor pode ter uma pasta no caminho esperado, mas esta não está ligada à pasta do anfitrião que pretendia usar.

Os sintomas comuns incluem:

  • a aplicação indica que uma pasta não existe;
  • os ficheiros gerados aparecem dentro do contentor, mas não no anfitrião;
  • os registos desaparecem ao recriar o contentor;
  • a configuração é reposta após uma atualização;
  • edita uma pasta no anfitrião, mas a aplicação continua a usar as definições antigas;
  • os scripts de cópia de segurança são executados, mas não incluem os dados reais da aplicação.

Quando isto acontecer, verifique em conjunto o caminho no anfitrião e o caminho no contentor. Não inspecione apenas um dos lados.

Como executar o Hermes Agent sem perder dados

O objetivo não é apenas iniciar o Hermes Agent. O objetivo é garantir que os dados que lhe interessam sobrevivem a reinícios, atualizações, recriações e reconfigurações.

Passo 1: Escolha uma pasta de dados dedicada no anfitrião

Escolha uma pasta de dados no anfitrião antes de executar ou recriar o contentor. Deve ser fácil de identificar, de incluir em cópias de segurança e não estar misturada com ficheiros pessoais não relacionados.

Uma pasta dedicada reduz o risco, porque permite ver o que pertence à aplicação. Também evita montar todo o seu diretório pessoal ou outras pastas sensíveis no contentor.

Uma pasta de dados no anfitrião prática deve ser:

  • específica da aplicação;
  • fora das pastas de transferências descartáveis;
  • incluída no seu plano de cópias de segurança;
  • não partilhada amplamente com serviços não relacionados;
  • apenas gravável pelos utilizadores ou serviços que precisam de acesso.

Passo 2: Monte a pasta de dados no contentor

Monte a pasta de dados do anfitrião no caminho do contentor esperado pela aplicação. É neste momento que muitos problemas de perda de dados são criados ou evitados.

Numa montagem bind, o caminho do anfitrião é escolhido por si e o caminho de destino é onde aparece dentro do contentor. Num volume com nome, o Docker gere a localização do lado do anfitrião.

Não presuma que a aplicação utilizará automaticamente uma pasta montada. Confirme que o destino da montagem corresponde ao caminho real dos dados da aplicação.

Passo 3: Confirme que o contentor utiliza o caminho de dados esperado pela aplicação

Depois de montar, verifique o caminho a partir de dentro do contentor. Uma pasta pode existir no anfitrião e, ainda assim, estar invisível para a aplicação se não estiver montada corretamente.

A validação mais simples consiste em criar ou localizar um ficheiro de teste inofensivo de um dos lados e confirmar que aparece do outro lado. Em seguida, verifique se a aplicação escreve ficheiros de configuração, registos ou ficheiros gerados reais no mesmo caminho persistente.

Este passo é especialmente importante antes de atualizações ou migrações.

Passo 4: Verifique a propriedade dos ficheiros e as permissões de escrita

Uma montagem correta pode falhar se a aplicação não conseguir escrever nela. Os erros de permissão ocorrem frequentemente quando os ficheiros são criados pelo root, mas a aplicação é posteriormente executada por outro utilizador.

Verifique a propriedade antes de alterar permissões de forma abrangente. Normalmente, a solução correta é permitir que o utilizador pretendido da aplicação leia e escreva na pasta específica dos dados da aplicação, em vez de dar controlo total a todos os processos sobre diretórios amplos do anfitrião.

Se vir «permissão negada», identifique:

  1. o caminho montado no anfitrião;
  2. o caminho de destino no contentor;
  3. o utilizador que executa a aplicação;
  4. o proprietário do ficheiro;
  5. se a montagem é só de leitura;
  6. se um caminho de cópia de segurança ou de exportação também permite escrita.

Passo 5: Mantenha os segredos e os ficheiros de configuração fora de caminhos descartáveis

Os segredos e os ficheiros de configuração não devem existir apenas em pastas temporárias, diretórios de saída gerada ou histórico de shell improvisado. Se utilizar variáveis de ambiente, mantenha o ficheiro de implementação ou o ficheiro de ambiente num local persistente e controlado.

Evite misturar segredos com registos ou ficheiros gerados. Os registos podem ser partilhados para resolver problemas; os segredos nunca devem ser partilhados sem cuidado.

Se fizer cópias de segurança de segredos, proteja-as. Uma cópia de segurança que exponha chaves de API ou tokens de bots cria outro tipo de risco.

Passo 6: Reinicie o contentor e verifique se os dados continuam lá

Após a configuração, reinicie o contentor e verifique se os dados importantes continuam lá. Este é o teste mais prático à persistência.

Não se fique pelo «o contentor inicia». Confirme que:

  • as definições do modelo continuam disponíveis;
  • as competências ou o estado da aplicação continuam visíveis;
  • os registos continuam no local esperado;
  • os ficheiros gerados aparecem no anfitrião;
  • as definições do gateway ou do bot continuam a funcionar;
  • é possível localizar os ficheiros de cópia de segurança.

Uma configuração que passa na validação após reiniciar é muito mais segura do que uma que apenas passou na primeira instalação.

Permissões, cópias de segurança e limites de segurança

A segurança dos dados depende de três limites: quem pode escrever, de que dados são feitas cópias de segurança e a que dados o agente pode aceder. Estes limites são especialmente importantes para agentes autoalojados, pois podem criar ficheiros, modificar fluxos de trabalho ou interagir com ferramentas.

Porque são importantes as permissões do utilizador do contentor

As permissões do utilizador do contentor determinam se a aplicação pode ler e escrever os seus dados. Se a aplicação for executada como um utilizador, mas a pasta montada pertencer a outro, as operações de escrita podem falhar.

Por isso, executar um comando de configuração como root pode causar problemas mais tarde. O root pode criar ficheiros sem dificuldade, mas o utilizador normal da aplicação poderá não conseguir modificá-los.

Corrija as permissões ao nível da pasta de dados da aplicação. Evite alterações abrangentes às permissões que exponham ficheiros não relacionados do anfitrião.

Porque deve evitar executar tudo como root

O utilizador root pode contornar muitas restrições, mas isso não faz dele uma opção predefinida segura. Executar tudo como root pode criar ficheiros cuja propriedade pertence ao root, ocultar problemas de permissões e dar à aplicação mais acesso do que aquele de que precisa.

Na maioria dos fluxos de trabalho com aplicações autoalojadas, o utilizador root deve ser usado apenas para tarefas administrativas específicas. Sempre que possível, a configuração habitual da aplicação deve ser feita com o utilizador previsto para a aplicação ou o contentor.

Uma abordagem mais segura é aplicar o princípio do menor privilégio: dê à aplicação acesso de escrita apenas às pastas de que precisa.

Quando usar montagens só de leitura ou pastas limitadas

Use montagens só de leitura quando o agente precisar de consultar ficheiros, mas não os puder modificar. Use pastas de escrita limitadas quando o agente precisar de criar ficheiros, mas não puder aceder a diretórios pessoais ou do sistema mais abrangentes.

Isto é especialmente útil quando pretende que o agente gere relatórios, planos ou scripts sem lhe dar acesso de escrita a todos os ficheiros do servidor.

Uma conceção com pastas limitadas reduz o impacto dos erros. Também facilita as cópias de segurança, porque sabe que pasta contém o estado da aplicação e qual contém os ficheiros gerados.

Como fazer cópias de segurança dos dados do agente antes de atualizações ou reconfigurações

Faça cópias de segurança dos dados importantes da aplicação antes de alterar imagens de contentores, caminhos de montagem, definições do gateway ou perfis. Uma cópia de segurança só é útil se souber o que inclui e como a restaurar.

A discussão da comunidade Docker sobre permissões na cópia de segurança de volumes mostra um padrão comum de falha visível para o utilizador: um caminho pode existir, mas as operações de cópia de segurança ou de escrita podem continuar a falhar devido a restrições de permissões, propriedade, etiquetagem ou montagem.

Use isso como lembrete para testar as cópias de segurança, não apenas para as criar. Um plano de cópias de segurança deve incluir tanto a sua criação como a verificação do restauro.

Problemas comuns e como resolvê-los

Quando faltarem dados do Hermes Agent, não reinstale imediatamente a aplicação. Primeiro, identifique que camada falhou: inventário de dados, caminho de persistência, mapeamento de montagem, limite de permissões, âmbito da cópia de segurança ou validação após reinício.

O contentor não consegue encontrar uma pasta montada

Isto significa geralmente que o caminho existe numa camada, mas não na outra. A pasta do anfitrião poderá não estar montada, o caminho de destino do contentor poderá estar incorreto ou a aplicação poderá estar a procurar noutro local.

Verifique pela seguinte ordem:

  1. Confirme que a pasta existe no anfitrião.
  2. Confirme que o contentor tem a montagem.
  3. Confirme o caminho de destino dentro do contentor.
  4. Confirme que a aplicação está configurada para utilizar esse caminho de destino.
  5. Confirme que o utilizador da aplicação consegue ler a pasta.
  6. Confirme que a montagem foi recriada após alterar as definições de composição ou execução.

Não resolva este problema criando pastas aleatórias dentro do contentor. Isso poderá fazer o erro desaparecer temporariamente, mas deixará os dados num armazenamento descartável.

Os dados da aplicação são repostos após o reinício

Se os dados forem repostos após o reinício, a aplicação poderá estar a escrever no sistema de ficheiros interno do contentor, em vez de no caminho persistente. Também poderá estar a utilizar um perfil, uma variável de ambiente ou um diretório de dados diferente do esperado.

Verifique se o caminho dos dados antes e depois do reinício é o mesmo. Em seguida, verifique se a pasta é suportada por uma montagem ou apenas pela camada do contentor.

Se o contentor foi recriado, confirme que o mesmo volume ou montagem vinculada foi associado ao novo contentor.

Erros de permissão negada no diretório de dados

O erro de permissão negada significa que a aplicação consegue aceder ao caminho, mas não consegue executar a ação necessária. O problema pode estar na propriedade, nas definições de montagem só de leitura, nas etiquetas do sistema de ficheiros ou numa incompatibilidade entre o utilizador do anfitrião e o do contentor.

Comece pela verificação mais simples: o utilizador da aplicação consegue criar um ficheiro de teste inofensivo no diretório de dados? Se não conseguir, verifique o proprietário e as permissões desse caminho específico.

Evite resolver este problema dando acesso amplo de escrita a todo o diretório do anfitrião. Corrija o caminho dos dados da aplicação e defina o utilizador pretendido para a aplicação.

Os ficheiros gerados são guardados apenas dentro do contentor

Se os ficheiros gerados desaparecerem após uma reconstrução, é provável que tenham sido guardados dentro do contentor, em vez de num caminho do anfitrião montado. Isto acontece frequentemente quando o diretório de trabalho ou o diretório de saída da aplicação não está mapeado.

Decida onde devem ser guardados os ficheiros gerados. Em seguida, monte essa pasta de saída ou configure a aplicação para escrever num local persistente existente.

Depois de alterar o caminho, crie um ficheiro de teste inofensivo e confirme que aparece no anfitrião.

As definições do bot ou do gateway desaparecem após a reconfiguração

As definições do gateway podem desaparecer se a configuração estiver guardada num caminho não persistente ou se a aplicação for executada com um perfil diferente após o reinício. O mesmo pode acontecer se uma variável de ambiente for alterada num local, mas o contentor em execução utilizar outro valor.

Verifique se a configuração do gateway, a referência do token do bot, a lista de permissões e as definições do painel estão guardadas no local persistente esperado. Em seguida, reinicie o gateway e confirme que as definições continuam ativas.

Se o bot funcionar antes do reinício, mas não depois, verifique primeiro a persistência e a configuração do ambiente, antes de alterar o token.

Como Verificar se os Dados do Hermes Agent Estão Seguros

Uma configuração segura deve passar nas verificações de reinício, escrita, cópia de segurança e acesso. Estas verificações não precisam de ser complicadas, mas devem ser repetidas após alterações importantes.

A Configuração Persiste Após o Reinício

Altere uma definição sem importância, reinicie o contentor e verifique se a definição se mantém. Isto confirma que a aplicação está a escrever no armazenamento persistente.

Se a definição desaparecer, não continue a adicionar mais configurações. Corrija primeiro o caminho dos dados.

Os Registos e os Ficheiros Gerados Aparecem na Pasta Esperada do Anfitrião

Os registos e os ficheiros gerados devem aparecer no anfitrião, na localização esperada. Se aparecerem apenas dentro do contentor, poderão perder-se durante a recriação.

Verifique ambos os lados da montagem. O anfitrião e o contentor devem reconhecer os ficheiros relevantes.

O Agente Consegue Escrever nos Dados da Aplicação sem Erros de Permissões

O agente deve poder escrever na pasta de dados da aplicação como o utilizador pretendido. Um teste de escrita bem-sucedido é mais útil do que simplesmente confirmar que a pasta existe.

Após o reinício, procure erros de permissões nos registos. Alguns problemas de permissões só surgem quando o agente tenta atualizar a configuração, escrever uma competência, guardar um ficheiro gerado ou atualizar o estado do gateway.

É Possível Localizar e Restaurar os Ficheiros da Cópia de Segurança

Uma cópia de segurança só está completa quando consegue localizá-la e restaurá-la numa localização de teste. No mínimo, confirme que contém os dados que pretendia proteger.

No caso de configurações importantes, restaure a cópia de segurança para uma pasta ou instância de teste separada antes de confiar nela. Assim, evita descobrir problemas de restauro apenas depois de perder dados.

O Acesso ao Painel de Controlo ou às Mensagens Continua a Funcionar Após o Reinício

Após o reinício, verifique se o painel de controlo ou o acesso às mensagens continua a funcionar. Isto confirma que os dados persistentes, as credenciais, as definições do gateway e o acesso à rede continuam corretamente configurados.

Se o painel de controlo funcionar, mas as mensagens não, verifique as definições do gateway e o acesso ao token. Se as mensagens funcionarem, mas os ficheiros gerados desaparecerem, verifique o caminho de saída e as montagens.

Como Funciona num Ambiente Real de Servidor Doméstico

Numa configuração real de servidor doméstico, aplica-se a mesma lógica de segurança dos dados, mesmo quando o sistema disponibiliza um painel de controlo intuitivo. Continua a ser necessário saber que dados têm de ser preservados, onde estão armazenados, como o contentor lhes acede, que utilizador pode escrever neles e como os verificar após um reinício.

Por exemplo, o fluxo de configuração do Hermes Agent no ZimaOS apresenta um percurso específico para o dispositivo que inclui a configuração do fornecedor do modelo, a configuração do gateway do Telegram, o acesso ao contentor Hermes, a ativação do ambiente da aplicação, a verificação do painel de controlo Web e a resolução de problemas de permissões ou de resposta do bot.

Para quem executa aplicações Docker, fluxos de trabalho de agentes e serviços locais numa máquina compacta e sempre ligada, o servidor doméstico ZimaBoard 2 é um exemplo relevante do tipo de ambiente de servidor doméstico leve em que é necessário planear em conjunto as pastas persistentes, os caminhos dos contentores, as permissões e a expansão do armazenamento. Não é a única configuração possível, mas corresponde ao tipo de fluxo de trabalho com aplicações autoalojadas abordado neste guia.

A lição geral é aplicável a qualquer configuração: antes de confiar tarefas importantes a um agente num contentor, certifique-se de que os dados essenciais sobrevivem ao contentor que está a ser executado neste momento.

Perguntas frequentes

Porque é que os meus dados do Hermes Agent desapareceram depois de reiniciar o contentor?

Um simples reinício não deve apagar os dados persistentes, mas a aplicação pode parecer reiniciada se estivesse a gravar num caminho não persistente do contentor. Os dados também podem desaparecer se o contentor tiver sido recriado sem o mesmo volume ou montagem bind. Verifique o caminho no anfitrião, o caminho no contentor e o caminho efetivo dos dados da aplicação antes de alterar mais definições.

Qual é a diferença entre um volume Docker e uma montagem bind?

Um volume Docker é gerido pelo Docker, enquanto uma montagem bind associa ao contentor uma pasta do anfitrião escolhida por si. Um volume é muitas vezes uma opção simples para dados geridos pela aplicação, enquanto uma montagem bind é mais fácil de localizar diretamente no anfitrião. A melhor escolha depende de preferir armazenamento gerido pelo Docker ou uma pasta visível no anfitrião para cópias de segurança e inspeção.

Onde devo guardar os dados da aplicação Hermes Agent num servidor doméstico?

Use uma pasta persistente dedicada ou um volume Docker, em vez de um caminho temporário do contentor. A localização deve ser fácil de incluir nas cópias de segurança, limitar-se às necessidades da aplicação e não estar misturada com ficheiros sensíveis sem relação com a mesma. O mais importante é que o caminho esperado pela aplicação dentro do contentor esteja efetivamente associado a esse armazenamento persistente.

Porque é que o contentor indica que uma pasta não existe?

A pasta pode existir no anfitrião, mas não dentro do contentor. Normalmente, isto significa que a montagem não foi criada, que o caminho de origem está errado, que o caminho de destino está errado ou que a aplicação está a procurar noutro caminho do contentor. Verifique tanto o lado do anfitrião como o do contentor, em vez de criar uma nova pasta sem pensar.

Devo executar o Hermes Agent como root para evitar erros de permissões?

Executar como root pode ocultar o erro imediato, mas pode criar ficheiros pertencentes ao root e aumentar o risco. Uma abordagem mais segura consiste em permitir que o utilizador da aplicação previsto leia e escreva apenas no caminho de dados necessário da aplicação. Use root apenas para ações administrativas ou de reparação específicas, quando compreender a alteração.

Com que frequência devo fazer cópias de segurança dos dados do Hermes Agent?

Faça cópias de segurança antes de atualizações, reconstruções de contentores, alterações de caminhos, reconfigurações do gateway ou migrações para outro servidor. Para uma utilização frequente, agende cópias de segurança regulares, de acordo com a frequência com que os skills, as definições, os ficheiros gerados ou as sessões são alterados. Uma cópia de segurança não é fiável até confirmar que consegue localizar e restaurar os ficheiros.

Assistência e dicas

Mais para ler

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.