1. Tổng quan
Phòng thí nghiệm này hướng dẫn bạn cách sử dụng Pulumi, một công cụ Cơ sở hạ tầng dưới dạng mã để cung cấp và quản lý các tài nguyên của Google Cloud.
Kiến thức bạn sẽ học được
Trong phòng thí nghiệm này, bạn sẽ tìm hiểu cách thực hiện những việc sau:
- Cài đặt và định cấu hình Pulumi
- Viết chương trình YAML để mô hình hoá cơ sở hạ tầng của bạn trên Google Cloud
- Cung cấp và quản lý tài nguyên trên Cloud bằng Pulumi
- Sử dụng pulumi convert để chuyển đổi chương trình YAML thành chương trình Python
2. Thiết lập và yêu cầu
Thiết lập môi trường theo tốc độ của riêng bạn
- Đăng nhập vào Google Cloud Console rồi tạo một dự án mới hoặc sử dụng lại một dự án hiện có. Nếu chưa có tài khoản Gmail hoặc Google Workspace, bạn phải tạo một tài khoản.
- Tên dự án là tên hiển thị của những người tham gia dự án này. Đây là một chuỗi ký tự mà các API của Google không sử dụng. Bạn có thể cập nhật thông tin này bất cứ lúc nào.
- Mã dự án là mã duy nhất trên tất cả các dự án trên Google Cloud và không thể thay đổi (bạn không thể thay đổi mã này sau khi đã đặt). Cloud Console sẽ tự động tạo một chuỗi duy nhất; thường thì bạn không cần quan tâm đến chuỗi này. Trong hầu hết các lớp học lập trình, bạn sẽ cần tham chiếu đến Mã dự án (thường được xác định là
PROJECT_ID). Nếu không thích mã dự án được tạo, bạn có thể tạo một mã dự án ngẫu nhiên khác. Hoặc bạn có thể thử tên người dùng của riêng mình để xem tên đó có được chấp nhận hay không. Bạn không thể thay đổi thông tin này sau bước này và thông tin này sẽ giữ nguyên trong suốt thời gian diễn ra dự án. - Để bạn biết, có một giá trị thứ ba là Số dự án mà một số API sử dụng. Tìm hiểu thêm về cả 3 giá trị này trong tài liệu.
- Tiếp theo, bạn cần bật tính năng thanh toán trong Cloud Console để sử dụng các tài nguyên/API trên Cloud. Việc thực hiện lớp học lập trình này sẽ không tốn nhiều chi phí, nếu có. Để tắt các tài nguyên nhằm tránh bị tính phí ngoài phạm vi hướng dẫn này, bạn có thể xoá các tài nguyên đã tạo hoặc xoá toàn bộ dự án. Người dùng mới của Google Cloud đủ điều kiện tham gia chương trình Dùng thử miễn phí trị giá 300 USD.
3. Thiết lập cơ sở hạ tầng
Cài đặt và định cấu hình Pulumi
Trong Cloud Shell, hãy chạy lệnh sau để cài đặt Pulumi
curl -fsSL https://get.pulumi.com | sh
Thêm Pulumi vào đường dẫn và xem thông báo trợ giúp của Pulumi
export PATH=${PATH}:~/.pulumi/bin
# view the help message to verify pulumi runs
pulumi -h
Chạy các lệnh sau để đặt mã dự án và uỷ quyền truy cập. Bạn cần làm theo hướng dẫn do các lệnh đưa ra
export PROJECT_ID=$(gcloud config get-value project)
gcloud auth application-default login
Trong Cloud Shell, hãy tạo một vùng lưu trữ GCS và sử dụng vùng lưu trữ đó làm phần phụ trợ
gsutil mb gs://pulumi-${PROJECT_ID}
pulumi login gs://pulumi-${PROJECT_ID}
Tạo dự án mới
Trong Cloud Shell, hãy tạo thư mục gốc của dự án
mkdir pulumi-lab && cd pulumi-lab
Xác định tệp dự án(điểm truy cập vào Pulumi)
cat <<EOT > Pulumi.yaml
name: pulumi-lab
description: Try Pulumi
runtime: yaml
main: yaml-repo/
EOT
Xác định tài nguyên YAML
Tạo thư mục để lưu trữ các định nghĩa tài nguyên đám mây ở định dạng yaml
mkdir yaml-repo
Tạo tệp yaml-repo/Pulumi.yaml bằng các định nghĩa tài nguyên sau
- Bộ chứa
- Liên kết IAM
- Một đối tượng văn bản có chuỗi "Hello World!"
- Và một số đầu ra
resources:
# Create a GCP resource (Storage Bucket)
my-bucket:
type: gcp:storage:Bucket
properties:
location: US
website:
mainPageSuffix: index.html
uniformBucketLevelAccess: true
my-bucket-binding:
type: gcp:storage:BucketIAMBinding
properties:
bucket: ${my-bucket.name}
role: "roles/storage.objectViewer"
members: ["allUsers"]
index-object:
type: gcp:storage:BucketObject
properties:
bucket: ${my-bucket}
source:
fn::stringAsset: Hello World!
outputs:
bucketName: ${my-bucket.url}
Triển khai tài nguyên
Khởi chạy và định cấu hình ngăn xếp
export PULUMI_CONFIG_PASSPHRASE=pulumi-lab
pulumi stack init dev
pulumi config set gcp:project $PROJECT_ID
Kiểm tra cấu hình ngăn xếp và bạn sẽ thấy khoá gcp:project với mã dự án của bạn làm giá trị
pulumi config
Lúc này, cấu trúc thư mục sẽ có dạng như sau
├── Pulumi.dev.yaml
├── Pulumi.yaml
└── yaml-repo
└── Pulumi.yaml
Triển khai ngăn xếp
pulumi up
Lệnh này đánh giá chương trình của bạn và xác định những nội dung cần cập nhật cho tài nguyên. Trước tiên, một bản xem trước sẽ xuất hiện, cho biết những thay đổi sẽ được thực hiện khi bạn dùng lệnh
(Đầu ra)
Previewing update (dev):
Downloading plugin gcp v6.44.0: 45.69 MiB / 45.69 MiB [=============] 100.00% 1s
Type Name Plan
+ pulumi:pulumi:Stack pulumi-lab-dev create
+ ├─ gcp:storage:Bucket my-bucket create
+ ├─ gcp:storage:BucketObject index-object create
+ └─ gcp:storage:BucketIAMBinding my-bucket-binding create
Outputs:
bucketName: output<string>
Resources:
+ 4 to create
Do you want to perform this update? [Use arrows to move, type to filter]
yes
> no
details
Chọn yes và các tài nguyên sẽ được cung cấp. Kết quả đầu ra sẽ có dạng như sau
Do you want to perform this update? yes
Updating (dev):
Type Name Status
+ pulumi:pulumi:Stack pulumi-lab-dev created (3s)
+ ├─ gcp:storage:Bucket my-bucket created (1s)
+ ├─ gcp:storage:BucketObject index-object created (0.78s)
+ └─ gcp:storage:BucketIAMBinding my-bucket-binding created (5s)
Outputs:
bucketName: "gs://my-bucket-874aa08"
Resources:
+ 4 created
Duration: 11s
Khi chạy lệnh sau, các đầu ra đã xác định sẽ được in
pulumi stack output
Chạy lệnh sau để xác minh thay đổi
gsutil ls $(pulumi stack output bucketName)
Đầu ra của bạn sẽ có dạng như sau
(đầu ra)
gs://my-bucket-11a9046/index-object-77a5d80
4. Chuyển đổi YAML sang Python
Hãy chuyển đổi ví dụ trên thành chương trình Pulumi Python
pulumi convert --language python --out ./py-repo
Kiểm tra mã đã được tạo trong py-repo
cat py-repo/__main__.py
(đầu ra)
import pulumi
import pulumi_gcp as gcp
my_bucket = gcp.storage.Bucket("my-bucket",
location="US",
website=gcp.storage.BucketWebsiteArgs(
main_page_suffix="index.html",
),
uniform_bucket_level_access=True)
my_bucket_binding = gcp.storage.BucketIAMBinding("my-bucket-binding",
bucket=my_bucket.name,
role="roles/storage.objectViewer",
members=["allUsers"])
index_object = gcp.storage.BucketObject("index-object",
bucket=my_bucket.id,
source=pulumi.StringAsset("Hello World!"))
pulumi.export("bucketName", my_bucket.url)
.......
Kích hoạt môi trường ảo Python
source py-repo/bin/activate
Cập nhật tệp dự án Pulumi.yaml để trỏ đến chương trình Python. Lưu ý rằng thời gian chạy và mục nhập chính đã thay đổi
cat <<EOT > Pulumi.yaml
name: pulumi-lab
description: Try Pulumi
runtime: python
main: py-repo/
EOT
Hãy thử triển khai lại ngăn xếp và chọn yes
pulumi up
Không có thay đổi nào và đầu ra của bạn sẽ có dạng như sau
(đầu ra)
Previewing update (dev):
Type Name Plan
pulumi:pulumi:Stack pulumi-lab-dev
Resources:
4 unchanged
Do you want to perform this update? yes
Updating (dev):
Type Name Status
pulumi:pulumi:Stack pulumi-lab-dev
Outputs:
bucketName: "gs://my-bucket-c2b49ad"
Resources:
4 unchanged
Duration: 6s
5. Xoá tài nguyên
Xoá các tài nguyên đã được tạo
pulumi destroy
Thông báo xác nhận sẽ có dạng như sau
Previewing update (dev):
Type Name Plan
pulumi:pulumi:Stack pulumi-lab-dev
Resources:
4 unchanged
Do you want to perform this update? [Use arrows to move, type to filter]
yes
> no
details
Do you want to perform this destroy? yes
Destroying (dev):
Type Name Status
- pulumi:pulumi:Stack pulumi-lab-dev deleted
- ├─ gcp:storage:BucketIAMBinding my-bucket-binding deleted (5s)
- ├─ gcp:storage:BucketObject index-object deleted (1s)
- └─ gcp:storage:Bucket my-bucket deleted (0.73s)
Outputs:
- bucketName: "gs://my-bucket-874aa08"
Resources:
- 4 deleted
Duration: 10s
6. Xin chúc mừng!
Xin chúc mừng, bạn đã hoàn thành bài thực hành này!