Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo fornece informações sobre o GitHub Actions que estão disponíveis para administrar o Microsoft Power Platform.
Configurar credenciais a serem usadas nos fluxos de trabalho do GitHub
Muitas das ações exigem que você se conecte a um ambiente do Microsoft Dataverse. É possível adicionar uma entidade de serviço ou credenciais de usuário como segredos no repositório do GitHub e, em seguida, usá-los no fluxo de trabalho.
Para obter detalhes sobre como configurar segredos no GitHub, acesse Usar segredos criptografados em um fluxo de trabalho.
Para obter detalhes sobre como configurar a autenticação principal de serviço para o Microsoft Power Platform, acesse Configurar conexões de serviço usando uma entidade de serviço. Após a configuração adequada, será possível chamar a entidade de serviço nos scripts de ação.
Defina os seguintes parâmetros no script do GitHub Actions como variáveis de ambiente:
- ID do aplicativo:
WF_APPLICATION_ID:<your application id> - ID do Locatário:
WF_TENANT_ID:<your tenant id>
O segredo do cliente será armazenado como um segredo do GitHub, conforme descrito em Segredos criptografados, e será consultado no script de ação por meio de um parâmetro como client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}.
Tarefas administrativas
As tarefas administrativas disponíveis são explicadas abaixo.
Crie um ambiente
| Parâmetro | Descrição |
|---|---|
| user-name | O nome de usuário da conta que você está usando para se conectar. |
| password-secret | A senha de user-name. As senhas do GitHub são definidas em Configurações em Segredos. Não será possível recuperar um segredo depois que ele tiver sido definido e salvo. |
| app-id | A ID do aplicativo para autenticação. Este parâmetro é obrigatório durante a autenticação com credenciais da entidade de serviço. |
| client-secret | O segredo do cliente usado na autenticação do pipeline do GitHub. Este parâmetro é obrigatório durante a autenticação com credenciais da entidade de serviço. |
| tenant-id | A ID do locatário durante a autenticação com app-id e client-secret. |
| name | O nome do ambiente que você criará. |
| região | O nome da região em que o ambiente será criado. O valor padrão é unitedstates. |
| type | O tipo de ambiente (Trial, Sandbox, Production, SubscriptionBasedTrial). Mais informações: Ambientes de avaliação |
| moeda | A moeda a ser usada no ambiente. O valor padrão é USD. |
| linguagem | O idioma a ser usado no ambiente. O valor padrão é English. |
| modelos | Os modelos que precisam ser implantados no ambiente. Eles são passados como valores separados por vírgula. |
| domain | O nome de domínio da URL do ambiente. Por exemplo, https://{contoso}0.crm.dynamics.com |
A saída será a URL do novo ambiente.
Copiar um ambiente
| Parâmetro | Descrição |
|---|---|
| source-url | A URL de origem do ambiente a ser copiada. Por exemplo, https://source-env.crm.dynamics.com |
| target-url | A URL de destino do ambiente a ser copiada. Por exemplo, https://target-copy-env.crm.dynamics.com |
| user-name | O nome de usuário da conta que você está usando para se conectar. |
| password-secret | A senha de user-name. As senhas do GitHub são definidas em Configurações em Segredos. Não será possível recuperar um segredo depois que ele tiver sido definido e salvo. |
| app-id | A ID do aplicativo para autenticação. Este parâmetro é obrigatório durante a autenticação com credenciais da entidade de serviço. |
| client-secret | O segredo do cliente usado na autenticação do pipeline do GitHub. Este parâmetro é obrigatório durante a autenticação com credenciais da entidade de serviço. |
| tenant-id | A ID do locatário durante a autenticação com app-id e client-secret. |
Fazer backup de um ambiente
| Parâmetro | Descrição |
|---|---|
| environment-url | A URL do ambiente cujo backup precisa ser feito. Por exemplo, https://env-to-backup.crm.dynamics.com |
| backup-label | Um nome significativo para usar como um rótulo para o backup do ambiente. |
| user-name | O nome de usuário da conta que você está usando para se conectar. |
| password-secret | A senha de user-name. As senhas do GitHub são definidas em Configurações em Segredos. Não será possível recuperar um segredo depois que ele tiver sido definido e salvo. |
| app-id | A ID do aplicativo para autenticação. Este parâmetro é obrigatório durante a autenticação com credenciais da entidade de serviço. |
| client-secret | O segredo do cliente usado na autenticação do pipeline do GitHub. Este parâmetro é obrigatório durante a autenticação com credenciais da entidade de serviço. |
| tenant-id | A ID do locatário durante a autenticação com app-id e client-secret. |
Restaurar um ambiente a partir de um backup
| Parâmetro | Descrição |
|---|---|
| source-url | A URL de origem do ambiente a ser restaurado. Por exemplo, https://env-backup-source.crm.dynamics.com |
| target-url | A URL de destino do ambiente a ser restaurado. Por exemplo, https://env-target-restore.crm.dynamics.com |
| user-name | O nome de usuário da conta que você está usando para se conectar. |
| password-secret | A senha de user-name. As senhas do GitHub são definidas em Configurações em Segredos. Não será possível recuperar um segredo depois que ele tiver sido definido e salvo. |
| app-id | A ID do aplicativo para autenticação. Este parâmetro é obrigatório durante a autenticação com credenciais da entidade de serviço. |
| client-secret | O segredo do cliente usado na autenticação do pipeline do GitHub. Este parâmetro é obrigatório durante a autenticação com credenciais da entidade de serviço. |
| tenant-id | A ID do locatário durante a autenticação com app-id e client-secret. |
Redefinir um ambiente
| Parâmetro | Descrição |
|---|---|
| environment-url | A URL do ambiente que precisa ser redefinido. Por exemplo, https://env-to-reset.crm.dynamics.com |
| user-name | O nome de usuário da conta que você está usando para se conectar. |
| password-secret | A senha de user-name. As senhas do GitHub são definidas em Configurações em Segredos. Não será possível recuperar um segredo depois que ele tiver sido definido e salvo. |
| app-id | A ID do aplicativo para autenticação. Este parâmetro é obrigatório durante a autenticação com credenciais da entidade de serviço. |
| client-secret | O segredo do cliente usado na autenticação do pipeline do GitHub. Este parâmetro é obrigatório durante a autenticação com credenciais da entidade de serviço. |
| tenant-id | A ID do locatário durante a autenticação com app-id e client-secret. |
Excluir um ambiente
| Parâmetro | Descrição |
|---|---|
| environment-url | A URL do ambiente que precisa ser excluída. Por exemplo, https://env-to-delete.crm.dynamics.com |
| user-name | O nome de usuário da conta que você está usando para se conectar. |
| password-secret | A senha de user-name. As senhas do GitHub são definidas em Configurações em Segredos. Não será possível recuperar um segredo depois que ele tiver sido definido e salvo. |
| app-id | A ID do aplicativo para autenticação. Este parâmetro é obrigatório durante a autenticação com credenciais da entidade de serviço. |
| client-secret | O segredo do cliente usado na autenticação do pipeline do GitHub. Este parâmetro é obrigatório durante a autenticação com credenciais da entidade de serviço. |
| tenant-id | A ID do locatário durante a autenticação com app-id e client-secret. |
Tarefas do assistente
As tarefas auxiliares disponíveis são descritas abaixo.
WhoAmI
Verifica a conexão do serviço conectando-se ao serviço e enviando uma solicitação WhoAmI [SDK/API da web]. Essa tarefa pode ser útil para incluir no início de seu pipeline de DevOps, para verificar a conectividade antes do início do processamento.
| Parâmetro | Descrição |
|---|---|
| environment-url | A URL do ambiente ao qual você está se conectando. |
| user-name | O nome de usuário da conta que você está usando para se conectar. |
| password-secret | A senha de user-name. As senhas do GitHub são definidas em Configurações em Segredos. Não será possível recuperar um segredo depois que ele tiver sido definido e salvo. |
| app-id | A ID do aplicativo para autenticação. Este parâmetro é obrigatório durante a autenticação com credenciais da entidade de serviço. |
| client-secret | O segredo do cliente usado na autenticação do pipeline do GitHub. Este parâmetro é obrigatório durante a autenticação com credenciais da entidade de serviço. |
| tenant-id | A ID do locatário durante a autenticação com app-id e client-secret. |
Desenvolver e lançar criação de pipeline
Para saber mais sobre como criar fluxos de trabalho e pipelines de ação múltipla por meio da criação prática usando GitHub Actions para o Microsoft Power Platform, conclua os laboratórios das GitHub Actions para o Microsoft Power Platform.
Mais informações: Sobre GitHub Actions