Criar e Configurar Jobs de Build de Produção

Você precisa configurar alguns jobs de empacotamento e implantação para poder implantar aplicativos visuais na instância de produção do Visual Builder. Este tópico explica como fazer isso.

Dica:

Se preferir, o VB Studio poderá criar e ativar os jobs de build e o pipeline para você. No editor de Definições do aplicativo visual, em Criando e Publicando, selecione a ramificação de produção e clique em Criar Pipeline CI/CD. Em seguida, é possível modificar os jobs de criação recém-criados conforme necessário (consulte a orientação abaixo para obter etapas de configuração adicionais). Por exemplo, no job de implantação, o destino da implantação é sempre o ambiente associado ao espaço de trabalho; portanto, você precisará alterar a instância de destino para sua instância de produção.

Antes de configurar jobs de criação de produção, anote o seguinte:

  • No job de empacotamento de produção, use a ramificação de produção do repositório Git para gerar artefatos de produção.
  • No job de empacotamento para desenvolvimento, se você tiver alterado os nomes de arquivo padrão dos arquivos de artefato de arquivamento, obtenha os novos nomes e seus caminhos. Você precisará deles ao configurar o job de empacotamento de produção.
  • Se você tiver configurado o job de empacotamento de desenvolvimento para substituir a versão do aplicativo definida em visual-application.json, obtenha a nova versão. Você precisará dele ao configurar o job de empacotamento de produção.
  • Ao configurar jobs de build de implantação, você especifica se deseja incluir a versão do aplicativo em seu URL. Um aplicativo visual sem a versão em seu URL é chamado de aplicativo Live. Em geral, você implanta um aplicativo ativo em uma instância de produção.
  • Se você implantar uma versão de um aplicativo visual que nunca foi implantado, o VB Studio substituirá a última versão implantada pela nova versão.

    O VB Studio não cancela a implantação da versão implantada anteriormente da instância de produção. Ele continua na instância de destino, mas está inacessível.

  • Se você quiser reimplantar um aplicativo ativo ou uma versão implantada anteriormente, cancele a implantação primeiro; caso contrário, o build de implantação falhará. Para cancelar a implantação de uma versão de aplicativo visual implantada anteriormente, configure um job de build de cancelamento de implantação e execute-o. Não é possível cancelar a implantação manualmente na página Ambientes.
  • Se você estiver implantando um aplicativo em um URL personalizado, deverá configurar o job de implantação para implantação no ambiente que hospeda o URL personalizado. Você só pode implantar o aplicativo usando autenticação de autenticação básica, portanto, precisará confirmar se as credenciais necessárias para se conectar e implantar no ambiente estão corretas.
  • Se você criou um perfil de aplicativo para produção, obtenha seu nome. Você precisará dele ao configurar o job de implantação de produção.

Criar um Job de Criação de Embalagem de Produção

O job de empacotamento de produção gera um artefato de aplicativo visual pronto para implantação.

  1. No navegador esquerdo, clique em Builds Builds.
  2. Na guia Jobs, clique em + Criar Job.
  3. Na caixa de diálogo Novo Job, em Nome, digite um nome exclusivo.
  4. Em Descrição, digite a descrição do job.
  5. Em Modelo, selecione o modelo Padrão do Sistema OL7 para o Visual Builder.
  6. Clique em Criar.
  7. Clique em Configurar Builds.
  8. Clique na guia Git.
  9. Na lista Adicionar Git, selecione Git.
  10. Em Repositório, selecione o repositório Git. Em Ramificação ou Tag, selecione a ramificação de produção.
  11. Clique na tab Etapas.
  12. Em Adicionar Etapa, selecione Aplicativo Visual e, em seguida, selecione Pacote.
  13. Por padrão, os jobs de build minimizam o código-fonte do aplicativo antes de executar o build. Se você não quiser minificar os arquivos de origem, desmarque a caixa de seleção Otimizar aplicativo.
    A minimização é um processo para remover os caracteres desnecessários (como espaços em branco, novas linhas e comentários) do código-fonte e reduzir o tamanho dos arquivos, fazendo com que a transferência de arquivos consuma menos largura de banda e armazenamento.
  14. Se quiser alterar os nomes padrão dos arquivos compactados, em Nomes de arquivos, selecione Usar nomes de arquivos personalizados.
    Em Origens, especifique o nome e o caminho do arquivo compactado de origem do aplicativo visual. Em Criar Artefato, especifique o nome e o caminho do arquivo de arquivamento do artefato de build.

    Você precisará dos dois arquivos compactados para implantar o aplicativo visual.

  15. Clique na guia Após o Build.
  16. Em Adicionar Após a Ação de Build, selecione Arquivador de Artefatos.
  17. Em Arquivos a serem arquivados, informe o nome do artefato de build. Você também pode usar caracteres curinga. Por exemplo, *.zip.
  18. Se quiser descartar artefatos antigos do build, clique em Definições o ícone de Engrenagem. Na guia Geral, marque a caixa de seleção Descartar Builds Antigos e especifique as opções de descarte.
  19. Clique em Salvar.

Criar um Job de Build de Implantação de Produção

O job de implantação de produção implanta o artefato do aplicativo visual que foi gerado no job de empacotamento de produção para a instância de produção do Visual Builder. Antes de criar o job, obtenha as credenciais de acesso de um usuário que pode se conectar e implantar na instância de produção do Visual Builder.

  1. No navegador esquerdo, clique em Builds Builds.
  2. Na guia Jobs, clique em + Criar Job.
  3. Na caixa de diálogo Novo Job, em Nome, digite um nome exclusivo.
  4. Em Descrição, digite a descrição do job.
  5. Em Modelo, selecione o modelo Padrão do Sistema OL7 para o Visual Builder.
  6. Clique em Criar.
  7. Clique em Configurar Builds.
  8. Clique na guia Antes do Build.
  9. Em Adicionar Antes da Ação de Build, selecione Copiar Artefatos.
  10. Em Do Job, selecione o job de empacotamento de produção que gerou o artefato do aplicativo visual.
  11. Em Qual Build, selecione Último Build Bem-sucedido.
  12. Deixe outros campos com seus valores padrão ou vazios.
  13. Clique na tab Etapas.
  14. Em Adicionar Etapa, selecione Aplicativo Visual e, em seguida, selecione Implantar.
  15. Em Instância de Destino, selecione a instância de produção do Visual Builder.
  16. Na seção Autorização, especifique o tipo de autorização para executar esta etapa de criação. Com a opção Usar OAuth selecionada por padrão, você verá a mensagem Authorization is required, indicando que essa etapa de build precisa de uma autorização única para tratar solicitações OAuth para a instância do Visual Builder do seu ambiente. Clique em Autorizar e informe credenciais para acessar sua instância do Visual Builder; você também pode executar o job manualmente e informar as credenciais quando solicitado.

    De qualquer forma, é recomendável autorizar sua conexão OAuth durante a configuração inicial. Se você ignorar esta etapa, não poderá publicar suas alterações no Designer e precisará concluir a autorização necessária antes de tentar implantar as alterações.

    Uma vez autorizada, a mensagem Authorization has been provided é exibida.

    Observação

    OAuth é o tipo de autorização recomendado. Use a autenticação Básica somente se tiver problemas ao configurar uma conexão OAuth. Para usar a autenticação Básica, selecione Usar Básico e informe as credenciais de um usuário que pode acessar a instância do Visual Builder em Nome do Usuário e Senha.

    Os tokens OAuth (acesso e atualização) são reiniciados durante o uso regular. Um token de atualização é usado para obter um token de acesso sempre que um usuário acessa a instância de destino. Esse token de atualização geralmente é válido por sete dias. (O tempo de expiração do token é definido no aplicativo de recursos do IDCS e pode ser diferente com base em seus requisitos de segurança.) Se o usuário se autenticar com a instância de destino dentro do período de sete dias, o token de atualização ativo gerará um novo token de acesso e um novo token de atualização. Esse ciclo continua indefinidamente, desde que o token de atualização permaneça válido. Se o token de atualização expirar durante longos períodos de inatividade (por exemplo, quando você estiver de férias), clique em Renovar Autorização (ou execute o job manualmente, para que você seja solicitado a autorizar quaisquer tokens OAuth expirados).

  17. No job de empacotamento de produção, se você tiver alterado os nomes de arquivo padrão dos arquivos de artefato de arquivamento, em Nomes de arquivo, selecione Usar nomes de arquivo personalizados.
    Em Origens e Criar Artefato, informe os mesmos nomes de arquivo (com caminho) especificados no job de empacotamento.

    Se você não alterou os nomes de arquivo, use a opção padrão.

  18. (Opcional) Se você tiver configurado o job de implantação de desenvolvimento para substituir a versão padrão do aplicativo, especifique a mesma versão em Versão do Aplicativo. Deixe-o vazio para usar a versão definida no arquivo visual-application.json do aplicativo.
    Se a versão já estiver implantada, cancele a implantação primeiro.
  19. Desmarque a caixa de seleção Incluir a versão do aplicativo no URL.
    Ao implantar em uma instância de produção, não inclua a versão do aplicativo no URL do aplicativo implantado.
  20. (Opcional) Em Perfil do Aplicativo, especifique o perfil do aplicativo de produção. Deixe-o vazio para usar o perfil padrão do aplicativo.

    Seu aplicativo visual acessa dados de diferentes servidores para serviços REST e pode precisar de configurações de segurança diferentes para diferentes ambientes, como desenvolvimento e produção. Usando perfis de aplicativo, você pode definir diferentes combinações de servidores e configurações de segurança para cada um dos seus ambientes e usá-los ao implantar o aplicativo em um ambiente. Isso simplifica o gerenciamento do aplicativo visual à medida que você avança do desenvolvimento para a produção. Para saber mais, consulte Sobre Perfis de Aplicativo.

  21. Para usar um banco de dados limpo para a aplicação, em Gerenciamento de Dados, selecione Usar banco de dados limpo.
  22. Clique em Salvar.

Configurar a configuração de privacidade de um trabalho de produção

Marque um job como privado para restringir quem pode ver ou editar a configuração de um job ou executar seu build.

Um job privado deve ser executado manualmente. Ele não será executado se um usuário não autorizado tentar executar o job diretamente, por meio de um trigger de SCM/periódico ou de um pipeline.
  1. No navegador esquerdo, clique em Administração de Projetos Administração do Projeto.
  2. Clique em Compilações.
  3. Clique na guia Proteção do Cargo.
  4. Na lista de jobs, selecione um job de produção.
  5. Selecione a opção Private.
  6. Em Usuários Autorizados, adicione você mesmo.
    Em seguida, para adicionar outros usuários, selecione-os individualmente ou, em Grupos, selecione um grupo (ou grupos) de usuários.
  7. Repita as etapas de 4 a 6 para o job de produção de implantação.
  8. Clique em Salvar.

Um job privado mostra um ícone Bloquear Bloquear na lista de jobs no lado direito da página Proteção de Job, na guia Jobs da página Builds e nos pipelines.

Criar e Configurar um Pipeline

Para garantir que o job de implantação de produção seja executado automaticamente após o job de empacotamento de produção, crie um pipeline e defina a dependência.

  1. No navegador esquerdo, clique em Builds Builds.
  2. Clique na guia Pipelines.
  3. Clique em + Criar Pipeline.
  4. Na caixa de diálogo Criar Pipeline, em Nome e Descrição, digite um nome e uma descrição exclusivos.
  5. Clique em Criar.
  6. Na página Configuração do Pipeline, clique com o botão direito do mouse no nó Iniciar e selecione Adicionar Novo Início jobs.
  7. Clique no campo Selecionar novo(s) job(s) bem-sucedido(s), selecione o job de empacotamento e clique em Salvar.
  8. Clique com o botão direito do mouse no job de empacotamento e selecione Adicionar e, em seguida, Adicionar Novos Jobs de Sucesso.
  9. Clique no campo Selecionar novo(s) job(s) bem-sucedido(s), selecione o job de implantação e clique em Salvar.

    Veja um exemplo do pipeline finalizado:

  10. Clique em Salvar.

Executar o Pipeline

Quando estiver pronto para implantar o aplicativo visual na instância de produção, execute o pipeline de produção.

  1. No navegador esquerdo, clique em Builds Builds.
  2. Clique na guia Pipelines.
  3. Na linha do pipeline de desenvolvimento, clique no menu Ações Ações e selecione Executar Pipeline.

Após um build bem-sucedido, você encontrará o link do aplicativo implantado na guia Implantações da página Ambientes.

Para exibir o log de build mais recente de um job, abra a página Builds, clique no nome do job e, em seguida, clique em Log de Build.