FtpUpload@1 - Attività di caricamento FTP v1

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

Questa versione dell'attività è deprecata; usare FtpUpload@2.

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.

Ingressi dati

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 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 protocollo ftps://, ad esempio ftps://server.example.com. Le connessioni ai server che non supportano FTPS avranno esito negativo se viene specificato ftps://.

URL del server serverUrl -
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 di 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. Opzionale. 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 prestazioni migliori, usare invece clean.

overwrite - Sovrascrivere
boolean. Valore predefinito: true

Sovrascrive i file esistenti nella directory remota.

preservePaths - Mantieni percorsi di 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 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 - certificato del server trust
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
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Questa attività viene eseguita usando le restrizioni del comando seguenti: con restrizioni
variabili impostabili	Questa attività dispone dell'autorizzazione per impostare le variabili seguenti: L'impostazione delle variabili è disabilitata
Versione dell'agente	2.182.1 o versione successiva
Categoria attività	Utilità