Azioni di rilascio per distribuire un'app per Release Management
È possibile aggiungere azioni di rilascio per definire la sequenza di distribuzione per ogni fase del rilascio. In ogni azione viene utilizzato uno strumento specifico per eseguire un comando con un set di argomenti.
Se non è stato ancora creato il percorso di rilascio, andare qui per farlo.
Trascinare un'azione di rilascio dalla casella degli strumenti per aggiungerla alla sequenza di distribuzione. Utilizzare una qualsiasi delle azioni di rilascio predefinite elencate nella casella degli strumenti o creare azioni di rilascio personalizzate.
.png "Scheda Configura applicazioni, scheda Modelli versione")
Dopo aver aggiunto un'azione di rilascio alla sequenza, è possibile modificare le variabili di configurazione in base alle esigenze. Per informazioni dettagliate sulle azioni di rilascio predefinite e sulle variabili di configurazione relative, vedere qui. Vengono fornite qui informazioni sugli strumenti utilizzati dalle azioni di rilascio.
Aggiungere un'azione di rilascio personalizzata
Aggiungere una nuova azione di rilascio e scegliere lo strumento che si desidera venga utilizzato dall'azione. In alternativa, è possibile copiare un'azione esistente e utilizzarla come base per creare un'azione di rilascio personalizzata. Non è possibile modificare un'azione di rilascio esistente.
In Release Management Client aprire la pagina Inventario. Se la pagina non viene visualizzata, richiedere l'autorizzazione Si può gestire l'inventario.
Copiare l'azione da modificare o aggiungere una nuova azione.
.png "Copiare un'azione di rilascio")
Selezionare lo strumento da utilizzare in base ai requisiti per l'azione. Scegliere Nuovo per aggiungere uno strumento personalizzato se gli strumenti predefiniti non sono in grado di eseguire le operazioni richieste per il passaggio della sequenza di distribuzione.
Nella sezione Esecuzione immettere gli argomenti richiesti con i relativi token nel formato necessario. È necessario aggiungere questo simbolo come prefisso e suffisso a ogni parametro: __. Tutte le volte che si eliminano o si aggiungono argomenti con i token relativi, tali argomenti vengono visualizzati nell'elenco Parametri.
Ad esempio è possibile aggiungere i seguenti parametri con i token: -servername __servername__ -switch __onoff__, Adesso servername e onoff vengono visualizzati nell'elenco di parametri.
Per disattivare un'azione di rilascio
- Se sono presenti alcune azioni che non si desidera vengano utilizzate dal team, è possibile disattivarle. Aprire l'azione nella pagina Inventario, quindi scegliere il pulsante Disattiva.
Per riattivare un'azione di rilascio
Aprire l'elenco Inattivo, aprire l'azione e scegliere Attiva.
.png "Elenco inattivo nella pagina Inventario")
D & R
.gif "Ff425471.collapse_all(it-it,VS.120).gif")
D: Quali autorizzazioni sono necessarie per modificare le azioni di rilascio?
R: Per modificare o aggiungere azioni di rilascio, gli utenti devono disporre dell'autorizzazione Si può gestire l'inventario. Se l'autorizzazione non è abilitata, la pagina Inventario non viene visualizzata.
Se l'opzione Nessuno strumento è selezionata, i campi Comando e Argomenti non sono modificabili a meno che l'utente non disponga dell'autorizzazione Si può utilizzare lo strumento personalizzato in azioni e componenti. In Configura applicazioni, Componenti, quando un utente non dispone dell'autorizzazione Si può utilizzare lo strumento personalizzato in azioni e componenti i campi Comando e Argomenti non sono modificabili quando è selezionata l'opzione Nessuno strumento.
Azioni e variabili di configurazione per azioni di rilascio
Gestire pool di applicazioni e siti Web
Creare o modificare file INI
Gestire database SQL Server
Impostare i server in uso
Gestire servizi Windows
Gestire pool di applicazioni e siti Web
Tali azioni utilizzano lo strumento IIS Deployer per gestire pool di applicazioni, siti Web, applicazioni Web e directory virtuali. Tali azioni sono supportate in IIS 7.0, 7.5, 8.0 e 8.5. Per informazioni dettagliate su questo strumento, andare qui.
Azione |
Utilizzo e condizioni di errore della distribuzione |
|---|---|
.png "spazio vuoto") |
Crea pool di applicazioni: consente agli utenti di creare un nuovo pool di applicazioni in IIS. Per IIS 7.0, 7.5, 8.0 e 8.5. Se il pool di applicazioni esiste già, viene riconfigurato in base ai valori delle variabili di configurazione definite (le variabili di configurazione non definite non influiscono sulla configurazione effettiva dell'applicazione Web). Con le versioni di IIS precedenti alla 7.0, se il pool di applicazioni esiste già, la distribuzione restituisce un errore. Configura pool di applicazioni, Riciclo di pool di applicazioni, Avvia pool di applicazioni o Arresta pool di applicazioni: consentono di riconfigurare, riciclare, avviare o arrestare un pool di applicazioni. Se il pool di applicazioni non esiste, la distribuzione avrà esito negativo. |
|
Crea sito Web: consente di creare un nuovo sito Web in IIS. Per IIS 7.0, 7.5, 8.0 e 8.5. Se il sito Web esiste già, verrà riconfigurato in base ai valori delle variabili di configurazione definite (le variabili di configurazione non definite non influiscono sulla configurazione effettiva del sito Web). Con le versioni di IIS precedenti alla 7.0, se il pool di applicazioni esiste già, la distribuzione restituisce un errore. Configura sito Web, Riavvia sito Web, Avvia sito Web, Arresta sito Web: consentono di riconfigurare, riavviare, avviare o arrestare un sito Web. Se il sito Web non esiste, la distribuzione avrà esito negativo. |
|
Crea applicazione Web: consente di creare una nuova applicazione Web in IIS. Per IIS 7.0, 7.5, 8.0 e 8.5. Se l'applicazione Web esiste già, verrà riconfigurata in base ai valori delle variabili di configurazione definite (le variabili di configurazione non definite non influiscono sulla configurazione effettiva dell'applicazione Web). Con le versioni di IIS precedenti alla 7.0, se il pool di applicazioni esiste già, la distribuzione restituisce un errore. Configura applicazione Web: consente di riconfigurare un'applicazione Web. Se l'applicazione Web non esiste, la distribuzione avrà esito negativo. |
|
Crea directory virtuale: consente di creare una directory virtuale in IIS. Per IIS 7.0, 7.5, 8.0 e 8.5. Se la directory virtuale esiste già, viene riconfigurata in base ai valori delle variabili di configurazione definite (le variabili di configurazione non definite non influiscono sulla configurazione effettiva della directory virtuale). Configura directory virtuale: consente di riconfigurare una directory virtuale. Se la directory virtuale non esiste, la distribuzione avrà esito negativo. |
Variabili di configurazione
Parametri |
Obbligatorio |
Descrizione |
|---|---|---|
AppPoolName |
Sì [azioni del pool di applicazioni] No [azioni del sito Web] |
Nome del pool di applicazioni da configurare, creare, riciclare, rimuovere, avviare o arrestare [azione del pool di applicazioni]. Nome del pool di applicazioni da utilizzare per un sito Web nuovo o modificato [azione del sito Web]. |
DotNetVersion |
No |
Versione di .NET Framework da utilizzare per il pool di applicazioni. Questo parametro è consentito solo per IIS 7.5, 8.0 e 8.5. I valori consentiti sono v1.0, v1.1, v2.0 o v4.0. |
IdentityUserDomain |
No |
Dominio dell'utente da utilizzare come identità del pool di applicazioni. Se non è definito e "IdentityUserName" è definito, l'utente viene considerato come locale, ovvero .\localuser. |
IdentityUserName |
No |
Nome utente da utilizzare come identità del pool di applicazioni. Se non è definito, i parametri IdentityUserDomain e IdentityUserPassword vengono ignorati e viene utilizzato il valore predefinito di IIS, ovvero ApplicationPoolIdentity. |
IdentityUserPassword |
No |
Password dell'utente da utilizzare come identità del pool di applicazioni. |
Is32BitsAllowed |
No |
Flag per consentire o non consentire l'esecuzione di applicazioni a 32 bit nel pool di applicazioni. I valori consentiti sono:
|
IsAutoStart |
No |
Flag che indica se il pool di applicazioni o il sito Web deve essere avviato automaticamente all'avvio di Windows. I valori consentiti sono:
|
IsPreloadEnabled |
No |
Flag che indica se la funzionalità di precaricamento è abilitata per l'applicazione o il sito Web. I valori consentiti sono:
|
PhysicalPath |
Sì [azione di creazione] No [tutte le altre azioni di directory virtuale, sito Web e applicazione Web] |
Percorso fisico completo della directory virtuale, del sito Web o dell'applicazione Web. |
PipeLineMode |
No |
Modalità pipeline gestita da utilizzare nel pool di applicazioni. I valori consentiti sono:
|
PortNumber |
Sì [solo azione di creazione] |
Numero di porta da utilizzare per un sito Web nuovo o modificato. |
ProcessIdleTimeOut |
No |
Numero di minuti durante i quali un processo può rimanere inattivo nel pool di applicazioni. |
RecycleAfterMinutes |
No |
Numero fisso di minuti dopo i quali il pool di applicazioni viene riciclato. |
RecycleFixedTime |
No |
Ora fissa a cui il pool di applicazioni viene riciclato. Il formato richiesto è HH:MM, ad esempio 23:58 o 01:23. |
RecycleKbMemory |
No |
Numero massimo di KB di memoria da utilizzare prima di riciclare il pool di applicazioni. |
SiteName |
Sì [azione di sito Web] No [azione di directory virtuale] |
Nome del sito Web da creare, configurare, rimuovere, avviare o arrestare. [azione del sito Web]. Nome del sito Web in cui risiede la directory virtuale. Se non è definito, viene utilizzato il sito Web predefinito [azione di directory virtuale]. |
StartMode |
No |
Modalità di avvio da utilizzare per il pool di applicazioni. I valori consentiti sono:
|
VirtualDirectoryName |
Yes |
Nome della directory virtuale da creare, configurare o rimuovere. |
WebApplicationName |
No |
Nome dell'applicazione Web in cui risiede la directory virtuale. Se non è definito, viene utilizzata l'applicazione Web radice del sito Web. |
WebAppName |
Yes |
Nome dell'applicazione Web da configurare, creare o rimuovere. |
WebSiteName |
Sì [azione di sito Web] No [azione di applicazione Web] |
Nome del sito Web da configurare, creare, rimuovere, avviare o arrestare. [azione del sito Web]. Nome del sito Web in cui risiede l'applicazione Web. Se non è definito, viene utilizzato il sito Web predefinito [azione di applicazione Web]. |
Creare o modificare file INI
Tali azioni del file INI utilizzano lo strumento Gestore file INI per aggiungere, modificare o rimuovere sezioni e chiavi dal file. Per informazioni dettagliate su questo strumento, andare qui.
Azione |
Descrizione |
|---|---|
Crea chiave |
Consente di creare una nuova chiave con un valore in una sezione specifica di un file INI. Se il file specificato non esiste, l'azione consente di crearlo. Se l'azione specificata non esiste, l'azione consente di crearla. Se la chiave esiste già nella sezione specificata, l'azione consente di sostituirne il valore. |
Modifica chiave |
Consente di modificare una chiave esistente con un nuovo valore in una sezione specifica di un file INI. Se il file specificato non esiste, l'azione consente di crearlo. Se l'azione specificata non esiste, l'azione consente di crearla. Se la chiave esiste già nella sezione specificata, l'azione consente di aggiungerla. |
Modifica valore |
Consente di modificare il valore di una chiave esistente in una sezione specifica di un file INI. Se il file specificato non esiste, l'azione consente di crearlo. Se l'azione specificata non esiste, l'azione consente di crearla. Se la chiave non esiste nella sezione specificata, l'azione consente di aggiungerla. |
Rimuovi chiave |
Consente di rimuovere una chiave e i valori relativi da una sezione specifica di un file INI. Se il file specificato non esiste, l'azione avrà esito negativo. Se la sezione o la chiave specificata non esiste, l'azione viene comunque eseguita in modo corretto. Se si specifica la rimozione di tutte le chiavi da una sezione, l'azione consente di rimuovere anche la sezione. |
Modifica sezione |
Consente di modificare il nome di una sezione in un file INI. Se il file specificato non esiste, l'azione consente di crearlo. Se la sezione specificata non esiste, l'azione viene comunque eseguita in modo corretto. |
Rimuovi sezione |
Consente di rimuovere una sezione e tutti i relativi valori e le chiavi in un file INI. Se il file specificato non esiste, l'azione avrà esito negativo. Se la sezione specificata non esiste, l'azione viene comunque eseguita in modo corretto. |
Variabili di configurazione
Parametri |
Obbligatorio |
Descrizione |
|---|---|---|
INIFile |
Yes |
Nome e percorso, se necessari, del file INI da modificare. |
KeyName |
Yes |
Nome della chiave da creare, modificare o rimuovere. |
KeyValue |
No |
Nuovo valore da assegnare a una chiave. Se non specificato e se NewKeyName è specificato, verrà utilizzato il valore effettivo. Se non specificato e se NewKeyName non è specificato, il valore viene lasciato vuoto. |
NewKeyName |
No |
Nuovo nome da assegnare a una chiave. Se non viene specificato, il nome della chiave non viene modificato. |
NewSectionName |
No |
Nuovo nome da assegnare a un nome di sezione. Se non viene specificato, le chiavi della sezione precedente vengono posizionate nella sezione radice (tutte le chiavi che si trovano all'inizio del file prima della prima sezione sono considerate la radice). |
SectionName |
No |
[azione di creazione o modifica chiave] Nome della sezione in cui una chiave deve essere aggiunta o modificata. Se non specificato, l'azione consente di aggiornare la sezione radice. .gif "Nota") Nota
Tutte le chiavi che si trovano all'inizio del file prima della prima sezione sono considerate come presenti nella radice.
[azione di ridenominazione] Nome della sezione da rinominare. Se non specificato, le chiavi della sezione precedente sono posizionate sotto la sezione radice. [azione di rimozione] Nome della sezione da rimuovere. Se non specificato, la sezione radice viene rimossa. |
Gestire database SQL Server
Tali azioni utilizzano lo strumento Deployer database - Esegui script per creare, eliminare e ripristinare un database di SQL Server o eseguirne il backup. Per informazioni dettagliate su questo strumento, andare qui.
Azioni |
Descrizione |
|---|---|
Creare database SQL |
Consente di creare un nuovo database. Se il database esiste già, l'azione avrà esito negativo. |
Elimina database SQL |
Consente di eliminare un database. Se il database non esiste, l'azione avrà esito negativo. |
Esegui backup del database SQL |
Consente di eseguire il backup di un database esistente in un percorso specificato. |
Ripristina database SQL |
Consente di ripristinare un database da un'origine specificata. |
Variabili di configurazione
Parametri |
Obbligatorio |
Descrizione |
|---|---|---|
DatabaseName |
Yes |
Nome del database di SQL Server da creare, eliminare o ripristinare o di cui eseguire il backup. |
Path |
Yes |
Percorso e nome file da utilizzare per archiviare il backup del database, ad esempio \\server\nomefile.bak. |
ServerName |
Yes |
Nome del server in cui creare, ripristinare o eliminare il database SQL o in cui eseguirne il backup. |
Source |
Yes |
Percorso e nome file del backup del database da utilizzare per ripristinare il database. |
Impostare i server in uso
Tali azioni consentono di impostare il computer server se quest'ultimo esegue un sistema operativo Windows. È possibile eseguire comandi e terminare processi nonché gestire file, cartelle, variabili di ambiente e chiavi e valori del Registro di sistema di Windows. Tali azioni vengono eseguite nel sistema tramite diversi strumenti predefiniti di Release Management, ad esempio Esecuzione riga di comando, Processo Windows e Deployer XCopy. Per informazioni dettagliate sugli strumenti, andare qui.
Azione |
Note e condizioni di errore della distribuzione |
|---|---|
|
Utilizzare Esegui riga di comando per eseguire un comando tramite l'identità di Deployment Agent. Utilizzare Esegui riga di comando come utente per eseguire un comando con le credenziali dell'utente specifico. |
|
Tali azioni supportano la creazione, la modifica e l'eliminazione di file, cartelle e attributi selezionati. Quando si creano file o cartelle, viene creata anche ogni directory padre non esistente della cartella da creare. |
|
Tali azioni supportano la creazione, la modifica e l'eliminazione di variabili di ambiente. |
|
Tali azioni supportano la creazione, la modifica e l'eliminazione di chiavi e valori del Registro di sistema. La sequenza di distribuzione avrà esito negativo solo quando si tenta di modificare una chiave del Registro di sistema che non esiste. |
Variabili di configurazione per eseguire comandi o terminare un processo
Parametri |
Obbligatorio |
Descrizione |
|---|---|---|
Arguments |
No |
Argomenti necessari per eseguire la riga di comando. |
command |
Yes |
Valore fisso ./WindowsProcess.ps1. |
FilePath |
No |
Dominio dell'utente da utilizzare come identità del pool di applicazioni. Se non è definito e IdentityUserName è definito, l'utente verrà considerato come locale, ovvero .\localuser. |
IsKillProcessTree |
No |
Indica se terminare l'albero processi. I valori consentiti sono:
|
ProcessName |
Yes |
Nome del processo Windows da terminare. |
UserDomain |
No |
Dominio dell'utente da utilizzare per eseguire l'eseguibile. Se non specificato, viene assegnato il valore .\localuser. |
UserName |
Sì [azione di esecuzione comando] No [azione di terminazione processo] |
Nome dell'utente da utilizzare per eseguire l'eseguibile. Account utente che esegue il processo. Se non viene specificato, il processo viene terminato per tutti gli utenti. |
UserPassword |
No |
Password dell'utente da utilizzare per eseguire l'eseguibile. |
Variabili di configurazione per gestire file e cartelle
Parametri |
Obbligatorio |
Descrizione |
|---|---|---|
Archive |
No |
Consente di impostare o reimpostare l'attributo Archive per uno o più file o per una cartella.
|
DestinationFileFolder |
Versione di .NET Framework da utilizzare per il pool di applicazioni. Questo parametro è consentito solo per IIS 7.5, 8.0 e 8.5. I valori consentiti sono v1.0, v1.1, v2.0 o v4.0. |
|
DestinationName |
Yes |
Percorso di destinazione in cui copiare o spostare file o cartelle. In alternativa, nuovo nome da assegnare al file o alla cartella da rinominare. |
FileFolderName |
Yes |
File o cartella di origine da eliminare, modificare, spostare o rinominare. Per l'azione di eliminazione, è possibile utilizzare caratteri jolly, ad esempio c:, temp o *.log. |
FolderName |
Yes |
Nome e percorso della cartella da creare. |
Hidden |
No |
Consente di impostare o reimpostare l'attributo Hidden per i file o per una cartella.
|
OwnerDomain |
No |
Dominio del nuovo proprietario dei file o della cartella. Se non specificato, viene assegnato il valore .\localuser. |
OwnerDomain |
Yes |
Nome del nuovo proprietario dei file o della cartella. |
ReadOnly |
Consente di impostare o reimpostare l'attributo ReadOnly per i file o per una cartella.
|
|
SourceFileFolder |
Yes |
File o cartella di origine da copiare. È possibile utilizzare caratteri jolly, ad esempio c:, temp o *.log. |
System |
Consente di impostare o reimpostare l'attributo System per uno o più file o per una cartella.
|
Variabili di configurazione per le azioni di variabili di ambiente
Parametri |
Obbligatorio |
Descrizione |
|---|---|---|
VariableName |
Yes |
Nome della variabile da creare, modificare o eliminare |
VariableValue |
No |
Valore da assegnare alla variabile aggiunta o modificata. Se non viene impostato alcun valore, la variabile viene eliminata. |
Variabili di configurazione per le azioni del Registro di sistema di Windows
Parametri |
Obbligatorio |
Descrizione |
|---|---|---|
NewRegistryKey |
Yes |
Nome completo della chiave del Registro di sistema di destinazione, ad esempio HKLM, Software o NEWKEY. |
OperatingSystemType |
No |
Tipo di sistema operativo in cui creare la chiave del Registro di sistema. I valori consentiti sono:
|
RegistryData |
No |
Dati da assegnare al valore del Registro di sistema. |
RegistryKey |
Yes |
Nome completo della chiave del Registro di sistema da creare, modificare o eliminare, ad esempio HKLM, Software o NEWKEY. |
RegistryValue |
Yes |
Nome del valore del Registro di sistema da aggiungere o modificare. |
ValueType |
No |
Tipo di dati del valore del Registro di sistema. I valori consentiti sono:
|
Gestire servizi Windows
Tali azioni utilizzano lo strumento Gestione servizio Windows predefinito per creare, configurare, eliminare, riavviare, avviare e arrestare un servizio Windows. Per informazioni dettagliate su questo strumento, andare qui.
Azione |
Utilizzo e condizioni di errore della distribuzione |
|---|---|
|
Utilizzare Crea servizio per creare un nuovo servizio. Se il servizio esiste già, la sequenza di distribuzione avrà esito negativo. Utilizzare Configura servizio per configurare un servizio esistente. Se il servizio non esiste, la sequenza di distribuzione avrà esito negativo. Utilizzare Configura credenziali servizio per configurare un servizio esistente con nuove credenziali. Se il servizio non esiste, la sequenza di distribuzione avrà esito negativo. La sequenza di distribuzione avrà inoltre esito negativo se la variabile ServiceName specificata non esiste quando si indica di avviare, arrestare o riavviare un servizio, mentre non avrà esito negativo se il servizio è già avviato o arrestato. |
Variabili di configurazione
Parametri |
Obbligatorio |
Descrizione |
|---|---|---|
BinPath |
No |
Nome e percorso binario del servizio. |
Description |
Yes |
Descrizione del servizio da creare o configurare. |
DisplayName |
No |
Nome del servizio da creare o configurare. |
Password |
No |
Password del nome utente specificato per avviare il servizio. |
ServiceName |
Yes |
Nome del servizio da creare, configurare, eliminare, riciclare, avviare o arrestare. |
StartMode |
No |
Modalità di avvio del servizio. I valori consentiti sono:
|
UserName |
Yes |
Nome utente utilizzato per le credenziali per l'avvio del servizio. Utilizzare il formato DOMINIO\UTENTE, ad esempio NT AUTHORITY\NETWORK SERVICE. Se si specifica UserName, è necessario specificare anche Password. Per reimpostare le credenziali su LocalSystem, immettere LocalSystem come utente e "" come password. |