Implantação em um clique no Jitterbit App Builder
Introdução
Desde o App Builder 4.52, é possível configurar um processo semi-automatizado para implantar um app de um ambiente do App Builder (a origem) para outro (o destino). (Desde o App Builder 4.53, você pode implantar e instalar pacotes automaticamente em um único clique, marcando um ambiente de destino como padrão.)
Uma visão geral das etapas é a seguinte:
-
No ambiente de destino:
-
No ambiente de origem:
Dica
Um caso de uso típico para este recurso é simplificar a implantação de apps, por exemplo, de desenvolvimento para QA, ou de QA para produção. Nestes exemplos, origem e destino seriam os seguintes:
(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 Deployment.
O usuário do ambiente de origem (aquele que faz a implantação) precisa ter as funções Administrator ou Developer.
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:
-
Configure um usuário para realizar as implantações em um clique:
-
(Opcional) Crie um novo usuário. Se você deseja realizar as implantações em um clique usando um usuário existente, vá para a próxima etapa.
-
Acesse IDE > User Management e abra a guia Groups.
-
No painel Groups, selecione Deployment.
-
O painel Membership agora lista todos os usuários pertencentes ao grupo selecionado. Clique no botão + Membership.
-
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 tem as permissões necessárias para implantar uma versão.
-
-
Gere uma chave de API para o usuário que realizará as implantações:
-
Se você saiu da página User Management, retorne a ela acessando IDE > User Management.
-
Na guia Users, o painel Users lista todos os usuários. Localize e selecione aquele para o qual você deseja autorizar implantações.
-
Clique no ícone do usuário selecionado. A caixa de diálogo User é aberta.
-
Acesse More > Keys. A caixa de diálogo Keys é aberta.
-
Clique em Create. A caixa de diálogo Generate Key é aberta.
-
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. Certifique-se de copiar e armazenar com segurança.
-
-
(Desde o App Builder 4.68.) Associe o provedor de segurança ao serviço web do aplicativo Vinyl - Release Management, o aplicativo de sistema integrado e lacrado cuja API REST recebe solicitações de implantação em um clique neste ambiente. Um serviço web de aplicativo lacrado não pode ser reconfigurado de dentro do app, portanto isso é feito a partir de Applications:
-
Em Security Providers, no painel Security Providers, selecione More > Applications.
-
Encontre Vinyl - Release Management e clique no ícone em sua coluna Web Service. A caixa de diálogo Authentication Providers é aberta.
-
-
Clique em + Authentication. A caixa de diálogo Provider abre.
-
Selecione o provedor de segurança criado acima. Se o ambiente de destino usa um provedor HTTP com Authentication Type definido como Basic, ou um provedor Authorization Server, selecione esse. Clique em Save.
Configure o ambiente de destino
Para configurar o ambiente de destino, siga estas etapas:
-
Selecione IDE > Create Release.
-
Selecione a aba Environments.
-
Em Current Environment, clique no botão Configure.
-
Na janela pop-up, defina os valores dos 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.
-
-
Clique no botão Save:
Na origem
Configure um provedor de segurança HTTP
Para configurar um provedor de segurança HTTP no ambiente de origem, siga estas etapas:
-
Selecione IDE > Security Providers.
-
Clique no botão + Security Provider.
-
Na página Provider, configure, ative e salve um provedor do tipo HTTP (listado na seção Data Source Authentication) com Authentication Type definido como API Key.
-
Clique no botão Save. Painéis adicionais aparecem.
-
Em Endpoints, clique no botão + Credential. A janela pop-up Credential abre.
-
Defina os seguintes campos:
-
Type: API Key
-
Key: Digite a chave de API do destino, que você criou anteriormente.
-
-
Feche a janela pop-up Credential.
Configure o ambiente de origem
Para configurar o ambiente de origem, siga estas etapas:
-
Defina o ambiente atual:
-
Selecione IDE > Create Release.
-
Selecione a aba Environments.
-
Em Current Environment, clique no botão Configure.
-
Na janela pop-up, defina os valores dos 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.
-
-
Clique no botão Save.
-
-
Defina o ambiente de destino:
-
Em Target Environments, clique no botão + Target Environment.
-
Defina os valores dos 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 é selecionado.) Selecione para fazer deploy automaticamente neste ambiente, a menos que outro seja selecionado.
-
Supports Install On Deploy: Selecionado.
- Default: (Opcional, aparece quando Supports Install on Deploy é selecionado.) Selecione para instalar pacotes automaticamente durante o deployment.
-
-
Clique no botão Save e feche a janela pop-up Environment.
-
Realize uma implantação em um clique
Para usar o recurso de deploy com um clique, siga estas etapas:
-
Crie um release:
-
Selecione IDE > Create Release.
-
Selecione a aba Create a Release.
-
Clique no botão + Solution.
-
Use o assistente Solution para definir o que fazer deploy.
-
-
Compile a solução:
- Clique no botão Build para o novo template de release.
-
Implantar a versão:
-
Aguarde uma notificação do App Builder informando que a compilação foi concluída.
-
Execute um dos seguintes procedimentos:
-
Clique no botão Ver Versão da notificação. A aba Todas as Versões abre.
-
Descarte a notificação e selecione a aba Todas as Versões.
-
-
Clique no botão Implantar da solução compilada.
-
Se a opção Padrão estiver marcada para Suporta Implantação e Suporta Instalar ao Implantar no ambiente de destino, nenhuma ação adicional é necessária.
Caso contrário, prossiga com as seguintes etapas:
-
No popup Implantar Versão, abra o menu Ambiente e selecione o ambiente de destino.
-
Marque a caixa de seleção Instalar ao Implantar.
-
Clique no botão Implantar.
-
-
Confirme que uma versão foi implantada
Após realizar uma implantação com um clique, você pode confirmar que a versão foi implantada executando o seguinte:
-
Faça login no ambiente de destino.
-
Navegue até IDE > Instalar Versão.
-
Verifique se o pacote existe e foi instalado.



