Partial Deploy File Object Types

This functionality became available in the 4.5.1 release.


The file plugin partial deploy support allows for deploying File and Folder type objects. This page explains the two types and their attributes.

File Objects

File type objects model files that are stored in SCM. They are used to copy files from an SCM to a filesystem on an endpoint. File objects can be sourced only from an SCM. They cannot be created manually. No attributes are required.

Subfolders to the final target location of the file are created by the plugin as long as the endpoint user has sufficient privileges.



Attributes

Name
Description
Default Value
Target

This is the location where the file will be placed. Property replacement will be performed on the value.

If blank, the file will be copied into FD_TEMP_DIR. If the default is used, but the FDFILE_ROOT_TARGET_FOLDER project property is left blank, then the file will be copied into FD_TEMP_DIR.

${{FDFILE_ROOT_TARGET_FOLDER}}
Use Source Path

If this is NOT checked, the file will be placed directly in target.

If it is checked, the whole File Name with path will be placed inside the target.

Use Source Path Default is the project property to control the default.

Owner:Group

Set the owner or owner:group of the file to this value.

This only work on Unix endpoints. On Windows endpoints, it is ignored.

Owner:Group File Default is the project property to control the default.
Permission

Set the permissions of the file to this value.

This only work on Unix endpoints. On Windows endpoints, it is ignored.

If it is not set, and Execute is checked, chmod +x will be run on the file if it is a Unix endpoint.

Permissions File Default is the project property to control the default.
Property ReplacementIf checked, property replacement will be run on the file, unless it appears to be a binary file, and then it will be skipped for property replacement.Property Replacement Defaultis the project property to control the default.
ExecuteIf checked the file will be executed. This works on both Windows and Unix.Execute Default is the project property to control the default.
Ignore FailureIf checked, the file and the execution will be marked successful even if it fails to be processed in any way. The failure will still be logged, but there will be no other indication.Ignore Failure Defaultis the project property to control the default.

Folder Objects

Folder objects are created manually. They cannot be populated from SCM, but it is possible to add a folder that replicates one in an SCM.

You can "Create" a folder that already exists on the file system for the purpose of changing attributes on the existing directory. This can be done on folders that are created as part of the SCM structure, or any other folders desired on the file system.

Attributes

Name
Description
Default Value

Target Location

This is the location where the file will be placed. Property replacement will be performed on the value.

If blank, the folder will be created in FD_TEMP_DIR. If the default is used, but the FDFILE_ROOT_TARGET_FOLDER project property is left blank, then the folder will be created in FD_TEMP_DIR.

${{FDFILE_ROOT_TARGET_FOLDER}}
Owner:Group

Set the owner or owner:group of the folder to this value.

This only work on Unix endpoints. On Windows endpoints, it is ignored.

Owner:Group Folder Default is the project property to control the default.
Permission

Set the permissions of the folder to this value.

This only work on Unix endpoints. On Windows endpoints, it is ignored.

Permissions Folder Default is the project property to control the default.
Property ReplacementIf checked, property replacement will be run on the file, unless it appears to be a binary file, and then it will be skipped for property replacement.Property Replacement Defaultis the project property to control the default.



The following macros are not currently supported in the footer:
  • style