Integração com o DevOps

Escrito para a interface antiga

Este artigo foi escrito para a interface antiga. As instruções ainda podem ser usadas, mas as capturas de tela estão desatualizadas. Em alguns casos, os itens referenciados nas instruções foram movidos ou alterados. Se você não conseguir encontrar um item, consulte o Para onde foi artigo.

Visão geral

Quando o aplicativo DevOps é aberto pela primeira vez, o Flosum inicia automaticamente o guia de onboarding. O guia continua aparecendo até que você o pule ou conclua, e, depois de pulado ou concluído, ele não pode ser executado novamente. O onboarding apresenta o DevOps orientando você pelas principais tarefas de configuração necessárias para começar, desde conectar suas orgs Salesforce até executar sua primeira implantação. Cada etapa inclui instruções guiadas e contexto, para que você possa concluir o processo em uma única sessão estruturada, sem experiência prévia em DevOps. Este artigo fornece informações e ajuda para cada etapa do processo de onboarding.

Antes de iniciar o processo de onboarding, certifique-se de que você tem acesso a duas orgs Salesforce e pode fazer alterações em pelo menos uma. Durante o processo de onboarding, você vai recuperar componentes de uma org e implantar uma seleção desses componentes na outra org. Para informações sobre os requisitos para conectar uma org Salesforce ao DevOps, consulte o artigo a seguir.

O diagrama abaixo fornece uma visão geral visual do processo de onboarding, mostrando cada etapa que você concluirá e a ordem em que elas ocorrem.

Pular onboarding

Você não é obrigado a concluir o processo de onboarding antes de usar o DevOps, e não perderá nenhuma funcionalidade. Você pode pular o processo de onboarding a qualquer momento.

1. Clique em pular onboarding no canto inferior esquerdo da tela.

   

Etapas do onboarding

O processo de onboarding do DevOps orienta você na configuração do DevOps e na implantação de componentes em uma org Salesforce. Este guia fornece informações úteis para dar suporte ao onboarding e inclui capturas de tela de exemplo para cada etapa concluída.

1

Qual é a sua função

Esta etapa permite que você selecione a função que melhor corresponde ao seu cargo atual. A função que você selecionar não afeta o onboarding nem a funcionalidade do DevOps. O Flosum usa sua resposta para análises internas a fim de melhorar o aplicativo DevOps, e isso não inclui informações de identificação pessoal.

1. Selecione uma das funções que melhor corresponde à sua.
2. Clique em Próximo.

2

Qual é o seu objetivo ao usar o DevOps

Esta etapa permite que você descreva o que espera alcançar com o DevOps. O que você escrever não afeta o onboarding nem a funcionalidade do DevOps. O Flosum usa sua resposta para análises internas a fim de melhorar o aplicativo DevOps, e isso não inclui informações de identificação pessoal.

1. Digite os objetivos de DevOps que você quer alcançar.
2. Clique em Próximo.

3

Conecte sua org Salesforce de origem

Esta etapa conecta uma de suas orgs Salesforce ao DevOps. A org Salesforce à qual você se conectar será usada como a Organização de origem branch de origem durante o processo de onboarding. Isso significa que você adicionará componentes desta organização a uma branch que será implantada em uma organização de destino.

Criar conexão

1. Em Nome da organização caixa de texto, insira um nome descritivo para a org do Salesforce à qual você está se conectando.
2. Clique na Ambiente menu suspenso e selecione o tipo de ambiente para esta organização.

A seleção de Ambiente ajuda você a identificar o uso principal da organização, mas não restringe como ela pode ser usada. Abaixo está uma descrição geral de cada ambiente.

• Desenv.: Onde os desenvolvedores criam e testam novos recursos.
• Prod: O ambiente em produção usado por clientes reais.
• Teste: Para validar alterações antes da liberação.
• QA: Para testes estruturados e aprovação de liberação.

1. Selecione o Tipo de organização para a org do Salesforce à qual você está se conectando: Produção ou Sandbox.
2. Clique em Conectar.

Faça login no Salesforce

Ao conectar uma org do Salesforce, recomenda-se usar um usuário dedicado. Para obter mais informações sobre como criar um usuário dedicado, consulte o artigo a seguir.

Criando um usuário dedicado do Salesforce

1. Você será direcionado para uma tela de login do Salesforce.
2. Em Nome de usuário caixa de texto, insira o nome de usuário de um usuário com privilégios de Administrador na org do Salesforce à qual você está se conectando.
3. Em Senha caixa de texto, insira a senha do usuário do Salesforce.
4. Clique em Entrar.
5. Se o Salesforce solicitar que você Permitir acesso ao Flosum:

   1. Revise os itens listados na solicitação de acesso.
   2. Clique em Permitir.

Concluir

Se você precisar usar uma organização diferente ou alterar as informações de login:

• Clique na Lixeira ícone para excluir a organização.
• Repita a Conectar organização de origem etapa.

1. Depois de conectado com sucesso, você verá a organização listada em Organização conectada.
2. Clique em Próximo.

   

4

Conecte sua org Salesforce de destino

Esta etapa conecta outra de suas orgs Salesforce ao DevOps. A org Salesforce à qual você se conectar será usada como a Organização de destino organização de destino durante o processo de onboarding. Isso significa que você implantará componentes de uma branch nessa organização.

Criar conexão

1. Em Nome da organização caixa de texto, insira um nome descritivo para a org do Salesforce à qual você está se conectando.
2. Clique na Ambiente menu suspenso e selecione o tipo de ambiente para esta organização.

A seleção de Ambiente ajuda você a identificar o uso principal da organização, mas não restringe como ela pode ser usada. Abaixo está uma descrição geral de cada ambiente.

• Desenv.: Onde os desenvolvedores criam e testam novos recursos.
• Prod: O ambiente em produção usado por clientes reais.
• Teste: Para validar alterações antes da liberação.
• QA: Para testes estruturados e aprovação de liberação.

1. Selecione o Tipo de organização para a org do Salesforce à qual você está se conectando: Produção ou Sandbox.
2. Clique em Conectar.

Faça login no Salesforce

Ao conectar uma org do Salesforce, recomenda-se usar um usuário dedicado. Para obter mais informações sobre como criar um usuário dedicado, consulte o artigo a seguir.

Criando um usuário dedicado do Salesforce

1. Você será direcionado para uma tela de login do Salesforce.
2. Em Nome de usuário caixa de texto, insira o nome de usuário de um usuário com privilégios de Administrador na org do Salesforce à qual você está se conectando.
3. Em Senha caixa de texto, insira a senha do usuário do Salesforce.
4. Clique em Entrar.
5. Se o Salesforce solicitar que você Permitir acesso ao Flosum:

   1. Revise os itens listados na solicitação de acesso.
   2. Clique em Permitir.

Concluir

Se você precisar usar uma organização diferente ou alterar as informações de login:

• Clique na Lixeira ícone para excluir a organização.
• Repita a Conectar organização de destino etapa.

1. Depois de conectado com sucesso, você verá a organização listada em Organização conectada.
2. Clique em Próximo.

   

5

Convide sua equipe

Esta etapa permite que você crie contas de usuário do Flosum Cloud Apps para seus colegas de equipe, para que eles possam usar o DevOps. Todos os usuários adicionados nesta etapa receberão um e-mail de convite com instruções de login e uma senha temporária.

O usuário que você criar nesta etapa terá a função de Administrador do Sistema. Mais tarde, você poderá alterar a função do usuário e adicionar mais usuários em Configurações Globais. Para saber mais sobre o gerenciamento de usuários no Flosum Cloud Apps, consulte o artigo a seguir.

• Visão geral de funções, grupos e usuários

A E-mail endereço de qualquer usuário adicionado nesta etapa deve ser um ao qual ele possa acessar, para que receba as instruções de login e uma senha temporária.

Adicionar usuário sugerido

Por conveniência, o processo de onboarding verifica as orgs Salesforce conectadas nas etapas anteriores e sugere usuários para os quais você talvez queira criar contas.

1. Navegue ou pesquise na Sugestões tabela para adicionar usuários.
2. Clique na Adicionar botão à direita de qualquer usuário para criar uma conta para ele.

Adicionar quaisquer usuários

1. Clique em Adicionar colega de equipe para adicionar uma nova linha de usuário.
2. Digite o Nome, Sobrenome nome, e E-mail.

Concluir

Depois que todos os usuários forem adicionados:

1. Clique em Convidar.
2. O processo de onboarding criará as contas e enviará e-mails de convite.

6

Criar uma nova branch

Esta etapa cria uma nova branch para a sua base de código. Nas etapas a seguir, você adicionará componentes da sua organização de origem a esta branch e depois implantará a branch na sua organização de destino.

1. Na Nome da nova branch caixa de texto, digite um nome descritivo. Siga as diretrizes de nomenclatura de branches da sua equipe.
2. Na Branch de origem menu suspenso, a única opção é main. Todos os tenants do DevOps começam com apenas a branch principal. Mais tarde, você pode criar branches adicionais e selecionar uma branch existente como origem.
3. Clique em Criar.

7

Recuperar

Esta etapa recupera metadados da sua Organização de origem, permitindo que você selecione o que incluir na sua branch nas etapas a seguir. Para acelerar a recuperação, apenas componentes ApexClass, ApexTrigger, CustomObject, CustomField, RecordType e FieldSet são recuperados; esse processo pode levar alguns minutos.

Esse processo pode levar alguns minutos, dependendo do número de componentes recuperados. Em trabalhos de recuperação grandes, o status pode ser atualizado para Parcialmente concluído, momento em que você pode prosseguir para a próxima etapa. No entanto, se o componente que você quer adicionar à sua branch ainda não tiver sido recuperado, você deve aguardar até que o status do trabalho de recuperação seja atualizado para Concluído.

1. Aguarde a conclusão deste trabalho.
2. Clique em Próximo.

Se forem encontrados problemas durante a recuperação, não é recomendável que você prossiga com o onboarding.

1. Clique em pular onboarding no canto inferior esquerdo.

8

Componentes recuperados

Esta etapa exibe os componentes que o DevOps recuperou da sua Organização de origem. Nenhuma ação é necessária nesta etapa. Você pode navegar, filtrar e pesquisar a lista de componentes para revisar o que foi recuperado. Clique em qualquer componente para ver seu conteúdo.

Como o processo de onboarding não recupera todos os componentes, talvez você não veja todos os componentes da sua org Salesforce. Após a conclusão do onboarding, execute uma recuperação completa para obter os componentes restantes.

1. Clique em Próximo.

9

Fazer commit dos metadados na sua branch

Esta etapa faz commit dos componentes selecionados na branch que você criou em uma etapa anterior. Você pode selecionar qualquer componente disponível para adicionar à branch. Esses componentes serão posteriormente implantados na sua branch de destino. Como uma org Salesforce típica tem milhares de componentes, é recomendável usar os recursos de pesquisa e filtro para encontrar os componentes que você deseja adicionar. A captura de tela abaixo demonstra a adição de um único componente à branch.

1. Pesquise e filtre para encontrar o componente que você quer adicionar.

   1. Use a Pesquisa caixa para pesquisar componentes pelo nome.
   2. Clique na Selecionar tipo menu suspenso para filtrar a lista de componentes por tipo.
2. Clique em Adicionar ao lado do componente que você quer adicionar à branch.
3. Repita este processo para adicionar todos os componentes que você quer incluir neste commit.
4. Depois de adicionar todos os componentes, digite uma mensagem de commit na mensagem de commit caixa de texto.
5. Clique em Commit.

A Adicionar tudo botão adiciona todos os componentes listados, incluindo os componentes em outras páginas da lista. Se você usar o Adicionar tudo botão, certifique-se de ter pesquisado e filtrado a lista cuidadosamente e verificado que não há componentes indesejados.

10

Commit

Esta etapa exibe o log do trabalho de commit, permitindo que você acompanhe o progresso do trabalho enquanto suas alterações são confirmadas na branch.

1. Aguarde a conclusão do trabalho de commit.
2. Clique em Próximo.

11

Componentes em commit

Esta etapa permite que você visualize os componentes confirmados na branch. Esses componentes serão posteriormente implantados na organização de destino. Você pode pesquisar e filtrar componentes. Clique em qualquer componente para ver seu conteúdo.

1. Revise os componentes na sua branch.
2. Clique em Próximo.

12

Correção pré-implantação

Esta etapa permite que você execute uma Correção pré-implantação para validar se os componentes na sua branch podem ser implantados na organização de destino. Durante o onboarding, o trabalho de Correção pré-implantação verifica apenas dependências ausentes e não permite que você as resolva. Esta etapa é opcional e pode ser pulada.

Se forem encontrados problemas, resolva-os fora do processo de onboarding. Como a etapa de Correção pré-implantação não é crítica, você pode continuar o onboarding e resolver os problemas depois de concluir. O artigo a seguir explica em detalhes o processo para resolver os problemas identificados por este trabalho.

• Usando o PreDeploy Fix da branch

1. Clique em Executar correção pré-implantação.
2. Aguarde a conclusão do trabalho de Correção pré-implantação.
3. Clique em Ver resultados para revisar os resultados.
4. Depois de revisar os resultados, clique em Próximo.

   

13

Validar

Esta etapa permite que você execute um trabalho de Validação para confirmar que os componentes na sua branch podem ser implantados na sua organização de destino. A validação verifica a compatibilidade dos metadados, confirma as dependências e executa testes Apex quando necessário, mas não faz alterações na organização de destino. Validar antes da implantação ajuda você a identificar e corrigir problemas antecipadamente, reduzindo falhas de implantação. Esta etapa é opcional e pode ser pulada.

Se a validação encontrar problemas, você pode prosseguir com o onboarding e ainda implantar a branch. Depois que a implantação for concluída, você poderá reverter no próximo passo do onboarding.

1. Clique em Executar validação.
2. Aguarde a conclusão do trabalho de Validação.
3. Clique em Próximo.

   

A próxima etapa inicia automaticamente o Implantar trabalho, implantando os componentes da branch na organização de destino.

14

Implantar

Esta etapa implanta os componentes na sua branch na Organização de destino. O trabalho de implantação começa automaticamente e pode levar vários minutos. Após a implantação, o trabalho executa testes padrão para verificar se a implantação foi bem-sucedida. Na próxima etapa, você pode desfazer a implantação revertendo as alterações na organização de destino.

1. Aguarde a conclusão do trabalho de implantação.
2. Clique em Próximo.

   

15

Reversão

Esta etapa permite que você reverta as alterações implantadas na sua organização de destino na etapa anterior. O trabalho de reversão pode levar vários minutos e usa um snapshot pré-implantação para reverter as alterações na organização e restaurar os componentes ao estado anterior. Esta etapa é opcional, mas útil se houver erros durante a implantação ou se você não quiser implantar a branch nessa organização.

1. Clique em Executar rollback.
2. Aguarde a conclusão do trabalho de rollback.
3. Clique em Próximo.

   

16

Está tudo pronto

Você concluiu o processo de onboarding do DevOps. Esta etapa fornece uma visão geral rápida do que você alcançou durante o onboarding.

1. Clique em Próximo.

17

Explore recursos mais poderosos

Há muitos outros recursos além do que você configurou durante o onboarding. Esta etapa fornece uma prévia dos recursos avançados e fluxos de trabalho no Flosum Cloud DevOps. Para saber mais sobre qualquer um desses recursos, siga os links abaixo.

Solicitações de Pull Request	Visão geral das solicitações de pull
Integração com Jira	Visão geral da integração com o Jira
Suporte a Git	Visão geral das integrações com Git
Pipelines	Visão geral dos pipelines
Mesclagem Inteligente	Usando o Smart Merge

1. Clique em Explorar o DevOps.
2. Agora você concluiu o onboarding e tem acesso ao aplicativo DevOps completo.