IISWebAppDeploymentOnMachineGroup@0 - Attività distribuzione v0 dell'app Web IIS

Articolo
2025-03-24

Usare questa attività per distribuire un sito Web o un'applicazione Web usando Distribuzione Web.

Sintassi

# IIS web app deploy v0
# Deploy a website or web application using Web Deploy.
- task: IISWebAppDeploymentOnMachineGroup@0
  inputs:
    WebSiteName: # string. Required. Website Name. 
    #VirtualApplication: # string. Virtual Application. 
    Package: '$(System.DefaultWorkingDirectory)\**\*.zip' # string. Required. Package or Folder. Default: $(System.DefaultWorkingDirectory)\**\*.zip.
  # Advanced Deployment Options
    #SetParametersFile: # string. SetParameters File. 
    #RemoveAdditionalFilesFlag: false # boolean. Remove Additional Files at Destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Exclude Files from the App_Data Folder. Default: false.
    #TakeAppOfflineFlag: false # boolean. Take App Offline. Default: false.
    #AdditionalArguments: # string. Additional Arguments. 
  # File Transforms & Variable Substitution Options
    #XmlTransformation: false # boolean. XML transformation. Default: false.
    #XmlVariableSubstitution: false # boolean. XML variable substitution. Default: false.
    #JSONFiles: # string. JSON variable substitution.

Ingressi dati

WebSiteName - nome sito Web
string. Obbligatorio.

Specifica il nome di un sito Web esistente nei computer del gruppo di computer.

VirtualApplication - 'applicazione virtuale
string.

Specifica il nome di un'applicazione virtuale di Azure già esistente nei computer di destinazione.

Package - pacchetto o cartella
string. Obbligatorio. Valore predefinito: $(System.DefaultWorkingDirectory)\**\*.zip

Specifica il percorso del file del pacchetto o della cartella generato da MSBuild o da un file di archivio compresso. Sono supportate le variabili ( Build | Release) e i caratteri jolly. Ad esempio: $(System.DefaultWorkingDirectory)\**\*.zip.

SetParametersFile - SetParameters File
string.

Opzionale. Specifica il percorso del file SetParameters.xml da utilizzare.

RemoveAdditionalFilesFlag - rimuovere altri file nella di destinazione
boolean. Valore predefinito: false

Seleziona l'opzione per eliminare i file nell'app Web senza file corrispondenti nel pacchetto ZIP dell'app Web.

ExcludeFilesFromAppDataFlag - escludere i file dal cartella App_Data
boolean. Valore predefinito: false

Seleziona l'opzione per impedire la distribuzione dei file nella cartella App_Data nell'app Web.

TakeAppOfflineFlag - portare l'app offline
boolean. Valore predefinito: false

Seleziona l'opzione per portare l'app Web offline inserendo un file app_offline.htm nella directory radice dell'app Web prima dell'avvio dell'operazione di sincronizzazione. Il file verrà rimosso al termine dell'operazione di sincronizzazione.

AdditionalArguments - argomenti aggiuntivi
string.

Specifica altri argomenti di distribuzione Web applicati durante la distribuzione dell'app Web di Azure. Ad esempio, -disableLink:AppPoolExtension o -disableLink:ContentExtension.

Per un elenco degli argomenti distribuzione Web, vedere Web Deploy Operation Settings.

XmlTransformation - trasformazione XML
boolean. Valore predefinito: false

Specifica le trasformazioni di configurazione eseguite per *.Release.config e *.<EnvironmentName>.config nel *.config file. Le trasformazioni di configurazione vengono eseguite prima della sostituzione delle variabili. Le trasformazioni XML sono supportate solo in Windows.

XmlVariableSubstitution - sostituzione di variabili XML
boolean. Valore predefinito: false

Specifica le variabili definite nella pipeline di compilazione o versione. Queste variabili vengono confrontate con le voci key o name nelle sezioni appSettings, applicationSettings e connectionStrings di qualsiasi file di configurazione e parameters.xml. La sostituzione delle variabili viene eseguita dopo le trasformazioni di configurazione.

Nota: Se le stesse variabili sono definite nella pipeline di versione e nell'ambiente, le variabili di ambiente supereranno le variabili della pipeline di versione.

JSONFiles - sostituzione di variabili JSON
string.

Specifica un nuovo elenco separato da righe di file JSON per sostituire i valori delle variabili. I nomi dei file devono essere relativi alla cartella radice.

Per sostituire le variabili JSON annidate o gerarchiche, specificarle usando espressioni JSONPath. Ad esempio, per sostituire il valore di ConnectionString nell'esempio seguente, è necessario definire una variabile come Data.DefaultConnection.ConnectionString nella pipeline di compilazione o versione (o nella fase della pipeline di versione).

{  
  "Data": {  
    "DefaultConnection": {  
      "ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"  
    }  
  }  
}

La sostituzione delle variabili viene eseguita dopo le trasformazioni di configurazione.

Nota: le variabili della pipeline vengono escluse in sostituzione.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni:

Usare questa attività per distribuire un sito Web o un'app Web usando WebDeploy.

Requisiti

Requisito	Descrizione
Tipi di pipeline	Versione classica
Viene eseguito in	Agente, DeploymentGroup
richieste	Nessuno
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Qualunque
variabili impostabili	Qualunque
Versione dell'agente	2.104.1 o versione successiva
Categoria attività	Distribuire

Condividi tramite