Esercitazione: Guida introduttiva a GitHub Actions per Microsoft Power Platform
Questa esercitazione in tre parti descrive le procedure consigliate per automatizzare la creazione e la distribuzione dell'app utilizzando GitHub Actions per Power Platform. Le primi due esercitazioni riguardano la configurazione degli ambienti richiesti e la creazione di una soluzione da utilizzare successivamente con GitHub Actions. Se hai esperienza nella creazione di ambienti e soluzioni, puoi seguire il suggerimento seguente e passare alla terza esercitazione per iniziare a utilizzare GitHub Actions per Power Platform.
- Creare tre ambienti Microsoft Dataverse nel tenant
- (Altamente consigliato) Creare un'entità servizio e fornire le autorizzazioni appropriate
- Creare un'app basata su modello
- Esportare e distribuire l'app utilizzando l'automazione ALM (Application Lifecycle Management)
Mancia
Se hai già familiarità con il concetto di più ambienti Dataverse e sai come utilizzare le soluzioni per creare il pacchetto dell'app, scarica e utilizza l'esempio Soluzione ALMLab e poi vai all'ultima esercitazione di questa serie.
Iniziamo con l'esercitazione n. 1 e creiamo tre ambienti Dataverse.
Creare gli ambienti necessari
Dovrai creare o avere accesso a tre ambienti Dataverse nella demo o nel tenant del cliente. Per creare questi ambienti, segui le istruzioni seguenti. Altrimenti, vai alla fine di questa esercitazione per i passaggi successivi.
Accedi all'interfaccia di amministrazione di Power Platform con credenziali che forniscono l'accesso a un tenant con una capacità disponibile minima di 3 GB (necessaria per creare tre ambienti).
Seleziona Ambienti nell'area di navigazione.
Seleziona +Nuovo per creare il primo nuovo ambiente.
Il primo ambiente dovrebbe essere denominato "Your Nome – dev", imposta la regione su "Stati Uniti (predefinito)", imposta il tipo di ambiente su Sandbox (se disponibile), in caso contrario utilizza "Versione di valutazione".
- Verifica che il pulsante di opzione Crea un database per questo ambiente sia impostato su Sì
Fare clic su Avanti.
Imposta la lingua e la valuta come preferite e imposta il pulsante di opzione "Distribuire app e dati di esempio? su Sì, quindi fai clic su Salva
Il tuo ambiente di sviluppo è stato creato, segui i passaggi da 2 a 7 sopra per creare un secondo ambiente chiamato "Your Nome – build", quindi, infine, crea un terzo ambiente chiamato "Your Nome – prod"
Ora hai gli ambienti di cui avremo bisogno per questo e sei pronto per iniziare i prossimi moduli di questo laboratorio pratico.
Creare l'account dell'entità servizio e assegnargli i diritti per gli ambienti creati
Dovrai creare una registrazione dell'applicazione in Microsoft Entra ID. Esegui questa operazione per tutti gli ambienti DEV/BUILD/PROD utilizzati. Maggiori informazioni: Esercitazione: Registrare un'app con Microsoft Entra ID
Al momento della creazione della registrazione dell'applicazione, annota e salva l'ID directory (tenant) e l'ID applicazione (client) dell'applicazione.
Nel riquadro di spostamento della pagina Panoramica, seleziona Autorizzazioni API.
Scegli + Aggiungi un'autorizzazione e nella scheda Microsoft API , scegli Dynamics CRM.
Nel modulo Richiedi le autorizzazioni dell'API, seleziona Autorizzazioni delegate, seleziona user_impersonation, quindi scegli Aggiungi autorizzazioni.
Nel modulo Richiedi le autorizzazioni dell'API, scegli Servizio runtime di PowerApps, seleziona Autorizzazioni delegate, seleziona user_impersonation, quindi scegli Aggiungi autorizzazioni.
Nel modulo Richiedi le autorizzazioni dell'API, scegli API usate dall'organizzazione, cerca "PowerApps -Advisor" utilizzando il campo di ricerca, seleziona PowerApps-Advisor nell'elenco dei risultati, seleziona Autorizzazioni delegate, seleziona i diritti Analysis.All e quindi scegli Aggiungi autorizzazioni.
Quindi, procedi alla creazione di un segreto client, nel riquadro di spostamento, seleziona Certificati e segreti.
Sotto Segreti cliente, seleziona + Nuovo segreto cliente.
Nel modulo, immettere una descrizione e seleziona Aggiungi. Registra la stringa segreta; non sarai in grado di visualizzare nuovamente il segreto se esci dal modulo.
Creazione di un utente dell'applicazione
Affinché il flusso di lavoro GitHub distribuisca soluzioni come parte di una pipeline CI/CD, devi concedere l'accesso all'ambiente a un "utente dell'applicazione". Un "utente dell'applicazione" rappresenta un utente senza licenza autenticato utilizzando la registrazione dell'applicazione completata nei passaggi precedenti.
Accedi all'interfaccia di amministrazione di Power Platform.
Vai ad Ambienti> apri l'ambiente desiderato >Impostazioni>Utenti + autorizzazioni>Utenti dell'applicazione.
Seleziona + nuovo utente dell'app. Verrà visualizzato un pannello sul lato destro della schermata.
Seleziona + Aggiungi un'app. Viene visualizzato un elenco di tutte le registrazioni dell'applicazione nel tenant di Microsoft Entra. Procedi selezionando il nome dell'applicazione dall'elenco delle app registrate.
Sotto Business Unit, nella casella a discesa, seleziona l'ambiente come Business Unit.
Sotto Ruoli di sicurezza, seleziona Amministratore di sistema, quindi seleziona crea. Ciò consentirà all'entità servizio di accedere all'ambiente.
Ora che hai creato l'entità servizio, puoi utilizzare l'entità servizio o il nome utente e la password standard per il flusso di lavoro GitHub.
Importante
Se è abilitata l'autenticazione a più fattori (MFA), l'autenticazione dell'entità servizio è il metodo di autenticazione che si desidera utilizzare.