Configurar ferramentas do Salesforce DX

O Salesforce DX adiciona ferramentas que simplificam todo o ciclo de vida de desenvolvimento. Ele melhora o desenvolvimento e a colaboração da equipe, permite a realização de testes automatizados e integração contínua, além de tornar o ciclo de lançamentos mais eficiente e ágil.

No entanto, o Salesforce DX é muito mais do que apenas um conjunto de ferramentas! Ele oferece uma alternativa ao desenvolvimento de conjuntos de alterações e transfere a fonte da verdade da organização para seu sistema de controle de versão (VCS). Ele transfere o foco do desenvolvimento da organização para o desenvolvimento com pacotes. Para saber como migrar seus processos de desenvolvimento existentes para o modelo de desenvolvimento com pacotes, acesse o módulo Modelo de desenvolvimento com pacotes.

Agora vamos ao que interessa. Você está pronto para começar a colocar a mão na massa? Vamos começar pela configuração do seu ambiente e apresentar algumas ferramentas.

Muitas ferramentas do Salesforce DX permitem que você use um tipo de organização chamado organização temporária. Uma organização temporária é um ambiente dedicado, configurável e de curto prazo do Salesforce. As organizações temporárias aumentam a produtividade e a colaboração do desenvolvedor durante o processo de desenvolvimento e permitem a realização de testes automatizados e integração contínua. Use extensões ou a Salesforce CLI no VS Code para abrir sua organização temporária em um navegador sem precisar fazer login. Você pode criar uma nova organização temporária quando quiser:

• Iniciar um novo projeto.
• Iniciar uma nova ramificação de recursos.
• Testar um novo recurso.
• Iniciar testes automatizados.
• Realizar tarefas de desenvolvimento diretamente em uma organização.
• Começar do “zero” com uma nova organização.

Embora as organizações temporárias sejam descartáveis, os arquivos de configuração da organização temporária é que realmente importam. Pelo arquivo de configuração, você pode configurar a organização temporária com diferentes edições do Salesforce usando apenas os recursos e preferências desejados. Além disso, você pode compartilhar o arquivo de configuração da organização temporária com outros membros da equipe. Dessa forma, todos têm a mesma organização básica para realizar o desenvolvimento.

O Dev Hub permite que você e sua equipe criem e gerenciem organizações temporárias. As organizações temporárias são ambientes temporários do Salesforce onde você faz a maior parte do seu trabalho de desenvolvimento no paradigma de desenvolvimento orientado por origem.

Para começar a usar organizações temporárias, escolha uma organização para ser seu Dev Hub. Embora você possa habilitar o Dev Hub em qualquer organização paga, o ideal mesmo é praticar em outro lugar que não seja na produção. Por isso, habilite o Dev Hub em uma organização Developer Edition ou Trailhead Playground para usar com o módulo. Use seus Trailhead Playgrounds existentes ou crie um novo clicando na sua imagem de perfil e, em seguida, selecionando Hands-On Orgs (Organizações práticas).

1. Faça login na organização que você escolheu para ser seu Dev Hub.
2. Em Setup (Configuração), insira Dev Hub na caixa Busca rápida e selecione Dev Hub.
3. Clique no botão para habilitar o Dev Hub.

Você também pode transformar qualquer organização paga em Dev Hub e conceder acesso aos desenvolvedores. Veja os detalhes no Guia do desenvolvedor do Salesforce DX.

Agora que você tem uma organização do Dev Hub, vamos configurar as demais ferramentas do Salesforce DX.

Use a Salesforce CLI para controlar todo o ciclo de vida dos aplicativos. Crie facilmente ambientes para desenvolvimento e teste, sincronize o código-fonte entre suas organizações e o VCS e realize testes.

Consulte o Guia de configuração da Salesforce CLI para concluir as instruções de instalação.

1. Instale a CLI em https://developer.salesforce.com/tools/salesforcecli.
2. Confirme se a CLI está corretamente instalada e na versão mais recente executando o comando a seguir na linha de comando.
   

   sf update

   Você deve ver a saída como @salesforce/cli:Updating CLI... (@salesforce/cli:Atualizando a CLI...). Em seguida, o comando update apresenta as notas de versão da versão mais recente.

Veja alguns comandos úteis para ajudar você a começar:

sf org login web -h
sf org login web --help

Muitos indicadores de comando da CLI têm um nome longo e um nome curto. Por exemplo, muitos comandos usam --target-org para especificar uma organização. O comando tem o nome curto -o. No módulo, para facilitar, mostraremos apenas os nomes longos dos indicadores, mas, se preferir, você pode usar o nome curto. 

Agora vamos continuar configurando o restante das ferramentas do Salesforce DX.

Para começar, faça o login no Dev Hub usando a CLI para estar autorizado a criar organizações temporárias. Use o comando org login web para fazer login em várias organizações. Disponibilizamos algumas opções para ajudar você a gerenciar essas organizações.

1. Para autorizar o Dev Hub, use o fluxo de login da web:

   sf org login web --set-default-dev-hub --alias DevHub

   Se você especificar o indicador --set-default-dev-hub, definirá essa organização como o Dev Hub padrão. Use o indicador --alias para definir um alias para a organização (algo cativante como DevHub). Um alias é muito mais fácil de ser lembrado do que o nome de usuário exclusivo do Dev Hub.
   
   Importante: Indique somente o indicador --set-default-dev-hub para seu Dev Hub. Se você usá-lo com uma organização diferente, não poderá criar organizações temporárias até identificar corretamente o Dev Hub usando o comando config set.
   
   
2. Faça login com suas credenciais na janela aberta do navegador.
   
   Feito isso, a CLI armazenará o token com segurança juntamente com o alias da organização. Neste exemplo, DevHub. Feche a janela do navegador da organização do Dev Hub quando quiser.

O Dev Hub pode ser fechado e, ainda assim, criar organizações temporárias. No entanto, se você quiser abrir a organização do Dev Hub para ver as organizações temporárias ativas ou o registro do namespace, o alias é bastante útil:

sf org open --target-org DevHub

É provável que você tenha muitas organizações, incluindo sandboxes e sua organização de produção. Com a CLI, também é possível fazer login nas organizações usando esses comandos. Quando você faz login em uma organização usando a CLI, adiciona essa organização à lista de organizações com as quais a CLI pode trabalhar no futuro.

sf org login web --instance-url https://MyDomainName--SandboxName.my.salesforce.com --alias FullSandbox
sf org login web --instance-url https://MyDomainName--SandboxName.my.salesforce.com --alias DevSandbox

Lembre-se, não use o indicador --set-default-dev-hub quando fizer login em uma sandbox. Se fizer isso, a CLI pensará que a organização é seu Dev Hub e você verá um erro quando tentar criar uma organização teste.

O poder da criação de alias

Como pode imaginar, a criação de alias é uma ótima forma de gerenciar e rastrear suas organizações, e nós a consideramos uma melhor prática. Por quê? Vamos observar os nomes de usuário da organização temporária como exemplo. Um nome de usuário da organização temporária é mais ou menos assim: test-7emx29rtpx0y@example.com. Não é fácil de lembrar. Por isso, quando você emite um comando que exige o nome de usuário da organização, usar um alias fácil de lembrar para a organização, agilizará as coisas.

sf org open --target-org FullSandbox
sf org open --target-org MyScratchOrg
sf limits api display --target-org DevSandbox

• Documentação do Salesforce: Guia de configuração da Salesforce CLI
• Documentação do Salesforce: Salesforce CLI Command Reference
• Documentação do Salesforce: Guia do desenvolvedor do Salesforce DX
• Marketplace do Visual Studio: Extensões do Salesforce para VS Code