Pre-popolare i riferimenti di connessione e le variabili di ambiente per le distribuzioni automatizzate
I riferimenti di connessione e le variabili ambiente consentono di specificare in modo interattivo i dettagli di connessione e le impostazioni di configurazione specifiche per la destinazione ambiente in cui viene distribuita l'app o la soluzione.
Ulteriori informazioni:
Dopo aver importato una soluzione contenente il riferimento di connessione e le informazioni sulle variabili di ambiente, viene richiesto di fornire informazioni specifiche per il proprio ambiente nell'interfaccia utente. Tuttavia, l'immissione di queste informazioni non funziona correttamente per scenari di integrazione continua/consegna continua (CI/CD) completamente automatizzati.
Per abilitare una distribuzione completamente automatizzata, ora puoi precompilare il riferimento di connessione e le informazioni sulla variabile di ambiente specifiche per l'ambiente di destinazione in modo da non doverli fornire in modo interattivo dopo l'importazione di una soluzione.
File di impostazioni di distribuzione
Per precompilare il riferimento di connessione e le informazioni sulla variabile di ambiente per la distribuzione, utilizza il file delle impostazioni di distribuzione (JSON) per archiviare le informazioni e passarlo come parametro durante l'importazione della soluzione utilizzando Strumenti di creazione Power Platform. Puoi archiviare il file JSON nel tuo sistema di controllo del codice sorgente per aggiornarlo e gestirlo come richiesto dalla tua organizzazione.
Di seguito è riportato un esempio di file delle impostazioni di distribuzione:
{
"EnvironmentVariables": [
{
"SchemaName": "tst_Deployment_env",
"Value": ""
},
{
"SchemaName": "tst_EnvironmentType",
"Value": ""
}
],
"ConnectionReferences": [
{
"LogicalName": "tst_sharedtst5fcreateuserandjob5ffeb85c4c63870282_b4cc7",
"ConnectionId": "",
"ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_tst-5fcreateuserandjob-5ff805fab2693f57dc"
},
{
"LogicalName": "tst_SharepointSiteURL",
"ConnectionId": "",
"ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline"
},
{
"LogicalName": "tst_AzureDevopsConnRef",
"ConnectionId": "",
"ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_visualstudioteamservices"
},
{
"LogicalName": "tst_GHConn",
"ConnectionId": "",
"ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_github"
}
]
}
Nel file JSON di esempio precedente, i valori mostrati come "" mancano e dovranno essere compilati. Ci occuperemo di farlo più avanti in questo articolo.
Passaggio 1: generare il file delle impostazioni di distribuzione
Il file delle impostazioni di distribuzione può essere generato utilizzando l'interfaccia della riga di comando di Power Platform. Puoi generare il file durante l'esportazione o la clonazione della soluzione.
Opzione 1: generare il file delle impostazioni di distribuzione utilizzando la proprietà create-settings
Usa la proprietà create-settings con l'interfaccia della riga di comando Power Platform:
C:\> pac solution create-settings --solution-zip <solution_zip_file_path> --settings-file <settings_file_name>
Questo comando genererà un file JSON come mostrato di seguito.
Nel file JSON, alcuni valori sono vuoti nella sezione ConnectionReferences. Questi valori devono essere raccolti dopo essere stati creati nell'ambiente di destinazione.
Opzione 2: generare il file delle impostazioni di distribuzione clonando la soluzione
Per questo passaggio è necessario un clone della soluzione del progetto perché esegue il rendering della soluzione originale in un formato compilabile. Dopo aver clonato una soluzione utilizzando l'interfaccia della riga di comando Power Platform ottieni la seguente struttura di directory creata sul tuo computer:
Procedi per creare il file delle impostazioni nel contesto della cartella corrente e popolare il valore del file delle impostazioni come mostrato di seguito.
Passaggio 2: ottenere il riferimento di connessione e le informazioni sulle variabili di ambiente
Per popolare il file delle impostazioni di distribuzione, sarà necessario ottenere il riferimento di connessione e le informazioni sulle variabili di ambiente della soluzione di destinazione.
Ottenere le informazioni di riferimento della connessione
Per ottenere l'ID connessione dell'ambiente di destinazione, utilizza uno dei seguenti modi:
Accedi a Power Apps e seleziona il tuo ambiente di destinazione. Nel riquadro di navigazione a sinistra, seleziona Dati>Connessioni, seleziona la connessione per la quale desideri ottenere l'ID connessione, quindi guarda l'URL per ottenere l'ID connessione.
Crea un'app canvas sull'entità di riferimento della connessione. Attieniti alla procedura seguente:
Accedi a Power Apps e seleziona il tuo ambiente di destinazione.
Nel riquadro di spostamento a sinistra seleziona App, quindi Nuova app>Canvas.
Seleziona Dataverse come origine dati.
Seleziona la tabella Riferimenti di connessione e seleziona Connetti.
Questo crea un'applicazione raccolta che elenca tutte le connessioni e i loro ID connessione all'interno dell'ambiente.
Ottenere le informazioni sulla variabile d'ambiente
Per ottenere i valori della variabile di ambiente nell'ambiente di destinazione, accedi a Power Apps, seleziona l'ambiente di destinazione e fai clic con il pulsante destro del mouse sui puntini di sospensione e scegli di modificare. Ciò fornirà le informazioni necessarie per popolare il file delle impostazioni di distribuzione (i valori sottolineati sono i valori necessari per il file):
In caso contrario, è possibile fornire il valore appropriato per l'ambiente di destinazione in base alla propria conoscenza dell'ambiente di destinazione.
Passaggio 3: aggiornare i valori nel file delle impostazioni di distribuzione
Modifica manualmente il file delle impostazioni di distribuzione (JSON) per aggiungere la connessione e le informazioni sulla variabile di ambiente in modo appropriato. Di seguito è riportato un file di impostazioni di esempio con aggiunti i valori (precedentemente) mancanti.
{
"EnvironmentVariables": [
{
"SchemaName": "tst_Deployment_env",
"Value": "Test"
},
{
"SchemaName": "tst_EnvironmentType",
"Value": "UAT"
}
],
"ConnectionReferences": [
{
"LogicalName": "tst_sharedtst5fcreateuserandjob5ffeb85c4c63870282_b4cc7",
"ConnectionId": "4445162937b84457a3465d2f0c2cab7e",
"ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_tst-5fcreateuserandjob-5ff805fab2693f57dc"
},
{
"LogicalName": "tst_SharepointSiteURL",
"ConnectionId": "ef3d1cbb2c3b4e7987e02486584689d3",
"ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline"
},
{
"LogicalName": "tst_AzureDevopsConnRef",
"ConnectionId": "74e578ccc24846729f32fcee83b630de",
"ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_visualstudioteamservices"
},
{
"LogicalName": "tst_GHConn",
"ConnectionId": "d8beb0fb533442c6aee5c18ae164f13d",
"ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_github"
}
]
}
Passaggio 4: utilizzare il file delle impostazioni di distribuzione per le attività degli strumenti di compilazione
Passa il file delle impostazioni di distribuzione come parametro durante l'importazione della soluzione nell'ambiente di destinazione. Ciò creerà il riferimento di connessione richiesto e gli ambienti con i valori appropriati al momento dell'importazione senza che l'utente debba specificare il valore in modo interattivo.
Quando si utilizza l'attività di importazione della soluzione in Strumenti di compilazione Power Platform, seleziona Usa il file delle impostazioni di distribuzione e fornisci il percorso del file delle impostazioni di distribuzione. Quindi, avvia la pipeline.
Validation
Durante l'importazione della soluzione, i riferimenti di connessione vengono convalidati per garantire che le connessioni interne siano utilizzabili dal proprietario del riferimento di connessione. Assicurati che le connessioni siano di proprietà del proprietario dei riferimenti di connessione o che le connessioni siano condivise.
Vedi anche
Che cosa è la CLI? Microsoft Power Platform
Microsoft Power Platform Attività degli strumenti di compilazione