Condividi tramite


FtpUpload@2 - Attività di caricamento FTP v2

Usare questa attività per caricare i file in un computer remoto usando FTP o in modo sicuro con FTPS.

Sintassi

# FTP upload v2
# Upload files using FTP.
- task: FtpUpload@2
  inputs:
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required. Authentication Method. Default: serviceEndpoint.
    serverEndpoint: # string. Required when credsType = serviceEndpoint. FTP Service Connection. 
    #serverUrl: # string. Required when credsType = inputs. Server URL. 
    #username: # string. Required when credsType = inputs. Username. 
    #password: # string. Required when credsType = inputs. Password. 
    #implicitFTPS: false # boolean. Use implicit FTPS. Default: false.
    rootDirectory: # string. Alias: rootFolder. Required. Root folder. 
    filePatterns: '**' # string. Required. File patterns. Default: **.
    remoteDirectory: '/upload/$(Build.BuildId)/' # string. Alias: remotePath. Required. Remote directory. Default: /upload/$(Build.BuildId)/.
  # Advanced
    #enableUtf8: false # boolean. Enable UTF8 support. Default: false.
    #clean: false # boolean. Delete remote directory. Default: false.
    #cleanContents: false # boolean. Optional. Use when clean = false. Clear remote directory contents. Default: false.
    #preservePaths: false # boolean. Preserve file paths. Default: false.
    #trustSSL: false # boolean. Trust server certificate. Default: false.
    #customCmds: # string. FTP Commands.
# FTP upload v2
# Upload files using FTP.
- task: FtpUpload@2
  inputs:
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required. Authentication Method. Default: serviceEndpoint.
    serverEndpoint: # string. Required when credsType = serviceEndpoint. FTP Service Connection. 
    #serverUrl: # string. Required when credsType = inputs. Server URL. 
    #username: # string. Required when credsType = inputs. Username. 
    #password: # string. Required when credsType = inputs. Password. 
    rootDirectory: # string. Alias: rootFolder. Required. Root folder. 
    filePatterns: '**' # string. Required. File patterns. Default: **.
    remoteDirectory: '/upload/$(Build.BuildId)/' # string. Alias: remotePath. Required. Remote directory. Default: /upload/$(Build.BuildId)/.
  # Advanced
    #enableUtf8: false # boolean. Enable UTF8 support. Default: false.
    #clean: false # boolean. Delete remote directory. Default: false.
    #cleanContents: false # boolean. Optional. Use when clean = false. Clear remote directory contents. Default: false.
    #preservePaths: false # boolean. Preserve file paths. Default: false.
    #trustSSL: false # boolean. Trust server certificate. Default: false.
    #customCmds: # string. FTP Commands.
# FTP upload v2
# Upload files using FTP.
- task: FtpUpload@2
  inputs:
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required. Authentication Method. Default: serviceEndpoint.
    serverEndpoint: # string. Required when credsType = serviceEndpoint. FTP Service Connection. 
    #serverUrl: # string. Required when credsType = inputs. Server URL. 
    #username: # string. Required when credsType = inputs. Username. 
    #password: # string. Required when credsType = inputs. Password. 
    rootDirectory: # string. Alias: rootFolder. Required. Root folder. 
    filePatterns: '**' # string. Required. File patterns. Default: **.
    remoteDirectory: '/upload/$(Build.BuildId)/' # string. Alias: remotePath. Required. Remote directory. Default: /upload/$(Build.BuildId)/.
  # Advanced
    #clean: false # boolean. Delete remote directory. Default: false.
    #cleanContents: false # boolean. Optional. Use when clean = false. Clear remote directory contents. Default: false.
    #preservePaths: false # boolean. Preserve file paths. Default: false.
    #trustSSL: false # boolean. Trust server certificate. Default: false.

Input

credentialsOption - Metodo di autenticazione
Alias di input: credsType. string. Obbligatorio. Valori consentiti: serviceEndpoint (connessione al servizio FTP), inputs (Immettere le credenziali). Valore predefinito: serviceEndpoint.

Specifica il metodo di autenticazione. Usare una connessione al servizio FTP o immettere le credenziali di connessione.


serverEndpoint - Connessione al servizio FTP
string. Obbligatorio quando credsType = serviceEndpoint.

Specifica la connessione al servizio per il server FTP. Per crearne uno, fare clic sul collegamento Gestisci e creare una nuova connessione al servizio generico e quindi immettere l'URL del server FTP per l'URL del server, ad esempio ftp://server.example.com, e le credenziali necessarie.

Le connessioni sicure verranno sempre effettuate indipendentemente dal protocollo specificato (ftp:// o ftps://) se il server di destinazione supporta FTPS. Per consentire solo connessioni sicure, usare il ftps:// protocollo, ad esempio ftps://server.example.com. Le connessioni ai server che non supportano FTPS avranno esito negativo se ftps:// specificato.


serverUrl - Server URL
string. Obbligatorio quando credsType = inputs.

Specifica l'URL per il server FTP.


username - Nome utente
string. Obbligatorio quando credsType = inputs.

Specifica il nome utente per la connessione FTP.


password - Password
string. Obbligatorio quando credsType = inputs.

Specifica la password per la connessione FTP.


implicitFTPS - Usare FTPS implicito
boolean. Valore predefinito: false.


rootDirectory - Cartella radice
Alias di input: rootFolder. string. Obbligatorio.

Specifica la cartella di origine da cui caricare i file.


filePatterns - Modelli di file
string. Obbligatorio. Valore predefinito: **.

Specifica i percorsi o i modelli di file da caricare. La stringa supporta più righe di modelli minimatch. Altre informazioni sui modelli di corrispondenza dei file.


remoteDirectory - Directory remota
Alias di input: remotePath. string. Obbligatorio. Valore predefinito: /upload/$(Build.BuildId)/.

Specifica la directory nel server FTP remoto in cui l'attività carica i file.


enableUtf8 - Abilitare il supporto UTF8
boolean. Valore predefinito: false.

Abilita il supporto UTF-8 per la connessione FTP (OPTS UTF8 ON).


clean - Eliminare la directory remota
boolean. Valore predefinito: false.

Elimina la directory remota, incluso il relativo contenuto, prima di caricare.


cleanContents - Cancellare il contenuto della directory remota
boolean. facoltativo. Usare quando clean = false. Valore predefinito: false.

Elimina in modo ricorsivo tutti i contenuti nella directory remota prima del caricamento. La directory esistente non verrà eliminata. Per migliorare le prestazioni, usare clean invece.


preservePaths - Mantenere i percorsi dei file
boolean. Valore predefinito: false.

Se selezionata, la struttura di directory locale relativa viene ricreata nella directory remota in cui vengono caricati i file. In caso contrario, i file vengono caricati direttamente nella directory remota senza creare sottodirectory aggiuntive.

Si supponga, ad esempio, che la cartella di origine sia /home/user/source/, che contiene il file foo/bar/foobar.txte che la directory remota sia: /uploads/. Se questo booleano è selezionato, il file viene caricato in /uploads/foo/bar/foobar.txt. Se questo booleano non è selezionato, il file viene caricato in /uploads/foobar.txt.


trustSSL - Certificato del server di attendibilità
boolean. Valore predefinito: false.

Considera attendibile il certificato SSL del server FTP con ftps://, anche se è autofirmato o non può essere convalidato da un'autorità di certificazione (CA).


customCmds - Comandi FTP
string.

I comandi FTP facoltativi che verranno inviati al server FTP remoto al momento della connessione.


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 caricare i file in un computer remoto usando FTP o in modo sicuro con FTPS.

Dove è possibile ottenere altre informazioni sui modelli di corrispondenza dei file?

Requisiti

Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Esecuzione in Agente, DeploymentGroup
Richieste Nessuno
Capabilities Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi Questa attività viene eseguita usando le restrizioni di comando seguenti: limitato
Variabili impostabili Questa attività dispone dell'autorizzazione per impostare le variabili seguenti: l'impostazione delle variabili è disabilitata
Versione agente 2.182.1 o versione successiva
Categoria attività Utilità
Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Viene eseguito in Agente, DeploymentGroup
Richieste Nessuno
Capabilities Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi Qualsiasi
Variabili impostabili Qualsiasi
Versione agente Tutte le versioni dell'agente supportate.
Categoria attività Utilità

Vedi anche