GitHub Actions disponibili per lo sviluppo di Microsoft Power Platform

Le sezioni seguenti descrivono GitHub Actions per Microsoft Power Platform. Le sezioni mostrano anche flussi di lavoro di esempio GitHub. Per altre informazioni su GitHub Actions e su come scaricarli, vedere GitHub Actions per Microsoft Power Platform.

Configurare le credenziali da utilizzare con GitHub Actions con Microsoft Power Platform

Molte azioni richiedono la connessione a un ambiente Microsoft Dataverse. Aggiungere le credenziali dell'entità servizio o dell'utente come segreti nel repository GitHub e quindi usarle nei flussi di lavoro.

• Per informazioni dettagliate su come configurare i segreti in GitHub, vedere Segreti crittografati.

• Per informazioni dettagliate su come configurare l'autenticazione del service principal per Microsoft Power Platform, vedere Strumenti di compilazione DevOps.

Dopo aver configurato le credenziali, è possibile chiamare il service principal dagli script di Action.

Definire i parametri seguenti all'interno dello script azione GitHub come variabili di ambiente:

• ID applicazione, ad esempio: WF_APPLICATION_ID:<your application id>
• ID tenant, ad esempio: WF_TENANT_ID:<your tenant id>

Aggiungere il segreto client come segreto GitHub. Farvi riferimento dall'interno del flusso di lavoro usando un parametro simile al seguente: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}

Attività Helper

È disponibile l'attività helper seguente.

actions-install

Quando un flusso di lavoro GitHub Actions forza un'installazione dell'interfaccia della riga di comando di Power Platform nel contesto di uno strumento di esecuzione e si verifica un errore di timeout, usare la versione 1 (@v1) con un'azione aggiuntiva (actions-install) come illustrato nell'esempio seguente.

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'

Per altri esempi di GitHub Actions, vedere Azioni di Power Platform.

whoAmI

Verifica la connessione del servizio connettendosi al servizio e inviando una richiesta WhoAmI [SDK/API Web]. Questa attività può essere utile per includere all'inizio del flusso di lavoro GitHub per verificare la connettività prima dell'inizio dell'elaborazione.

Attività relative alla soluzione

Queste attività eseguono azioni rispetto alle soluzioni e includono quanto segue.

import-solution

Importa una soluzione nell'ambiente di destinazione.

export-solution

Esporta una soluzione da un ambiente di origine.

unpack-solution

Acquisisce un file di soluzione compresso e lo scompone in più file XML. È possibile leggere e gestire più facilmente questi file in un sistema di controllo del codice sorgente.

pack-solution

Comprime una soluzione rappresentata nel controllo della versione del codice sorgente in un file solution.zip che è possibile importare in un altro ambiente.

publish-solution

Pubblica le personalizzazioni della soluzione.

clone-solution

Clona la soluzione per un dato ambiente.

check-solution

Controlla il file della soluzione per rilevare incongruenze.

upgrade-solution

Esegue l'upgrade della soluzione.

Attività del package

Queste attività eseguono azioni sui pacchetti.

deploy-package

Distribuisce un file DLL del pacchetto o un file ZIP con un pacchetto.

Attività del portale

Queste attività eseguono le seguenti azioni in relazione a Power Pages.

upload-paportal

Carica i dati in Power Pages.

Altre informazioni sul supporto di Microsoft Power Platform CLI per Power Pages.

Catalogo attività (anteprima)

Queste attività eseguono azioni sul catalogo in Power Platform.

installa

Installa un elemento Catalog nell'ambiente di destinazione.

invia

Elenca tutti gli elementi del catalogo pubblicati dall'ambiente corrente Dataverse (organizzazione).

stato

Ottenere lo stato dell'installazione del catalogo o della richiesta di invio.

Creazione di flussi di lavoro GitHub

Per altre informazioni su come creare workflow GitHub usando GitHub Actions, completa i lab GitHub Actions per Microsoft Power Platform.

Per altre informazioni, vedere Informazioni su GitHub Actions.

Vedi anche

GitHub Actions per Microsoft Power Platform