Esercizio - Uso di GitHub Actions per Microsoft Power Platform

  • 15 minuti

In questo esercizio si esporterà una soluzione contenente un connettore personalizzato in GitHub usando GitHub Actions per Microsoft Power Platform.

Importante

Usare un ambiente di test in cui sia stato effettuato il provisioning di Microsoft Dataverse. Se non si dispone di un ambiente di test, è possibile iscriversi al piano della community. È inoltre necessario un account GitHub per completare l'esercizio. È possibile ottenerne uno gratuitamente iscrivendosi sul sito GitHub.com.

Nota

Per completare questo esercizio, scaricare il file seguente nel computer locale: Contoso Invoicing ALM. Selezionare il pulsante Scarica nella parte destra della schermata.

Attività 1 - Importazione della soluzione

In questa attività si importerà una soluzione non gestita contenente un connettore personalizzato Contoso Invoicing. Il connettore verrà usato per completare le attività di questo esercizio.

  1. Accedere a Power Apps Maker Portal e assicurarsi di essere nell'ambiente corretto.

  2. Selezionare Soluzioni e quindi Importa soluzione.

  3. Selezionare Sfoglia.

  4. Selezionare la soluzione ContosoInvoicingALM_1_0_0_0.zip e quindi Apri.

  5. Selezionare Avanti.

  6. Selezionare Importa e attendere il completamento dell'importazione. Al termine dell'importazione, dovrebbe apparire un messaggio di operazione riuscita.

  7. Selezionare Pubblica tutte le personalizzazioni e attendere il completamento della pubblicazione.

  8. Selezionare la soluzione Contoso Invoicing - ALM importata.

    Il componente connettore personalizzato Contoso Invoicing - ALM dovrebbe essere visualizzato.

  9. Selezionare l'icona Impostazioni nell'angolo in alto a destra della pagina, quindi Dettagli sessione.

    Screenshot che mostra la selezione di Dettagli sessione.

  10. Nella finestra di dialogo Dettagli della sessione Power Apps, selezionare il valore URL istanza e copiarlo per un uso successivo nell'esercizio.

    Screenshot che mostra i dettagli della sessione e dove trovare il valore dell'URL dell'istanza.

Attività 2 - Creazione di un repository GitHub

Per creare un repository GitHub, effettuare i seguenti passaggi:

  1. Accedere a GitHub e selezionare Crea repository.

  2. Immettere ContosoInvoiceALM come nome del repository.

  3. Selezionare Aggiungi un file LEGGIMI.

  4. Selezionare Create repository.

  5. Nel nuovo repository selezionare l'icona Settings.

  6. Espandere la sezione Secrets and variables e selezionare Actions. I segreti sono variabili di ambiente crittografate. Chiunque abbia accesso come collaboratore a questo repository può usare questi segreti per GitHub Actions. Si creeranno tre segreti per assicurarsi che l'azione creata non contenga informazioni sensibili.

  7. Selezionare Nuovo segreto repository.

  8. Immettere ambiente nel campo Nome.

  9. Incollare l'URL dell'ambiente copiato nell'attività precedente nel campo Secret.

    Screenshot che mostra l'aggiunta di un nuovo segreto di azione.

  10. Selezionare Add Secret.

  11. Aggiungere un altro secreto denominato user con Secret** contenente l'indirizzo e-mail dell'account usato per accedere all'ambiente.

  12. Aggiungere un altro segreto denominato password con Secret contenente la password dell'account usato per accedere all'ambiente.

  13. Dopo aver aggiunto i segreti, l'elenco dei valori dovrebbe essere simile allo screenshot seguente.

    Screenshot che mostra le tre azioni aggiunte: environment, password e user.

  14. Espandere Actions e selezionare General

    Screenshot che mostra il pulsante General di Actions.

  15. Scorrere verso il basso fino alla sezione Workflow permissions, selezionare Read and write permissions, quindi selezionare Save.

    Screenshot che mostra la sezione Workflow permissions.

Attività 3 - Creazione di un'azione GitHub

Per creare un'azione GitHub, effettuare i seguenti passaggi:

  1. Nella barra di spostamento del repository, selezionare la voce di menu Azioni.

    Screenshot che mostra la selezione di Azioni.

  2. Selezionare l'opzione impostare personalmente un flusso di lavoro.

    Screenshot con l'opzione per impostare il proprio flusso di lavoro evidenziata.

  3. Aprire il file export-and-branch-solution.yml fornito e incollare il contenuto nell'area Edit new file.

    Screenshot che mostra l'operazione per incollare i passaggi per la nuova azione.

  4. Sono stati aggiunti quattro passaggi per: 1) Identificare l'utente per testare la connessione 2) Esportare la soluzione 3) Decomprimere la soluzione e 4) Creare un ramo e archiviare i file della soluzione.

    Screenshot che mostra i passaggi elencati sopra.

  5. Selezionare Inizia commit sul lato destro e quindi selezionare Esegui commit nuovo file. Questo passaggio salverà l'azione creata.

    Screenshot con le azioni Inizia commit ed Esegui commit nuovo file selezionate.

L'azione è stata salvata ed è pronta per essere eseguita.

Attività 4 - Esecuzione dell'azione di esportazione

Per eseguire l'azione di esportazione, attenersi ai seguenti passaggi:

  1. Accedere al repository Azioni.

    Screenshot che mostra la selezione di Azioni per visualizzare l'elenco.

  2. Selezionare l'azione export-and-branch-solution e quindi selezionare Esegui flusso di lavoro.

    Screenshot che mostra la selezione dell'azione creata e la selezione di Esegui flusso di lavoro.

  3. Nella sezione Usa flusso di lavoro da, selezionare il ramo principale e selezionare Esegui flusso di lavoro.

    Screenshot che mostra la selezione di Esegui flusso di lavoro.

  4. Monitorare l'avanzamento del flusso di lavoro fino a che non viene completato correttamente.

    Screenshot con il monitoraggio dell'avanzamento dell'esecuzione del flusso di lavoro.

  5. Selezionare Codice nella barra di spostamento e selezionare rami.

    Screenshot che mostra l'opzione Codice, il numero di rami e la selezione dell'elenco dei rami.

  6. Il ramo creato mediante l'implementazione dell'azione GitHub dovrebbe essere visualizzato. Questo ramo non è ancora stato unito al ramo principale. Selezionare Nuova richiesta pull per avviare il processo di merge.

    Screenshot con la selezione di Nuova richiesta pull per il ramo creato di recente.

  7. Nell'area dei commenti, immettere Versione iniziale del connettore.

  8. Selezionare l'opzione Crea richiesta pull.

  9. In genere a questo punto qualcun altro eseguirebbe una verifica e quindi il merge, ma poiché si tratta di un esercizio, si approverà la richiesta pull personalmente.

  10. Espandere Merge richiesta pull e selezionare Squash e merge.

    Screenshot con la selezione di Merge richiesta pull.

  11. Selezionare Squash e merge e quindi Conferma squash e merge.

    Il ramo con le modifiche è stato unito.

  12. Selezionare Codice e quindi solutions/ContosoInvoiciningALM. Questa cartella contiene i file della soluzione creati. È possibile esplorare il contenuto di questa cartella per determinare cosa è stato estratto dalla soluzione e archiviato come file individuali.

    Screenshot con il contenuto del repository dopo il merge.

Attività 5 - Modifica e registrazione delle definizioni del connettore

Per modificare e registrare le definizioni del connettore, attenersi alla seguente procedura:

  1. Accedere a Power Apps Maker Portal e assicurarsi di essere nell'ambiente corretto.

  2. Selezionare Soluzioni, quindi selezionare e aprire la soluzione Contoso Invoicing - ALM.

  3. Selezionare i puntini di sospensione (...) accanto al componente del connettore personalizzato e quindi selezionare Modifica.

    Screenshot con la selezione di Modifica per modificare il connettore.

  4. Impostare Colore di sfondo dell'icona su #0066ff e quindi seleziona Aggiorna connettore.

    Screenshot che mostra la selezione di Aggiorna connettore dopo aver cambiato il colore.

  5. Ripetere i passaggi da 1 a 12 dell'Attività 4 per eseguire il flusso di lavoro, creare una nuova richiesta pull e unire il codice nel ramo principale.

  6. Selezionare Codice nella barra di spostamento quindi selezionare il nome della richiesta pull per aprire i dettagli.

    Screenshot della richiesta pull.

  7. Verificare la modifica registrata nel colore dell'icona da #007ee5 a #0066ff.

    Screenshot che mostra la modifica del colore dell'icona.

Nota

Altre modifiche automatiche potrebbero essere applicate quando si salva il connettore, ad esempio, il formato dell'icona potrebbe cambiare da JPEG a PNG.

A questo punto si dispone di un processo automatizzato per esportare e registrare le modifiche al connettore personalizzato in un sistema di controllo del codice sorgente.