Configuração da integração Git do Dataverse (pré-visualização)
[Este artigo inclui documentação pré-versão e está sujeito a alterações.]
A integração Git no Dataverse é iniciada no Power Platform na área Soluções no Power Apps (make.powerapps.com). Este artigo aborda a integração das soluções do Dataverse com o Git, concentrando-se na ligação ao Azure DevOps e na vinculação do seu ambiente para o Dynamics 365 e Power Platform.
Importante
- Esta é uma funcionalidade de pré-visualização.
- As caraterísticas de pré-visualização não se destinam à produção e poderão ter caraterísticas restritas. Estas caraterísticas estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipado e enviar comentários.
- Atualmente, esse recurso só está disponível para ambientes que foram criados para ciclos de lançamento antecipados. Vá para Ambientes do ciclo de lançamento antecipado.
Pré-requisitos para integração do Git com o Dataverse
Funcionalidade de integração Git do Dataverse de Ambientes Geridos. Os ambientes de desenvolvimento devem ser ativados como Ambientes Geridos para utilizar a funcionalidade.
Uma subscrição do Azure DevOps e licenças para utilizadores que interagem com o controlo de código fonte são necessárias ao ligar o seu ambiente do Dataverse ao Git.
Nota
Um número limitado de licenças está disponível no Azure DevOps no Plano Básico do serviço. Vá para Serviços do Azure DevOps para obter mais informações sobre preços e licenciamento para o Azure DevOps.
É necessária permissão de serviços Azure DevOps para fazer confirmações e ler ficheiros de origem. Os membros do grupo de segurança Contribuidores têm permissão.
Um ambiente Power Platform com Dataverse e a função de segurança de administrador do sistema são necessários para se ligar ao Git, o que conclui a vinculação inicial do seu ambiente ou solução a um projeto no Azure DevOps.
Configuração do Azure DevOps
Para começar, precisa de um projeto e repositório do Azure DevOps para ligar o seu ambiente Dataverse. Se não tiver um projeto e repositório do Azure DevOps configurados, siga estes passos para criar um novo projeto e repositório no Azure DevOps.
- Inicie sessão no Azure DevOps e selecione a sua organização.
- Selecione Novo projeto, introduza um nome e verifique se o controlo de versão está definido como Git para o seu projeto e selecione Criar.
- No novo projeto, selecione Repositório e, em seguida, selecione Inicializar na parte inferior da página para inicializar o repositório predefinido.
Certifique-se de que todos os utilizadores que estão a efetuar alterações no seu ambiente têm acesso ao repositório e consolidam as alterações. Reveja a sua configuração de licenciamento e grupos de segurança do Azure DevOps para garantir que podem utilizar o painel de controlo de código fonte da solução.
Ligar o Dataverse ao Git
Para ligar o seu ambiente Dataverse ao Git, vincule o seu ambiente a um projeto no Azure DevOps. Pode vincular o seu ambiente a um projeto usando a vinculação de ambiente ou solução. Para saber mais sobre as diferenças entre vinculação de ambiente e solução, vá para Como escolher entre vinculação de ambiente e solução.
Inicie sessão no Power Apps e, em seguida, aceda a Soluções.
Na área Soluções, selecione Ligar ao Git na barra de comandos.
Selecione Ambiente ou Solução nas opções de tipo de ligação e selecione a sua organização e o seu projeto do Azure DevOps.
Importante
Uma vez definidas, estas definições não podem ser alteradas.
Para mais informações sobre as diferenças entre a vinculação do ambiente e da solução, vá para a secção que se segue.
Dependendo do tipo de vínculo, pode selecionar um projeto, repositório ou ramificação e introduzir uma pasta à qual vincular o ambiente ou a solução. Selecione Ligar.
Como escolher entre vinculação de ambiente e solução
Importante
Essas associações não podem ser alteradas após a configuração inicial, por isso é importante escolher a estratégia de vinculação certa para a sua organização e ambiente.
Se não tiver a certeza de qual a estratégia de vinculação a utilizar, a vinculação do ambiente é a abordagem recomendada para iniciar a integração com o Git no Dataverse. Aqui estão algumas diferenças importantes entre a vinculação de ambiente e solução para ajudá-lo a decidir a abordagem certa para si.
Vinculação do ambiente
A vinculação do ambiente é um processo único para ligar todo o ambiente do Dataverse e todas as soluções e componentes não geridos no ambiente a um único repositório e pasta. Quando opta por ligar todo o ambiente, todas as personalizações não geridas feitas em qualquer solução não gerida personalizada são armazenadas numa única pasta e ramo do Git e não precisa de configurar nenhuma outra solução depois de selecionada. O sistema permite que várias soluções usem uma única localização de pasta raiz e mantém o controlo de quais componentes pertencem a cada solução num ficheiro separado. Já não é necessário usar uma pasta raiz exclusiva para cada solução. Se utilizar a vinculação do ambiente, pode selecionar o repositório, o ramo e a pasta à qual vincular o ambiente durante a configuração inicial.
Vinculação de soluções
A vinculação de soluções pode ser utilizada para controlar o código fonte de várias soluções no mesmo ambiente para separar repositórios ou pastas. A vinculação de soluções proporciona flexibilidade adicional na organização dos ficheiros de origem, mas exige mais gestão por parte dos criadores para integrar novas soluções no controlo de código fonte. O sistema requer que exista apenas uma localização no controlo de código fonte para cada objeto de solução, o que significa que se optar por vincular soluções a diferentes localizações de origem, o sistema não lhe permitirá ter o mesmo componente nas múltiplas soluções. A vinculação de soluções não requer a seleção de um repositório ou solução durante a configuração inicial. Em vez disso, seleciona o repositório e a pasta aos quais vincular cada solução quando estiver pronto para vincular a solução ao controlo de código fonte.
Outras considerações
Se selecionar a vinculação do ambiente, todas as novas soluções não geridas são sincronizadas automaticamente com o código fonte sem mais ações e, se selecionar a vinculação por solução, a criação de uma nova solução posteriormente exigirá que a solução também seja configurada para controlo de código fonte antes de ser sincronizada com o controlo de código fonte. Considere a segurança de ter todas as soluções sincronizadas versus a flexibilidade de ter pastas e ligações de códigos fonte diferentes para cada solução.
Vincular uma solução a um repositório e pasta (ao utilizar a estratégia de vinculação de soluções)
Depois de ter ligado o seu ambiente ao Git utilizando a estratégia de vinculação de soluções, pode vincular uma solução a um repositório e pasta no mesmo projeto do Azure DevOps.
- Na área Soluções, selecione os três pontos verticais ao lado da solução que pretende vincular ao controlo de código fonte e selecione Ligar ao Git.
- Selecione um ramo existente ou crie um novo ramo, introduza uma pasta Git à qual vincular a solução e selecione Ligar.
Validar a sua ligação
Para validar a sua ligação com o Git, crie uma nova solução ou faça alterações a uma solução existente e visualize as alterações usando estes passos:
- Na página Soluções, abra a solução onde pretende ver as alterações.
- No painel esquerdo, selecione Controlo de código fonte para ver as alterações efetuadas na solução.
Agora pode ver as alterações feitas à solução e pode confirmar e enviar as alterações por push para o repositório, bem como visualizar o ramo atual ao qual sua solução está vinculado.
Próximos passos
Depois de o seu ambiente e as suas soluções estarem ligados ao Git, poderá começar a fazer alterações às suas soluções e confirmar e enviar essas alterações para o repositório. Para obter mais informações sobre operações de controlo de código fonte, vá para Operações do repositório de controlo de código fonte (pré-visualização).