Visão Geral
A distribuição de recursos e atualizações é um dos pilares mais importantes no ciclo de vida de um projeto. No ecossistema LATROMI, essa distribuição é realizada através dos arquivos LCP (Latromi Content Package).
Para gerenciar suas versões de forma eficiente, a plataforma oferece dois métodos distintos de geração, cada um adequado a uma necessidade específica do fluxo de desenvolvimento:
- Geração por revisão: Este método permite compilar em um único pacote LCP todos os objetos que foram modificados em uma determinada Revisão do sistema.
- Geração por objeto: Esta opção oferece controle total, permitindo selecionar individualmente quais objetos farão parte do pacote de exportação.
Compreender qual dessas opções utilizar em cada cenário do dia a dia garantirá maior segurança e organização no gerenciamento das suas entregas.
Gerando um pacote por revisão
Criar um pacote por revisão é ideal quando temos grandes versões com atualizações completas ou quando é necessário garantir que todas as alterações de um período sejam migradas em conjunto para um ambiente de produção.
Esse processo pode ser feito por qualquer usuário com cargo desenvolvedor, na plataforma. Ao selecionar a revisão que deseja gerar o pacote, o sistema irá adicionar todos os objetos criados/modificados na revisão indicada.
Revisão
Sempre que um objeto é liberado, cria-se uma revisão respectiva as alterações, permitindo ao desenvolvedor um controle sobre as versão de cada objeto. Com isso é possível ter um histórico das alterações, além de permitir visualizar o estado do objeto em cada revisão.
Liberação de objetos
Com o objetivo de facilitar a criação de uma revisão, que contenha todas as alterações efetuadas em um período, podemos usar a tela de liberação de objeto. Ela é crucial para o processo de geração de pacote por revisão.
Nesta tela podemos selecionar todos os objetos a serem liberados na mesma versão.
Gerando o pacote
Enfim, vamos efetuar a geração do pacote, para isso siga os seguintes passos:
- Abra a tela de geração de pacote por revisão.
- Adicione um nome para o pacote.
- Clique em revisões.
- Selecione uma ou mais revisões para gerar o pacote.
- Clique em exportar.
Pronto, agora temos nosso pacote gerado e pode ser enviado para outros servidores para ser importado.
Gerando um pacote por objeto
A criação de pacote por objeto é restrita a usuários que possuam os cargos de Administrador e desenvolvedor, pois seu cenário de aplicação é mais especifico sendo ideal para correções pontuais, migrações de recursos isolados ou quando uma parte do projeto foi entregue e precisa ser testada sem afetar o resto do sistema.
Gerando o pacote
O processe de geração de pacote por objeto é muito semelhante ao processo de geração por revisão diferindo em poucos pontos, siga o passos a seguir para concluí-lo:
- Abra a tela de geração de pacote por objeto.
- Adicione um nome para o pacote.
- Clique em um dos menus de objetos laterais.
- Selecione os objetos que deseja exportar.
- Caso o objeto selecionado tenha dependência de outros objetos e deseje enviar junto no pacote, marque-os no canto direito.
- Clique em exportar.
Pronto, agora temos nosso pacote gerado e pode ser enviado para outros servidores para ser importado.
Importando o pacote em outro ambiente
A etapa final do processo de distribuição é a Importação. Após gerar o arquivo .LCP em sua máquina local seguindo os métodos anteriores, você deve transferi-lo para o servidor ou ambiente de destino onde as atualizações serão aplicadas.
Segurança e Acesso:
Por se tratar de uma operação que altera a estrutura do sistema, o processo de importação é restrito a usuários que possuam os perfis de Administrador e Desenvolvedor no ambiente de destino.
Conexão
Durante a importação, você terá controle sobre como o objeto se comunicará com o banco de dados. É possível:
- Usar a conexão original: Mantém as configurações de fonte de dados contidas no arquivo de importação.
- Redirecionar conexão: Indicar uma nova conexão específica já existente no ambiente de destino (ideal para quando os nomes das bases de dados variam entre Desenvolvimento e Produção).
Preservar estado
O LATROMI gerencia a integridade dos seus objetos através de regras de versionamento. Entender como e quando intervir nessas regras é fundamental:
- Regra Padrão (Recomendada): O sistema compara as datas e mantém sempre a versão mais atualizada do objeto. Recomendamos manter esta opção ativa para evitar um downgrade acidental (sobrescrever um trabalho novo por um antigo).
- Sobrescrita Forçada: Existem cenários de exceção — como quando um Hotfix (correção emergencial) foi aplicado diretamente em Produção enquanto o desenvolvimento principal continuava em outro ambiente. Nestes casos, você pode marcar a opção de Sobrescrever Objetos, forçando a plataforma a aceitar o conteúdo do pacote LCP, independentemente da data de alteração.
Importando o pacote
Por fim, vamos apresentar o passo a passo para importar o pacote em um ambiente, siga-o abaixo:
- Abra a tela de importação de pacotes.
- Selecione o arquivo LCP para importação.
- Confira se os dados do arquivo de importação está correto.
- Clique em Importar.
Pronto, os objetos foram importados no ambiente e podem ser utilizados pelo usuário final.