Documentation
¶
Index ¶
- func BucketDeployment_IsConstruct(x interface{}) *bool
- func NewBucketDeployment_Override(b BucketDeployment, scope constructs.Construct, id *string, ...)
- type BucketDeployment
- type BucketDeploymentProps
- type CacheControl
- func CacheControl_FromString(s *string) CacheControl
- func CacheControl_MaxAge(t awscdk.Duration) CacheControl
- func CacheControl_MustRevalidate() CacheControl
- func CacheControl_NoCache() CacheControl
- func CacheControl_NoTransform() CacheControl
- func CacheControl_ProxyRevalidate() CacheControl
- func CacheControl_SMaxAge(t awscdk.Duration) CacheControl
- func CacheControl_SetPrivate() CacheControl
- func CacheControl_SetPublic() CacheControl
- type DeploymentSourceContext
- type ISource
- type ServerSideEncryption
- type Source
- type SourceConfig
- type StorageClass
- type UserDefinedObjectMetadata
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func BucketDeployment_IsConstruct ¶
func BucketDeployment_IsConstruct(x interface{}) *bool
Checks if `x` is a construct.
Returns: true if `x` is an object created from a class which extends `Construct`. Deprecated: use `x instanceof Construct` instead
func NewBucketDeployment_Override ¶
func NewBucketDeployment_Override(b BucketDeployment, scope constructs.Construct, id *string, props *BucketDeploymentProps)
Types ¶
type BucketDeployment ¶
type BucketDeployment interface {
constructs.Construct
Node() constructs.Node
ToString() *string
}
`BucketDeployment` populates an S3 bucket with the contents of .zip files from other S3 buckets or from local disk.
TODO: EXAMPLE
func NewBucketDeployment ¶
func NewBucketDeployment(scope constructs.Construct, id *string, props *BucketDeploymentProps) BucketDeployment
type BucketDeploymentProps ¶
type BucketDeploymentProps struct {
// System-defined x-amz-acl metadata to be set on all objects in the deployment.
// See: https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#canned-acl
//
AccessControl awss3.BucketAccessControl `json:"accessControl"`
// System-defined cache-control metadata to be set on all objects in the deployment.
// See: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#SysMetadata
//
CacheControl *[]CacheControl `json:"cacheControl"`
// System-defined cache-disposition metadata to be set on all objects in the deployment.
// See: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#SysMetadata
//
ContentDisposition *string `json:"contentDisposition"`
// System-defined content-encoding metadata to be set on all objects in the deployment.
// See: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#SysMetadata
//
ContentEncoding *string `json:"contentEncoding"`
// System-defined content-language metadata to be set on all objects in the deployment.
// See: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#SysMetadata
//
ContentLanguage *string `json:"contentLanguage"`
// System-defined content-type metadata to be set on all objects in the deployment.
// See: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#SysMetadata
//
ContentType *string `json:"contentType"`
// The S3 bucket to sync the contents of the zip file to.
DestinationBucket awss3.IBucket `json:"destinationBucket"`
// Key prefix in the destination bucket.
//
// Must be <=104 characters
DestinationKeyPrefix *string `json:"destinationKeyPrefix"`
// The CloudFront distribution using the destination bucket as an origin.
//
// Files in the distribution's edge caches will be invalidated after
// files are uploaded to the destination bucket.
Distribution awscloudfront.IDistribution `json:"distribution"`
// The file paths to invalidate in the CloudFront distribution.
DistributionPaths *[]*string `json:"distributionPaths"`
// If this is set, matching files or objects will be excluded from the deployment's sync command.
//
// This can be used to exclude a file from being pruned in the destination bucket.
//
// If you want to just exclude files from the deployment package (which excludes these files
// evaluated when invalidating the asset), you should leverage the `exclude` property of
// `AssetOptions` when defining your source.
// See: https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters
//
Exclude *[]*string `json:"exclude"`
// System-defined expires metadata to be set on all objects in the deployment.
// See: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#SysMetadata
//
Expires awscdk.Expiration `json:"expires"`
// If this is set, matching files or objects will be included with the deployment's sync command.
//
// Since all files from the deployment package are included by default, this property
// is usually leveraged alongside an `exclude` filter.
// See: https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters
//
Include *[]*string `json:"include"`
// The amount of memory (in MiB) to allocate to the AWS Lambda function which replicates the files from the CDK bucket to the destination bucket.
//
// If you are deploying large files, you will need to increase this number
// accordingly.
MemoryLimit *float64 `json:"memoryLimit"`
// User-defined object metadata to be set on all objects in the deployment.
// See: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#UserMetadata
//
Metadata *UserDefinedObjectMetadata `json:"metadata"`
// If this is set to false, files in the destination bucket that do not exist in the asset, will NOT be deleted during deployment (create/update).
// See: https://docs.aws.amazon.com/cli/latest/reference/s3/sync.html
//
Prune *bool `json:"prune"`
// If this is set to "false", the destination files will be deleted when the resource is deleted or the destination is updated.
//
// NOTICE: Configuring this to "false" might have operational implications. Please
// visit to the package documentation referred below to make sure you fully understand those implications.
// See: https://github.com/aws/aws-cdk/tree/master/packages/%40aws-cdk/aws-s3-deployment#retain-on-delete
//
RetainOnDelete *bool `json:"retainOnDelete"`
// Execution role associated with this function.
Role awsiam.IRole `json:"role"`
// System-defined x-amz-server-side-encryption metadata to be set on all objects in the deployment.
// See: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#SysMetadata
//
ServerSideEncryption ServerSideEncryption `json:"serverSideEncryption"`
// System-defined x-amz-server-side-encryption-aws-kms-key-id metadata to be set on all objects in the deployment.
// See: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#SysMetadata
//
ServerSideEncryptionAwsKmsKeyId *string `json:"serverSideEncryptionAwsKmsKeyId"`
// System-defined x-amz-server-side-encryption-customer-algorithm metadata to be set on all objects in the deployment.
//
// Warning: This is not a useful parameter until this bug is fixed: https://github.com/aws/aws-cdk/issues/6080
// See: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html#sse-c-how-to-programmatically-intro
//
ServerSideEncryptionCustomerAlgorithm *string `json:"serverSideEncryptionCustomerAlgorithm"`
// The sources from which to deploy the contents of this bucket.
Sources *[]ISource `json:"sources"`
// System-defined x-amz-storage-class metadata to be set on all objects in the deployment.
// See: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#SysMetadata
//
StorageClass StorageClass `json:"storageClass"`
// Mount an EFS file system.
//
// Enable this if your assets are large and you encounter disk space errors.
// Enabling this option will require a VPC to be specified.
UseEfs *bool `json:"useEfs"`
// The VPC network to place the deployment lambda handler in.
//
// This is required if `useEfs` is set.
Vpc awsec2.IVpc `json:"vpc"`
// Where in the VPC to place the deployment lambda handler.
//
// Only used if 'vpc' is supplied.
VpcSubnets *awsec2.SubnetSelection `json:"vpcSubnets"`
// System-defined x-amz-website-redirect-location metadata to be set on all objects in the deployment.
// See: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#SysMetadata
//
WebsiteRedirectLocation *string `json:"websiteRedirectLocation"`
}
Properties for `BucketDeployment`.
TODO: EXAMPLE
type CacheControl ¶
type CacheControl interface {
Value() interface{}
}
Used for HTTP cache-control header, which influences downstream caches.
TODO: EXAMPLE
See: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#SysMetadata
func CacheControl_FromString ¶
func CacheControl_FromString(s *string) CacheControl
Constructs a custom cache control key from the literal value.
func CacheControl_MaxAge ¶
func CacheControl_MaxAge(t awscdk.Duration) CacheControl
Sets 'max-age=<duration-in-seconds>'.
func CacheControl_MustRevalidate ¶
func CacheControl_MustRevalidate() CacheControl
Sets 'must-revalidate'.
func CacheControl_ProxyRevalidate ¶
func CacheControl_ProxyRevalidate() CacheControl
Sets 'proxy-revalidate'.
func CacheControl_SMaxAge ¶
func CacheControl_SMaxAge(t awscdk.Duration) CacheControl
Sets 's-maxage=<duration-in-seconds>'.
type DeploymentSourceContext ¶
type DeploymentSourceContext struct {
// The role for the handler.
HandlerRole awsiam.IRole `json:"handlerRole"`
}
Bind context for ISources.
TODO: EXAMPLE
type ISource ¶
type ISource interface {
// Binds the source to a bucket deployment.
Bind(scope constructs.Construct, context *DeploymentSourceContext) *SourceConfig
}
Represents a source for bucket deployments.
func Source_Asset ¶
func Source_Asset(path *string, options *awss3assets.AssetOptions) ISource
Uses a local asset as the deployment source.
If the local asset is a .zip archive, make sure you trust the producer of the archive.
type ServerSideEncryption ¶
type ServerSideEncryption string
Indicates whether server-side encryption is enabled for the object, and whether that encryption is from the AWS Key Management Service (AWS KMS) or from Amazon S3 managed encryption (SSE-S3). See: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#SysMetadata
const ( ServerSideEncryption_AES_256 ServerSideEncryption = "AES_256" ServerSideEncryption_AWS_KMS ServerSideEncryption = "AWS_KMS" )
type Source ¶
type Source interface {
}
Specifies bucket deployment source.
Usage:
Source.bucket(bucket, key)
Source.asset('/local/path/to/directory')
Source.asset('/local/path/to/a/file.zip')
type SourceConfig ¶
type SourceConfig struct {
// The source bucket to deploy from.
Bucket awss3.IBucket `json:"bucket"`
// An S3 object key in the source bucket that points to a zip file.
ZipObjectKey *string `json:"zipObjectKey"`
}
Source information.
TODO: EXAMPLE
type StorageClass ¶
type StorageClass string
Storage class used for storing the object. See: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#SysMetadata
const ( StorageClass_DEEP_ARCHIVE StorageClass = "DEEP_ARCHIVE" StorageClass_GLACIER StorageClass = "GLACIER" StorageClass_INTELLIGENT_TIERING StorageClass = "INTELLIGENT_TIERING" StorageClass_ONEZONE_IA StorageClass = "ONEZONE_IA" StorageClass_REDUCED_REDUNDANCY StorageClass = "REDUCED_REDUNDANCY" StorageClass_STANDARD StorageClass = "STANDARD" StorageClass_STANDARD_IA StorageClass = "STANDARD_IA" )
type UserDefinedObjectMetadata ¶
type UserDefinedObjectMetadata struct {
}
Custom user defined metadata.
TODO: EXAMPLE