Select a Staging Location and Set Up a Drop Folder

When you define or queue a build definition, you can specify a path to a drop folder so that your build process can deliver binaries and log files to your team. Make sure the folder you’ve identified is prepared for use as a drop folder.

What do you want to do?

  • Set up a drop folder on a file share for your on-premises build controllers

  • Drop outputs into TFS when you use the Hosted Build Controller

Set up a drop folder on a file share for your on-premises build controllers

You can specify a path to a file share when you define or queue a build definition that is run by an on premises-build controller. The on-premises build controller can be dedicated to a team project collection on either an on-premises Team Foundation Server (TFS) or on Team Foundation Service.

Drop folders in a build system

Tip

If you see a TF270016 error in your build results log, it’s possible that the build server does not have the required permissions to access the drop folder. Follow the instructions below to resolve this problem.

Requirements

You must be a member of the Administrators group on the computer where the drop folder resides.

You can use a file share drop folder on the following operating systems:

  • Windows Server 2012

  • Windows Server 2008

  • Windows Server 2003

  • Windows 8

  • Windows 7

  • Windows Vista

To set up a drop folder on a file share

  1. Log on to the computer where the drop folder will reside.

  2. Open Windows Explorer (File Explorer in Windows 8), and browse to the folder that contains (or will contain) the drop folder.

  3. If necessary, create the drop folder.

    Tip

    Try to keep the path to the drop folder as short as possible (for example: c:\drops). The drop folder must not cause the build agent to produce any physical paths that contain more than 259 characters. Otherwise, your builds will fail and log the TF205022 error message.

  4. Open the shortcut menu for the folder, choose Properties, and then choose the Sharing tab.

  5. On Windows Server 2012, Windows Server 2008, Windows 8, Windows 7, and Windows Vista only: Choose Advanced Sharing.

    The Advanced Sharing dialog box appears.

  6. Select Share this folder, and then choose Permissions.

    The Permissions for FolderName dialog box appears.

  7. Choose Add.

    The Select Users, Computers, or Groups dialog box appears.

  8. Perform one of the following steps, depending on what type of account you’ve specified as the build service account on the build server that hosts your build controller:

    • NETWORK SERVICE running on the computer that contains the drop folder: In the Enter the object names to select box, enter NETWORK SERVICE.

    • NETWORK SERVICE running on a different computer from the one that contains the drop folder:

      1. Choose Object Types.

        The Object Types dialog box appears.

      2. Select the Computers check box, and then choose OK.

      3. Verify that the location is correct.

      4. In the Enter the object names to select box, enter BuildMachine$ where BuildMachine is the name of the build machine on which the build agent is running.

    • A domain account: Verify that the location is correct. In the Enter the object names to select box, enter the name of the account.

  9. Choose OK.

  10. Repeat the previous two steps for the build service account on the build server that hosts your build agents.

  11. In the Permissions for FolderName dialog box, choose the account that you just added to the Group or user names list.

  12. Select the Change and Read check boxes, and then choose OK.

Drop outputs into TFS when you use the Hosted Build Controller

When you use Visual Studio 2012 Update 1 (or a newer version) to create a build definition and the Hosted Build Controller to run it, you should drop the outputs into your Team Foundation Service server.

Drop outputs to TFS

Warning

Although the system accepts a version control drop folder as the staging location when you use Team Foundation Service, we do not recommend this approach.

If you do use a version control drop folder, you must designate a folder that is intended only for use as a drop folder. This folder must not contain any of your team’s code or other valuable source files. Otherwise, you risk destroying your source files.

To avoid degrading performance by downloading unnecessary files, make sure your dev machine workspace mappings and your build definition workspace mappings exclude the version control drop folder.

Note

If you use the version of Visual Studio 2012 released before Visual Studio 2012 Update 1 to edit the build definition, the Copy build output to the server option will be disabled.

Next Steps

Once you have identified and set up the drop folder, you can specify the path to this folder when you define your build and when you queue a build.