GitHub Actions disponibles pour le développement de Microsoft Power Platform

Les sections suivantes décrivent GitHub Actions pour Microsoft Power Platform. Les sections affichent également des exemples de flux de travail GitHub. Pour plus d’informations sur GitHub Actions et sur la façon de les télécharger, consultez GitHub Actions pour Microsoft Power Platform.

Configurer les informations d’identification à utiliser avec les actions GitHub avec Microsoft Power Platform

De nombreuses actions nécessitent que vous vous connectiez à un environnement Microsoft Dataverse. Ajoutez des informations d’identification de principal de service ou d’utilisateur en tant que secrets dans votre référentiel GitHub, puis utilisez-les dans vos flux de travail.

  • Pour plus d’informations sur la configuration des secrets dans GitHub, consultez Secrets chiffrés.

  • Pour plus d’informations sur la configuration de l’authentification du principal de service pour Microsoft Power Platform, consultez DevOps Build tools.

Après avoir configuré les informations d’identification, vous pouvez appeler le service principal à partir de vos scripts Action.

Définissez les paramètres suivants dans votre script d’action GitHub en tant que variables d’environnement :

  • ID d’application, par exemple : WF_APPLICATION_ID:<your application id>
  • ID de locataire, par exemple : WF_TENANT_ID:<your tenant id>

Ajoutez le secret client en tant que secret GitHub. Référencez-le à partir du flux de travail à l’aide d’un paramètre comme suit : client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}

Tâches d’aide

La tâche d’assistance suivante est disponible.

actions-install

Lorsqu’un flux de travail GitHub Actions force une installation de l’interface CLI Power Platform dans le contexte d’un exécuteur et qu’une erreur de délai d’attente se produit, utilisez la version 1 (@v1) avec une action supplémentaire (actions-install) comme indiqué dans l’exemple suivant.

Important

  • L’utilisation de la version 1 (@v1) peut entraîner des mises à jour des GitHub Actions existantes, ce qui peut entraîner la mise à jour des workflows actuels.
  • Ajoutez la tâche Installer Power Platform Tools en tant que première tâche dans votre flux de travail avant toute autre GitHub Actions pour Power Platform.
jobs:
    builds:
        runs-on: windows-latest   # alternate runner OS is: ubuntu-latest

    steps:
    - name: Install Power Platform Tools
        uses: microsoft/powerplatform-actions/actions-install@v1

    - name: Export Solution
         uses: microsoft/powerplatform-actions/export-solution@v1
      with:
         environment-url: 'https://myenv.crm.dynamics.com'
         user-name: 'me@myenv.onmicrosoft.com'
         password-secret: ${{ secrets.MYPASSWORD }}
         solution-name: aSolution
         solution-output-file: 'aSolution.zip'
         working-directory: 'out'

Vous trouverez d’autres exemples de GitHub Actions dans Power Platform Actions.

whoAmI

Vérifie la connexion au service en se connectant au service et en envoyant une demande de WhoAmI [SDK/API Web]. Il peut être utile d’inclure cette tâche au début de votre flux de travail GitHub pour vérifier la connectivité avant le début du traitement.

Paramètre Description
environment-url L’URL de l’environnement auquel vous souhaitez vous connecter.
user-name Le nom d’utilisateur du compte que vous utilisez pour vous connecter.
password-secret Mot de passe pour user-name. Définissez les mots de passe GitHub dans Paramètres sous Secrets. Vous ne pouvez pas récupérer un secret après avoir défini et enregistré celui-ci.
app-id L’ID d’application permettant de s’authentifier. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
client-secret Le secret client utilisé pour authentifier le pipeline GitHub. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
ID de locataire L’ID du locataire lors de l’authentification avec app-id et client-secret.

Tâches de solution

Ces tâches exécutent des opérations sur des solutions, et incluent ce qui suit :

import-solution

Importe une solution dans un environnement cible.

Paramètre Description
environment-url (Obligatoire) URL de l’environnement cible dans lequel vous voulez importer la solution (par exemple, https://YourOrg.crm.dynamics.com).
nom d’utilisateur (Obligatoire) Si vous utilisez l’authentification par nom d’utilisateur/mot de passe, le nom d’utilisateur du compte que vous utilisez pour vous connecter.
password-secret (Obligatoire) Si vous utilisez l’authentification par nom d’utilisateur/mot de passe, le mot de passe du compte que vous utilisez pour vous connecter.
solution-file (Obligatoire) Le chemin et le nom du fichier de solution que vous souhaitez importer.
app-id L’ID d’application pour l’authentification. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
client-secret Le secret client utilisé pour authentifier le pipeline GitHub. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
ID de locataire L’ID de locataire lors de l’authentification avec app-id et client-secret.

exporter la solution

Exporte une solution à partir d’un environnement source.

Paramètre Description
environment-url (Obligatoire) URL de l’environnement source depuis lequel vous voulez exporter la solution (par exemple, https://YourOrg.crm.dynamics.com).
user-name (Obligatoire) Si vous utilisez l’authentification par nom d’utilisateur/mot de passe, le nom d’utilisateur du compte que vous utilisez pour vous connecter.
password-secret (Obligatoire) Si vous utilisez l’authentification par nom d’utilisateur/mot de passe, le mot de passe pour user-name. Définissez les mots de passe GitHub dans Paramètres sous Secrets. Vous ne pouvez pas récupérer un secret après avoir défini et enregistré celui-ci.
app-id L’ID d’application avec lequel s’authentifier. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
client-secret Le secret client utilisé pour authentifier le pipeline GitHub. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
ID de locataire L’ID de locataire lors de l’authentification avec app-id et client-secret.
solution-name (Obligatoire) Nom de la solution à exporter. Utilisez toujours le nom de la solution, pas son nom d’affichage.
solution-output-file (Obligatoire) Chemin d’accès et nom du fichier solution.zip vers lequel exporter l’environnement source.
géré (Obligatoire) Définissez sur vrai pour exporter en tant que solution gérée ; la valeur par défaut (faux) permet d’exporter en tant que solution non gérée.

décompresser une solution

Prend un fichier de solution compressé et le décompose en plusieurs fichiers XML. Vous pouvez lire et gérer plus facilement ces fichiers dans un système de contrôle de code source.

Paramètre Description
solution-file (Obligatoire) Chemin d’accès et nom du fichier solution.zip à décompresser.
solution-folder (Obligatoire) Chemin d’accès et dossier cible dans lequel vous souhaitez décompresser la solution.
solution-type (Obligatoire) Type de solution à décompresser. Les options comprennent : Non géré (conseillé), Géré et Les deux.

pack-solution

Empaquette une solution représentée dans le contrôle de code source dans un fichier solution.zip que vous pouvez importer dans un autre environnement.

Paramètre Description
solution-file (Obligatoire) Chemin d’accès et nom de fichier du fichier solution.zip dans lequel packer la solution (par exemple, out/CI/ALMLab.zip).
solution-folder (Obligatoire) Chemin d’accès et dossier source de la solution à empaqueter.
solution-type (Facultatif) Le type de solution à empaqueter. Les options comprennent : Non géré (conseillé), Géré et Les deux.

publish-solution

Publie les personnalisations de solution.

Paramètre Description
environment-url (Obligatoire) URL de l’environnement dans lequel vous voulez publier la solution (par exemple, https://YourOrg.crm.dynamics.com).
user-name (Obligatoire) Si vous utilisez l’authentification par nom d’utilisateur/mot de passe, le nom d’utilisateur du compte que vous utilisez pour vous connecter.
password-secret (Obligatoire) Si vous utilisez l’authentification par nom d’utilisateur/mot de passe, le mot de passe du compte que vous utilisez pour vous connecter.
solution-file (Obligatoire) Le chemin et le nom du fichier de solution que vous souhaitez importer.
id d’application L’ID d’application à utiliser pour s’authentifier. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
client-secret Le secret client utilisé pour authentifier le pipeline GitHub. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
tenant-id L’ID de locataire lors de l’authentification avec app-id et client-secret.

clone-solution

Clone la solution pour un environnement donné.

Paramètre Description
environment-url (Obligatoire) URL de l’environnement à partir duquel vous voulez cloner la solution (par exemple, https://YourOrg.crm.dynamics.com).
user-name (Obligatoire) Si vous utilisez l’authentification par nom d’utilisateur/mot de passe, le nom d’utilisateur du compte que vous utilisez pour vous connecter.
password-secret (Obligatoire) Si vous utilisez l’authentification par nom d’utilisateur/mot de passe, le mot de passe du compte que vous utilisez pour vous connecter.
solution-file (Obligatoire) Le chemin et le nom du fichier de solution que vous souhaitez importer.
app-id L’ID d’application à utiliser pour s’authentifier. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
client-secret Le secret client utilisé pour authentifier le pipeline GitHub. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
tenant-id L’ID du locataire lors de l’authentification avec app-id et client-secret.
solution-name (Obligatoire) Le chemin et le nom du fichier solution.zip nécessaires au clonage (par exemple, out/CI/ALMLab.zip).
version de la solution Version de la solution à cloner.
dossier de destination Dossier cible dans lequel placer la solution extraite. (par exemple, dépôt Git\t target-solution-folder).
Répertoire de travail Dossier temporaire pour les artefacts de travail en cours nécessaires au clonage de la solution.
par défaut : root of the repository

vérificateur de solution

Vérifie le fichier de solution pour détecter les incohérences.

Paramètre Description
environment-url (Obligatoire) URL de l’environnement source à partir duquel vous voulez cloner la solution (par exemple, https://YourOrg.crm.dynamics.com).
user-name (Obligatoire) Si vous utilisez l’authentification par nom d’utilisateur/mot de passe, le nom d’utilisateur du compte que vous utilisez pour vous connecter.
password-secret (Obligatoire) Si vous utilisez l’authentification par nom d’utilisateur/mot de passe, le mot de passe du compte que vous utilisez pour vous connecter.
app-id L’ID d’application avec lequel s’authentifier. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
client-secret Le secret client utilisé pour authentifier le pipeline GitHub. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
ID de locataire L’ID de locataire lors de l’authentification avec app-id et client-secret.
chemin (Obligatoire) Le chemin et le nom du fichier de solution que vous souhaitez vérifier.
geo Quelle géolocalisation du service Microsoft Power Platform Checker à utiliser. La valeur par défaut est « united states ».
règle-niveau-écraser Chemin d’accès au fichier contenant un tableau JSON de règles et leurs niveaux. Les valeurs acceptées sont : Critique, Élevé, Faible et Informationnel. Exemple : [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
checker-logs-artifact-name Le nom du dossier d’artefacts pour lequel les journaux du vérificateur Microsoft Power Platform seront téléversés. La valeur par défaut est « CheckSolutionLogs ».

solution de mise à niveau

Met à niveau la solution.

Paramètre Description
environment-url (Obligatoire) URL de l’environnement source à partir duquel vous voulez cloner la solution (par exemple, https://YourOrg.crm.dynamics.com).
user-name (Obligatoire) Si vous utilisez l’authentification par nom d’utilisateur/mot de passe, le nom d’utilisateur du compte que vous utilisez pour vous connecter.
password-secret (Obligatoire) Si vous utilisez l’authentification par nom d’utilisateur/mot de passe, le mot de passe du compte que vous utilisez pour vous connecter.
solution-file (Obligatoire) Le chemin et le nom du fichier de solution que vous souhaitez importer.
app-id L’ID d’application avec lequel s’authentifier. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
client-secret Le secret client utilisé pour authentifier le pipeline GitHub. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
tenant-id L’ID du locataire lors de l’authentification avec app-id et client-secret.
solution-name (Obligatoire) Nom de la solution à mettre à niveau.
async Met à niveau la solution de manière asynchrone.
Délai d’attente asynchrone maximal Temps d’attente asynchrone maximum en minutes. La valeur par défaut est 60 minutes.

Tâches de package

Ces tâches effectuent des actions sur des packages.

deploy-package

Déploie une DLL de package ou un fichier ZIP avec un package.

Note

Cette action n’est prise en charge que sur Windows.

Paramètre Description
environment-url (Obligatoire) URL de l’environnement cible dans lequel vous voulez cloner la solution (par exemple, https://YourOrg.crm.dynamics.com).
user-name (Obligatoire) Si vous utilisez l’authentification par nom d’utilisateur/mot de passe, le nom d’utilisateur du compte que vous utilisez pour vous connecter.
password-secret (Obligatoire) Si vous utilisez l’authentification par nom d’utilisateur/mot de passe, le mot de passe du compte que vous utilisez pour vous connecter.
app-id L’ID d’application à utiliser pour s’authentifier. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
client-secret Le secret client utilisé pour authentifier le pipeline GitHub. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
tenant-id L’ID de locataire lors de l’authentification avec app-id et client-secret.
package (Obligatoire) Chemin d’accès à un fichier DLL ou ZIP avec un package.

Tâches du portail

Ces tâches effectuent les actions suivantes sur les portails Power Pages.

upload-paportal

Téléverse des données vers Power Pages.

Paramètre Description
environment-url (Obligatoire) URL de l’environnement dans lequel vous voulez importer la solution (par exemple, https://YourOrg.crm.dynamics.com).
id d’application L’ID d’application avec lequel s’authentifier. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
client-secret Le secret client utilisé pour authentifier le pipeline GitHub. Ce paramètre est obligatoire lors de l’authentification avec les informations d’identification du principal de service.
tenant-id L’ID de locataire lors de l’authentification avec app-id et client-secret.
upload-path Chemin où est stocké le contenu du site web (alias : -p).
profil de déploiement Chargez les données du portail avec les détails de l′environnement définis par les variables de profil dans le fichier deployment-profiles/[profile-name].deployment.yaml.
model-version Indique si les données de site à charger utilisent le modèle de données standard (1) ou le modèle de données amélioré (2). La valeur par défaut est 1.

En savoir plus sur le Support Microsoft Power Platform CLI pour Power Pages.

Tâches du catalogue (version préliminaire)

Ces tâches effectuent des actions sur le catalogue dans Power Platform.

Note

Actuellement, les tâches de catalogue pour Power Platform sont en préversion.

install

Installez un élément de catalogue dans l’environnement cible.

Paramètre Description
catalog-item-id (Obligatoire) Élément de catalogue à installer sur l’environnement cible.
target-url (Obligatoire) URL de l’environnement cible pour l’installation de l’élément de catalogue (par exemple, https://YourOrg.crm.dynamics.com).
paramètres (Obligatoire) Paramètres du package d’exécution nécessaires à l’exécution du framework d’installation. Le format de la chaîne doit être key=value|key=value.
target-version Version cible à installer. Si vous ne spécifiez pas de version, la version publiée est sélectionnée.
poll-status Interrogez pour vérifier le statut de votre demande.

Soumettre

Répertoriez tous les éléments du catalogue publiés à partir de l’environnement Dataverse actuel (organisation).

Paramètre Description
chemin (Obligatoire) Chemin d’accès au document d’envoi du catalogue.
package-zip Chemin d’accès au fichier zip du package.
solution-zip Chemin d’accès au fichier zip de la solution.
poll-status Interrogez pour vérifier le statut de votre demande.

status

Obtenez le statut de la demande d’installation ou de soumission du catalogue.

Paramètre Description
tracking-id (Obligatoire) ID de suivi de la demande.
type (Obligatoire) Type de requête. Les valeurs valides sont Install et Submit.

Création de workflow GitHub

Pour en savoir plus sur la composition de workflows GitHub à l’aide d’actions GitHub, complétez les laboratoires Actions GitHub pour Microsoft Power Platform.

Pour plus d’informations, consultez À propos de GitHub Actions.

Voir aussi

Actions GitHub pour Microsoft Power Platform