The CDK Construct Library for AWS::EFS
Project description
Amazon Elastic File System Construct Library
---All classes with the
Cfn
prefix in this module (CFN Resources) are always stable and safe to use.
The APIs of higher level constructs in this module are experimental and under active development. They are subject to non-backward compatible changes or removal in any future version. These are not subject to the Semantic Versioning model and breaking changes will be announced in the release notes. This means that while you may use them, you may need to update your source code when upgrading to a newer version of this package.
This construct library allows you to set up AWS Elastic File System (EFS).
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
import aws_cdk.aws_efs as efs
my_vpc = ec2.Vpc(self, "VPC")
file_system = efs.FileSystem(self, "MyEfsFileSystem",
vpc=my_vpc,
encrypted=True,
lifecycle_policy=efs.LifecyclePolicy.AFTER_14_DAYS,
performance_mode=efs.PerformanceMode.GENERAL_PURPOSE,
throughput_mode=efs.ThroughputMode.BURSTING
)
A file system can set RemovalPolicy
. Default policy is RETAIN
.
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
file_system = FileSystem(self, "EfsFileSystem",
vpc=vpc,
removal_policy=RemovalPolicy.DESTROY
)
Access Point
An access point is an application-specific view into an EFS file system that applies an operating system user and group, and a file system path, to any file system request made through the access point. The operating system user and group override any identity information provided by the NFS client. The file system path is exposed as the access point's root directory. Applications using the access point can only access data in its own directory and below. To learn more, see Mounting a File System Using EFS Access Points.
Use addAccessPoint
to create an access point from a fileSystem:
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
file_system.add_access_point("AccessPoint")
By default, when you create an access point, the root(/
) directory is exposed to the client connecting to
the access point. You may specify custom path with the path
property. If path
does not exist, it will be
created with the settings defined in the creationInfo
. See
Creating Access Points for more details.
Any access point that has been created outside the stack can be imported into your CDK app.
Use the fromAccessPointAttributes()
API to import an existing access point.
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
efs.AccessPoint.from_access_point_attributes(self, "ap",
access_point_arn="fsap-1293c4d9832fo0912",
file_system=efs.FileSystem.from_file_system_attributes(self, "efs",
file_system_id="fs-099d3e2f",
security_group=SecurityGroup.from_security_group_id(self, "sg", "sg-51530134")
)
)
⚠️ Notice: When importing an Access Point using fromAccessPointAttributes()
, you must make sure the mount targets are deployed and their lifecycle state is available
. Otherwise, you may encounter the following error when deploying:
EFS file system referenced by access point has mount targets created in all availability zones the function will execute in, but not all are in the available life cycle state yet. Please wait for them to become available and try the request again.
Connecting
To control who can access the EFS, use the .connections
attribute. EFS has
a fixed default port, so you don't need to specify the port:
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
file_system.connections.allow_default_port_from(instance)
Mounting the file system using User Data
In order to automatically mount this file system during instance launch, following code can be used as reference:
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
vpc = ec2.Vpc(self, "VPC")
file_system = efs.FileSystem(self, "MyEfsFileSystem",
vpc=vpc,
encrypted=True,
lifecycle_policy=efs.LifecyclePolicy.AFTER_14_DAYS,
performance_mode=efs.PerformanceMode.GENERAL_PURPOSE,
throughput_mode=efs.ThroughputMode.BURSTING,
enable_automatic_backups=True
)
inst = Instance(self, "inst",
instance_type=InstanceType.of(InstanceClass.T2, InstanceSize.LARGE),
machine_image=AmazonLinuxImage(
generation=AmazonLinuxGeneration.AMAZON_LINUX_2
),
vpc=vpc,
vpc_subnets={
"subnet_type": SubnetType.PUBLIC
}
)
file_system.connections.allow_default_port_from(inst)
inst.user_data.add_commands("yum check-update -y", "yum upgrade -y", "yum install -y amazon-efs-utils", "yum install -y nfs-utils", "file_system_id_1=" + file_system.file_system_id, "efs_mount_point_1=/mnt/efs/fs1", "mkdir -p \"${efs_mount_point_1}\"", "test -f \"/sbin/mount.efs\" && echo \"${file_system_id_1}:/ ${efs_mount_point_1} efs defaults,_netdev\" >> /etc/fstab || " + "echo \"${file_system_id_1}.efs." + cdk.Stack.of(self).region + ".amazonaws.com:/ ${efs_mount_point_1} nfs4 nfsvers=4.1,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport,_netdev 0 0\" >> /etc/fstab", "mount -a -t efs,nfs4 defaults")
This module is part of the AWS Cloud Development Kit project.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for aws_cdk.aws_efs-1.78.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cc22ae13cfe80aebe3836adfddf3a13f114448e01bc91cb516aafc4655f20a16 |
|
MD5 | 81bd7b95cc115ca992bdd47f46322d60 |
|
BLAKE2b-256 | aa6cf626393e374a7eff4025a72e5314e56ab46134cf8fac4cd7a72cf105ebf4 |