Implantação com um clique no Jitterbit App Builder

Introdução

Desde o App Builder 4.52, é possível configurar um processo semi-automatizado para implantar um aplicativo de um ambiente do App Builder (a origem) para outro (o destino). (Desde o App Builder 4.53, é possível implantar e instalar pacotes automaticamente com um único clique, marcando um ambiente de destino como padrão.)

Uma visão geral dos passos é a seguinte:

No ambiente de destino:
1. Configure uma chave de API.
2. Configure o ambiente.
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 é agilizar a implantação de aplicativos, de, por exemplo, desenvolvimento para QA, ou de QA para produção. Nesses exemplos, a origem e o destino seriam os seguintes:

flowchart LR DEV["Desenvolvimento
(Origem)"] --> QA1["QA
(Destino)"] QA2["QA
(Origem)"] --> PROD["Produção
(Destino)"]

Pré-requisitos

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

O usuário do ambiente de origem (aquele que está realizando a implantação) precisa ter os papéis de Administrador ou Desenvolvedor.

No destino

Configure uma chave de API

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

Crie um provedor de segurança de chave de API:
1. Selecione IDE > Provedores de Segurança.
2. Clique no botão + Autenticação de Usuário.
3. Na página Provedor, configure, habilite e salve um provedor com o tipo Chave de API:
Configure um usuário para realizar as implantações com um clique:
1. (Opcional) Criar um novo usuário. Se você deseja realizar as implantações com um clique usando um usuário existente, vá para o próximo passo.
2. Vá para IDE > Gerenciamento de Usuários e abra a aba Grupos.
3. No painel Grupos, selecione Implantação.
4. O painel Membros agora lista todos os usuários pertencentes ao grupo que você selecionou. Clique no botão + Membro.
5. Use o menu suspenso para selecionar o usuário que você deseja usar e clique no ícone . Esse usuário agora pertence ao grupo que possui as permissões necessárias para implantar uma versão.
Gere uma chave de API para o usuário que realizará as implantações:
1. Se você saiu da página de Gerenciamento de Usuários, retorne a ela indo para IDE > Gerenciamento de Usuários.
2. Na aba Usuários, o painel Usuários lista todos os usuários. Localize e selecione aquele que você deseja autorizar a realizar implantações.
3. Clique no ícone para o usuário que você selecionou. O diálogo Usuário se abre.
4. Vá para Mais > Chaves. O diálogo Chaves se abre.
5. Clique em Criar. O diálogo Gerar Chave se abre.
6. No campo Provedor, selecione o provedor de segurança que você criou acima. Clique em Salvar. O App Builder criará uma chave de API para o usuário.
  
  Aviso
  
  A chave de API será exibida apenas uma vez. Certifique-se de copiá-la e armazená-la com segurança.

Configurar o ambiente de destino

Para configurar o ambiente de destino, siga estas etapas:

Selecione IDE > Criar Versão.
Selecione a aba Ambientes.
Em Ambiente Atual, clique no botão Configurar.
Na janela pop-up, defina valores para os seguintes campos:
- Nome: Um nome para este ambiente de destino.
- URL: A URL deste ambiente (de destino).
- Autenticação: Selecione a chave de API criada na seção anterior.
- Habilitar Implantação: Selecionado.
- Permitir Instalação na Implantação: Selecionado.
Clique no botão Salvar:

Na fonte

Configurar um provedor de segurança HTTP

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

Selecione IDE > Provedores de Segurança.
Clique no botão + Autenticação de Fonte de Dados.
Na página Provedor, configure, habilite e salve um provedor com tipo HTTP (listado na seção Autenticação de Fonte de Dados), e Tipo de Autenticação definido como Chave de API.
Clique no botão Salvar. Painéis adicionais aparecem.
Em Endpoints, clique no botão + Credencial. O popup Credencial é aberto.
Defina os seguintes campos:
- Tipo: Chave de API
- Chave: Insira a chave de API do destino, que você criou anteriormente.
Feche o popup Credencial.

Configurar o ambiente de origem

Para configurar o ambiente de origem, siga estas etapas:

Defina o ambiente atual:
1. Selecione IDE > Criar Lançamento.
2. Selecione a aba Ambientes.
3. Em Ambiente Atual, clique no botão Configurar.
4. No popup, defina valores para os seguintes campos:
  - Nome: Um nome para este ambiente de origem.
  - URL: A URL deste ambiente (de origem).
  - Habilitar Implantação: Selecionado.
  - Permitir Instalação na Implantação: Selecionado.
5. Clique no botão Salvar.
Defina o ambiente de destino:
1. Em Ambientes de Destino, clique no botão + Ambiente de Destino.
2. Defina valores para os seguintes campos:
  - Nome: Insira um nome para o ambiente de destino.
  - URL: O URL de acesso do ambiente de destino.
  - Autenticação: Selecione o provedor HTTP criado na seção anterior.
  - Suporta Implantação: Selecionado.
    - Padrão: (Opcional, aparece quando Suporta Implantação está selecionado.) Selecione para implantar automaticamente neste ambiente, a menos que outro seja selecionado.
  - Suporta Instalação na Implantação: Selecionado.
    - Padrão: (Opcional, aparece quando Suporta Instalação na Implantação está selecionado.) Selecione para instalar automaticamente pacotes durante a implantação.
3. Clique no botão Salvar, e depois feche o popup Ambiente.

Realizar uma implantação com um clique

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

Crie uma versão:
1. Selecione IDE > Criar Versão.
2. Selecione a aba Criar uma Versão.
3. Clique no botão + Solução.
4. Use o assistente Solução para definir o que implantar.
Construa a solução:
1. Clique no botão Construir para o novo modelo de versão.
Implemente a versão:
1. Aguarde uma notificação do App Builder informando que a construção está completa.
2. Faça uma das seguintes ações:
  1. Clique no botão Ver Versão da notificação. A aba Todas as Versões é aberta.
  2. Descarte a notificação e, em seguida, selecione a aba Todas as Versões.
3. Clique no botão Implantar para a solução construída.
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 seguintes etapas:
  1. No popup Implantar Versão, abra o menu Ambiente e selecione o ambiente de destino.
  2. Selecione a caixa de seleção Instalar na Implantação.
  3. Clique no botão Implantar.

Confirmar que uma versão foi implantada

Após realizar uma implantação com um clique, você pode garantir que a versão foi implantada fazendo o seguinte:

Faça login no ambiente de destino.
Navegue até IDE > Instalar Versão.
Verifique se o pacote existe e foi instalado.