Implantar um Release

Implantação padrão

Por padrão, todos os dispositivos da frota mantêm instalado o Release publicado mais recentemente na frota.

Se um dispositivo estiver desconectado do JelinaCloud, ele iniciará a atualização e a implantação do Release assim que se conectar novamente.

• Na visão geral do dispositivo, você pode consultar o Release instalado e o Release de destino.

• Na lista de serviços, na parte inferior esquerda, você pode consultar os serviços instalados, seus estados e controlar seu ciclo de vida.

• À direita, você pode consultar os logs do dispositivo, detalhados por serviço. Isso permite acompanhar todo o processo de instalação do Release e observar o comportamento das aplicações após a instalação.

Implantação de uma versão específica

Defina qual versão (Release) da aplicação o dispositivo deve executar.

Fixar a versão da frota

Se não quiser que os dispositivos instalem automaticamente o Release mais recente, acesse a página de Operações da frota e defina um Release específico para todos os dispositivos.

Ao fixar a versão da frota, o Release de destino de todos os dispositivos passa a ser essa versão, que será instalada na próxima atualização.

Fixar a versão de um dispositivo

Você também pode definir diretamente a versão de um dispositivo. Nesse caso, ele não seguirá a versão fixada na frota ao atualizar.

Atenção

Embora esse recurso esteja disponível, não recomendamos fixar individualmente as versões dos dispositivos. Isso contraria o objetivo de manter a mesma configuração de ambiente em toda a frota e pode dificultar a gestão posterior se não for bem administrado.

Após definir a versão, consulte na visão geral do dispositivo a próxima ação prevista: instalar o Release especificado.

Para acompanhar melhor a implantação, consulte na página de detalhes do Release quais dispositivos o instalaram.

Configurar variáveis de serviço

As variáveis de serviço permitem adicionar variáveis de ambiente às aplicações executadas nos dispositivos. Elas não são incluídas nas variáveis do sistema e se aplicam apenas aos serviços do dispositivo.

Configurar variáveis de serviço compartilhadas na frota

As variáveis de serviço configuradas na frota podem se aplicar a todos os dispositivos.

Há dois tipos de variáveis de serviço:

• All Services: aplicam-se a todos os serviços da frota, ou seja, aos serviços de todos os dispositivos.

• Serviço específico: aplicam-se a um único serviço de determinado Release, apenas nos dispositivos que tenham esse Release instalado.

— Etapas para adicionar uma variável

Acesse a página de variáveis de serviço compartilhadas da frota e clique em Adicionar variável.

Selecione os serviços aos quais a variável se aplica, informe seu nome e valor e clique em Adicionar. O nome pode conter apenas números, letras e sublinhados.

Após a adição, a variável aparece na lista.

Configurar variáveis de serviço privadas no dispositivo

Você também pode adicionar variáveis de serviço privadas a um dispositivo. Elas funcionam como as variáveis compartilhadas, mas se aplicam apenas aos serviços executados nesse dispositivo.

Observe os seguintes pontos:

• Se uma variável privada tiver o mesmo nome de uma variável compartilhada, a privada terá prioridade.
• É possível sobrescrever o valor de uma variável compartilhada. A alteração vale apenas para o dispositivo e não modifica o valor original da frota.
• Ao excluir a sobrescrita, o dispositivo volta a utilizar o valor da variável compartilhada.

— Etapas para adicionar uma variável

Acesse a página de variáveis de serviço privadas do dispositivo e clique em Adicionar variável.

Selecione os serviços aos quais a variável se aplica, preencha o nome e o valor e clique em Adicionar. O nome pode conter apenas números, letras e sublinhados.

— Etapas para sobrescrever uma variável

Clique em Sobrescrever.

Informe o valor da variável e clique em Confirmar.

Na página de variáveis de serviço compartilhadas da frota, você pode consultar quais dispositivos sobrescreveram cada variável.

Informações sobre variáveis de serviço

1. Qual é o escopo das variáveis de serviço?

• Aplicações em contêiner: o JelinaCloud adiciona as variáveis de serviço a environment, isto é, à chave environment da configuração compose. Se houver uma variável com o mesmo nome no compose, a variável de serviço terá prioridade.
• Aplicações nativas: as variáveis de serviço são usadas como variáveis de ambiente da aplicação.

2. O que acontece no dispositivo quando as variáveis de serviço mudam?

• Serviços em contêiner: o contêiner é removido e recriado para aplicar as variáveis.
• Aplicações nativas: o serviço é reiniciado.

3. As variáveis de serviço permitem configurar com flexibilidade as políticas de execução das aplicações. Para isso, a aplicação implantada deve ser capaz de ler as variáveis e ajustar seu comportamento. Fornecemos o suporte de infraestrutura; a implementação específica fica a seu critério.

Veja alguns exemplos de uso que podem orientar o desenvolvimento:

• Distribuir chaves e endereços de conexão por variáveis de serviço para conectar a nuvens IoT, como Azure, Amazon, Aliyun e Tencent.
• Configurar conexões com bancos de dados.
• Configurar conexões MQ.
• Configurar limites de uso de recursos.
• Usar as variáveis como central de configuração das políticas de execução dos serviços.