TeamCity On-Premises
 
2020.2
You are viewing the documentation for an earlier version of TeamCity On-Premises.
  1. TeamCity Documentation
  2. Administrator's Guide
  3. Managing Projects and Build Configurations
  4. Creating and Editing Build Configurations
  5. Configuring Build Steps
  6. Deployers
  7. SMB Upload

SMB Upload

Edit page
Last modified: 01 March 2021

The SMB Upload build runner enables TeamCity to upload files/directories to Windows shares via Server Message Block (SMB) protocol.

The settings common for all runners are described in Configuring Build Steps; this page details the SMB Upload settings.

tip

The fields below support parameter references: any text between percentage signs (%) is considered a reference to a property by TeamCity. To prevent TeamCity from treating the text in the percentage signs as a property reference, use two percentage signs to escape them: for example, if you want to pass %Y%m%d%H%M%S into the build, change it to %%Y%%m%%d%%H%%M%%S.

Option

Description

Deployment Target

Target URL

The URL should point to a host + share at least. Subdirectories are allowed here and will be created if missing. Valid examples:

\\host\share_name
\\host\share_name\some\path
\\host\c$\Temp

Note that the files with matching names will be rewritten in the target directory.

Name resolution

The DNS only name resolution allows switching JCIFS to "DNS-only" mode. May fix performance or out of memory exceptions (see this bitbucket issue for details). Is equivalent to following JCIFS settings:

-Djcifs.resolveOrder=DNS
-Djcifs.smb.client.dfs.disabled=true

Deployment Credentials

Username

Specify the username

Password

Specify the password

Domain

Specify the domain

Deployment Source

Path to sources

Specify the deployment sources as a newline- or comma-separated list of paths to files/directories.

The field supports Ant-style wildcard patterns (for example, dir/**/*.zip ).
You can also specify a target directory to be created using the file => directory pattern (for example, *.zip => winFiles,unix/distro.tgz => linuxFiles will create the winFiles and linuxFiles directories, and respectively put the declared files inside them).