Repository

PowerShell Universal archivia principalmente la configurazione nel proprio repository. La cartella predefinita del repository è %ProgramData%\UniversalAutomation\Repository; modifichi la posizione in appsettings.json.

Il repository contiene script di configurazione PowerShell e file XML creati dalla console di amministrazione. PowerShell Universal monitora la cartella per rilevare le modifiche e ricarica la configurazione interessata. Quando la sincronizzazione Git è abilitata, questa è la cartella sincronizzata con il repository remoto.

Tutti i cmdlet di configurazione fanno parte del modulo Universal.

Cosa viene archiviato nel repository

La configurazione viene archiviata come testo normale per ottenere diff compatibili con il controllo del codice sorgente. Le risorse basate sul repository includono autenticazione, agenti e strumenti IA, app, endpoint, ambienti, licenze, pagine di accesso, pagine, cartelle pubblicate, limiti di frequenza, ruoli, pianificazioni, script, impostazioni, tag, trigger, variabili e casseforti.

I token delle app, le identità e la cronologia dei processi vengono archiviati nel database di PowerShell Universal.

Modifica del repository

Modifichi i file del repository nella console di amministrazione in Source Control > Files / Repository > Files, dove è possibile creare cartelle e modificare i file nella directory del repository. È anche possibile modificare i file su disco con un editor come Visual Studio Code.

Quando si effettuano modifiche su disco, abiliti il ricaricamento automatico o risolva le modifiche manualmente. Visualizzi le modifiche in sospeso in Source Control > Files / Repository > Configuration Changes.

Script di configurazione

Gli script di configurazione si trovano nella directory .universal. La console di amministrazione gestisce le parti generate di questi file, mentre le aree PSUHeader e PSUFooter rimangono in sola lettura. Utilizzi queste aree per la logica personalizzata, le risorse generate o le classi richieste dagli schemi OpenAPI.

#region PSUHeader

1..100 | ForEach-Object {
    New-PSUEndpoint -Url "/endpoint/$_" -Endpoint { }
}

#endregion

New-PSUEndpoint -Url '/user' -Endpoint { }

#region PSUFooter
#endregion

File	Scopo
authentication.ps1	Configurazione dell'autenticazione tramite form.
aiAgents.ps1 e aiTools.ps1	Agenti e strumenti IA.
branding.ps1	Impostazioni di branding.
dashboards.ps1	Registrazione delle app e metadati.
endpoints.ps1	Definizioni degli endpoint API.
environments.ps1	Ambienti di esecuzione.
healthChecks.ps1	Controlli di integrità.
initialize.ps1	Viene eseguito prima dell'avvio dell'individuazione della configurazione.
licenses.ps1	Configurazione della licenza del prodotto.
middleware.ps1	Personalizzazione delle richieste HTTP.
publishedFolders.ps1	Cartelle pubblicate.
rateLimits.ps1	Limiti di frequenza.
roles.ps1	Ruoli.
schedules.ps1	Pianificazioni.
scripts.ps1	Metadati degli script; i percorsi degli script possono essere relativi al repository o assoluti.
settings.ps1	Impostazioni della piattaforma.
tags.ps1	Tag.
triggers.ps1	Trigger.
variables.ps1	Variabili.
vaults.ps1	Casseforti.
workflows.ps1	Definizioni dei flussi di lavoro quando i flussi di lavoro utilizzano la persistenza nel repository.

Modelli

Utilizzi la cartella Templates per fornire modelli per le risorse create più frequentemente nella console di amministrazione. Gli script PowerShell nelle cartelle seguenti vengono visualizzati come modelli:

• Templates\App
• Templates\AppPage
• Templates\Endpoint
• Templates\Script

.psuignore

Utilizzi .psuignore per escludere file e percorsi dal watcher del file system della configurazione. Questo è utile per i log o altri file archiviati accanto alla configurazione. Aggiunga un'espressione regolare per riga; i percorsi corrispondenti vengono ignorati.

logs.*
.git.*

Codifica dei file

Configuri la codifica dei file in Settings gear > General. Il valore predefinito è UTF-8 con un byte-order mark (utf-8-bom). Selezioni utf-8 per omettere il byte-order mark.

PowerShell Universal supporta le codifiche restituite da Encoding.GetEncodings, tra cui utf-32, utf-32-bom, utf-8, utf-8-bom e windows-1250. Aggiunga -bom a un nome di codifica per includere un byte-order mark.

Risorse del database

È possibile archiviare determinate risorse nel database invece che nel repository di configurazione. Le risorse basate sul database sono disponibili immediatamente su tutti i computer connessi in un cluster PowerShell Universal.

[!WARNING] Quando una risorsa è configurata per la persistenza nel database, PowerShell Universal ignora il relativo file di configurazione nel repository.

Le app, gli endpoint con percorsi, gli script e i moduli non possono utilizzare la persistenza nel database.

Configuri una risorsa impostando Data:Persistence:<ResourceType> su Database in appsettings.json, quindi riavvii PowerShell Universal. Ad esempio, in questo modo i flussi di lavoro vengono archiviati nel database invece che in .universal\workflows.ps1:

{
  "Data": {
    "Persistence": {
      "Workflow": "Database"
    }
  }
}

Imposti la variabile di ambiente equivalente prima di avviare PowerShell Universal:

Data__Persistence__Workflow=Database

Dopo il riavvio, i flussi di lavoro nuovi e modificati vengono salvati nel database e conservati tra i riavvii. I parametri dei flussi di lavoro seguono l'impostazione di persistenza del flusso di lavoro padre, pertanto vengono archiviati anch'essi nel database. Lo stesso schema di impostazione si applica a ogni risorsa del database supportata.

Ad esempio, quanto segue archivia le pianificazioni e i parametri delle pianificazioni nel database:

{
  "Data": {
    "Persistence": {
      "Schedule": "Database",
      "ScheduleParameter": "Database"
    }
  }
}