Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Usare Microsoft Power Platform Build Tools per automatizzare le attività di compilazione e distribuzione comuni correlate alle app basate su Microsoft Power Platform. Queste attività includono:
- Sincronizzazione dei metadati della soluzione (noti anche come soluzioni) che contengono i vari componenti della piattaforma come:
- App di coinvolgimento dei clienti: Dynamics 365 Sales, customer service, field service, marketing e Project Service Automation
- App canvas
- App basate su modello
- Flussi di interfaccia utente
- Agenti virtuali
- AI Builder modelli
- Connettori tra ambienti di sviluppo e controllo del codice sorgente
- Generazione degli artefatti della compilazione
- Distribuzione in ambienti downstream
- Provisioning o de-provisioning di ambienti
- Esecuzione di controlli di analisi statici sulle soluzioni tramite il servizio di controllo Power Apps
Usare le attività di Microsoft Power Platform Build Tools con qualsiasi altra attività di Azure DevOps disponibili per comporre le pipeline di compilazione e rilascio. Le pipeline che i team in genere implementano includono Initiate, Export from Dev, Build e Release.
Nota
Microsoft Power Platform Gli strumenti di compilazione sono supportati solo per un ambiente Microsoft Dataverse con un database. Altre informazioni: Creare un ambiente con un database
Microsoft Power Platform Build Tools sono ora disponibili per l'uso nelle aree GCC e GCC High.
Che cosa sono gli strumenti di compilazione di Microsoft Power Platform?
Microsoft Power Platform Build Tools sono una raccolta di attività di compilazione specifiche di Power Platform Azure DevOps che eliminano la necessità di scaricare manualmente strumenti e script personalizzati per gestire il ciclo di vita delle app basate su Microsoft Power Platform.
Le attività possono essere utilizzate singolarmente, come l'importazione di una soluzione in un ambiente downstream, oppure insieme in una pipeline per orchestrare uno scenario come generare un artefatto di compilazione, distribuire a scopo di test o raccogliere le modifiche del creatore. Le attività di compilazione possono essere in gran parte classificate in quattro tipi:
- Helper
- Controllo qualità
- Soluzione
- Gestione dell'ambiente
Per altre informazioni sulle attività disponibili, vedere Attività di Microsoft Power Platform Build Tools.
Cos'è Power Platform Build Tools versione 2.0?
Oltre a quanto fornito da Power Platform Build Tools, la versione 2.0 di Power Platform Build Tools è basata su Power Platform CLI.
Power Platform Build Tools versione 1.0 è basato su PowerShell. Power Platform Build Tools 2.0 è la versione che verrà supportata con l'aggiunta di nuove funzionalità.
Per le versioni precedenti di Power Platform Build Tools, eseguiremo aggiornamenti di sicurezza critici secondo necessità. Consigliamo vivamente ai clienti di passare a Power Platform Build Tools versione 2.0 al più presto.
Importante
Non è possibile combinare e abbinare le versioni di Power Platform Build Tools nella pipeline di compilazione.
Ottenere gli strumenti di compilazione di Microsoft Power Platform
Microsoft Power Platform Build Tools può essere installato nell'organizzazione Azure DevOps da Azure Marketplace.
Dopo l'installazione, tutte le attività incluse nell'Microsoft Power Platform Build Tools saranno disponibili per l'aggiunta in qualsiasi pipeline nuova o esistente. Puoi trovarle cercando "Power Platform".
Connessione agli ambienti
Per interagire con l'ambiente Microsoft Power Platform, è necessario stabilire una connessione in modo che le attività dello strumento di compilazione possano eseguire le azioni necessarie. Sono disponibili due tipi di connessioni:
| Tipo di connessione | Descrizione |
|---|---|
| Entità servizio tramite la federazione delle identità del carico di lavoro (consigliato) | Utilizza l'autenticazione basata sull'entità servizio tramite credenziali federate. Consigliato per i tenant che richiedono l'autenticazione a più fattori. |
| Entità servizio e segreto client | Utilizza l'autenticazione basata sull'entità servizio. |
| Nome utente e password | Una connessione di servizio generica con nome utente e password. Non supporta gli utenti che richiedono l'autenticazione a più fattori. |
Configurare le connessioni di servizio utilizzando un'entità servizio
Per configurare una connessione utilizzando l'entità servizio, devi prima disporre di un profilo Power Platform autenticato con le autorizzazioni richieste. È necessario aggiungere un'applicazione Microsoft Entra ID e l'utente dell'applicazione associata all'ambiente Dataverse.
Crea entità servizio e segreto client
Usare il comando pac admin create-service-principal per creare e configurare il principale del servizio da usare con le attività di Microsoft Power Platform Build Tools.
Questo comando registra un oggetto applicazione e il nome principale del servizio (SPN) corrispondente, per prima cosa, in Microsoft Entra ID. Aggiunge quindi l'applicazione come utente amministratore al tenant Microsoft Power Platform.
Questo comando ha due parametri:
| nome. | nome breve | Richiesto | Descrizione |
|---|---|---|---|
environment |
env |
Sì | ID o URL dell'ambiente a cui aggiungere un utente dell'applicazione. |
role |
r |
No | Nome o ID del ruolo di sicurezza da applicare all'utente dell'applicazione. Il valore predefinito è: "Amministratore di sistema".
Verifica soluzione richiede un ruolo con il privilegio prvAppendmsdyn_analysisjob per aggiungere alla tabella msdyn_analysisjob. Il ruolo Amministratore di sistema dispone di questo privilegio per impostazione predefinita. |
Puoi utilizzarlo come:
C:\> pac admin create-service-principal --environment <environment id>
Una volta completata l'operazione, vengono visualizzate quattro colonne:
- TenantId di Power Platform
- ID dell'applicazione
- Segreto cliente (in testo non crittografato)
- Scadenza
Ad esempio:
PS C:\>pac admin create-service-principal --environment d3fcc479-0122-e7af-9965-bde57f69ee1d
Connected as admin@M365x57236726.onmicrosoft.com
Successfully assigned user adde6d52-9582-4932-a43a-beca5d182301 to environment d3fcc479-0122-e7af-9965-bde57f69eeld with security role System Administrator
Tenant ID Application ID Client Secret Expiration
2b0463ed-efd7-419d-927d-a9dca49d899c adde6d52-9582-4932-a43a-beca5d182301 beY8Q~JBZ~CBDgIKKBjbZ3g6BofKzoZkYj23Hbf 7/31/2024 4:27:03 PM
Utilizza le informazioni visualizzate per configurare la connessione di servizio Power Platform.
Importante
Mantieni il segreto client al sicuro e protetto. Una volta cancellato il prompt dei comandi, non è possibile recuperare nuovamente lo stesso segreto client.
Configurare l'ambiente con l'ID applicazione
È necessario aggiungere l'ID applicazione come utente dell'applicazione nell'ambiente Microsoft Power Platform a cui ci si connette. Esistono due modi per farlo.
- Puoi consultare questo articolo: Creazione utente applicazione.
- Puoi usare l'interfaccia della riga di comando di Power Platform. Ad esempio:
PS C:\>pac admin assign-user --user "adde6d52-9582-4932-a43a-beca5d182301" --role "System administrator" --environment d3fcc479-0122-e7af-9965-bde57f69ee1d --application-user
Connected to... SnDemoDev
Connected as admin@M365x57236726.onmicrosoft.com
Successfully assigned user adde6d52-9582-4932-a43a-beca5d182301 to environment d3fcc479-0122-e7af-9965-bde57f69ee1d with security role System Administrator
Assicurati che all'utente dell'applicazione aggiunto sia assegnato il ruolo di amministratore di sistema (disponibile da "Gestisci ruoli" nelle impostazioni di sicurezza per l'utente dell'applicazione).
Domande frequenti
Continueranno a funzionare le vecchie pipeline dello strumento di compilazione Microsoft Power Platform Build Tool?
Le pipeline precedenti continuano a funzionare, ma le funzionalità più recenti non verranno aggiunte alle attività precedenti. Se desideri utilizzare le funzionalità più recenti, ti consigliamo vivamente di modificare la versione dell'attività nella pipeline.
Perché hai basato la nuova attività sull'interfaccia della riga di comando di Power Platform anziché su PowerShell?
Le attività dell'interfaccia della riga di comando di Power Platform sono multipiattaforma ed estremamente flessibili, inclusa l'esecuzione su runner Linux. Si tratta delle stesse attività disponibili con Power Platform Actions per GitHub. È ora disponibile un'esperienza coerente tra Azure DevOps e GitHub.
Do gli strumenti di compilazione di Microsoft Power Platform funzionano solo per Power Apps?
Gli strumenti di compilazione funzionano sia per le app canvas che per le app basate su modello, Microsoft Copilot Studio agenti virtuali, flussi dell'interfaccia utente e flussi tradizionali, AI Builder, connettori personalizzati e flussi di dati, che ora possono essere aggiunti a una soluzione. Questo elenco include anche app per l'engagement dei clienti (Dynamics 365 Sales, Servizio clienti, Field Service, Marketing e Project Service Automation). Sono disponibili attività di compilazione separate per le applicazioni per la finanza e le operazioni.
I aveva installato in precedenza l'anteprima degli strumenti di compilazione: è possibile eseguire l'aggiornamento dall'anteprima di Power Apps Build Tools a Power Platform Build Tools?
Non è possibile eseguire l'aggiornamento dalla versione di anteprima poiché abbiamo dovuto introdurre alcune modifiche sostanziali nella versione disponibile a livello generale. Per passare dalla versione di anteprima, è necessario installare gli strumenti di compilazione Microsoft Power Platform e ricompilare le pipeline oppure riconfigurare le pipeline esistenti per usare le nuove attività di Strumenti di compilazione. Devi inoltre creare anche nuove connessioni al servizio.
Posso includere flussi e app canvas?
Sì, i flussi e le app canvas riconoscono le soluzioni, quindi se questi componenti vengono aggiunti alla tua soluzione, possono partecipare al ciclo di vita della tua app. Tuttavia, alcuni passaggi richiedono ancora configurazioni manuali. La necessità di una configurazione manuale verrà determinata entro la fine dell'anno quando introdurremo connettori e variabili di ambiente. Un elenco delle limitazioni attuali è disponibile in Limitazioni note.
Quanto costano gli strumenti di compilazione di Microsoft Power Platform?
Gli strumenti Build Tools sono disponibili gratuitamente. Tuttavia, è necessaria una sottoscrizione valida per Azure DevOps per usare gli strumenti di compilazione. Altre informazioni sono disponibili Pricing per Azure DevOps.
Posso vedere l'estensione, ma perché non ho un'opzione per installarla?
Se non viene visualizzata l'opzione install, probabilmente mancano i privilegi di installazione necessari nell'organizzazione Azure DevOps. Altre informazioni sono disponibili in Gestire le autorizzazioni per le estensioni.
In che modo gli sviluppatori possono utilizzare i risultati dell'attività di verifica?
L'output dell'attività Verifica è un file Sarif e le estensioni di VS Code e Visual Studio sono disponibili per la visualizzazione e l'esecuzione di azioni sui file Sarif.
Vedere anche
note di rilascio di Power Platform Build Tools per Azure DevOps
Attività di Build Tools
Microsoft Power Platform Build Tools labs