Transferir (migrar) um projeto para um ambiente no Jitterbit Integration Studio

Introdução

A transferência de projetos move projetos entre ambientes dentro de uma única organização Harmony. Esse recurso ajuda a promover mudanças de design ao longo do ciclo de desenvolvimento. Utilize a transferência de projetos para manter ambientes de desenvolvimento, teste e produção separados. A transferência de projetos garante a implantação controlada de mudanças.

A transferência de projetos proporciona uma implantação controlada ao mover projetos ou componentes através das etapas de desenvolvimento de forma planejada. Ela mantém o isolamento dos ambientes ao manter desenvolvimento, teste e produção separados. A transferência de projetos cria um histórico de auditoria para rastrear o histórico de transferências para conformidade.

Você pode usar a transferência de projetos para realizar o seguinte:

• Mover projetos ou componentes entre ambientes na mesma organização.
• Promover mudanças através das etapas de desenvolvimento.
• Manter configurações específicas do ambiente.
• Preservar o histórico de transferências e dependências.

Você pode transferir projetos usando uma dessas duas opções:

1. Transferência de projeto completo: Transfira o projeto inteiro para um ambiente. (Essa opção aparece como Migrar na interface atual.)

2. Transferência seletiva (Beta): Transfira apenas componentes especificados para um ambiente.

A tabela a seguir compara os principais recursos de cada opção de transferência:

Pré-requisitos

Antes de transferir um projeto ou componente de projeto, complete estes requisitos:

• Certifique-se de ter o acesso apropriado em ambos os ambientes de origem e destino.

• Verifique se o ambiente de destino possui o tipo de agente necessário (nuvem ou privado) se estiver usando recursos que são limitados a um determinado tipo de agente.

Cadeias de transferência

Uma cadeia de transferência é uma sequência vinculada de ambientes pelos quais um projeto se move durante seu ciclo de vida. Uma vez estabelecidas, essas cadeias criam dependências que você deve gerenciar com cuidado.

Fluxo de transferência típico

Um fluxo de trabalho típico envolve estas etapas:

[Desenvolvimento] → [QA/Teste] → [Produção]
     ↓               ↓               ↓
  (Criar)      (Testar/Corrigir)      (Entrar em Produção)

1. Crie um projeto em um ambiente de desenvolvimento.
2. Transfira para um ambiente de QA (Garantia de Qualidade) para testes.
3. Corrija quaisquer problemas no ambiente de desenvolvimento.
4. Transfira novamente para o ambiente de QA para reteste.
5. Transfira do QA para produção quando estiver pronto.
6. Repita as etapas 3-5 para alterações contínuas.

As transferências de projetos são baseadas em IDs internos, não em nomes, portanto, projetos renomeados mantêm suas relações de transferência.

Dependências de Cadeia

A transferência de projetos cria essas dependências permanentes entre projetos:

• Projetos não podem ser excluídos se existirem projetos dependentes a jusante.

• Cadeias não podem ser quebradas sem excluir projetos a jusante.

• Renomear projetos não afeta as relações de cadeia.

Um projeto transferido tem uma dependência do projeto de onde foi transferido. Você não pode excluir um projeto no início de uma cadeia de transferência até que todos os projetos mais abaixo na cadeia sejam excluídos. Para mais informações, veja Excluir um projeto em Criação e configuração de projetos.

Você só pode quebrar uma cadeia de transferência excluindo projetos mais abaixo na cadeia ou exportando e importando o projeto. Para mais informações, veja Exportações e importações de projetos. Renomear um projeto transferido não quebra a cadeia.

Melhores práticas

Recomendamos estas melhores práticas ao projetar uma cadeia de transferência:

• Faça alterações de design apenas no primeiro ambiente da cadeia. No exemplo de fluxo de transferência típico, este é o ambiente de desenvolvimento. Em ambientes posteriores, recomendamos que você apenas altere os valores das variáveis do projeto. Faça essas alterações dentro do aplicativo Integration Studio para que apareçam no histórico do projeto. Alterações nos valores das variáveis do projeto feitas a partir da página Projetos do Console de Gerenciamento não aparecem no histórico do projeto. Durante a transferência do projeto, você pode selecionar se deseja transferir todos os valores das variáveis do projeto ou apenas valores de variáveis de projeto selecionados (descrito na próxima seção).

• Torne o primeiro ambiente da cadeia acessível àqueles que podem precisar fazer alterações no projeto ao longo do tempo. Recomendamos que não haja um único desenvolvedor projetando o projeto em uma organização pessoal. Se isso acontecer, primeiro exporte o projeto original e, em seguida, importe-o para o ambiente que iniciará a cadeia. Faça futuras alterações no projeto no ambiente que inicia a cadeia.

Transferência de projeto

Você pode transferir projetos usando uma dessas duas opções:

1. Transferência completa de projeto: Transfira o projeto inteiro para um ambiente. (Esta opção aparece como Migrar na interface atual.)
2. Transferência seletiva (Beta): Transfira apenas componentes especificados para um ambiente.

Transferir um projeto completo

Quando você transfere um projeto completo usando a opção Migrar, todos os componentes do projeto e os metadados do projeto são transferidos.

A opção Migrar está acessível a partir destes locais:

• A barra de ferramentas do projeto. Para mais informações, veja o menu de ações do projeto na barra de ferramentas do projeto.
• A tela de design. Para mais informações, veja o menu de ações de implantar/migrar na tela de design.

Quando você seleciona Migrar, uma tela de configuração é aberta. Você pode escolher o ambiente de destino e se deseja transferir os valores das variáveis do projeto:

• Organização e Projeto: A organização Harmony onde o projeto reside e o nome do projeto a ser transferido, separados por uma vírgula.

• Ambiente atual e Ambiente de destino: O ambiente atual onde o projeto reside e o ambiente de destino para onde o projeto será transferido são listados junto com seu tipo de grupo de agente associado (agente em nuvem ou agente privado).

  Quando o projeto é transferido, o projeto existente no ambiente atual permanece inalterado. Se o projeto já foi transferido para o ambiente de destino, o projeto do ambiente de destino é sobrescrito usando as seleções para os valores das variáveis do projeto abaixo.

  Cuidado

  Se o projeto de origem usar conectores que estão disponíveis apenas em agentes privados, você não pode transferi-lo para um ambiente associado a um grupo de agentes em nuvem. Esses ambientes ainda aparecem no dropdown de Ambiente de Destino, mas não podem ser selecionados.

• Nome da tag de histórico do projeto: Insira uma tag para rotular o evento de transferência. A tag aparece como um rótulo no evento de transferência e é registrada nos detalhes da implantação acessíveis a partir do histórico do projeto. Recomenda-se inserir uma tag única, mas não é obrigatório.

• Endpoints Globais: Quaisquer endpoints globais usados pelo projeto sendo transferido que não existem no ambiente de destino são listados. Quando o projeto é transferido, o endpoint global é adicionado a esse ambiente e precisa de configuração após a transferência.

• Migrar todos os valores das variáveis: Selecione esta opção para transferir todos os valores das variáveis do projeto. Se o projeto já existir no ambiente de destino, os valores de todas as variáveis do projeto serão sobrescritos. Na primeira vez que um projeto é transferido, esta opção é selecionada por padrão. Transferências posteriores padrão para Selecionar valores das variáveis para migrar.

• Selecionar valores de variáveis para migrar: Selecione esta opção para transferir todos os componentes do projeto e os metadados do projeto, exceto pelos valores das variáveis do projeto listadas em Excluir. Se o projeto já existir no ambiente de destino, todos os componentes do projeto, incluindo os valores das variáveis do projeto listadas em Incluir, serão sobrescritos.

  Quando Selecionar valores de variáveis para migrar é selecionado, nenhuma variável do projeto é selecionada para transferência por padrão, a menos que o projeto já exista no ambiente de destino. Quando o projeto já foi transferido, variáveis do projeto recém-adicionadas ou renomeadas são selecionadas para transferência por padrão, mas variáveis cujos valores foram alterados são excluídas.

  • Pesquisar: Digite qualquer parte do nome de uma variável do projeto para filtrar a lista de variáveis do projeto no ambiente atual.
  • Ambiente atual: Selecione variáveis do projeto cujos valores você deseja transferir para o ambiente de destino. À medida que você seleciona variáveis do projeto, elas aparecem em Incluir. Os links Selecionar tudo e Desmarcar tudo adicionam ou removem todas as seleções de variáveis do projeto de uma vez.
  • Excluir: Variáveis do projeto cujos valores são excluídos da transferência. Se o projeto já existir no ambiente de destino e já contiver a variável do projeto, seu valor existente no ambiente de destino é mantido. Se a variável do projeto não existir, então o componente da variável do projeto é transferido, mas não recebe nenhum valor.
  • Incluir: Variáveis do projeto cujos valores estão incluídos na transferência. Se o projeto já existir no ambiente de destino e já contiver a variável do projeto, seu valor existente no ambiente de destino é sobrescrito.

• Migrar: Clique para transferir o projeto para o ambiente selecionado. Se o projeto já foi transferido para o ambiente de destino, uma mensagem pede que você confirme que deseja transferir. Esta transferência sobrescreve o projeto existente no ambiente de destino usando as seleções para os valores das variáveis do projeto acima.

  Texto do diálogo

  Confirmar Migração
  Um projeto com o mesmo nome no ambiente de destino já existe. Você tem certeza de que deseja sobrescrevê-lo?

  Quando você clicar em Continuar, se a transferência para o ambiente de destino for bem-sucedida, o projeto transferido será aberto no designer de projetos.

Transferir componentes de um projeto (Beta)

A transferência seletiva permite que você transfira apenas componentes especificados de um projeto. Esse recurso ajuda a evitar interferir no trabalho que outros colaboradores estão realizando no mesmo projeto e ambiente. Use a transferência seletiva quando quiser promover suas alterações sem sobrescrever o trabalho de outros usuários no ambiente de destino.

Para transferir apenas componentes especificados de um projeto, use o menu de ações do projeto ou o menu de ações da operação em um projeto e clique em Transferência Seletiva:

Na tela de configuração, você seleciona o ambiente de destino e os componentes a serem transferidos:

Seleção de componentes

Você pode selecionar componentes individuais com base em suas necessidades. Quando você seleciona componentes para transferir, o sistema inclui automaticamente as dependências necessárias, exceto por cronogramas. Você deve selecionar manualmente os cronogramas se quiser transferi-los.

O sistema agrupa componentes com base em seu status nos ambientes de origem e destino:

• Criar: Componentes que existem no projeto de origem, mas não no projeto de destino. Quando selecionados, esses componentes são criados no projeto de destino.

• Sobrescrever: Componentes que existem em ambos os projetos, mas têm conteúdo diferente com base na data da última modificação e na comparação de usuários. Quando selecionados, esses componentes são sobrescritos no projeto de destino.

• Excluir: Componentes que existem no projeto de destino, mas não no projeto de origem. Quando selecionados, esses componentes são removidos do projeto de destino.

• Inalterado: Componentes que existem em ambos os projetos e têm o mesmo conteúdo com base na data da última modificação e na comparação de usuários. Esses componentes não podem ser selecionados.

Você pode selecionar ou desmarcar componentes nas categorias Criar, Sobrescrever e Excluir para configurar sua transferência.

Opções de configuração

• Ambiente de destino: Escolha o ambiente onde deseja transferir os componentes selecionados.

  Aviso

  Se um projeto não relacionado com o mesmo nome já existir no ambiente de destino (não faz parte da cadeia de transferência), a transferência não pode prosseguir. Você verá uma tela vazia. Nesse caso, deve renomear um dos projetos antes de tentar a transferência.

• Nome da tag de histórico do projeto: Insira uma tag para rotular o evento de transferência para rastreamento no histórico do projeto. Em transferências subsequentes, os componentes são exibidos com o nome da tag de histórico do projeto. Isso ajuda a identificar de qual versão cada componente veio ao decidir se deve sobrescrever durante transferências futuras.

• Endpoints globais: Endpoints globais que não estão no ambiente de destino são adicionados automaticamente durante a transferência. As mesmas configurações do ambiente atual são utilizadas.

• Variáveis do projeto e Incluir valores: Quando você seleciona uma variável do projeto para incluir na transferência, pode decidir quais valores de variáveis do projeto incluir ou excluir da transferência usando a caixa de seleção Incluir valor. Suas seleções são salvas para transferências futuras para o mesmo ambiente de destino.

• Mostrar: Mostrar dados ocultos para Última Modificação. Clique para exibir essas informações.

• Ocultar: Ocultar dados visíveis para Última Modificação. Clique para ocultar essas informações.

• Transferir: Iniciar o processo de transferência com os componentes e a configuração selecionados. Quando a transferência estiver completa, um diálogo de confirmação aparecerá com a opção de abrir o projeto no ambiente de destino.

• Cancelar: Cancelar a transferência e retornar ao projeto.