Configuração da integração do Git do Dataverse

A integração do Git é iniciada na área Power Platform Soluções dentro de , Power Apps, Copilot Studio e Power Automate. Power Pages Este artigo discute a conexão de ambientes e soluções a um Azure DevOps repositório Git.

À medida que a equipe se desenvolve, as personalizações dentro de um ambiente podem ser confirmadas no Git e as alterações feitas no Git podem ser inseridas em ambientes conectados.

Pré-requisitos para integração do Git com o Dataverse

• Dataverse A integração com o Git é um recurso de Ambientes Gerenciados. Os ambientes de desenvolvimento e de destino devem ser habilitados como Ambientes Gerenciados.

• 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 Azure DevOps projeto e repositório para conectar seu Dataverse ambiente. Se você não tiver um Azure DevOps projeto e repositório configurados, siga estas etapas para criar um novo projeto e repositório em Azure DevOps.

1. Faça logon em Azure DevOps e selecione sua organização.
2. Selecione Novo projeto, insira um nome e certifique-se de que seu controle de versão esteja definido como Git para seu projeto e selecione Criar.
3. 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 ao Git

A conexão com o Git vincula soluções no seu ambiente a um local e ramificação específicos dentro do Azure DevOps repositório. 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.

1. Habilite todos os ambientes de desenvolvimento e de destino como Ambientes Gerenciados no Power Platform centro de administração.

2. Faça login em Power Apps (ou Copilot Studio, Power Automate, Power Pages) e depois vá para Soluções.

3. Na página Soluções ou na página Controle de origem em uma solução não gerenciada personalizada, selecione Conectar ao Git.

4. Selecione Ambiente ou Solução nas opções do tipo de conexão e selecione sua organização e projeto do Azure DevOps. Para obter mais informações sobre as diferenças entre vinculação de ambiente e de solução, acesse Como escolher entre vinculação de ambiente e de solução.

5. 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.

6. Opcionalmente, crie uma nova ramificação.

7. Selecione Conectar.

   Observação

   Por design, a Solução Padrão e a Common Data Service Solução Padrão não podem ser conectadas ao Git. Use uma solução personalizada para desenvolvimento de aplicativos e soluções.

Como escolher entre associação de ambiente e solução

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 vinculação de ambiente é um processo único para vincular todo o seu ambiente e todas as soluções e objetos não gerenciados no ambiente a um único repositório e pasta. Dataverse 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 mantém um registro de quais objetos 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 exige que haja apenas um local no controle de origem para cada objeto de solução, o que significa que, se você optar por vincular soluções a diferentes locais de origem, o sistema não permitirá que você tenha o mesmo objeto 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.

1. 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.
2. 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:

1. Na página Soluções, abra a solução onde você deseja exibir as alterações.
2. 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.

Desconectar do Git

Ambientes e soluções podem ser desconectados e depois reconectados a diferentes locais do Git. Com a vinculação de ambiente ou solução, todas as soluções podem ser desconectadas. Com a vinculação de solução, você também pode desconectar uma solução específica.

Desconecte todas as soluções

1. Na página Soluções, selecione Conexão com o Git (vinculação de ambiente) ou Conectar ao Git (vinculação de solução).
2. Selecione Desconectar todas as soluções do Git.
3. Selecione Continuar na caixa de diálogo de confirmação.

Desconectar uma solução específica

1. Na página Soluções ou Controle de origem , selecione Conexão Git.
2. Selecione Desconectar solução do Git.
3. Selecione Continuar na caixa de diálogo de confirmação.

Conecte vários ambientes de desenvolvimento ao Git

Vários ambientes de desenvolvimento podem ser conectados ao mesmo local do Git. Esse recurso fornece isolamento ao desenvolvedor com a capacidade de enviar rapidamente suas alterações para o Git e puxar as alterações de outros para seu ambiente.

Importante

Cada ambiente deve estar conectado com o mesmo tipo de vinculação, repositório, branch e pasta Git.

1. Exporte as soluções desejadas como não gerenciadas do ambiente de desenvolvimento original e importe para o segundo ambiente.
2. Como alternativa, crie uma solução no segundo ambiente com o mesmo nome e editor exatos.
3. Em outros ambientes, repita as etapas de Conectar ao Git descritas anteriormente. Use o mesmo tipo de conexão (vinculação), organização, projeto, repositório, branch e pasta Git.

Agora você pode sincronizar alterações em vários ambientes.

Próximas etapas

Depois que seus ambientes e soluções estiverem conectados ao Git, você poderá começar a fazer alterações em suas soluções e enviar essas alterações para o repositório. Para obter mais informações sobre operações de controle de origem, acesse Operações do repositório de controle de origem.