enum SymlinkFollowMode
| Language | Type name |
|---|---|
 .NET | Amazon.CDK.SymlinkFollowMode |
 Go | github.com/aws/aws-cdk-go/awscdk/v2#SymlinkFollowMode |
 Java | software.amazon.awscdk.SymlinkFollowMode |
 Python | aws_cdk.SymlinkFollowMode |
 TypeScript (source) | aws-cdk-lib » SymlinkFollowMode |
Determines how symlinks are followed.
Members
| Name | Description |
|---|---|
| NEVER | Copy symlinks themselves (do not follow, preserve the symlink contents). |
| ALWAYS | Copy all the files the symlinks point to (always follow). |
| EXTERNAL | Materialize symlinks pointing outside, leave symlinks pointing inside. |
| BLOCK_EXTERNAL | Forbids source from having any symlinks pointing outside of the source tree. |
NEVER
Copy symlinks themselves (do not follow, preserve the symlink contents).
If any of the symlinks point outside the source directory and the Cloud Assembly gets moved to a different computer, the asset may end up pointing to files that don't exist on that other computer.
ALWAYS
Copy all the files the symlinks point to (always follow).
This reads target files even if the symlinks point outside the source directory. Uses more disk space but is guaranteed to end up with a complete asset directory.
EXTERNAL
Materialize symlinks pointing outside, leave symlinks pointing inside.
If the symlink points to a file outside the source, copy the target file. Otherwise copy the symlink itself.
This produces a complete asset bundle, while saving space.
BLOCK_EXTERNAL
Forbids source from having any symlinks pointing outside of the source tree.
This is the safest mode of operation as it ensures that copy operations won't materialize files from the user's file system. Internal symlinks are not followed.
If the copy operation runs into an external symlink, it will fail.