Configuração da integração do Git do Dataverse (versão preliminar)
[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]
A integração do Git no Dataverse é iniciada a partir do Power Platform na área Soluções dentro do Power Apps (make.powerapps.com). Este artigo discute a integração das soluções do Dataverse com o Git, concentrando-se na conexão ao Azure DevOps e associando seu ambiente para Dynamics 365 e Power Platform.
Importante
- Este é um recurso em versão preliminar.
- Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.
- No momento, esse recurso está disponível apenas para ambientes criados para ciclos de lançamento antecipados. Vá até Ambientes do ciclo de lançamento antecipado.
Pré-requisitos para integração do Git com o Dataverse
Recurso de integração do Git do Dataverse de Ambientes Gerenciados. Os ambientes de desenvolvimento devem ser habilitados como Ambientes Gerenciados para usar o recurso.
Uma assinatura do Azure DevOps e licenças para usuários que interagem com o controle do código-fonte são necessárias ao conectar seu ambiente do Dataverse ao Git.
Observação
Um número limitado de licenças está disponível no Azure DevOps no Plano Básico do serviço. Vá até Serviços do Azure DevOps para obter mais informações sobre preços e licenciamento do Azure DevOps.
A permissão de Serviços do Azure DevOps para fazer confirmações e ler arquivos de origem é necessária. Os membros do grupo de segurança Colaboradores têm permissão.
Um ambiente do Power Platform com o Dataverse e o direito de acesso de administrador do sistema é necessário para se conectar ao Git, que conclui a associação inicial de seu ambiente ou solução a um projeto no Azure DevOps.
Configuração de Azure DevOps
Para começar, você precisa de um projeto do Azure DevOps e de um repositório para conectar seu ambiente do Dataverse. Se você não tiver um projeto do Azure DevOps e um repositório configurados, siga estas etapas para criar um novo projeto e um repositório no Azure DevOps.
- Faça logon em Azure DevOps e selecione sua organização.
- Selecione Novo projeto, insira um nome e verifique se o controle de versão está definido como Git para seu projeto e selecione Criar.
- No novo projeto, selecione Repositórios e, em seguida, selecione Inicializar na parte inferior da página para inicializar o repositório padrão.
Certifique-se de que todos os usuários que estão fazendo alterações em seu ambiente tenham acesso ao repositório e confirmem as alterações. Revise a configuração de licenciamento do Azure DevOps e os grupos de segurança para garantir que eles possam usar o painel de controle de origem da solução.
Conectar o Dataverse ao Git
Para conectar seu ambiente do Dataverse ao Git, associe seu ambiente a um projeto no Azure DevOps. Você pode associar seu ambiente a um projeto usando a associação de ambiente ou solução. Para saber mais sobre as diferenças entre associação de ambiente e solução, vá para Como escolher entre associação de ambiente e solução.
Entre no Power Apps e depois acesse Soluções.
Na área Soluções, selecione Conectar ao Git na barra de comandos.
Selecione Ambiente ou Solução nas opções do tipo de conexão e selecione sua organização e projeto do Azure DevOps.
Importante
Depois de definidas, essas configurações não poderão ser alteradas.
Para obter mais informações sobre as diferenças entre a associação de ambiente e solução, vá para a seção a seguir.
Dependendo do tipo de associação, você pode selecionar um projeto, repositório ou ramificação e acessar uma pasta para associar o ambiente ou a solução. Selecione Conectar.
Como escolher entre associação de ambiente e solução
Importante
Essas associações não poderão ser alteradas após a configuração inicial, portanto, é importante escolher a estratégia de associação correta para sua organização e ambiente.
Se você não tiver certeza de qual estratégia de associação usar, a associação de ambiente é a abordagem recomendada para começar a usar a integração do Git no Dataverse. Aqui estão algumas diferenças importantes entre a associação de ambiente e solução para ajudá-lo a decidir qual abordagem é ideal para você.
Associação de ambiente
A associação de ambiente é um processo único para associar todo o ambiente do Dataverse e todas as soluções e componentes não gerenciados no ambiente a um único repositório e pasta. Quando você opta por associar todo o ambiente, todas as personalizações não gerenciadas feitas em qualquer solução não gerenciada personalizada são armazenadas em uma única pasta e ramificação do Git, e você não precisará configurar nenhuma outra solução depois de selecionada. O sistema permite que várias soluções usem um único local de pasta raiz e controla quais componentes pertencem a cada solução em um arquivo separado. Não é mais um requisito usar uma pasta raiz exclusiva para cada solução. Se você estiver usando a associação de ambiente, poderá selecionar o repositório, a ramificação e a pasta aos quais vincular o ambiente durante a configuração inicial.
Associação de solução
A associação de solução pode ser usada no controle do código-fonte de várias soluções no mesmo ambiente para separar repositórios ou pastas. A associação de solução fornece flexibilidade adicional na organização dos arquivos de origem, mas exige mais gerenciamento por parte dos criadores para integrar novas soluções para o controle do código-fonte. O sistema requer que haja apenas um local no controle do código-fonte para cada objeto de solução, o que significa que, se você optar por associar soluções a locais de origem diferentes, o sistema não permitirá que você tenha o mesmo componente em várias soluções. A associação de solução não requer que um repositório ou solução seja selecionado durante a configuração inicial. Em vez disso, você seleciona o repositório e a pasta aos quais associar cada solução quando estiver pronto para associar a solução ao controle do código-fonte.
Outras considerações
Se você selecionar associação de ambiente, todas as novas soluções não gerenciadas serão sincronizadas automaticamente com o código-fonte sem outras ações e, se você selecionar por associação de solução, a criação de uma nova solução posteriormente exigirá que a solução também seja configurada para controle do código-fonte antes de ser sincronizada com o controle do código-fonte. Considere a segurança de ter todas as soluções sincronizadas versus a flexibilidade de ter diferentes pastas e links de código-fonte para cada solução.
Associação de uma solução a um repositório e pasta (ao usar a estratégia de associação de solução)
Depois de conectar seu ambiente ao Git usando a estratégia de associação de solução, você poderá associar uma solução a um repositório e uma pasta no mesmo projeto do Azure DevOps.
- Na área Soluções, selecione os três pontos verticais ao lado da solução que você deseja associar ao controle do código-fonte e selecione Conectar ao Git.
- Selecione uma ramificação existente ou crie uma nova ramificação, insira uma pasta Git à qual associar a solução e selecione Conectar.
Valide a conexão
Para validar sua conexão com o Git, crie uma nova solução ou faça alterações em uma solução existente e exiba as alterações usando estas etapas:
- Na página Soluções, abra a solução onde você deseja exibir as alterações.
- No painel esquerdo, selecione Controle do código-fonte para exibir as alterações feitas na solução.
Agora você pode exibir as alterações feitas na solução e confirmar e enviar as alterações por push para o repositório, bem como exibir a ramificação atual à qual sua solução está associada.
Próximas etapas
Depois que o ambiente e as soluções estiverem conectados ao Git, você poderá começar a fazer alterações em suas soluções e confirmar e enviar essas alterações por push para o repositório. Para obter mais informações sobre operações de controle do código-fonte, vá para Operações do repositório de controle do código-fonte (versão preliminar).