Ir para o conteúdo

Implantação com um clique no Jitterbit App Builder

Introdução

A partir do App Builder 4.52, você pode configurar um processo semi-automatizado para implantar um aplicativo de um ambiente do App Builder (a origem) para outro (o destino). (A partir do App Builder 4.53, você pode implantar e instalar pacotes automaticamente com um único clique, marcando um ambiente de destino como padrão.)

Um resumo das etapas é o seguinte:

  1. No ambiente de destino:

    1. Configure uma chave de API.

    2. Configure o ambiente.

  2. No ambiente de origem:

    1. Configure um provedor de segurança HTTP.

    2. Configure o ambiente de origem.

Dica

Um caso de uso típico para esse recurso é simplificar a implantação de aplicativos, por exemplo, de desenvolvimento para QA ou de QA para produção. Nesses exemplos, a origem e o destino seriam os seguintes:

%%{init: {"themeVariables": {"lineColor": "#6b7280", "edgeLabelBackground": "#f5f5f5"}}}%% flowchart LR DEV["Development
(Source)"] --> QA1["QA
(Target)"] QA2["QA
(Source)"] --> PROD["Production
(Target)"]

Pré-requisitos

O usuário do ambiente de destino (aquele para o qual a chave de API é criada) deve ter a função Implantação.

O usuário do ambiente de origem (aquele que está fazendo a implantação) precisa de funções Administrador ou Desenvolvedor.

No destino

Configure uma chave de API

Para configurar uma chave de API no ambiente de destino, siga estas etapas:

  1. Crie um provedor de segurança de chave de API:

    1. Selecione IDE > Security Providers.

    2. Clique no botão + User Authentication.

    3. Na página Provider, configure, ative e salve um provedor com o tipo API Key:

      Provider

  2. Configure um usuário para realizar as implantações com um clique:

    1. (Opcional) Crie um novo usuário. Se você quiser realizar as implantações com um clique usando um usuário existente, prossiga para a próxima etapa.

    2. Acesse IDE > User Management e abra a aba Groups.

    3. No painel Groups, selecione Deployment.

    4. O painel Membership agora lista todos os usuários pertencentes ao grupo selecionado. Clique no botão + Membership.

    5. Use o menu suspenso para selecionar o usuário que deseja usar e clique no ícone . Esse usuário agora pertence ao grupo que tem as permissões necessárias para implantar uma versão.

  3. Gere uma chave de API para o usuário que realizará as implantações:

    1. Se você saiu da página Gerenciamento de Usuários, retorne a ela acessando IDE > User Management.

    2. Na aba Users, o painel Users lista todos os usuários. Localize e selecione aquele que deseja autorizar a realizar implantações.

    3. Clique no ícone do usuário selecionado. O diálogo User se abre.

    4. Acesse More > Keys. O diálogo Keys se abre.

    5. Clique em Create. O diálogo Generate Key se abre.

    6. No campo Provider, selecione o provedor de segurança criado acima. Clique em Save. O App Builder criará uma chave de API para o usuário.

      Aviso

      A chave de API será exibida apenas uma vez. Copie e armazene-a com segurança.

  4. (A partir do App Builder 4.68.) Associe o provedor de segurança ao serviço da web do aplicativo Vinyl - Release Management, o aplicativo de sistema integrado e selado cuja API REST recebe solicitações de implantação com um clique neste ambiente. O serviço da web de um aplicativo selado não pode ser reconfigurado de dentro do aplicativo, portanto isso é feito em Manage Applications:

    1. Em Security Providers, em User Authentication, selecione More > Manage Applications.

    2. Encontre Vinyl - Release Management e clique no ícone em sua coluna Web Service. O diálogo Authentication Providers se abre.

  5. Clique em + Authentication. A caixa de diálogo Provider abre.

  6. Selecione o provedor de segurança que você criou acima. Se o ambiente de destino usar um provedor HTTP com Authentication Type definido como Basic, ou um provedor Authorization Server, selecione esse em vez disso. Clique em Save.

Configure o ambiente de destino

Para configurar o ambiente de destino, siga estas etapas:

  1. Selecione IDE > Create Release.

  2. Selecione a aba Environments.

  3. Em Current Environment, clique no botão Configure.

  4. No popup, defina valores para os seguintes campos:

    • Name: Um nome para este ambiente de destino.

    • URL: A URL deste ambiente (de destino).

    • Authentication: Selecione a chave de API criada na seção anterior.

    • Enable Deployment: Selecionado.

    • Allow Install On Deploy: Selecionado.

  5. Clique no botão Save:

Target environment

Na origem

Configure um provedor de segurança HTTP

Para configurar um provedor de segurança HTTP no ambiente de origem, siga estas etapas:

  1. Selecione IDE > Security Providers.

  2. Clique no botão + Data Source Authentication.

  3. Na página Provider, configure, ative e salve um provedor com tipo HTTP (listado na seção Data Source Authentication) e Authentication Type definido como API Key.

  4. Clique no botão Save. Painéis adicionais aparecem.

  5. Em Endpoints, clique no botão + Credential. O popup Credential abre.

  6. Defina os seguintes campos:

    • Type: API Key

    • Key: Digite a chave de API do destino, que você criou anteriormente.

  7. Feche o popup Credential.

HTTP security provider

Configure o ambiente de origem

Para configurar o ambiente de origem, siga estas etapas:

  1. Defina o ambiente atual:

    1. Selecione IDE > Create Release.

    2. Selecione a aba Environments.

    3. Em Current Environment, clique no botão Configure.

    4. No popup, defina valores para os seguintes campos:

      • Name: Um nome para este ambiente de origem.

      • URL: A URL deste ambiente (de origem).

      • Enable Deployment: Selecionado.

      • Allow Install On Deploy: Selecionado.

    5. Clique no botão Save.

  2. Defina o ambiente de destino:

    1. Em Target Environments, clique no botão + Target Environment.

    2. Defina valores para os seguintes campos:

      • Name: Digite um nome para o ambiente de destino.

      • URL: A URL de acesso do ambiente de destino.

      • Authentication: Selecione o provedor HTTP criado na seção anterior.

      • Supports Deployment: Selecionado.

        • Default: (Opcional, aparece quando Supports Deployment está selecionado.) Selecione para implantar automaticamente neste ambiente, a menos que outro seja selecionado.

      • Supports Install On Deploy: Selecionado.

        • Default: (Opcional, aparece quando Supports Install on Deploy está selecionado.) Selecione para instalar automaticamente pacotes durante a implantação.

    3. Clique no botão Save e feche o popup Environment.

Source environment

Execute uma implantação com um clique

Para usar o recurso de implantação com um clique, siga estas etapas:

  1. Crie uma release:

    1. Selecione IDE > Create Release.

    2. Selecione a aba Create a Release.

    3. Clique no botão + Solution.

    4. Use o assistente Solution para definir o que implantar.

  2. Crie a solution:

    1. Clique no botão Build para o novo modelo de release.

  3. Implante a versão:

    1. Aguarde uma notificação do App Builder informando que a compilação foi concluída.

    2. Faça um dos seguintes:

      1. Clique no botão Ver Versão da notificação. A guia Todas as Versões será aberta.

      2. Feche a notificação e selecione a guia Todas as Versões.

    3. Clique no botão Implantar da solução compilada.

    4. Se Padrão estiver marcado para Suporta Implantação e Suporta Instalação na Implantação no ambiente de destino, nenhuma ação adicional é necessária.

      Caso contrário, continue com as etapas a seguir:

      1. Na janela pop-up Implantar Versão, abra o menu Ambiente e selecione o ambiente de destino.

      2. Marque a caixa de seleção Instalar na Implantação.

      3. Clique no botão Implantar.

Confirme que uma versão foi implantada

Após executar uma implantação com um clique, você pode verificar se a versão foi implantada seguindo estas etapas:

  1. Faça login no ambiente de destino.

  2. Navegue até IDE > Instalar Versão.

  3. Verifique se o pacote existe e foi instalado.