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 Remote Assist, 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.
Note
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 dell'applicazione 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. È possibile classificare in gran parte le attività di compilazione in quattro tipi:
- Aiutante
- 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 a cui Microsoft fornisce supporto e aggiunge funzionalità più recenti.
Per le versioni precedenti di Power Platform Build Tools, Microsoft fornisce aggiornamenti di sicurezza critici in base alle esigenze. Passare a Power Platform Build Tools versione 2.0 appena possibile.
Important
Non è possibile mescolare versioni diverse delle attività 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 | Description |
|---|---|
| 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/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
Usa il comando pac admin create-service-principal per creare e configurare il service principal da utilizzare con le attività di Microsoft Power Platform Build Tools.
Questo comando prima registra un oggetto Applicazione e il corrispondente nome dell'entità servizio (SPN) in Microsoft Entra ID. Aggiunge quindi l'applicazione come utente amministratore al tenant Microsoft Power Platform.
Questo comando ha due parametri:
| name | nome breve | Obbligatorio | Description |
|---|---|---|---|
environment |
env |
Yes | 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. |
Usare il comando come segue:
C:\> pac admin create-service-principal --environment <environment id>
Al termine, il comando visualizza quattro colonne:
- TenantId di Power Platform
- ID applicazione
- Segreto cliente (in testo non crittografato)
- Scadenza
Per 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.
Important
Mantieni il segreto client al sicuro e protetto. Dopo aver cancellato il prompt dei comandi, non è possibile recuperare nuovamente lo stesso segreto client.
Configurare l'ambiente con l'ID applicazione
Devi aggiungere l'ID applicazione come utente dell'applicazione nell'ambiente Microsoft Power Platform a cui ti stai connettendo. Esistono due modi per farlo.
- Puoi consultare questo articolo: Creazione utente applicazione.
- Puoi usare l'interfaccia della riga di comando di Power Platform. Per 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 meno recenti continuano a funzionare, ma le funzionalità più recenti non sono disponibili nelle attività precedenti. Se vuoi usare le funzionalità più recenti, modifica 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 con grande flessibilità, inclusa l'esecuzione in strumenti di esecuzione Linux. Queste attività sono le stesse attività disponibili con Le azioni di Power Platform 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 è possibile aggiungere a una soluzione. Questo elenco include anche app per l'engagement dei clienti (Dynamics 365 Remote Assist, Servizio clienti, Field Service, Marketing e Project Service Automation). Sono disponibili attività di compilazione separate per le applicazioni per la finanza e le operazioni.
In precedenza è stata installata 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 perché è stato necessario introdurre alcune modifiche di rilievo 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 o riconfigurare le pipeline esistenti per usare le nuove attività di Strumenti di compilazione. È anche necessario creare nuove connessioni al servizio.
Posso includere flussi e app canvas?
Sì, i flussi e le app canvas sono consapevoli della soluzione, quindi se si aggiungono questi componenti alla soluzione, possono partecipare al ciclo di vita dell'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 correnti è disponibile nell'articolo 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. Per altre informazioni, vedere Pricing per Azure DevOps.
Posso vedere l'estensione, ma perché non ho un'opzione per installarla?
Se non viene visualizzata l'opzione di installazione, probabilmente non sono disponibili i privilegi di installazione necessari nell'organizzazione Azure DevOps. Per altre informazioni, vedere Gestire le autorizzazioni di estensione.
In che modo gli sviluppatori possono utilizzare i risultati dell'attività di verifica?
L'output dell'attività Checker è un file SARIF. Sia VS Code che le estensioni 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
laboratori di Microsoft Power Platform Build Tools