Xin chào các bạn! Trong bài viết này, mình sẽ hướng dẫn từng bước cách dùng AWS CDK với Python để triển khai một EC2 instance và một S3 bucket.

Mục tiêu của CDK là cho phép chúng ta “viết hạ tầng bằng code” thay vì phải thao tác trên giao diện web của AWS. Rất tiện lợi khi triển khai nhanh nhiều service hoặc tích hợp CI/CD.

1. Chuẩn bị thư viện

Đầu tiên chúng ta cần khai báo các thư viện cần thiết để sử dụng AWS CDK với Python. Việc này sẽ giúp cho CDK hoạt động đúng phiên bản và đảm bảo tương thích khi deploy.

aws-cdk-lib>=2.0.0,<3.0.0
constructs>=10.0.0,<11.0.0

• aws-cdk-lib: Thư viện chính của AWS CDK, chứa các module như EC2, S3, Lambda...
• constructs: Thư viện nền, dùng để tạo và quản lý các khối CDK.

Sau khi tạo file này, bạn chỉ cần chạy lệnh bên dưới để cài đặt:

pip install -r requirements.txt

2. Cài đặt cấu hình CDK

CDK sử dụng file cdk.json để biết lệnh nào sẽ chạy khi chúng ta thực hiện deploy lên AWS

{ "app": "python3 app.py", "toolkitStackName": "MyCdkToolkit"
}

• "app": Chỉ rõ file python nào sẽ được chạy khi CDK hoạt động
• "toolkitStackName": Tên stack mà CDK dùng để quản lý việc deploy

3. Khởi tạo ứng dụng CDK

Giờ chúng ta sẽ tạo file app.py, đây là file mà CDK sẽ gọi khi chúng ta deploy. Mình sẽ khởi tạo App CDK và định nghĩa 1 stack trong đó

#!/usr/bin/env python3 import aws_cdk as cdk
from cdk_ec2_s3_stack import CdkEc2S3Stack app = cdk.App()
CdkEc2S3Stack(app, "CdkEc2S3Stack")
app.synth()

• cdk.App(): Tạo 1 ứng dụng CDK mới
• CdkEc2S3Stack(...): Tạo một stack tên là CdkEc2S3Stack, chi tiết các stack sẽ được tạo trong file cdk_ec2_s3_stack.py
• app.synth(): CDK sẽ dùng dòng này để chuyển code Python thành template CloudFormation

4. Tạo EC2 và S3 trong stack

Trong phần này, chúng ta sẽ xây dựng một EC2 instance, có thể SSH và cài đặt môi trường web cơ bản nhờ user data. Ngoài ra, chúng ta sẽ thêm VPC, Security Group và IAM role phù hợp để instance có thể hoạt động và đầy đủ quyền truy cập.

from aws_cdk import ( Stack, aws_ec2 as ec2, aws_iam as iam, CfnOutput,
)
from constructs import Construct class AccessibleEC2Stack(Stack): def __init__(self, scope: Construct, id: str, **kwargs) -> None: super().__init__(scope, id, **kwargs) # Tạo VPC với public subnet duy nhất vpc = ec2.Vpc(self, "MyVpc", max_azs=1, nat_gateways=0, subnet_configuration=[ ec2.SubnetConfiguration( name="Public", subnet_type=ec2.SubnetType.PUBLIC, cidr_mask=24 ) ] ) # Role EC2 có quyền truy cập SSM và S3 nếu cần role = iam.Role( self, "InstanceRole", assumed_by=iam.ServicePrincipal("ec2.amazonaws.com") ) role.add_managed_policy(iam.ManagedPolicy.from_aws_managed_policy_name("AmazonSSMManagedInstanceCore")) role.add_managed_policy(iam.ManagedPolicy.from_aws_managed_policy_name("AmazonS3ReadOnlyAccess")) # Security Group mở SSH và HTTP sg = ec2.SecurityGroup(self, "SG", vpc=vpc, allow_all_outbound=True) sg.add_ingress_rule(ec2.Peer.any_ipv4(), ec2.Port.tcp(22), "Allow SSH") sg.add_ingress_rule(ec2.Peer.any_ipv4(), ec2.Port.tcp(80), "Allow HTTP") # User data để cài Node.js, nginx, unzip (Amazon Linux 2023) user_data = ec2.UserData.for_linux() user_data.add_commands( "dnf update -y", "dnf install -y unzip nginx", "systemctl enable nginx", "systemctl start nginx", "curl -fsSL https://rpm.nodesource.com/setup_18.x | bash -", "dnf install -y nodejs", "mkdir -p /home/ec2-user/app", "chown ec2-user:ec2-user /home/ec2-user/app", "echo '<h1>EC2 on Amazon Linux 2023 is working!</h1>' > /usr/share/nginx/html/index.html" ) # Tạo EC2 instance với Amazon Linux 2023 instance = ec2.Instance(self, "AppInstance", instance_type=ec2.InstanceType("t2.micro"), machine_image=ec2.MachineImage.latest_amazon_linux2023(), vpc=vpc, vpc_subnets=ec2.SubnetSelection(subnet_type=ec2.SubnetType.PUBLIC), role=role, security_group=sg, user_data=user_data ) # Xuất IP public để dùng cho CodeBuild CfnOutput(self, "InstancePublicIP", value=instance.instance_public_ip)

• Định nghĩa class CdkEc2S3Stack kế thừa Stack để chứa hạ tầng AWS

5. Deploy

Bây giờ chúng ta có thể deploy stack vừa tạo lên AWS với 2 câu lệnh:

# Chuẩn bị môi trường deploy, câu lệnh này chỉ cần chạy cho lần đầu tiên
cdk bootstrap # Build hạ tầng và deploy lên AWS
cdk deploy

6. Kết quả

Sau khi deploy thành công, chúng ta sẽ thấy một số tài nguyên được tạo ra trực tiếp trên tài khoản AWS của mình:

• EC2 instance: chạy Amazon Linux 2023, type là t2.micro. Sau khi status check pass thì chúng ta có thể truy cập vào public IP và xác nhận thành quả
• S3 bucket: một bucket mới dùng để lưu trữ dữ liệu. Tên bucket sẽ được CDK sinh tự động nếu không đặt tên cụ thể.
• VPC: mạng ảo chứa EC2, có đủ public/private subnet và route table được CDK tạo tự động.

Ngoài ra bạn cũng có thể vào phần CloudFormation để xem toàn bộ cấu trúc stack tên là CdkEc2S3Stack, kèm trạng thái deploy và lịch sử cập nhật.

Trên đây mình đã giới thiệu về cách triển khai hạ tầng đơn giản bằng AWS CDK với Python. Bài viết có thể còn nhiều hạn chế, rất mong nhận được góp ý từ mọi người để mình cải thiện trong những bài sau. Cảm ơn các bạn đã theo dõi và ủng hộ!