Configuração de pacotes incrementais

Pacotes incrementais

As alterações feitas no sistema de arquivos podem ser empacotadas exatamente como estão e enviadas ao JelinaCloud como um pacote incremental, que pode ser implantado diretamente nos dispositivos.

Você pode primeiro configurar o ambiente de execução do dispositivo e depois enviar um Increment. A implantação desse Increment permite migrar o ambiente para outros dispositivos.

Regras de empacotamento

O Jelina não inclui determinados caminhos de cache e configurações sensíveis no pacote. A seguir estão alguns caminhos que não são incluídos no Increment:

/adv, /app, /mnt/boot, /mnt/overlay/rw, /mnt/inactive, /mnt/overlay/ro, /tmp, /var/cache, /var/log, /var/backups, /var/tmp, /var/run, /var/mail, /var/volatile, /proc, /sys, /dev, /run, /boot, /lost+found , /etc/systemd/system/jelinvisored_* , /etc/ld.so.cache, /etc/ssh/ssh_host*, /etc/gshadow, /etc/gshadow-, /etc/fstab, /etc/docker, /var/lib/systemd/coredump, /var/lib/systemd/random-seed, /var/lib/dbus, /var/lib/containerd, /var/lib/private, /etc/.pwd.lock , /var/lib/apt/lists, /var/lib/apt/mirrors, /var/lib/logrotate/status, pycache

Usar pacotes incrementais

Vincular a um Release

Após configurar o ambiente de execução, você pode empacotá-lo, enviá-lo ao JelinaCloud e vinculá-lo a um Release. Ao implantar essa versão, o dispositivo instala primeiro o pacote incremental vinculado, garantindo o ambiente necessário às aplicações e padronizando o ambiente de execução de vários dispositivos.

Implantar diretamente

Na página de operações da frota ou do dispositivo, selecione o Increment desejado. O dispositivo instalará, por padrão, o Increment especificado.

Enviar um pacote incremental

Acesse a lista de pacotes incrementais da frota e clique em Enviar pacote incremental.
Informe o nome do pacote, selecione o dispositivo, adicione opcionalmente uma descrição e clique em Enviar pacote incremental. Somente dispositivos online podem enviar pacotes.

O JelinaCloud notificará o dispositivo para empacotar seu ambiente e enviar o arquivo, vinculando-o ao pacote incremental criado.

O novo pacote incremental aparece na lista.

Publicar um pacote incremental

Após concluir o envio do arquivo, acesse a visão geral do pacote incremental e clique em Publicar.

Upload consolidado e exclusão de caminhos

O que esses recursos permitem

Anteriormente, ao empacotar e enviar novamente um pacote incremental, a nuvem só conseguia empacotar cada nível da cadeia de incrementos já instalada no dispositivo. Assim, o tamanho aumentava à medida que o histórico de versões instaladas crescia. Agora, o painel de upload ou reenvio oferece duas opções adicionais:

Upload consolidado: reúne as várias gerações de incrementos das quais o dispositivo depende em um único pacote para envio, reduzindo níveis de dependência e tamanho e acelerando as instalações posteriores.
Excluir caminhos: permite excluir manualmente diretórios ou arquivos desnecessários, como logs e caches, durante o empacotamento para reduzir ainda mais o tamanho.

Ambas as opções são opcionais. Se você não as selecionar nem preencher, a operação continuará funcionando como antes.

Pré-requisitos

O dispositivo de destino deve estar online.
O Jelinvisor executado no dispositivo deve ter versão ≥ 1.2.27. Caso contrário, “Upload consolidado” e “Excluir caminhos” ficam indisponíveis: a opção aparece desabilitada e o campo não pode ser editado.
“Upload consolidado” também exige que o ambiente atual do dispositivo ofereça suporte ao recurso, conforme a verificação feita no dispositivo. Mesmo com uma versão compatível, a opção permanece desabilitada se o ambiente não oferecer suporte.

Procedimento

Como exemplo, vamos empacotar e enviar novamente um pacote incremental do dispositivo:

Na frota (Fleet) de destino, acesse a gestão de pacotes incrementais do dispositivo correspondente e localize a opção de upload ou reenvio, equivalente às operações existentes de Enviar pacote incremental e Reenviar.
Ao abrir o painel, a interface verifica primeiro as condições atuais do dispositivo:
- Se a versão ou os recursos do dispositivo não atenderem aos requisitos, “Upload consolidado” ficará desabilitado e será exibido o motivo, por exemplo:
  - “O Jelinvisor do dispositivo deve ter versão ≥ 1.2.27”.
  - “O ambiente atual do dispositivo não oferece suporte ao upload consolidado”, acompanhado do motivo retornado pelo dispositivo.
- Se os requisitos forem atendidos, a opção poderá ser selecionada normalmente.
Escolha as opções necessárias:
- Selecionar “Upload consolidado”: as várias gerações de incrementos pai serão reunidas em um único pacote. Após a instalação, o dispositivo não dependerá mais da cadeia anterior de pacotes incrementais.
- Preencher “Excluir caminhos”: informe uma ou mais regras de caminho, uma por linha ou adicionando-as individualmente no campo. Exemplos:
  - var/lib/docker/: exclui esse diretório.
  - etc/ssh/ssh_host*: exclui por prefixo.
  - *.log: exclui todos os arquivos de log.
  - Há suporte aos curingas * e ?. Incluir ou omitir ./ ou / no início do caminho produz o mesmo efeito.
  - Recomenda-se informar caminhos completos, sem usar caminhos relativos como ./.
- As duas opções podem ser usadas juntas, individualmente ou não ser usadas.
Confira as opções e clique em Enviar incremento do ambiente para solicitar ao dispositivo o empacotamento e o envio. Após o início, o progresso é exibido da mesma forma que no fluxo anterior.
Se os parâmetros não atenderem aos requisitos, por exemplo, se “Upload consolidado” estiver selecionado em um dispositivo com versão incompatível, a interface exibirá um erro e impedirá o envio. Remova as opções incompatíveis e tente novamente.

Consultar as informações após o upload

Nas páginas de lista e detalhes, cada registro de pacote incremental agora também mostra:

Se o upload consolidado foi usado nesse envio.
As regras de exclusão de caminhos utilizadas, se houver.

Essas informações permitem consultar posteriormente as opções de empacotamento, facilitando o diagnóstico de problemas e a reutilização da configuração.

Um pacote gerado por “Upload consolidado” não exibe mais uma dependência de “incremento pai”, pois as dependências já estão reunidas no próprio pacote. Nos pacotes sem consolidação, a exibição das dependências continua como antes.

Perguntas frequentes

P: Por que a opção “Upload consolidado” não aparece? R: A versão do Jelinvisor é inferior a 1.2.27 ou, embora a versão seja compatível, o ambiente do sistema não oferece suporte à consolidação. Nesse caso, somente o fluxo anterior de upload de pacotes incrementais está disponível.

P: Excluir caminhos sem selecionar o upload consolidado exige algum suporte adicional no dispositivo? R: Não. A exclusão de caminhos exige apenas Jelinvisor ≥ 1.2.27 e não depende da aprovação na verificação de suporte ao upload consolidado.