AssetStagingProps
Initialization properties for AssetStaging
.
Initializer
using AlibabaCloud.SDK.ROS.CDK.Core;
new AssetStagingProps {
string[] Exclude = null,
SymlinkFollowMode Follow = null,
IgnoreMode IgnoreMode = null,
string ExtraHash = null,
string AssetHash = null,
AssetHashType AssetHashType = null,
BundlingOptions Bundling = null,
string SourcePath
};
Properties
Name | Type | Description |
---|---|---|
Exclude |
string[] |
File paths matching the patterns will be excluded. |
Follow |
SymlinkFollowMode |
A strategy for how to handle symlinks. |
IgnoreMode |
IgnoreMode |
The ignore behavior to use for exclude patterns. |
ExtraHash |
string |
Extra information to encode into the fingerprint (e.g. build instructions and other inputs). |
AssetHash |
string |
Specify a custom hash for this asset. |
AssetHashType |
AssetHashType |
Specifies the type of hash to calculate for this asset. |
Bundling |
BundlingOptions |
Bundle the asset by executing a command in a Docker container or a custom bundling provider. |
SourcePath |
string |
The source file or directory to copy from. |
Exclude
Optional
public string[] Exclude { get; set; }
- Type: string[]
- Default: nothing is excluded
File paths matching the patterns will be excluded.
See ignoreMode
to set the matching behavior.
Has no effect on Assets bundled using the bundling
property.
Follow
Optional
public SymlinkFollowMode Follow { get; set; }
- Type: SymlinkFollowMode
- Default: SymlinkFollowMode.NEVER
A strategy for how to handle symlinks.
IgnoreMode
Optional
public IgnoreMode IgnoreMode { get; set; }
- Type: IgnoreMode
- Default: IgnoreMode.GLOB
The ignore behavior to use for exclude
patterns.
ExtraHash
Optional
public string ExtraHash { get; set; }
- Type: string
- Default: hash is only based on source content
Extra information to encode into the fingerprint (e.g. build instructions and other inputs).
AssetHash
Optional
public string AssetHash { get; set; }
- Type: string
- Default: based on
assetHashType
Specify a custom hash for this asset.
If assetHashType
is set it must
be set to AssetHashType.CUSTOM
. For consistency, this custom hash will
be SHA256 hashed and encoded as hex. The resulting hash will be the asset
hash.
NOTE: the hash is used in order to identify a specific revision of the asset, and used for optimizing and caching deployment activities related to this asset such as packaging, uploading to OSS bucket, etc. If you chose to customize the hash, you will need to make sure it is updated every time the asset changes, or otherwise it is possible that some deployments will not be invalidated.
AssetHashType
Optional
public AssetHashType AssetHashType { get; set; }
- Type: AssetHashType
- Default: the default is
AssetHashType.SOURCE
, but ifassetHash
is explicitly specified this value defaults toAssetHashType.CUSTOM
.
Specifies the type of hash to calculate for this asset.
If assetHash
is configured, this option must be undefined
or
AssetHashType.CUSTOM
.
Bundling
Optional
public BundlingOptions Bundling { get; set; }
- Type: BundlingOptions
- Default: uploaded as-is to OSS bucket if the asset is a regular file or a .zip file, archived into a .zip file and uploaded to OSS bucket otherwise.
Bundle the asset by executing a command in a Docker container or a custom bundling provider.
The asset path will be mounted at /asset-input
. The Docker
container is responsible for putting content at /asset-output
.
The content at /asset-output
will be zipped and used as the
final asset.
SourcePath
Required
public string SourcePath { get; set; }
- Type: string
The source file or directory to copy from.