Lançamentos e versões

A Mirox é entregue de forma contínua. Um lançamento é um estado testado e versionado de toda a plataforma; é implementado nas duas regiões sem interromper as suas sessões, e cada lançamento é listado com as suas alterações no registo de alterações.

As três linhas de lançamento

LinhaO que contém
PlataformaA aplicação web, a API, os serviços por trás delas e a base de dados
AgentesOs serviços que recolhem e analisam os dados das suas centrais. Funcionam de forma descentralizada, em clusters de agentes, em regiões distintas das da própria plataforma, para redundância e disponibilidade.
Aplicação móvelA aplicação iOS e Android

As três linhas são lançadas de forma independente. Um lançamento da plataforma nunca exige um novo agente ou uma nova aplicação, e vice-versa; quando uma alteração abrange duas linhas, o registo de alterações indica-o na entrada.

O que significa o número de versão

A versão da plataforma é o único número que identifica o que a sua organização está a executar. É a versão do lançamento completo da plataforma — não de um serviço individual — e é o número que o registo de alterações utiliza.

As três linhas seguem o mesmo esquema de versionamento semântico, MAJOR.MINOR.PATCH:

  • MAJOR marca uma geração do produto.
  • MINOR aumenta quando um lançamento transporta uma alteração ao modelo de dados, por exemplo um novo tipo de componente ou definição que precisa de novo armazenamento.
  • PATCH conta todos os outros lançamentos: novas funcionalidades, correções e melhorias que deixam o modelo de dados intacto.

Qualquer aumento, em qualquer posição, é um lançamento completo que passou os mesmos testes e foi implementado da mesma forma.

Encontrar a versão que está a executar

  • Na aplicação web, o fundo da barra lateral esquerda mostra, junto ao ícone de compilação, a data e a hora em que a aplicação web que está a ver foi compilada. Identifica a compilação da própria aplicação web.
  • Através da API, qualquer utilizador com sessão iniciada e qualquer token de API pode ler o lançamento:
GET /api/v1/system/version

{
  "version": "MAJOR.MINOR.PATCH",
  "build_timestamp": 1761206880,
  "region": "htz-fsn1"
}

version é a versão da plataforma, build_timestamp a hora de compilação do serviço que respondeu, em tempo Unix, e region a região que respondeu. Procure a versão no registo de alterações para ver que alterações contém.

Como uma atualização chega até si

Plataforma. Um lançamento é implementado região a região sem indisponibilidade: a nova versão arranca ao lado da antiga, assume o tráfego e a antiga é retirada. A sua sessão mantém-se iniciada. Enquanto a implementação decorre, a aplicação web repara que existe uma compilação mais recente e mostra um pequeno aviso com um botão Atualizar; se não estiver a interagir com a página, ela recarrega sozinha após uma breve contagem decrescente, e nunca recarrega enquanto está a escrever. Um lançamento normalmente não precisa de janela de manutenção; só é anunciada uma quando os trabalhos o exigem.

Agentes. Os agentes das suas centrais são atualizados pela Mirox, independentemente da plataforma e região a região nos clusters de agentes. Uma atualização de agente não precisa de nada da sua parte e não interrompe a plataforma; os dados recolhidos durante o breve reinício são guardados numa memória intermédia e entregues depois.

Aplicação móvel. As novas versões da aplicação chegam através da App Store e do Google Play. As atualizações mais pequenas que não precisam de um lançamento na loja são aplicadas over the air na próxima vez que a aplicação é iniciada.

Registo de alterações e roadmap

  • changelog.mirox.io lista cada lançamento, agrupado por dia, com a versão da linha a que pertence. As entradas são escritas para as pessoas que operam centrais com a Mirox, não para programadores.
  • roadmap.mirox.io mostra o que está planeado, o que está em curso e o que já foi entregue, e permite-lhe votar nos itens.

Perguntas frequentes

Tenho de fazer alguma coisa para uma atualização? Não. As atualizações da plataforma e dos agentes são aplicadas pela Mirox. Para a aplicação móvel, mantenha as atualizações automáticas ativadas na sua loja.

Porque é que a barra lateral mostra uma data em vez de uma versão? A data identifica a compilação da aplicação web no seu browser, que é o que importa quando uma página se comporta de forma inesperada. A versão da plataforma está disponível através da API, como descrito acima.

As duas regiões estão sempre na mesma versão? Um lançamento é implementado nas duas regiões na mesma implementação. Durante os poucos minutos que uma implementação demora, as regiões podem diferir brevemente; o campo region do endpoint de versão diz-lhe que região respondeu.

Páginas relacionadas