Phát triển InsideLoop bằng Cloud Workstation với Python

1. Tổng quan

Phòng thí nghiệm này minh hoạ các tính năng và chức năng được thiết kế để đơn giản hoá quy trình phát triển cho các kỹ sư phần mềm có nhiệm vụ phát triển ứng dụng Python trong môi trường vùng chứa. Việc phát triển vùng chứa thông thường đòi hỏi người dùng phải hiểu rõ thông tin chi tiết về vùng chứa và quy trình xây dựng vùng chứa. Ngoài ra, nhà phát triển thường phải ngắt quy trình của mình, chuyển ra khỏi IDE để kiểm thử và gỡ lỗi ứng dụng trong môi trường từ xa. Với các công cụ và công nghệ được đề cập trong hướng dẫn này, nhà phát triển có thể làm việc hiệu quả với các ứng dụng được chứa trong vùng chứa mà không cần rời khỏi IDE.

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ác phương pháp phát triển bằng vùng chứa trong GCP, bao gồm:

  • Tạo một ứng dụng khởi động Python mới
  • Tìm hiểu quy trình phát triển
  • Phát triển một dịch vụ REST CRUD đơn giản
  • Triển khai vào GKE
  • Gỡ lỗi trạng thái lỗi
  • Sử dụng điểm ngắt / nhật ký
  • Triển khai nóng các thay đổi trở lại GKE

58a4cdd3ed7a123a.png

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

  1. Đă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.

b35bf95b8bf3d5d8.png

a99b7ace416376c4.png

bd84a6d3004737c5.png

  • 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ã nhận dạng được tạo, bạn có thể tạo một mã nhận dạng 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ó dùng được 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.
  1. 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 phát sinh phí thanh toán ngoài 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.

Khởi động Trình chỉnh sửa Cloud Shell

Bài tập thực hành này được thiết kế và thử nghiệm để sử dụng với Trình chỉnh sửa Google Cloud Shell. Để truy cập vào trình chỉnh sửa,

  1. truy cập vào dự án của bạn trên Google tại https://console.cloud.google.com.
  2. Ở góc trên cùng bên phải, hãy nhấp vào biểu tượng trình chỉnh sửa Cloud Shell

8560cc8d45e8c112.png

  1. Một ngăn mới sẽ mở ra ở cuối cửa sổ
  2. Nhấp vào nút Mở trình chỉnh sửa

9e504cb98a6a8005.png

  1. Trình chỉnh sửa sẽ mở ra với một trình khám phá ở bên phải và trình chỉnh sửa ở khu vực trung tâm
  2. Một ngăn cửa sổ dòng lệnh cũng phải có ở cuối màn hình
  3. Nếu thiết bị đầu cuối CHƯA mở, hãy dùng tổ hợp phím "Ctrl+" để mở một cửa sổ dòng lệnh mới

Thiết lập môi trường

Trong Cloud Shell, hãy đặt mã dự án và số dự án cho dự án của bạn. Lưu các giá trị này dưới dạng biến PROJECT_ID và PROJECT_ID.

export PROJECT_ID=$(gcloud config get-value project)
export PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID \
    --format='value(projectNumber)')

Cung cấp cơ sở hạ tầng được dùng trong phòng thí nghiệm này

Trong phòng thí nghiệm này, bạn sẽ triển khai mã đến GKE và truy cập vào dữ liệu được lưu trữ trong cơ sở dữ liệu Spanner. Bạn cũng sẽ sử dụng Cloud Workstations làm IDE. Tập lệnh thiết lập bên dưới sẽ chuẩn bị cơ sở hạ tầng này cho bạn.

  1. Tải tập lệnh thiết lập xuống và thực thi tập lệnh đó.
wget https://raw.githubusercontent.com/GoogleCloudPlatform/container-developer-workshop/main/labs/python/setup_with_cw.sh
chmod +x setup_with_cw.sh
  1. Mở tệp setup_with_cw.sh và chỉnh sửa giá trị của mật khẩu hiện được đặt thành CHANGEME
  2. Chạy tập lệnh thiết lập để thiết lập một cụm GKE và một cơ sở dữ liệu Spanner mà bạn sẽ sử dụng trong phòng thí nghiệm này
./setup_with_cw.sh &

Cụm Cloud Workstations

  1. Mở Cloud Workstations trong Cloud Console. Chờ cụm ở trạng thái READY.

305e1a3d63ac7ff6.png

Tạo cấu hình trạm làm việc

  1. Nếu phiên Cloud Shell của bạn bị ngắt kết nối, hãy nhấp vào "Kết nối lại" rồi chạy lệnh gcloud cli để đặt mã dự án. Thay thế mã dự án mẫu bên dưới bằng mã dự án qwiklabs của bạn trước khi chạy lệnh.
gcloud config set project qwiklabs-gcp-project-id
  1. Tải xuống và chạy tập lệnh bên dưới trong thiết bị đầu cuối để tạo cấu hình Cloud Workstations.
wget https://raw.githubusercontent.com/GoogleCloudPlatform/container-developer-workshop/main/labs/python/workstation_config_setup.sh
chmod +x workstation_config_setup.sh
./workstation_config_setup.sh
  1. Xác minh kết quả trong phần Cấu hình. Quá trình chuyển sang trạng thái SẴN SÀNG sẽ mất 2 phút.

2e23c2e9983d1ccf.png

  1. Mở Cloud Workstations trong Bảng điều khiển rồi tạo thực thể mới.

a53adeeac81a78c8.png

  1. Đổi tên thành my-workstation và chọn cấu hình hiện có: codeoss-python.

f052cd47701ec774.png

  1. Xác minh kết quả trong phần Máy trạm.

Khởi chạy Workstation

  1. Khởi động và chạy máy trạm. Quá trình khởi động máy trạm sẽ mất vài phút.

682f8a307032cba3.png

  1. Cho phép cookie của bên thứ ba bằng cách nhấp vào biểu tượng trên thanh địa chỉ. 1b8923e2943f9bc4.png

fcf9405b6957b7d7.png

  1. Nhấp vào "Trang web không hoạt động?".

36a84c0e2e3b85b.png

  1. Nhấp vào "Cho phép cookie".

2259694328628fba.png

  1. Sau khi máy trạm khởi động, bạn sẽ thấy IDE Code OSS xuất hiện. Nhấp vào "Đánh dấu là đã hoàn tất" trên trang Bắt đầu của IDE máy trạm

94874fba9b74cc22.png

3. Tạo một ứng dụng khởi động Python mới

Trong phần này, bạn sẽ tạo một ứng dụng Python mới.

  1. Mở một cửa sổ dòng lệnh mới.

c31d48f2e4938c38.png

  1. Tạo một thư mục mới và mở thư mục đó dưới dạng không gian làm việc
mkdir music-service && cd music-service

code-oss-cloud-workstations -r --folder-uri="$PWD"

Nhấp vào nút Cho phép nếu bạn thấy thông báo này để có thể sao chép và dán vào máy trạm.

58149777e5cc350a.png

  1. Tạo một tệp có tên là requirements.txt rồi sao chép nội dung sau vào tệp đó

789e8389170bd900.png

Flask
gunicorn
google-cloud-spanner
ptvsd==4.3.2
  1. Tạo một tệp có tên là app.py rồi dán đoạn mã sau vào tệp đó
import os
from flask import Flask, request, jsonify
from google.cloud import spanner

app = Flask(__name__)

@app.route("/")
def hello_world():
    message="Hello, World!"
    return message

if __name__ == '__main__':
    server_port = os.environ.get('PORT', '8080')
    app.run(debug=False, port=server_port, host='0.0.0.0')
  1. Tạo một tệp có tên là Dockerfile rồi dán nội dung sau vào tệp đó
FROM python:3.8
ARG FLASK_DEBUG=0
ENV FLASK_DEBUG=$FLASK_DEBUG
ENV FLASK_APP=app.py
WORKDIR /app
COPY requirements.txt .
RUN pip install --trusted-host pypi.python.org -r requirements.txt
COPY . .
ENTRYPOINT ["python3", "-m", "flask", "run", "--port=8080", "--host=0.0.0.0"]

Lưu ý: FLASK_DEBUG=1 cho phép bạn tự động tải lại các thay đổi về mã cho một ứng dụng flask Python. Tệp Docker này cho phép bạn truyền giá trị này dưới dạng một đối số xây dựng.

Tạo tệp kê khai

Trong cửa sổ dòng lệnh, hãy thực thi lệnh sau để tạo skaffold.yaml và deployment.yaml mặc định

  1. Khởi động Skaffold bằng lệnh sau
skaffold init --generate-manifests

Khi có lời nhắc, hãy dùng các phím mũi tên để di chuyển con trỏ và dùng phím cách để chọn các lựa chọn.

Chọn:

  • 8080 cho cổng
  • y để lưu cấu hình

Cập nhật cấu hình Skaffold

  • Thay đổi tên ứng dụng mặc định
  • Mở skaffold.yaml
  • Chọn tên hình ảnh hiện được đặt làm dockerfile-image
  • Nhấp chuột phải rồi chọn Thay đổi tất cả các lần xuất hiện
  • Nhập tên mới bằng python-app
  • Chỉnh sửa thêm phần bản dựng để
  • thêm docker.buildArgs vào thẻ FLASK_DEBUG=1
  • Đồng bộ hoá chế độ cài đặt để tải mọi thay đổi đối với tệp *.py từ IDE vào vùng chứa đang chạy

Sau khi chỉnh sửa, phần bản dựng trong tệp skaffold.yaml sẽ có dạng như sau:

build:
 artifacts:
 - image: python-app
   docker:
     buildArgs:
       FLASK_DEBUG: "1"
     dockerfile: Dockerfile
   sync:
     infer:
     - '**/*.py'

Sửa đổi tệp cấu hình Kubernetes

  1. Thay đổi Tên mặc định
  • Mở tệp deployment.yaml
  • Chọn tên hình ảnh hiện được đặt làm dockerfile-image
  • Nhấp chuột phải rồi chọn Thay đổi tất cả các lần xuất hiện
  • Nhập tên mới bằng python-app

4. Tìm hiểu quy trình phát triển

Sau khi thêm logic nghiệp vụ, giờ đây, bạn có thể triển khai và kiểm thử ứng dụng của mình. Phần sau đây sẽ trình bày cách sử dụng trình bổ trợ Cloud Code. Ngoài các tiêu chí khác, trình bổ trợ này còn tích hợp với skaffold để tinh giản quy trình phát triển của bạn. Khi bạn triển khai đến GKE trong các bước sau, Cloud Code và Skaffold sẽ tự động tạo hình ảnh vùng chứa, đẩy hình ảnh đó vào một Container Registry, rồi triển khai ứng dụng your đến GKE. Quá trình này diễn ra ở chế độ nền, giúp loại bỏ các thông tin chi tiết khỏi quy trình của nhà phát triển.

Đăng nhập vào Google Cloud

  1. Nhấp vào biểu tượng Cloud Code rồi chọn "Đăng nhập vào Google Cloud":

1769afd39be372ff.png

  1. Nhấp vào "Tiếp tục đăng nhập".

923bb1c8f63160f9.png

  1. Kiểm tra đầu ra trong Terminal và mở đường liên kết:

517fdd579c34aa21.png

  1. Đăng nhập bằng thông tin đăng nhập của học viên Qwiklabs.

db99b345f7a8e72c.png

  1. Chọn "Cho phép":

a5376553c430ac84.png

  1. Sao chép mã xác minh rồi quay lại thẻ Workstation.

6719421277b92eac.png

  1. Dán mã xác minh rồi nhấn Enter.

e9847cfe3fa8a2ce.png

Thêm cụm Kubernetes

  1. Thêm một Cụm

62a3b97bdbb427e5.png

  1. Chọn Google Kubernetes Engine:

9577de423568bbaa.png

  1. Chọn dự án.

c5202fcbeebcd41c.png

  1. Chọn "python-cluster" được tạo trong quá trình thiết lập ban đầu.

719c2fc0a7f9e84f.png

  1. Giờ đây, cụm này sẽ xuất hiện trong danh sách cụm Kubernetes trong Cloud Code. Di chuyển và khám phá cụm từ đây.

7e5f50662d4eea3c.png

Đặt mã dự án hiện tại bằng giao diện dòng lệnh gcloud

  1. Sao chép mã dự án cho bài thực hành này từ trang qwiklabs.

fcff2d10007ec5bc.png

  1. Trong thiết bị đầu cuối, hãy chạy lệnh gcloud cli để đặt mã dự án. Thay thế mã dự án mẫu trước khi chạy lệnh. THAY THẾ mã dự án trước khi chạy lệnh bên dưới.
gcloud config set project qwiklabs-gcp-project-id

Triển khai lên Kubernetes

  1. Trong ngăn ở cuối Cloud Shell Editor, hãy chọn Cloud Code 

d99a88992e15fea9.png

  1. Trong bảng điều khiển xuất hiện ở trên cùng, hãy chọn Chạy trên Kubernetes. Nếu được nhắc, hãy chọn Có để sử dụng ngữ cảnh Kubernetes hiện tại.

bfd65e9df6d4a6cb.png

Lệnh này bắt đầu tạo bản dựng mã nguồn rồi chạy các kiểm thử. Quá trình tạo và kiểm thử sẽ mất vài phút để chạy. Các kiểm thử này bao gồm kiểm thử đơn vị và một bước xác thực để kiểm tra các quy tắc được đặt cho môi trường triển khai. Bước xác thực này đã được định cấu hình và đảm bảo rằng bạn sẽ nhận được cảnh báo về các vấn đề triển khai ngay cả khi bạn vẫn đang làm việc trong môi trường phát triển.

  1. Lần đầu tiên bạn chạy lệnh, một lời nhắc sẽ xuất hiện ở đầu màn hình để hỏi xem bạn có muốn ngữ cảnh kubernetes hiện tại hay không, hãy chọn "Yes" (Có) để chấp nhận và sử dụng ngữ cảnh hiện tại.
  2. Tiếp theo, một lời nhắc sẽ xuất hiện để hỏi bạn muốn dùng sổ đăng ký vùng chứa nào. Nhấn Enter để chấp nhận giá trị mặc định được cung cấp
  3. Chọn thẻ "Đầu ra" trong ngăn dưới cùng để xem tiến trình và thông báo. Sử dụng trình đơn thả xuống để chọn "Kubernetes: Run/Debug" (Kubernetes: Chạy/Gỡ lỗi)

9c87ccbf5d06f50a.png

  1. Chọn "Kubernetes: Run/Debug – Detailed" (Kubernetes: Chạy/Gỡ lỗi – Chi tiết) trong trình đơn thả xuống ở bên phải để xem thêm thông tin chi tiết và nhật ký phát trực tiếp từ các vùng chứa

804abc8833ffd571.png

Khi quá trình tạo và kiểm thử hoàn tất, nhật ký trên thẻ Đầu ra sẽ có URL http://localhost:8080 được liệt kê trong chế độ xem "Kubernetes: Chạy/Gỡ lỗi".

  1. Trong thiết bị đầu cuối Cloud Code, hãy di chuột qua URL đầu tiên trong đầu ra (http://localhost:8080), sau đó trong chú thích xuất hiện, hãy chọn Open Web Preview (Mở bản xem trước trên web).
  2. Một thẻ trình duyệt mới sẽ mở ra và hiển thị thông báo Hello, World!

Tải lại nóng

  1. Mở tệp app.py
  2. Thay đổi tin nhắn chào mừng thành Hello from Python

Lưu ý rằng ngay lập tức trong cửa sổ Output, chế độ xem Kubernetes: Run/Debug, trình theo dõi sẽ đồng bộ hoá các tệp đã cập nhật với vùng chứa trong Kubernetes

Update initiated
Build started for artifact python-app
Build completed for artifact python-app

Deploy started
Deploy completed

Status check started
Resource pod/python-app-6f646ffcbb-tn7qd status updated to In Progress
Resource deployment/python-app status updated to In Progress
Resource deployment/python-app status completed successfully
Status check succeeded
...
  1. Nếu chuyển sang chế độ xem Kubernetes: Run/Debug - Detailed, bạn sẽ thấy chế độ xem này nhận ra các thay đổi đối với tệp, sau đó tạo và triển khai lại ứng dụng
files modified: [app.py]
Syncing 1 files for gcr.io/veer-pylab-01/python-app:3c04f58-dirty@sha256:a42ca7250851c2f2570ff05209f108c5491d13d2b453bb9608c7b4af511109bd
Copying files:map[app.py:[/app/app.py]]togcr.io/veer-pylab-01/python-app:3c04f58-dirty@sha256:a42ca7250851c2f2570ff05209f108c5491d13d2b453bb9608c7b4af511109bd
Watching for changes...
[python-app] * Detected change in '/app/app.py', reloading
[python-app] * Restarting with stat
[python-app] * Debugger is active!
[python-app] * Debugger PIN: 744-729-662
  1. Làm mới thẻ trình duyệt nơi bạn thấy kết quả trước đó để xem kết quả mới nhất.

Gỡ lỗi

  1. Chuyển đến chế độ xem Gỡ lỗi và dừng luồng hiện tại 647213126d7a4c7b.png. Nếu được hỏi, bạn có thể chọn dọn dẹp sau mỗi lần chạy.
  2. 70d6bd947d04d1e6.png
  3. Nhấp vào biểu tượng Cloud Code trong trình đơn dưới cùng rồi chọn Debug on Kubernetes để chạy ứng dụng ở chế độ debug.
  • Trong chế độ xem Kubernetes Run/Debug - Detailed của cửa sổ Output, hãy lưu ý rằng skaffold sẽ triển khai ứng dụng này ở chế độ gỡ lỗi.
  1. Khi quá trình này hoàn tất. Bạn sẽ thấy một trình gỡ lỗi được đính kèm và thẻ Đầu ra có nội dung: Attached debugger to container "python-app-8476f4bbc-h6dsl" successfully., đồng thời URL http://localhost:8080 được liệt kê.
Port forwarding pod/python-app-8bd64cf8b-cskfl in namespace default, remote port 5678 -> http://127.0.0.1:5678
  1. Thanh trạng thái dưới cùng sẽ thay đổi màu từ xanh dương sang cam, cho biết rằng thanh này đang ở chế độ Gỡ lỗi.
  2. Trong khung hiển thị Kubernetes Run/Debug, hãy lưu ý rằng một vùng chứa có thể gỡ lỗi đã được khởi động
**************URLs*****************
Forwarded URL from service python-app: http://localhost:8080
Debuggable container started pod/python-app-8bd64cf8b-cskfl:python-app (default)
Update succeeded
***********************************

Khai thác điểm ngắt

  1. Mở tệp app.py
  2. Tìm câu lệnh có nội dung return message
  3. Thêm một điểm ngắt vào dòng đó bằng cách nhấp vào khoảng trống ở bên trái số dòng. Một chỉ báo màu đỏ sẽ xuất hiện để cho biết điểm ngắt đã được đặt
  4. Trong lần đầu tiên chạy, một lời nhắc sẽ hỏi vị trí của nguồn bên trong vùng chứa. Giá trị này liên quan đến các thư mục trong Dockerfile.

Nhấn Enter để chấp nhận giá trị mặc định

fccc866f32b5ed86.png

Ứng dụng sẽ mất vài phút để tạo và triển khai.

  1. Tải lại trình duyệt và lưu ý rằng trình gỡ lỗi sẽ dừng quy trình tại điểm ngắt, đồng thời cho phép bạn kiểm tra các biến và trạng thái của ứng dụng đang chạy từ xa trong GKE
  2. Nhấp vào mục BIẾN
  3. Nhấp vào Locals (Biến cục bộ), bạn sẽ thấy biến "message".
  4. Nhấp đúp vào tên biến "message" và trong cửa sổ bật lên, hãy thay đổi giá trị thành một giá trị khác, chẳng hạn như "Greetings from Python"
  5. Nhấp vào nút Tiếp tục trong bảng điều khiển gỡ lỗi 607c33934f8d6b39.png
  6. Xem lại phản hồi trong trình duyệt. Lúc này, trình duyệt sẽ cho thấy giá trị mới cập nhật mà bạn vừa nhập.
  7. Dừng chế độ "Gỡ lỗi" bằng cách nhấn nút dừng 647213126d7a4c7b.png và xoá điểm ngắt bằng cách nhấp lại vào điểm ngắt.

5. Phát triển một dịch vụ REST CRUD đơn giản

Đến đây, ứng dụng của bạn đã được định cấu hình đầy đủ cho quá trình phát triển theo mô hình vùng chứa và bạn đã tìm hiểu quy trình phát triển cơ bản bằng Cloud Code. Trong các phần sau, bạn sẽ thực hành những gì đã học bằng cách thêm các điểm cuối dịch vụ còn lại kết nối với một cơ sở dữ liệu được quản lý trong Google Cloud.

Mã hoá dịch vụ còn lại

Đoạn mã dưới đây tạo một dịch vụ REST đơn giản sử dụng Spanner làm cơ sở dữ liệu hỗ trợ ứng dụng. Tạo ứng dụng bằng cách sao chép mã sau vào ứng dụng của bạn.

  1. Tạo ứng dụng chính bằng cách thay thế app.py bằng nội dung sau
import os
from flask import Flask, request, jsonify
from google.cloud import spanner


app = Flask(__name__)


instance_id = "music-catalog"

database_id = "musicians"

spanner_client = spanner.Client()
instance = spanner_client.instance(instance_id)
database = instance.database(database_id)


@app.route("/")
def hello_world():
    return "<p>Hello, World!</p>"

@app.route('/singer', methods=['POST'])
def create():
    try:
        request_json = request.get_json()
        singer_id = request_json['singer_id']
        first_name = request_json['first_name']
        last_name = request_json['last_name']
        def insert_singers(transaction):
            row_ct = transaction.execute_update(
                f"INSERT Singers (SingerId, FirstName, LastName) VALUES" \
                f"({singer_id}, '{first_name}', '{last_name}')"
            )
            print("{} record(s) inserted.".format(row_ct))

        database.run_in_transaction(insert_singers)

        return {"Success": True}, 200
    except Exception as e:
        return e



@app.route('/singer', methods=['GET'])
def get_singer():

    try:
        singer_id = request.args.get('singer_id')
        def get_singer():
            first_name = ''
            last_name = ''
            with database.snapshot() as snapshot:
                results = snapshot.execute_sql(
                    f"SELECT SingerId, FirstName, LastName FROM Singers " \
                    f"where SingerId = {singer_id}",
                    )
                for row in results:
                    first_name = row[1]
                    last_name = row[2]
                return (first_name,last_name )
        first_name, last_name = get_singer()  
        return {"first_name": first_name, "last_name": last_name }, 200
    except Exception as e:
        return e


@app.route('/singer', methods=['PUT'])
def update_singer_first_name():
    try:
        singer_id = request.args.get('singer_id')
        request_json = request.get_json()
        first_name = request_json['first_name']
        
        def update_singer(transaction):
            row_ct = transaction.execute_update(
                f"UPDATE Singers SET FirstName = '{first_name}' WHERE SingerId = {singer_id}"
            )

            print("{} record(s) updated.".format(row_ct))

        database.run_in_transaction(update_singer)
        return {"Success": True}, 200
    except Exception as e:
        return e


@app.route('/singer', methods=['DELETE'])
def delete_singer():
    try:
        singer_id = request.args.get('singer')
    
        def delete_singer(transaction):
            row_ct = transaction.execute_update(
                f"DELETE FROM Singers WHERE SingerId = {singer_id}"
            )
            print("{} record(s) deleted.".format(row_ct))

        database.run_in_transaction(delete_singer)
        return {"Success": True}, 200
    except Exception as e:
        return e

port = int(os.environ.get('PORT', 8080))
if __name__ == '__main__':
    app.run(threaded=True, host='0.0.0.0', port=port)

Thêm cấu hình cơ sở dữ liệu

Để kết nối với Spanner một cách an toàn, hãy thiết lập ứng dụng để sử dụng Workload Identity. Điều này cho phép ứng dụng của bạn hoạt động như tài khoản dịch vụ riêng và có các quyền riêng lẻ khi truy cập vào cơ sở dữ liệu.

  1. Cập nhật deployment.yaml. Thêm đoạn mã sau vào cuối tệp (đảm bảo bạn giữ nguyên các dấu thụt dòng trong ví dụ bên dưới)
      serviceAccountName: python-ksa
      nodeSelector:
        iam.gke.io/gke-metadata-server-enabled: "true"

Sau khi thay đổi, phần thông số kỹ thuật sẽ có dạng như sau

   spec:
     containers:
     - name: python-app
       image: python-app
     serviceAccountName: python-ksa
     nodeSelector:
       iam.gke.io/gke-metadata-server-enabled: "true"

Triển khai và xác thực ứng dụng

  1. Trong ngăn ở cuối Cloud Shell Editor, hãy chọn Cloud Code rồi chọn Debug on Kubernetes ở đầu màn hình.
  2. Khi quá trình tạo và kiểm thử hoàn tất, thẻ Output (Đầu ra) sẽ có nội dung: Resource deployment/python-app status completed successfully và một URL được liệt kê: "Forwarded URL from service python-app: http://localhost:8080" (URL được chuyển tiếp từ dịch vụ python-app: http://localhost:8080)
  3. Thêm một vài mục.

Trong Terminal của Cloud Shell, hãy chạy lệnh bên dưới

curl -X POST http://localhost:8080/singer -H 'Content-Type: application/json' -d '{"first_name":"Cat","last_name":"Meow", "singer_id": 6}'
  1. Kiểm thử phương thức GET bằng cách chạy lệnh bên dưới trong cửa sổ dòng lệnh
curl -X GET http://localhost:8080/singer?singer_id=6
  1. Xoá thử: Giờ đây, hãy thử xoá một mục bằng cách chạy lệnh sau. Thay đổi giá trị của item-id nếu cần.
curl -X DELETE http://localhost:8080/singer?singer_id=6

    This throws an error message

500 Internal Server Error

Xác định và khắc phục vấn đề

  1. Chuyển sang chế độ gỡ lỗi và tìm ra vấn đề. Dưới đây là một số mẹo:
  • Chúng tôi biết có vấn đề với thao tác XOÁ vì thao tác này không trả về kết quả mong muốn. Vì vậy, bạn sẽ đặt điểm ngắt trong app.py trong phương thức delete_singer.
  • Chạy quy trình thực thi từng bước và theo dõi các biến ở mỗi bước để quan sát các giá trị của biến cục bộ trong cửa sổ bên trái.
  • Để quan sát các giá trị cụ thể như singer_id và request.args, hãy thêm các biến này vào cửa sổ Watch (Theo dõi).
  1. Xin lưu ý rằng giá trị được chỉ định cho singer_id là None. Thay đổi mã để khắc phục vấn đề.

Đoạn mã cố định sẽ có dạng như sau.

@app.route('/delete-singer', methods=['DELETE', 'GET'])
def delete_singer():
    try:
        singer_id = request.args.get('singer_id')
  1. Sau khi ứng dụng khởi động lại, hãy thử xoá lại để kiểm tra.
  2. Dừng phiên gỡ lỗi bằng cách nhấp vào hình vuông màu đỏ trên thanh công cụ gỡ lỗi 647213126d7a4c7b.png

6. Dọn dẹp

Xin chúc mừng! Trong phòng thí nghiệm này, bạn đã tạo một ứng dụng Python mới từ đầu và định cấu hình ứng dụng đó để hoạt động hiệu quả với các vùng chứa. Sau đó, bạn đã triển khai và gỡ lỗi ứng dụng của mình cho một cụm GKE từ xa theo quy trình phát triển tương tự trong các ngăn xếp ứng dụng truyền thống.

Cách dọn dẹp sau khi hoàn thành bài thực hành:

  1. Xoá các tệp được dùng trong phòng thí nghiệm
cd ~ && rm -rf ~/music-service
  1. Xoá dự án để loại bỏ tất cả cơ sở hạ tầng và tài nguyên liên quan