Releases
Visão Geral
Uma das etapas do ciclo de vida de desenvolvimento de integrações consiste em instalá-la em um ambiente de forma que esteja funcional e operante. Os serviços de integração desenvolvidos no módulo iPaaS do DHuO são distribuídos como aplicações e implantados em clusters Kubernetes.
O primeiro passo para essa distribuição é a geração de uma release da integração. A release é uma entidade no DHuO que representa o artefato gerado a partir do empacotamento de tudo desenvolvido na interface do canvas.
Após a criação da release, o próximo passo é disponibilizá-la em um cluster kubernetes, no processo de implantação. Para saber mais, acesse a seção Implantação (Deploy) da integração.
Construção da release
O processo de geração de uma release consiste nas seguintes etapas:
- Empacotamento
- Compilação
- Distribuição
Na etapa de empacotamento, o canvas da integração é obtido, validado e traduzido para o formato final. Caso a integração possua subfluxos, os canvas dos subfluxos também são obtidos conforme a versão configurada e o mesmo processo é realizado.
Na etapa de compilação é gerado uma imagem docker com o motor de integrações do DHuO e o fluxo correspondente. Caso o fluxo contenha um ou mais componentes Go Plugin, ocorre a compilação do código go dos plugins.
Por fim, na etapa de distribuição, a imagem docker construída é armazenada em um repositório de imagens, acessível para a implantação em clusters kubernetes. O DHuO possui suporte aos serviços gerenciados de repositório de imagens dos principais provedores de nuvem:
- Google Container Registry (GCR) / Google Artifact Registry
- Azure Container Registry
- Amazon Elastic Container Registry (ECR)
- Oracle Container Registry
Além disso, possui suporte ao container registry open source:
- Harbor
O repositório de imagens é configurado no momento da instalação da plataforma. Para saber mais, entre em contato com a equipe de suporte responsável pela operação da plataforma.
Configuração
As releases são gerenciadas pela interface do estúdio da integração. A partir da home, acesse o menu > Integrações. Na página de integrações, visualize a integração desejada e acesse o menu > Implantação. Na aba > Releases, elas podem ser criadas e excluídas.
No botão Detalhes de uma release é possível visualizar os detalhes, como a relação de subfluxos e suas versões incluídas na release gerada.
O processo de criação e exclusão de releases pode levar alguns instantes. É possível acompanhar o status pela lista de releases. Enquanto isso, é possível realizar outras atividades na plataforma.
Permissões
Apenas usuários com papel de administrador da organização (Org Admin) ou provedor de APIs (API Provider) podem gerenciar releases. Para saber mais, acesse a seção Papéis e permissões.
Parâmetros
Aqui estão os parâmetros para configuração de uma release de integração:
- Nome: Obrigatório. Nome da release.
As releases são únicas. Não é possível ter mais de uma release com o mesmo nome.
O nome de uma release não pode conter espaços e pode conter apenas letras sem acentos, números e o caractere -. Também não pode terminar com o caractere -.
- Descrição: Texto opcional para detalhes sobre a release.
Não é possível excluir uma release caso ele esteja implantada em algum cluster. É necessário remover todas as implantações para excluir uma release.
Atualmente a exclusão de uma release não exclui a imagem docker do repositório de imagens, apenas remove o registro da administração do DHuO. Caso deseje remover a imagem da release do repositório de imagens, é necessário entrar em contato com a equipe de suporte responsável pela operação da plataforma.
Da mesma forma, caso a imagem docker seja removida do repositório de imagens, o DHuO não conseguirá implantar a release correspondente. Implantações existentes também podem deixar de funcionar pela ausência da imagem da release no repositório.