FtpUpload@1 - Attività caricamento FTP v1

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

Sintassi

# FTP upload v1
# Upload files using FTP.
- task: FtpUpload@1
  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.
    #overwrite: true # boolean. Overwrite. Default: true.
    #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, quindi immettere l'URL del server FTP per l'URL del server, ad esempio ftp://server.example.come le credenziali necessarie.

Le connessioni protette 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. Connections ai server che non supportano FTPS avrà 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.

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.

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

Elimina la directory remota, incluso il relativo contenuto, prima del caricamento.

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

Elimina in modo ricorsivo tutto il contenuto nella directory remota prima del caricamento. La directory esistente non verrà eliminata. Per ottenere prestazioni migliori, usare clean invece .

overwrite - Sovrascrivere
boolean. Valore predefinito: true.

Sovrascrive i file esistenti nella directory remota.

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

Se questa opzione è 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 valore booleano è selezionato, il file viene caricato in /uploads/foo/bar/foobar.txt. Se questo valore booleano non è selezionato, il file viene caricato in /uploads/foobar.txt.

trustSSL - Trust server certificate (Certificato server attendibile)
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).

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

Nota

È disponibile una versione più recente di questa attività in FtpUpload@2.

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

• Informazioni di riferimento per i criteri di corrispondenza dei file

Requisiti

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	Questa attività viene eseguita usando le restrizioni di comando seguenti: con restrizioni
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à