Hội thảo về cách sửa đổi ứng dụng

1. Giới thiệu

Lần cập nhật gần đây nhất: 1/11/2024

Làm cách nào để hiện đại hoá một ứng dụng PHP cũ lên Google Cloud?

(📽️ xem video giới thiệu dài 7 phút về lớp học lập trình này)

Thông thường, các ứng dụng cũ chạy tại chỗ cần được hiện đại hoá. Điều này có nghĩa là các ứng dụng này phải có khả năng mở rộng, bảo mật và triển khai được trong nhiều môi trường.

Trong hội thảo này, bạn sẽ:

  1. Đưa ứng dụng PHP vào vùng chứa.
  2. Chuyển sang Dịch vụ cơ sở dữ liệu được quản lý (Cloud SQL).
  3. Triển khai lên Cloud Run (đây là giải pháp thay thế không cần vận hành cho GKE/Kubernetes).
  4. Bảo mật ứng dụng bằng tính năng Quản lý danh tính và quyền truy cập (IAM) và Secret Manager.
  5. Xác định quy trình CI/CD thông qua Cloud Build. Bạn có thể kết nối Cloud Build với kho lưu trữ Git được lưu trữ trên các nhà cung cấp Git phổ biến như GitHub hoặc GitLab và được kích hoạt tại bất kỳ lệnh đẩy nào đến nhánh chính, chẳng hạn.
  6. Lưu trữ hình ảnh ứng dụng trên Cloud Storage. Bạn có thể thực hiện việc này thông qua quá trình gắn kết và không cần mã để thay đổi ứng dụng.
  7. Giới thiệu chức năng AI tạo sinh thông qua Gemini, được điều phối qua Cloud Functions (không máy chủ).
  8. Làm quen với SLO và vận hành ứng dụng mới được làm mới.

Bằng cách làm theo các bước này, bạn có thể dần hiện đại hoá ứng dụng PHP, cải thiện khả năng có thể mở rộng, tính bảo mật và tính linh hoạt khi triển khai. Hơn nữa, việc chuyển sang Google Cloud cho phép bạn tận dụng cơ sở hạ tầng và dịch vụ mạnh mẽ của Google Cloud để đảm bảo ứng dụng của bạn chạy mượt mà trong môi trường gốc trên đám mây.

Chúng tôi tin rằng những gì bạn học được sau các bước đơn giản này có thể áp dụng cho ứng dụng và tổ chức của riêng bạn với ngôn ngữ/ngăn xếp khác nhau và các trường hợp sử dụng khác nhau.

Giới thiệu về ứng dụng

Ứng dụng (mã, theo giấy phép MIT) mà bạn sẽ phân nhánh là một ứng dụng PHP 5.7 cơ bản có xác thực MySQL. Ý tưởng chính của Ứng dụng là cung cấp một nền tảng nơi người dùng có thể tải ảnh lên và quản trị viên có thể gắn thẻ hình ảnh không phù hợp. Ứng dụng có hai bảng:

  • Người dùng. Được biên dịch trước với quản trị viên. Người mới có thể đăng ký.
  • Hình ảnh. Đi kèm một vài hình ảnh mẫu. Người dùng đã đăng nhập có thể tải ảnh mới lên. Chúng tôi sẽ thêm một số gợi ý tại đây.

Mục tiêu của bạn

Chúng tôi muốn hiện đại hoá ứng dụng cũ để đưa ứng dụng đó lên Google Cloud. Chúng tôi sẽ tận dụng các công cụ và dịch vụ của Google Cloud để cải thiện khả năng mở rộng, tăng cường bảo mật, tự động hoá việc quản lý cơ sở hạ tầng và tích hợp các tính năng nâng cao như xử lý hình ảnh, giám sát và lưu trữ dữ liệu bằng các dịch vụ như Cloud SQL, Cloud Run, Cloud Build, Trình quản lý bí mật và nhiều dịch vụ khác.

445f7a9ae37e9b4d.png

Quan trọng hơn, chúng tôi muốn thực hiện từng bước để bạn có thể tìm hiểu quy trình tư duy đằng sau mỗi bước. Thông thường, mỗi bước sẽ mở ra những khả năng mới cho các bước tiếp theo (ví dụ: mô-đun 2 -> 3 và 6 -> 7).

Bạn vẫn chưa bị thuyết phục? Hãy xem video dài 7 phút này trên YouTube.

Bạn cần có

  • Máy tính có trình duyệt và kết nối Internet.
  • Một số tín dụng GCP. Hãy xem bước tiếp theo để biết cách thực hiện.
  • Bạn sẽ sử dụng Cloud Shell. Môi trường này có sẵn tất cả các lệnh cần thiết và một IDE.
  • Tài khoản GitHub. Bạn cần có tài khoản này để phân nhánh mã gốc 🧑🏻‍💻 gdgpescara/app-mod-workshop bằng kho lưu trữ git của riêng bạn. Bạn cần có quy trình CI/CD của riêng mình (tự động cam kết -> xây dựng -> triển khai)

Bạn có thể xem các giải pháp mẫu tại đây:

Hội thảo này được thiết kế để hoàn thành trên Cloud Shell (trên trình duyệt).

Tuy nhiên, bạn cũng có thể thử từ máy tính cục bộ.

2. Thiết lập tín dụng và Fork

6dafc658860c0ce5.png

Sử dụng tín dụng GCP và thiết lập môi trường GCP [không bắt buộc]

Để chạy hội thảo này, bạn cần có một tài khoản thanh toán có một số tín dụng. Hãy sử dụng tín dụng trong biểu ngữ ở đầu lớp học lập trình này để bắt đầu. Nếu đã kết nối với một tài khoản thanh toán, bạn có thể bỏ qua bước này.

Sau khi hoàn tất, hãy mở Google Cloud Console và tạo một dự án mới bằng cách nhấp vào Bộ chọn dự án ở trình đơn thả xuống trên cùng bên trái, nơi hiển thị "Không có tổ chức". Xem bên dưới

bd7548f78689db0b.png

Tạo một dự án mới nếu bạn chưa có dự án nào, như trong ảnh chụp màn hình bên dưới. Có một lựa chọn "NEW PROJECT" (DỰ ÁN MỚI) ở góc trên cùng bên phải.

6c82aebcb9f5cd47.png

Hãy nhớ liên kết dự án mới với tài khoản thanh toán dùng thử GCP như sau.

f202527d254893fb.png

Bạn đã sẵn sàng sử dụng Google Cloud Platform. Nếu là người mới bắt đầu hoặc chỉ muốn thực hiện mọi việc trong môi trường Cloud, bạn có thể truy cập vào Cloud Shell và trình chỉnh sửa của Cloud Shell thông qua nút sau ở góc trên cùng bên trái như minh hoạ bên dưới.

7d732d7bf0deb12e.png

Đảm bảo rằng bạn đã chọn dự án mới ở trên cùng bên trái:

Chưa chọn (không tốt):

c2ffd36a781b276a.png

Đã chọn (tốt):

594563c158f4f590.png

Phân nhánh ứng dụng từ GitHub

  1. Chuyển đến ứng dụng minh hoạ: https://github.com/gdgpescara/app-mod-workshop
  2. Nhấp vào 🍴 fork.
  3. Nếu chưa có tài khoản GitHub, bạn cần tạo một tài khoản mới.
  4. Chỉnh sửa nội dung theo ý muốn.

734e51bfc29ee5df.png

  1. Sao chép mã ứng dụng bằng cách sử dụng
  2. git clone https://github.com/YOUR-GITHUB-USER/YOUR-REPO-NAME
  1. Mở thư mục dự án đã sao chép bằng trình chỉnh sửa bạn yêu thích. Nếu chọn Cloud Shell, bạn có thể thực hiện bằng cách nhấp vào "Open Editor" (Mở trình chỉnh sửa) như minh hoạ bên dưới.

40f5977ea4c1d1cb.png

Bạn có mọi thứ cần thiết với Trình chỉnh sửa Google Cloud Shell như trong hình sau

a4e5ffb3e9a35e84.png

Bạn có thể thực hiện việc này bằng cách nhấp vào "Open Folder" (Mở thư mục) rồi chọn thư mục, có thể là app-mod-workshop trong thư mục gốc.

3. Mô-đun 1: Tạo một phiên bản SQL

645902e511a432a6.png

Tạo phiên bản Google Cloud SQL

Ứng dụng PHP của chúng ta sẽ kết nối với cơ sở dữ liệu MySQL, do đó, chúng ta cần sao chép cơ sở dữ liệu đó sang Google Cloud để di chuyển một cách dễ dàng. Cloud SQL là lựa chọn phù hợp nhất vì dịch vụ này cho phép bạn chạy một cơ sở dữ liệu MySQL được quản lý toàn diện trên đám mây. Sau đây là các bước cần thực hiện:

  1. Truy cập vào trang Cloud SQL: https://console.cloud.google.com/sql/instances
  2. Nhấp vào "Create Instance" (Tạo thực thể)
  3. Bật API (nếu cần). Quá trình này có thể mất vài giây.
  4. Chọn MySQL.
  5. (Chúng tôi đang cố gắng cung cấp cho bạn phiên bản rẻ nhất để bạn có thể sử dụng lâu hơn):
  • Phiên bản: Enterprise
  • Cài đặt trước: development (chúng tôi đã thử Sandbox nhưng không hiệu quả)
  • Phiên bản MySQL: 5.7 (wow, một phiên bản từ quá khứ!)
  1. Mã thực thể: chọn appmod-phpapp (nếu bạn thay đổi mã này, hãy nhớ thay đổi cả các tập lệnh và giải pháp trong tương lai cho phù hợp).
  2. Mật khẩu: bất kỳ mật khẩu nào bạn muốn nhưng hãy ghi lại dưới dạng CLOUDSQL_INSTANCE_PASSWORD
  3. Khu vực: giữ nguyên như bạn đã chọn cho phần còn lại của ứng dụng (ví dụ: Milan = europe-west8)
  4. Phạm vi cung cấp theo vùng: Một vùng (chúng tôi đang tiết kiệm chi phí cho bản minh hoạ)

Nhấp vào nút Create Instance (Tạo phiên bản) để triển khai cơ sở dữ liệu Cloud SQL; ⌛ quá trình này mất khoảng 10 phút để hoàn tất⌛. Trong thời gian chờ đợi, hãy tiếp tục đọc tài liệu; bạn cũng có thể bắt đầu giải quyết mô-đun tiếp theo ("Đóng gói ứng dụng PHP của bạn") vì mô-đun này không phụ thuộc vào mô-đun này trong phần đầu tiên (cho đến khi bạn khắc phục kết nối DB).

Lưu ý. Phiên bản này sẽ tốn khoảng 7 USD/ngày. Hãy nhớ tách riêng sau khi kết thúc hội thảo.

Tạo cơ sở dữ liệu image_catalog và Người dùng trong Cloud SQL

Dự án ứng dụng đi kèm với một thư mục db/ chứa hai tệp sql:

  1. 01_schema.sql: Chứa mã SQL để tạo hai bảng chứa dữ liệu Người dùng và Hình ảnh.
  2. 02_seed.sql: Chứa mã SQL để đưa dữ liệu vào các bảng đã tạo trước đó.

Các tệp này sẽ được dùng sau khi cơ sở dữ liệu image_catalog được tạo. Bạn có thể thực hiện việc này bằng cách làm theo các bước sau:

  1. Mở phiên bản của bạn rồi nhấp vào thẻ Databases (Cơ sở dữ liệu):
  2. nhấp vào "Tạo cơ sở dữ liệu"
  3. gọi là image_catalog (như trong cấu hình ứng dụng PHP).

997ef853e5ebd857.png

Sau đó, chúng ta tạo người dùng cơ sở dữ liệu. Nhờ đó, chúng ta có thể xác thực vào cơ sở dữ liệu image_catalog.

  1. Bây giờ, hãy nhấp vào thẻ Người dùng
  2. Nhấp vào "Thêm tài khoản người dùng".
  3. Người dùng: hãy tạo một người dùng:
  • Tên người dùng: appmod-phpapp-user
  • Mật khẩu: Chọn mật khẩu mà bạn có thể nhớ hoặc nhấp vào "tạo"
  • Giữ nguyên "Cho phép mọi máy chủ (%)".
  1. nhấp vào THÊM.

Mở cơ sở dữ liệu cho các IP phổ biến.

Xin lưu ý rằng tất cả cơ sở dữ liệu trong Cloud SQL đều được tạo ra ở trạng thái "bị tách biệt". Bạn cần thiết lập rõ ràng một mạng để có thể truy cập.

  1. Nhấp vào thực thể của bạn
  2. Mở trình đơn "Kết nối"
  3. Nhấp vào thẻ "Mạng".
  4. Nhấp vào mục "Mạng được uỷ quyền". Bây giờ, hãy thêm một mạng (tức là một mạng con).
  • Bây giờ, hãy chọn một chế độ cài đặt nhanh nhưng KHÔNG AN TOÀN để cho phép Ứng dụng hoạt động. Sau này, bạn có thể hạn chế quyền truy cập vào các IP mà bạn tin tưởng:
  • Tên: "Mọi người trên thế giới – KHÔNG AN TOÀN".
  • Mạng: "0.0.0.0/0" (Lưu ý: đây là phần KHÔNG AN TOÀN!)
  • Nhấp vào XONG
  1. Nhấp vào Lưu.

Bạn sẽ thấy như sau:

5ccb9062a7071964.png

Lưu ý. Giải pháp này là một giải pháp dung hoà tốt để hoàn thành hội thảo trong O(giờ). Tuy nhiên, hãy xem tài liệu BẢO MẬT để bảo mật giải pháp của bạn cho môi trường thực tế!

Đã đến lúc kiểm tra kết nối cơ sở dữ liệu!

Hãy xem người dùng image_catalog mà chúng ta đã tạo trước đó có hoạt động hay không.

Truy cập vào "Cloud SQL Studio" bên trong thực thể rồi nhập Cơ sở dữ liệu, Người dùng và Mật khẩu để xác thực như minh hoạ dưới đây:

d56765c6154c11a4.png

Bây giờ, bạn có thể mở Trình chỉnh sửa SQL và chuyển sang phần tiếp theo.

Nhập Cơ sở dữ liệu từ toàn bộ mã nguồn

Sử dụng Trình chỉnh sửa SQL để nhập các bảng image_catalog cùng với dữ liệu của các bảng đó. Sao chép mã SQL từ các tệp trong kho lưu trữ ( 01_schema.sql rồi đến 02_seed.sql) và thực thi các tệp đó theo thứ tự tuần tự.

Sau đó, bạn sẽ nhận được hai bảng trong image_catalog, đó là users và images như minh hoạ dưới đây:

65ba01e4c6c2dac0.png

Bạn có thể kiểm thử bằng cách chạy lệnh sau trong trình chỉnh sửa: select * from images;

Ngoài ra, hãy nhớ ghi lại địa chỉ IP công khai của phiên bản Cloud SQL, bạn sẽ cần địa chỉ này sau. Để lấy địa chỉ IP, hãy chuyển đến trang chính của phiên bản Cloud SQL trong trang Tổng quan. (Tổng quan > Kết nối với thực thể này > Địa chỉ IP công khai).

4. Mô-đun 2: Đưa ứng dụng PHP vào vùng chứa

e7f0e9979d8805f5.png

Chúng tôi muốn xây dựng ứng dụng này cho đám mây.

Điều này có nghĩa là đóng gói mã trong một loại tệp ZIP chứa tất cả thông tin để chạy mã đó trên Cloud.

Có một số cách để đóng gói:

  • Docker. Rất phổ biến nhưng khá phức tạp để thiết lập chính xác.
  • Buildpack. Ít phổ biến hơn nhưng có xu hướng "tự động đoán" nội dung cần tạo và chạy. Thường thì cách này sẽ hiệu quả!

Trong bối cảnh của hội thảo này, chúng tôi giả định rằng bạn sử dụng Docker.

Nếu bạn chọn sử dụng Cloud Shell, thì đây là lúc để mở lại (nhấp vào phía trên cùng bên phải của Cloud Console).

ec6a6b90b39e03e.png

Thao tác này sẽ mở một shell thuận tiện ở cuối trang, nơi bạn đã phân nhánh mã trong bước thiết lập.

6999b906c0dedeb7.png

Docker

Nếu bạn muốn có quyền kiểm soát, thì đây là giải pháp phù hợp cho bạn. Điều này hợp lý khi bạn cần định cấu hình các thư viện cụ thể và chèn một số hành vi không rõ ràng (chmod trong tệp tải lên, tệp thực thi không chuẩn trong ứng dụng, v.v.)

Vì cuối cùng chúng ta muốn triển khai ứng dụng trong vùng chứa lên Cloud Run, hãy xem tài liệu sau đây. Bạn sẽ chuyển đổi ngược từ PHP 8 sang PHP 5.7 như thế nào? Có thể bạn dùng được Gemini cho việc đó. Ngoài ra, bạn có thể sử dụng phiên bản tạo sẵn này:

# Use the official PHP image: https://hub.docker.com/_/php
FROM php:5.6-apache

# Configure PHP for Cloud Run.
# Precompile PHP code with opcache.
# Install PHP's extension for MySQL
RUN docker-php-ext-install -j "$(nproc)" opcache mysqli pdo pdo_mysql && docker-php-ext-enable pdo_mysql

RUN set -ex; \
  { \
    echo "; Cloud Run enforces memory & timeouts"; \
    echo "memory_limit = -1"; \
    echo "max_execution_time = 0"; \
    echo "; File upload at Cloud Run network limit"; \
    echo "upload_max_filesize = 32M"; \
    echo "post_max_size = 32M"; \
    echo "; Configure Opcache for Containers"; \
    echo "opcache.enable = On"; \
    echo "opcache.validate_timestamps = Off"; \
    echo "; Configure Opcache Memory (Application-specific)"; \
    echo "opcache.memory_consumption = 32"; \
  } > "$PHP_INI_DIR/conf.d/cloud-run.ini"

# Copy in custom code from the host machine.
WORKDIR /var/www/html

COPY . .

# Setup the PORT environment variable in Apache configuration files: https://cloud.google.com/run/docs/reference/container-contract#port
ENV PORT=8080

# Tell Apache to use 8080 instead of 80.
RUN sed -i 's/80/${PORT}/g' /etc/apache2/sites-available/000-default.conf /etc/apache2/ports.conf

# Note: This is quite insecure and opens security breaches. See last chapter for hardening ideas.
# Uncomment at your own risk:
#RUN chmod 777 /var/www/html/uploads/

# Configure PHP for development.
# Switch to the production php.ini for production operations.
# RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
# https://github.com/docker-library/docs/blob/master/php/README.md#configuration
RUN mv "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini"

# Expose the port
EXPOSE 8080

Bạn có thể xem phiên bản Dockerfile mới nhất tại đây.

Để kiểm thử ứng dụng trên máy, chúng ta cần thay đổi tệp config.php sao cho Ứng dụng PHP sẽ kết nối với cơ sở dữ liệu MYSQL có trên Google CloudSQL. Dựa trên những gì bạn đã thiết lập trước đó, hãy điền vào chỗ trống:

<?php
// Database configuration
$db_host = '____________';
$db_name = '____________';
$db_user = '____________';
$db_pass = '____________';

try {
    $pdo = new PDO("mysql:host=$db_host;dbname=$db_name", $db_user, $db_pass);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
    die("Errore di connessione: " . $e->getMessage());
}

session_start();
?>
  • DB_HOST là địa chỉ IP công khai của Cloud SQL, bạn có thể tìm thấy địa chỉ này trong bảng điều khiển SQL:

bd27071bf450a8d0.png

  • DB_NAME không được thay đổi: image_catalog
  • DB_USER phải là appmod-phpapp-user
  • DB_PASS là nội dung bạn đã chọn. Hãy thiết lập trong dấu nháy đơn và thoát nếu cần.

Ngoài ra, bạn có thể thoải mái dịch một số đoạn tiếng 🇮🇹 Ý sang tiếng Anh bằng Gemini!

Giờ đây, khi bạn đã có Dockerfile và đã định cấu hình Ứng dụng PHP để kết nối với DB, hãy thử xem!

Cài đặt Docker nếu bạn chưa có (đường liên kết). Bạn không cần cài đặt nếu đang sử dụng Cloud Shell (thật tuyệt phải không?).

Bây giờ, hãy thử tạo và chạy Ứng dụng PHP trong vùng chứa bằng các lệnh docker build và docker run thích hợp.

# Build command - don't forget the final . This works if Dockerfile is inside the code folder:
$ docker build -t my-php-app-docker .   

# Local Run command: most likely ports will be 8080:8080
$ docker run -it -p <CONTAINER_PORT>:<LOCAL_MACHINE_PORT> my-php-app-docker

Nếu mọi thứ đều hoạt động, bạn sẽ thấy trang web sau đây khi kết nối với máy chủ cục bộ! Bây giờ, ứng dụng của bạn đang chạy trên cổng 8080, hãy nhấp vào biểu tượng "Web preview" (Bản xem trước trên web) (trình duyệt có hình con mắt) rồi nhấp vào Preview on port 8080 (Xem trước trên cổng 8080) (hoặc "Change port" (Thay đổi cổng) cho bất kỳ cổng nào khác)

33a24673f4550454.png

Kiểm tra kết quả trên trình duyệt

Bây giờ, ứng dụng của bạn sẽ có dạng như sau:

2718ece96b1f18b6.png

Nếu đăng nhập bằng Admin/admin123, bạn sẽ thấy nội dung như sau.

68b62048c2e86aea.png

Tuyệt vời!!! Ngoài văn bản tiếng Ý, mọi thứ đều hoạt động! 🎉🎉🎉

Nếu quá trình dockerization của bạn diễn ra suôn sẻ nhưng thông tin đăng nhập DB không chính xác, bạn có thể nhận được thông báo như sau:

e22f45b79bab86e1.png

Hãy thử lại, bạn sắp thành công rồi!

Lưu vào Artifact Registry [không bắt buộc]

Đến đây, bạn đã có một ứng dụng PHP được đóng gói sẵn sàng để triển khai lên đám mây. Tiếp theo, chúng ta cần một nơi trên đám mây để lưu trữ hình ảnh Docker và cho phép triển khai hình ảnh đó cho các dịch vụ của Google Cloud như Cloud Run. Giải pháp lưu trữ này được gọi là Artifact Registry, một dịch vụ được quản lý toàn diện của Google Cloud, được thiết kế để lưu trữ các cấu phần phần mềm của ứng dụng, bao gồm cả hình ảnh vùng chứa Docker, gói Maven, mô-đun npm và nhiều cấu phần khác.

Hãy tạo một kho lưu trữ trong Google Cloud Artifact Registry bằng nút thích hợp.

e1123f0c924022e6.png

Chọn tên hợp lệ, định dạng và khu vực phù hợp để lưu trữ cấu phần phần mềm.

4e516ed209c470ee.png

Quay lại thẻ môi trường phát triển cục bộ và đẩy hình ảnh vùng chứa ứng dụng vào kho lưu trữ Artifact Registry vừa tạo. Hãy hoàn tất các lệnh sau để thực hiện việc này.

  • docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]
  • docker push TARGET_IMAGE[:TAG]

Kết quả sẽ có dạng như ảnh chụp màn hình sau đây.

1e498feb4e88be9f.png

Tuyệt vời 🎉🎉🎉 bạn có thể chuyển sang cấp độ tiếp theo. Trước đó, có thể bạn nên dành 2 phút để thử tải lên/đăng nhập/đăng xuất và làm quen với các điểm cuối của ứng dụng.Bạn sẽ cần đến các điểm cuối này sau.

Các lỗi có thể xảy ra

Nếu bạn gặp lỗi khi đóng gói, hãy thử dùng Gemini để giải thích và khắc phục lỗi, đồng thời cung cấp:

  • Dockerfile hiện tại của bạn
  • Lỗi nhận được
  • [nếu cần] mã PHP đang được thực thi.

Quyền tải lên. Ngoài ra, hãy thử điểm cuối /upload.php và thử tải ảnh lên. Bạn có thể gặp lỗi bên dưới. Nếu có, bạn cần khắc phục một số vấn đề về chmod/chown trong Dockerfile.

Warning: move_uploaded_file(uploads/image (3).png): failed to open stream: Permission denied in /var/www/html/upload.php on line 11

PDOException "could not find driver" (hoặc "Errore di connessione: could not find driver"). Đảm bảo tệp Docker của bạn có các thư viện PDO thích hợp cho mysql (pdo_mysql) để kết nối với cơ sở dữ liệu. Tìm cảm hứng từ các giải pháp tại đây.

Không thể chuyển tiếp yêu cầu của bạn đến phần phụ trợ. Không thể kết nối với máy chủ trên cổng 8080. Điều này có nghĩa là bạn có thể đang hiển thị sai cổng. Hãy đảm bảo rằng bạn đang hiển thị cổng mà Apache/Nginx thực sự đang phân phát. Đây không phải là việc dễ dàng. Nếu có thể, hãy cố gắng đặt cổng đó là 8080 (giúp bạn dễ dàng sử dụng Cloud Run). Nếu bạn muốn giữ cổng 80 (ví dụ: vì Apache muốn như vậy), hãy sử dụng một lệnh khác để chạy:

$ docker run -it -p 8080:80 # force 80

# Use the PORT environment variable in Apache configuration files.

# https://cloud.google.com/run/docs/reference/container-contract#port

RUN sed -i 's/80/${PORT}/g' /etc/apache2/sites-available/000-default.conf /etc/apache2/ports.conf

5. Mô-đun 3: Triển khai ứng dụng lên Cloud Run

9ffca42774f6c5d1.png

Tại sao nên dùng Cloud Run?

Câu hỏi hay đấy! Nhiều năm trước, chắc chắn bạn sẽ chọn Google App Engine.

Nói một cách đơn giản, Cloud Run hiện có bộ phần mềm cơ sở mới hơn, dễ triển khai hơn, rẻ hơn và có thể giảm quy mô xuống 0 khi bạn không sử dụng. Nhờ khả năng linh hoạt chạy mọi vùng chứa không có trạng thái và tích hợp với nhiều dịch vụ của Google Cloud, Cloud Run là lựa chọn lý tưởng để triển khai các dịch vụ vi mô và ứng dụng hiện đại với mức hao tổn tối thiểu và hiệu quả tối đa.

Cụ thể hơn, Cloud Run là một nền tảng được quản lý toàn diện của Google Cloud, cho phép bạn chạy các ứng dụng được đóng gói không có trạng thái trong môi trường không máy chủ. Dịch vụ này tự động xử lý toàn bộ cơ sở hạ tầng, mở rộng quy mô từ 0 để đáp ứng lưu lượng truy cập đến và thu hẹp quy mô khi không hoạt động, giúp tiết kiệm chi phí và hoạt động hiệu quả. Cloud Run hỗ trợ mọi ngôn ngữ hoặc thư viện, miễn là ngôn ngữ hoặc thư viện đó được đóng gói trong một vùng chứa, mang lại sự linh hoạt cao trong quá trình phát triển. Dịch vụ này tích hợp tốt với các dịch vụ khác của Google Cloud và phù hợp để xây dựng các dịch vụ vi mô, API, trang web và ứng dụng dựa trên sự kiện mà không cần quản lý cơ sở hạ tầng máy chủ.

Điều kiện tiên quyết

Để hoàn thành nhiệm vụ này, bạn cần cài đặt gcloud trên máy cục bộ. Nếu không, hãy xem hướng dẫn tại đây. Nếu đang sử dụng Google Cloud Shell, bạn không cần làm gì cả.

Trước khi triển khai...

Nếu bạn đang làm việc trong môi trường cục bộ, hãy xác thực với Google Cloud bằng lệnh sau

  • $ gcloud auth login –update-adc # not needed in Cloud Shell

Thao tác này sẽ xác thực bạn thông qua thông tin đăng nhập OAuth trên trình duyệt. Đảm bảo rằng bạn đăng nhập thông qua Chrome bằng cùng một người dùng (ví dụ: vattelapesca@gmail.com) đã đăng nhập vào Google Cloud và đã bật tính năng thanh toán.

Bật Cloud Run API bằng lệnh sau:

  • $ gcloud services enable run.googleapis.com cloudbuild.googleapis.com

Bây giờ, mọi thứ đã sẵn sàng để triển khai lên Cloud Run.

Triển khai ứng dụng lên Cloud Run thông qua gcloud

Lệnh cho phép bạn triển khai ứng dụng trên Cloud Run là gcloud run deploy. Bạn có thể đặt một số lựa chọn để đạt được mục tiêu của mình. Sau đây là tập hợp các tuỳ chọn tối thiểu (bạn có thể cung cấp thông qua dòng lệnh hoặc công cụ sẽ hỏi bạn bằng lời nhắc tương tác):

  1. Tên của Dịch vụ Cloud Run mà bạn muốn triển khai cho Ứng dụng của mình. Dịch vụ Cloud Run sẽ trả về cho bạn một URL cung cấp điểm cuối cho Ứng dụng của bạn.
  2. Khu vực Google Cloud nơi Ứng dụng của bạn sẽ chạy. (--region REGION)
  3. Hình ảnh vùng chứa bao bọc Ứng dụng của bạn.
  4. Biến môi trường mà Ứng dụng của bạn cần sử dụng trong quá trình thực thi.
  5. Cờ Allow-Unauthenticated cho phép mọi người truy cập vào Ứng dụng của bạn mà không cần xác thực thêm.

Hãy tham khảo tài liệu (hoặc di chuyển xuống để xem giải pháp có thể áp dụng) để biết cách áp dụng lựa chọn này cho dòng lệnh của bạn.

Quá trình triển khai sẽ mất vài phút. Nếu mọi thứ đều chính xác, bạn sẽ thấy một thông báo như sau trong Google Cloud Console.

ef1029fb62f8de81.pngf7191d579c21ca3e.png

Nhấp vào URL do Cloud Run cung cấp và kiểm thử Ứng dụng của bạn. Sau khi xác thực, bạn sẽ thấy nội dung như sau.

d571a90cd5a373f9.png

"gcloud run deploy" không có đối số

Bạn có thể nhận thấy rằng gcloud run deploy đặt cho bạn những câu hỏi phù hợp và điền vào những chỗ trống mà bạn để lại. Thật tuyệt vời!

Tuy nhiên, trong một số mô-đun, chúng ta sẽ thêm lệnh này vào một trình kích hoạt Cloud Build để không phải trả lời các câu hỏi tương tác. Chúng ta cần điền vào mọi tuỳ chọn trong lệnh. Vậy là bạn muốn chế tạo gcloud run deploy --option1 blah --foo bar --region your-fav-region vàng. Bạn sẽ làm những gì?

  1. lặp lại các bước 2-3-4 cho đến khi gcloud ngừng đặt câu hỏi:
  2. [LOOP] gcloud run deploy với các lựa chọn đã tìm thấy cho đến nay
  3. Hệ thống [LOOP] yêu cầu lựa chọn X
  4. [LOOP] Search in public docs how to set up X from CLI adding option --my-option [my-value].
  5. Bây giờ, hãy quay lại bước 2, trừ phi gcloud hoàn tất mà không có câu hỏi nào khác.
  6. Lệnh gcloud run deploy này thật tuyệt vời! Lưu lệnh này ở đâu đó, bạn sẽ cần đến lệnh này sau cho bước Cloud Build!

Bạn có thể xem một giải pháp khả thi tại đây. Tài liệu có tại đây.

🎉🎉🎉 Chúc mừng bạn đã triển khai thành công ứng dụng của mình trên Google Cloud, hoàn thành bước đầu tiên trong quá trình hiện đại hoá.

6. Học phần 4: Xoá mật khẩu bằng Secret Manager

95cd57b03b4e3c73.png

Trong bước trước, chúng ta đã triển khai và chạy thành công ứng dụng trong Cloud Run. Tuy nhiên, chúng tôi đã thực hiện việc này bằng một phương pháp bảo mật không tốt: cung cấp một số thông tin bí mật ở dạng văn bản thô.

Lần lặp lại đầu tiên: Cập nhật config.php để sử dụng ENV

Bạn có thể nhận thấy rằng chúng ta đã đặt mật khẩu cơ sở dữ liệu ngay vào mã trong tệp config.php. Điều này phù hợp cho mục đích thử nghiệm và để xem Ứng dụng có hoạt động hay không. Nhưng bạn không thể cam kết/sử dụng mã như vậy trong môi trường thực tế. Mật khẩu (và các tham số kết nối DB khác) phải được đọc linh động và cung cấp cho Ứng dụng trong thời gian chạy. Thay đổi tệp config.php để tệp này đọc các tham số cơ sở dữ liệu từ các biến ENV. Nếu không thành công, bạn nên cân nhắc việc đặt giá trị mặc định. Điều này rất hữu ích trong trường hợp bạn không tải được ENV, vì vậy, kết quả của trang sẽ cho bạn biết liệu trang có đang sử dụng các giá trị mặc định hay không. Điền vào chỗ trống và thay thế mã trong config.php.

<?php
// Database configuration with ENV variables. Set default values as well 
$db_host = getenv('DB_HOST') ?: 'localhost';
$db_name = getenv('DB_NAME') ?: 'image_catalog';
$db_user = getenv('DB_USER') ?: 'appmod-phpapp-user';
$db_pass = getenv('DB_PASS') ?: 'wrong_password';
// Note getenv() is PHP 5.3 compatible
try {
    $pdo = new PDO("mysql:host=$db_host;dbname=$db_name", $db_user, $db_pass);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
    die("Errore di connessione: " . $e->getMessage());
}

session_start();
?>

Vì Ứng dụng của bạn được đóng gói, nên bạn cần cung cấp một cách để cung cấp các biến ENV cho Ứng dụng. Bạn có thể thực hiện việc này theo một số cách:

  • Tại thời điểm bản dựng, trên Dockerfile. Thêm 4 tham số vào tệp Docker trước đó bằng cú pháp ENV DB_VAR=ENV_VAR_VALUE. Thao tác này sẽ thiết lập các giá trị mặc định có thể ghi đè trong thời gian chạy. Ví dụ: "DB_NAME" và "DB_USER" có thể được đặt ở đây và không đặt ở nơi nào khác.
  • Tại thời điểm chạy. Bạn có thể thiết lập các biến này cho Cloud Run, cả từ CLI hoặc từ giao diện người dùng. Đây là nơi thích hợp để đặt tất cả 4 biến (trừ phi bạn muốn giữ nguyên các giá trị mặc định được đặt trong tệp Docker).

Trong localhost, bạn nên đặt các biến ENV vào tệp .env (kiểm tra thư mục solutions).

Ngoài ra, hãy đảm bảo rằng .env được thêm vào .gitignore của bạn: bạn không muốn đẩy thông tin bí mật của mình lên GitHub!

echo .env >> .gitignore

Sau đó, bạn có thể kiểm thử thực thể trên máy:

docker run -it -p 8080:8080 --env-file .env my-php-app-docker

Giờ đây, bạn đã đạt được những điều sau:

  1. Ứng dụng của bạn sẽ đọc biến một cách linh động từ ENV
  2. Bạn đã cải thiện tính bảo mật vì đã xoá mật khẩu cơ sở dữ liệu khỏi mã của mình)

Giờ đây, bạn có thể triển khai một bản sửa đổi mới cho Cloud Run. Hãy chuyển sang giao diện người dùng và đặt các biến môi trường theo cách thủ công:

  • Truy cập vào https://console.cloud.google.com/run
  • Nhấp vào ứng dụng của bạn
  • Nhấp vào "Chỉnh sửa và triển khai bản sửa đổi mới"
  • Trên thẻ đầu tiên "Container(s)" (Vùng chứa), hãy nhấp vào thẻ dưới "Variables and secrets" (Biến và khoá bí mật)
  • Nhấp vào "+ Thêm biến" rồi thêm tất cả các biến cần thiết. Bạn sẽ thấy kết quả như sau:

7a5fbfa448544d3.pngf2780c35585388ca.png

Is this perfect? Không. PASS của bạn vẫn hiển thị với hầu hết các nhà mạng. Bạn có thể giảm thiểu tình trạng này bằng cách sử dụng Google Cloud Secret Manager.

Lần lặp lại thứ hai: Trình quản lý bí mật

Mật khẩu đã biến mất khỏi mã của bạn: thành công! Nhưng khoan đã, chúng ta đã an toàn chưa?

Mật khẩu của bạn vẫn hiển thị với bất kỳ ai có quyền truy cập vào Google Cloud Console. Trên thực tế, nếu truy cập vào tệp triển khai YAML của Cloud Run, bạn sẽ có thể truy xuất tệp này. Hoặc nếu bạn cố gắng chỉnh sửa hoặc triển khai một bản sửa đổi Cloud Run mới, mật khẩu sẽ hiển thị trong phần Biến và bí mật như trong ảnh chụp màn hình bên dưới.

Secret Manager của Google Cloud là một dịch vụ tập trung, bảo mật để quản lý thông tin nhạy cảm như khoá API, mật khẩu, chứng chỉ và các thông tin bí mật khác.

Dịch vụ này cho phép bạn lưu trữ, quản lý và truy cập vào thông tin bí mật bằng các quyền chi tiết và tính năng mã hoá mạnh mẽ. Được tích hợp với dịch vụ Quản lý danh tính và quyền truy cập (IAM) của Google Cloud, Secret Manager cho phép bạn kiểm soát những người có thể truy cập vào các mật khẩu cụ thể, đảm bảo tính bảo mật dữ liệu và tuân thủ quy định.

Dịch vụ này cũng hỗ trợ việc tự động xoay vòng và tạo phiên bản cho dữ liệu bí mật, giúp đơn giản hoá quy trình quản lý vòng đời của dữ liệu bí mật và tăng cường bảo mật cho các ứng dụng trên các dịch vụ của Google Cloud.

Để truy cập vào Secret Manager, hãy chuyển từ trình đơn có biểu tượng ba dấu gạch ngang đến các dịch vụ Bảo mật rồi tìm dịch vụ này trong mục Bảo vệ dữ liệu như trong ảnh chụp màn hình bên dưới.

6df83a1c3cb757f6.png

Bật Secret Manager API khi bạn truy cập vào đó, như trong hình sau.

a96c312e2c098db1.png

  • Bây giờ, hãy nhấp vào "Create a secret" (Tạo khoá bí mật): Hãy đặt tên cho khoá bí mật này một cách hợp lý:
  • Tên: php-amarcord-db-pass
  • Giá trị bí mật: "mật khẩu cơ sở dữ liệu của bạn" (bỏ qua phần "tải tệp lên").
  • chú thích đường liên kết bí mật này, sẽ có dạng như projects/123456789012/secrets/php-amarcord-db-pass. Đây là con trỏ duy nhất đến khoá bí mật của bạn (Đối với Terraform, Cloud Run và các dịch vụ khác). Số này là mã số dự án riêng biệt của bạn.

Mẹo: Cố gắng sử dụng quy ước đặt tên nhất quán cho các khoá bí mật, chuyên biệt hoá từ trái sang phải, ví dụ: cloud-devrel-phpamarcord-dbpass

  • Tổ chức (với công ty)
  • Nhóm (trong tổ chức)
  • Ứng dụng (trong nhóm)
  • Tên biến (trong ứng dụng)

Điều này sẽ giúp bạn dễ dàng sử dụng biểu thức chính quy để tìm tất cả thông tin bí mật cho một ứng dụng.

Tạo bản sửa đổi Cloud Run mới

Bây giờ, khi đã có một khoá bí mật mới, chúng ta cần loại bỏ biến môi trường DB_PASS và thay thế bằng khoá bí mật mới. Do đó:

  • Truy cập vào Cloud Run bằng Google Cloud Console
  • Chọn ứng dụng.
  • Nhấp vào "Chỉnh sửa và triển khai bản sửa đổi mới"
  • tìm thẻ "Variables & Secrets" (Biến và khoá bí mật).
  • Sử dụng nút "+ Tham chiếu một khoá bí mật" để đặt lại biến môi trường DB_PASS.
  • Sử dụng cùng một "DB_PASS" cho các Bí mật được tham chiếu và sử dụng phiên bản mới nhất.

9ed4e35be7654dcb.png

Sau khi hoàn tất, bạn sẽ gặp lỗi sau

da0ccd7af39b04ed.png

Cố gắng tìm cách khắc phục. Để giải quyết vấn đề này, bạn cần truy cập vào mục IAM & Admin (Quản lý danh tính và quyền truy cập và Quản trị viên) rồi thay đổi quyền cấp. Chúc bạn gỡ lỗi thành công!

Sau khi tìm ra, hãy quay lại Cloud Run và triển khai lại một bản sửa đổi mới. Kết quả sẽ có dạng như hình sau:

e89f9ca780169b6b.png

Mẹo: Developer Console (giao diện người dùng) là công cụ rất hữu ích để chỉ ra các vấn đề về quyền. Hãy dành thời gian khám phá tất cả các đường liên kết cho các thực thể Cloud của bạn!

7. Mô-đun 5: Thiết lập CI/CD bằng Cloud Build

ba49b033c11be94c.png

Tại sao nên dùng quy trình CI/CD?

Đến giờ, có lẽ bạn đã nhập gcloud run deploy vài lần, có thể là trả lời cùng một câu hỏi nhiều lần.

Bạn mệt mỏi vì phải triển khai ứng dụng theo cách thủ công bằng lệnh gcloud run deploy? Sẽ thật tuyệt nếu ứng dụng của bạn có thể tự động triển khai mỗi khi bạn đẩy một thay đổi mới lên kho lưu trữ Git.

Để sử dụng quy trình CI/CD, bạn cần có hai thứ:

  1. Kho lưu trữ Git cá nhân: May mắn là bạn đã phân nhánh kho lưu trữ hội thảo sang tài khoản GitHub của mình ở Bước 2. Nếu chưa, hãy quay lại và hoàn tất bước đó. Kho lưu trữ được phân nhánh của bạn sẽ có dạng như sau: https://github.com/<YOUR_GITHUB_USER>/app-mod-workshop
  2. Cloud Build. Dịch vụ tuyệt vời và giá rẻ này cho phép bạn định cấu hình tự động hoá bản dựng cho hầu hết mọi thứ: Terraform, ứng dụng Docker, v.v.

Phần này sẽ tập trung vào việc thiết lập Cloud Build.

Cloud Build đã ra đời!

Chúng ta sẽ sử dụng Cloud Build để thực hiện việc này:

  • tạo nguồn (bằng Dockerfile). Hãy coi đây là một "tệp .zip lớn" chứa mọi thứ bạn cần để tạo và chạy tệp đó ("phần mềm bản dựng").
  • đẩy cấu phần phần mềm này vào Artifact Registry (AR).
  • Sau đó, triển khai từ AR sang Cloud Run cho ứng dụng "php-amarcord"
  • Thao tác này sẽ tạo một phiên bản mới ("bản sửa đổi") của ứng dụng hiện có (hãy coi đây là một lớp có mã mới) và chúng tôi sẽ định cấu hình để chuyển hướng lưu lượng truy cập đến phiên bản mới nếu quá trình đẩy thành công.

Sau đây là ví dụ về một số bản dựng cho ứng dụng php-amarcord của tôi:

f30f42d4571ad5e2.png

Làm thế nào để chúng tôi thực hiện tất cả những điều này?

  1. Bằng cách tạo một tệp YAML hoàn hảo: cloudbuild.yaml
  2. Bằng cách tạo một trình kích hoạt Cloud Build.
  3. Bằng cách kết nối với kho lưu trữ GitHub của chúng tôi thông qua giao diện người dùng Cloud Build.

Tạo điều kiện kích hoạt (và kết nối kho lưu trữ)

  • Truy cập vào https://console.cloud.google.com/cloud-build/triggers
  • Nhấp vào "Tạo điều kiện kích hoạt".
  • Biên dịch:
  • Tên: Một tên có ý nghĩa, chẳng hạn như on-git-commit-build-php-app
  • Sự kiện: Đẩy lên nhánh
  • Nguồn: "Kết nối kho lưu trữ mới" văn bản thay thế
  • Thao tác này sẽ mở một cửa sổ ở bên phải: "Kết nối kho lưu trữ"
  • Nhà cung cấp nguồn: "GitHub" (đầu tiên)
  • "Tiếp tục"
  • Xác thực sẽ mở một cửa sổ trên github để xác thực chéo. Hãy làm theo quy trình và kiên nhẫn. Nếu bạn có nhiều kho lưu trữ, quá trình này có thể mất một chút thời gian.
  • "Chọn kho lưu trữ" Chọn tài khoản/kho lưu trữ của bạn và đánh dấu vào phần "Tôi hiểu...".
  • Nếu bạn gặp lỗi: Ứng dụng GitHub chưa được cài đặt trên bất kỳ kho lưu trữ nào của bạn, hãy tiếp tục nhấp vào "Cài đặt Google Cloud Build" và làm theo hướng dẫn.
  • 23e0e0f1219afea3.pngNhấp vào Kết nối
  • bafd904ec07122d2.png
  • Bingo! Kho lưu trữ của bạn hiện đã được kết nối.
  • Quay lại phần Trình kích hoạt....
  • Cấu hình: Tự động phát hiện (*)
  • Nâng cao: Chọn tài khoản dịch vụ "[PROJECT_NUMBER]- compute@developer.gserviceaccount.com"
  • xxxxx là mã dự án của bạn
  • Tài khoản dịch vụ điện toán mặc định phù hợp với phương pháp phòng thí nghiệm – đừng sử dụng tài khoản này trong môi trường thực tế! (Tìm hiểu thêm).
  • giữ nguyên mọi thứ khác.
  • Nhấp vào nút "Tạo".

(*) Đây là cách đơn giản nhất vì cách này kiểm tra tệp Docker hoặc cloudbuild.yaml. Tuy nhiên, cloudbuild.yaml cho phép bạn quyết định việc cần làm ở từng bước.

Tôi có sức mạnh!

Giờ đây, điều kiện kích hoạt sẽ không hoạt động trừ phi bạn cấp cho tài khoản dịch vụ Cloud Build (tài khoản dịch vụ là gì? Email của một "robot" thay mặt bạn thực hiện một nhiệm vụ – trong trường hợp này là xây dựng nội dung trên Cloud!).

SA của bạn sẽ không thể xây dựng và triển khai trừ phi bạn trao quyền cho họ. May mắn là việc này rất dễ dàng!

  • chuyển đến phần "Cloud Build" > "Cài đặt".
  • Tài khoản dịch vụ "[PROJECT_NUMBER]- compute@developer.gserviceaccount.com"
  • Đánh dấu vào các hộp sau:
  • Cloud Run
  • Secret Manager
  • Tài khoản dịch vụ
  • Cloud Build
  • Đồng thời, hãy đánh dấu vào ô "Đặt làm tài khoản dịch vụ ưu tiên"

8715acca72286a46.png

Tệp YAML của Cloud Build ở đâu?

Bạn nên dành thời gian để tạo tệp YAML Cloud Build của riêng mình.

Tuy nhiên, nếu không có thời gian hoặc không muốn dành thời gian, bạn có thể lấy cảm hứng trong thư mục giải pháp này: .solutions

Giờ đây, bạn có thể đẩy một thay đổi lên GitHub và quan sát Cloud Build thực hiện phần việc của mình.

Việc thiết lập Cloud Build có thể khá phức tạp. Dự kiến sẽ có một số cuộc trao đổi qua lại trước:

  • Đang kiểm tra nhật ký trong https://console.cloud.google.com/cloud-build/builds;region=global
  • Đang tìm lỗi.
  • Sửa lỗi trong mã và phát hành lại git commit/git push.
  • Đôi khi, lỗi không nằm trong mã mà nằm ở một số cấu hình. Trong trường hợp đó, bạn có thể phát hành một bản dựng mới từ giao diện người dùng (bản dựng trên đám mây > "Trình kích hoạt" > Chạy)

97acd16980a144ab.png

Xin lưu ý rằng nếu sử dụng giải pháp này, bạn vẫn còn một số việc phải làm. Ví dụ: bạn cần đặt biến ENV cho các điểm cuối dev/prod mới tạo:

3da8723e4ff80c0a.png

Bạn có thể làm điều này theo hai cách:

  • Thông qua giao diện người dùng – bằng cách đặt lại các biến ENV
  • Thông qua CLI bằng cách tạo tập lệnh "hoàn hảo" cho bạn. Bạn có thể xem ví dụ tại đây: gcloud-run-deploy.sh . Bạn cần điều chỉnh một số thông tin, chẳng hạn như điểm cuối và số dự án. Bạn có thể tìm thấy số dự án trong phần Tổng quan về Cloud.

Làm cách nào để cam kết mã với GitHub?

Hội thảo này không hướng dẫn bạn cách tốt nhất để git push lên GitHub. Tuy nhiên, trong trường hợp bạn gặp khó khăn và đang ở trong Cloud Shell, có hai cách:

  1. CLI. Thêm khoá ssh trên máy và thêm kho lưu trữ từ xa bằng git@github.com:YOUR_USER/app-mod-workshop.git (thay vì http)
  2. VSCode. Nếu sử dụng trình chỉnh sửa Cloud Shell, bạn có thể dùng thẻ Kiểm soát nguồn (ctrl-shift-G), nhấp vào "đồng bộ hoá các thay đổi" rồi làm theo hướng dẫn. Bạn có thể xác thực tài khoản GitHub của mình với VS Code và việc kéo/đẩy từ đó sẽ trở nên dễ dàng.

f0d53f839c7fa3b6.png

Nhớ git add clodubuild.yaml trong số các tệp khác, nếu không thì tệp này sẽ không hoạt động.

"Sự tương đồng giữa môi trường phát triển và môi trường chính thức" ở mức độ sâu và nông [không bắt buộc]

Nếu sao chép phiên bản mô hình từ đây, bạn sẽ có hai phiên bản DEV và PROD giống hệt nhau. Điều này rất thú vị và phù hợp với quy tắc 10 của Ứng dụng 12 yếu tố.

Tuy nhiên, chúng ta đang sử dụng hai điểm cuối web khác nhau để có một ứng dụng trỏ đến cùng một Cơ sở dữ liệu. Điều này là đủ cho một hội thảo; tuy nhiên, trong thực tế, bạn nên dành chút thời gian để tạo một môi trường sản xuất phù hợp. Điều này có nghĩa là bạn có hai cơ sở dữ liệu (một cho môi trường phát triển và một cho môi trường chính thức) và cũng chọn nơi lưu trữ các cơ sở dữ liệu đó để khôi phục sau thảm hoạ/đảm bảo tính sẵn sàng cao. Điều này nằm ngoài phạm vi của hội thảo này, nhưng là một điều đáng suy ngẫm.

Nếu bạn có thời gian để thực hiện phiên bản sản xuất "chuyên sâu", hãy lưu ý đến tất cả tài nguyên bạn cần sao chép, chẳng hạn như:

  • Cơ sở dữ liệu Cloud SQL (và có thể là phiên bản SQL).
  • Bộ chứa GCS
  • Cloud Function.
  • Bạn có thể sử dụng Gemini 1.5 Flash làm mô hình trong quá trình phát triển (rẻ hơn, nhanh hơn) và Gemini 1.5 Pro (mạnh mẽ hơn).

Nói chung, mỗi khi bạn làm điều gì đó liên quan đến ứng dụng, hãy suy nghĩ kỹ: liệu bản phát hành công khai có nên có cùng giá trị này hay không? Nếu không, hãy nỗ lực gấp đôi. Tất nhiên, việc này sẽ dễ dàng hơn nhiều với Terraform, nơi bạn có thể chèn môi trường (-dev, -prod) làm hậu tố cho tài nguyên của mình.

8. Mô-đun 6: Chuyển sang Google Cloud Storage

a680e0f287dd2dfb.png

Bộ nhớ

dc3a4b8ea92aaef6.png

Hiện tại, ứng dụng lưu trữ trạng thái trong một vùng chứa Docker. Nếu máy bị hỏng, ứng dụng gặp sự cố hoặc đơn giản là nếu bạn đẩy một bản sửa đổi mới, thì một bản sửa đổi mới sẽ được lên lịch, với một bộ nhớ mới, trống: 🙈

Làm cách nào để khắc phục? Có một số phương pháp.

  1. Lưu trữ hình ảnh trong cơ sở dữ liệu. Đó là điều tôi đã làm với ứng dụng PHP trước đây của mình. Đây là giải pháp đơn giản nhất vì không làm tăng độ phức tạp. Nhưng chắc chắn nó sẽ làm tăng độ trễ và tải cho cơ sở dữ liệu của bạn!
  2. Di chuyển ứng dụng Cloud Run sang một giải pháp lưu trữ phù hợp: GCE + Persistent Disk? Có thể là GKE + Bộ nhớ? Lưu ý: khi bạn có nhiều quyền kiểm soát hơn, bạn sẽ mất đi sự linh hoạt.
  3. Chuyển sang GCS. Google Cloud Storage cung cấp dịch vụ lưu trữ tốt nhất cho toàn bộ Google Cloud và là giải pháp phù hợp nhất với Cloud. Tuy nhiên, chúng ta cần phải tìm hiểu kỹ về thư viện PHP. Chúng ta có thư viện PHP 5.7 cho GCS không? PHP 5.7 có hỗ trợ Composer không (có vẻ như PHP 5.3.2 là phiên bản sớm nhất được Composer hỗ trợ)?
  4. Có thể sử dụng docker sidecar?
  5. Hoặc có thể sử dụng Cloud Run Volume Mounts của GCS. Nghe thật tuyệt.

🤔 Di chuyển bộ nhớ (câu trả lời mở)

[Câu hỏi mở] Trong bài tập này, chúng tôi muốn bạn tìm ra giải pháp để di chuyển hình ảnh theo cách được duy trì.

Kiểm thử chấp nhận

Tôi không muốn nói cho bạn biết giải pháp, nhưng tôi muốn điều này xảy ra:

  1. Bạn tải newpic.jpg lên. Bạn sẽ thấy thông báo này trong ứng dụng.
  2. Bạn nâng cấp ứng dụng lên phiên bản mới.
  3. newpic.jpg vẫn còn đó, vẫn hiển thị.

💡 Giải pháp khả thi (Gắn ổ đĩa Cloud Run của GCS)

Đây là một giải pháp rất tinh tế, cho phép chúng ta tải tệp lên có trạng thái mà không cần chạm vào mã (ngoài việc hiển thị nội dung mô tả hình ảnh, nhưng điều đó không quan trọng và chỉ để thoả mãn thị giác).

Điều này sẽ cho phép bạn gắn một thư mục từ Cloud Run vào GCS, vì vậy:

  1. Tất cả nội dung tải lên GCS sẽ thực sự hiển thị trong ứng dụng của bạn.
  2. Tất cả nội dung tải lên ứng dụng của bạn sẽ thực sự được tải lên GCS
  3. Điều kỳ diệu sẽ xảy ra với các đối tượng được tải lên GCS (chương 7).

Lưu ý. Vui lòng đọc kỹ điều khoản của FUSE. Điều này KHÔNG ổn nếu hiệu suất là một vấn đề.

Tạo bộ chứa GCS

GCS là dịch vụ lưu trữ phổ biến của Google Cloud. Hệ thống này đã được kiểm nghiệm thực tế và được mọi dịch vụ của GCP cần đến bộ nhớ sử dụng.

Lưu ý rằng Cloud Shell xuất PROJECT_ID dưới dạng GOOGLE_CLOUD_PROJECT:

$ export PROJECT_ID=$GOOGLE_CLOUD_PROJECT

#!/bin/bash

set -euo pipefail

# Your Cloud Run Service Name, eg php-amarcord-dev
SERVICE_NAME='php-amarcord-dev'
BUCKET="${PROJECT_ID}-public-images"
GS_BUCKET="gs://${BUCKET}"

# Create bucket
gsutil mb -l "$GCP_REGION" -p "$PROJECT_ID" "$GS_BUCKET/"

# Copy original pictures there - better if you add an image of YOURS before.
gsutil cp ./uploads/*.png "$GS_BUCKET/"

Định cấu hình Cloud Run để gắn bộ chứa vào thư mục /uploads/

Bây giờ, hãy đến với phần tinh tế. Chúng ta tạo một ổ đĩa php_uploads và hướng dẫn Cloud Run thực hiện một điểm gắn kết FUSE trên MOUNT_PATH (chẳng hạn như /var/www/html/uploads/):

#!/bin/bash

set -euo pipefail

# .. keep variables from previous script..

# Uploads folder within your docker container.
# Tweak it for your app code.
MOUNT_PATH='/var/www/html/uploads/'

# Inject a volume mount to your GCS bucket in the right folder.
gcloud --project "$PROJECT_ID" beta run services update "$SERVICE_NAME" \
    --region $GCP_REGION \
    --execution-environment gen2 \
    --add-volume=name=php_uploads,type=cloud-storage,bucket="$BUCKET"  \
    --add-volume-mount=volume=php_uploads,mount-path="$MOUNT_PATH"

Bây giờ, hãy lặp lại bước này cho tất cả các điểm cuối mà bạn muốn trỏ đến Cloud Storage.

Bạn cũng có thể làm tương tự từ giao diện người dùng

  1. Trong thẻ "Volumes" (Ổ đĩa), hãy tạo một Điểm gắn ổ đĩa trỏ đến bộ chứa của bạn, thuộc loại "Bộ chứa Cloud Storage", ví dụ: có tên "php_uploads".
  2. Trong phần Container(s) > Volume Mounts (Vùng chứa > Gắn ổ đĩa), hãy gắn ổ đĩa bạn vừa tạo vào điểm ổ đĩa mà ứng dụng yêu cầu. Việc này phụ thuộc vào tệp Docker, nhưng có thể trông giống như var/www/html/uploads/ .

Dù bằng cách nào, nếu thành công, thì khi chỉnh sửa bản sửa đổi Cloud Run mới, bạn sẽ thấy nội dung như sau:

6c2bb98fc1b0e077.png

Bây giờ, hãy kiểm thử ứng dụng mới bằng cách tải một hình ảnh mới lên điểm cuối /upload.php.

Hình ảnh sẽ được chuyển liền mạch đến GCS mà không cần viết một dòng PHP nào:

70032b216afee2d7.png

Chuyện gì vừa xảy ra vậy?

Một điều kỳ diệu đã xảy ra.

Một ứng dụng cũ với mã cũ vẫn đang hoạt động. Một ngăn xếp mới, hiện đại cho phép chúng tôi lưu trữ tất cả hình ảnh/ảnh trong ứng dụng của mình một cách thoải mái trong một Cloud Bucket có trạng thái. Giờ đây, bạn có thể thoả sức sáng tạo:

  • Bạn muốn gửi email mỗi khi nhận được hình ảnh có nội dung "nguy hiểm" hoặc "khoả thân"? Bạn có thể làm việc này mà không cần can thiệp vào mã PHP.
  • Bạn muốn dùng mô hình đa phương thức của Gemini mỗi khi có hình ảnh để mô tả hình ảnh đó và tải nội dung mô tả lên cơ sở dữ liệu? Bạn có thể làm việc đó mà không cần can thiệp vào mã PHP. Bạn không tin tôi? Hãy tiếp tục đọc chương 7.

Chúng ta vừa mở ra một cơ hội lớn.

9. Mô-đun 7: Nâng cao sức mạnh cho ứng dụng bằng Google Gemini

c00425f0ad83b32c.png

Giờ đây, bạn đã có một ứng dụng PHP mới, hiện đại và tuyệt vời (như một chiếc Fiat 126 năm 2024) với bộ nhớ trên đám mây.

Tác dụng

Điều kiện tiên quyết

Trong chương trước, một giải pháp mẫu đã cho phép chúng ta gắn hình ảnh /uploads/ trên GCS, trên thực tế tách Logic ứng dụng khỏi bộ nhớ hình ảnh.

Bài tập này yêu cầu bạn:

  • Đã hoàn thành bài tập trong chương 6 (bộ nhớ).
  • Có một bộ chứa GCS chứa các hình ảnh được tải lên, nơi mọi người tải ảnh lên ứng dụng của bạn và ảnh sẽ được chuyển đến bộ chứa của bạn.

Thiết lập một hàm Cloud (bằng Python)

Bạn có bao giờ thắc mắc về cách triển khai một ứng dụng dựa trên sự kiện không? Chẳng hạn như:

  • khi <sự kiện> xảy ra => gửi email
  • khi <event> xảy ra => nếu <condition> là đúng, thì hãy cập nhật Cơ sở dữ liệu.

Sự kiện có thể là bất cứ điều gì, từ bản ghi mới có trong BigQuery, một đối tượng mới được thay đổi trong một thư mục trong GCS hoặc một thông báo mới đang chờ trong hàng đợi trong Pub/Sub.

Google Cloud hỗ trợ nhiều mô hình để đạt được điều này. Đáng chú ý nhất:

Trong bài tập này, chúng ta sẽ tìm hiểu kỹ về Cloud Function để đạt được kết quả khá ấn tượng. Chúng tôi cũng sẽ cung cấp các bài tập không bắt buộc cho bạn.

Xin lưu ý rằng mã mẫu được cung cấp theo .solutions/

Thiết lập một Cloud Functions (🐍 python)

Chúng tôi đang cố gắng tạo ra một GCF rất tham vọng.

  1. Khi một hình ảnh mới được tạo trên GCS.. (có thể là do ai đó đã tải ảnh lên ứng dụng, nhưng không chỉ có vậy)
  2. .. gọi Gemini để mô tả hình ảnh và nhận nội dung mô tả bằng văn bản của hình ảnh .. (bạn nên kiểm tra MIME và đảm bảo đó là hình ảnh chứ không phải tệp PDF, MP3 hoặc văn bản)
  3. .. và cập nhật cơ sở dữ liệu bằng nội dung mô tả này. (bạn có thể phải vá cơ sở dữ liệu để thêm cột description vào bảng images).

Vá cơ sở dữ liệu để thêm description vào hình ảnh

  1. Mở Cloud SQL Studio:

b92b07c4cba658ef.png

  1. Nhập người dùng và mật khẩu cho Cơ sở dữ liệu hình ảnh
  2. Chèn SQL này để thêm một cột cho nội dung mô tả hình ảnh:

ALTER TABLE images ADD COLUMN description TEXT;

3691aced78a6389.png

Và thế là xong! Hãy thử ngay để kiểm tra xem có hiệu quả không:

SELECT * FROM images;

Bạn sẽ thấy cột mô tả mới:

bed69d6ad0263114.png

Viết hàm f(x) của Gemini

Lưu ý. Hàm này thực sự được tạo nhờ sự trợ giúp của Gemini Code Assist.

Lưu ý. Khi tạo hàm này, bạn có thể gặp lỗi về quyền IAM. Một số lỗi được ghi lại bên dưới trong đoạn "Lỗi có thể xảy ra".

  1. Bật API
  2. Truy cập vào https://console.cloud.google.com/functions/list
  3. Nhấp vào "Create Function" (Tạo hàm)
  4. Bật API từ trình hướng dẫn API:

d22b82658cfd4c48.png

Bạn có thể tạo GCF từ giao diện người dùng hoặc từ dòng lệnh. Ở đây, chúng ta sẽ sử dụng dòng lệnh.

Bạn có thể tìm thấy mã có thể sử dụng trong .solutions/

  1. Tạo một thư mục để lưu trữ mã của bạn, ví dụ: "gcf/". Nhập tên thư mục.
  2. Tạo tệp requirements.txt:
google-cloud-storage
google-cloud-aiplatform
pymysql
  1. Tạo một hàm Python. Mã mẫu tại đây: gcf/main.py.
#!/usr/bin/env python

"""Complete this"""

from google.cloud import storage
from google.cloud import aiplatform
import vertexai
from vertexai.generative_models import GenerativeModel, Part
import os
import pymysql
import pymysql.cursors

# Replace with your project ID
PROJECT_ID = "your-project-id"
GEMINI_MODEL = "gemini-1.5-pro-002"
DEFAULT_PROMPT = "Generate a caption for this image: "

def gemini_describe_image_from_gcs(gcs_url, image_prompt=DEFAULT_PROMPT):
    pass

def update_db_with_description(image_filename, caption, db_user, db_pass, db_host, db_name):
    pass

def generate_caption(event, context):
    """
    Cloud Function triggered by a GCS event.
    Args:
        event (dict): The dictionary with data specific to this type of event.
        context (google.cloud.functions.Context): The context parameter contains
                                                event metadata such as event ID
                                                and timestamp.
    """
    pass
  1. Đẩy hàm. Bạn có thể sử dụng một tập lệnh tương tự như sau: gcf/push-to-gcf.sh.

Lưu ý 1. Hãy nhớ cung cấp các giá trị phù hợp cho ENV hoặc chỉ cần thêm các giá trị đó vào đầu (GS_BUCKET=blah, ..):

Lưu ý 2. Thao tác này sẽ đẩy tất cả mã cục bộ (.), vì vậy, hãy nhớ đặt mã của bạn vào một thư mục cụ thể và sử dụng .gcloudignore như một chuyên gia để tránh đẩy các thư viện lớn. ( ví dụ).

#!/bin/bash

set -euo pipefail

# add your logic here, for instance:
source .env || exit 2 

echo "Pushing ☁️ f(x)☁ to 🪣 $GS_BUCKET, along with DB config.. (DB_PASS=$DB_PASS)"

gcloud --project "$PROJECT_ID" functions deploy php_amarcord_generate_caption \
    --runtime python310 \
    --region "$GCP_REGION" \
    --trigger-event google.cloud.storage.object.v1.finalized \
    --trigger-resource "$BUCKET" \
    --set-env-vars "DB_HOST=$DB_HOST,DB_NAME=$DB_NAME,DB_PASS=$DB_PASS,DB_USER=$DB_USER" \
    --source . \
    --entry-point generate_caption \
    --gen2

Lưu ý: trong ví dụ này, generate_caption sẽ là phương thức được gọi và Cloud Function sẽ truyền sự kiện GCS đến phương thức đó cùng với tất cả thông tin liên quan (tên bộ chứa, tên đối tượng, v.v.). Hãy dành chút thời gian để gỡ lỗi từ điển Python của sự kiện đó.

Kiểm thử hàm

Kiểm thử đơn vị

Hàm này có nhiều phần chuyển động. Bạn có thể muốn kiểm thử tất cả các phần tử riêng lẻ.

Ví dụ: gcf/test.py.

Giao diện người dùng của Cloud Functions

Ngoài ra, hãy dành chút thời gian để khám phá hàm của bạn trên giao diện người dùng. Mỗi thẻ đều đáng để khám phá, đặc biệt là Source (thẻ tôi thích nhất), Variables, Trigger và Logs; Bạn sẽ dành nhiều thời gian trong Logs để khắc phục lỗi (đồng thời xem các lỗi có thể xảy ra ở cuối trang này). Ngoài ra, hãy nhớ kiểm tra Permissions.

cf3ded30d532a2c7.png

Kiểm thử toàn diện

Đã đến lúc kiểm thử hàm theo cách thủ công!

  1. Chuyển đến ứng dụng của bạn rồi đăng nhập
  2. Tải ảnh lên (không quá lớn, chúng tôi đã thấy vấn đề với ảnh lớn)
  3. kiểm tra trên giao diện người dùng xem ảnh đã được tải lên chưa.
  4. Kiểm tra trên Cloud SQL Studio để đảm bảo nội dung mô tả đã được cập nhật. Đăng nhập và chạy truy vấn này: SELECT * FROM images.

43a680b12dbbdda0.png

Và cách làm này hiệu quả! Chúng ta cũng có thể cập nhật giao diện người dùng để hiển thị nội dung mô tả đó.

Cập nhật PHP để hiển thị [không bắt buộc]

Chúng tôi đã chứng minh được rằng ứng dụng này hoạt động hiệu quả. Tuy nhiên, sẽ tốt hơn nếu người dùng cũng có thể xem nội dung mô tả đó.

Chúng ta không cần phải là chuyên gia PHP để thêm nội dung mô tả vào index.php. Mã này sẽ thực hiện (đúng vậy, Gemini cũng viết mã này cho tôi!):

<?php if (!empty($image['description'])): ?>
    <p class="font-bold">Gemini Caption:</p>
    <p class="italic"><?php echo $image['description']; ?></p>
<?php endif; ?>

Đặt mã này vào bên trong foreach theo ý bạn.

Trong các bước tiếp theo, chúng ta cũng sẽ thấy một phiên bản giao diện người dùng đẹp hơn nhờ Gemini Code Assist. Phiên bản đẹp mắt có thể trông như sau:

fdc12de0c88c4464.png

Kết luận

Bạn có một Cloud Function được kích hoạt trên các đối tượng mới xuất hiện trên GCS. Cloud Function này có thể chú thích nội dung của hình ảnh như con người và tự động cập nhật cơ sở dữ liệu. Thật ấn tượng!

Tiếp theo là gì? Bạn có thể làm theo cùng một lý luận để đạt được hai chức năng tuyệt vời.

[không bắt buộc] Thêm các Cloud Functions khác [câu hỏi mở]

Tôi nghĩ đến một vài tính năng bổ sung.

📩 Điều kiện kích hoạt email

Một trình kích hoạt email sẽ gửi email cho bạn mỗi khi có người gửi ảnh.

  • Quá thường xuyên? Thêm một quy tắc ràng buộc khác: Một bức ảnh LỚN hoặc một bức ảnh có nội dung Gemini chứa các từ "khoả thân/ảnh khoả thân/bạo lực".
  • Hãy cân nhắc việc kiểm tra EventArc cho vấn đề này.

🚫 Tự động kiểm duyệt ảnh không phù hợp

Hiện tại, quản trị viên là con người đang gắn cờ hình ảnh là "không phù hợp". Bạn có muốn Gemini giúp bạn xử lý những việc khó khăn và kiểm duyệt không gian không? Thêm một chương trình kiểm thử để gắn cờ nội dung kích hoạt không phù hợp và cập nhật cơ sở dữ liệu như chúng ta đã tìm hiểu trong hàm trước. Về cơ bản, điều này có nghĩa là lấy hàm trước đó, thay đổi câu lệnh và cập nhật cơ sở dữ liệu dựa trên câu trả lời.

Lưu ý. AI tạo sinh có kết quả đầu ra không thể đoán trước. Đảm bảo "kết quả sáng tạo" của Gemini được "kiểm soát chặt chẽ". Bạn có thể yêu cầu một câu trả lời tất định như điểm tin cậy từ 0 đến 1, một JSON, v.v. Bạn có thể đạt được điều này theo nhiều cách, ví dụ: * Sử dụng thư viện Python pydantic, langchain, v.v. * Sử dụng Kết quả có cấu trúc của Gemini.

Mẹo. Bạn có thể có NHIỀU hàm hoặc có một câu lệnh duy nhất thực thi câu trả lời JSON (hoạt động hiệu quả với "Kết quả có cấu trúc của Gemini" như được nêu bật ở trên) như:

Câu lệnh để tạo hình ảnh này là gì?

{
    "description": "This is the picture of an arrosticino",
    "suitable": TRUE
}

Bạn có thể thêm các trường bổ sung vào câu lệnh để nhận được thông tin chi tiết như: có điểm gì hay không? Điều gì khiến bạn thấy video này tệ? Bạn có nhận ra địa điểm này không? Is there some text (OCR has never been easier):

  • goods: "Trông ngon quá"
  • bads: "Trông giống như đồ ăn không tốt cho sức khoẻ"
  • OCR: "Da consumare preferibilmente prima del 10 Novembre 2024"
  • location: "Pescara, Lungomare"

Mặc dù thường thì nên có N hàm cho N kết quả, nhưng việc tạo một hàm có thể làm 10 việc sẽ mang lại kết quả vô cùng xứng đáng. Hãy xem bài viết này của Riccardo để biết cách thực hiện.

Các lỗi có thể xảy ra (chủ yếu là IAM/quyền)

Lần đầu tiên phát triển giải pháp này, tôi đã gặp một số vấn đề về quyền IAM. Tôi sẽ thêm các lỗi đó vào đây để thể hiện sự đồng cảm và đưa ra một số ý tưởng về cách khắc phục.

Lỗi: không đủ quyền đối với Tài khoản dịch vụ

  1. Xin lưu ý rằng để triển khai một hàm GCF theo dõi một bộ chứa GCS, bạn cần thiết lập các quyền thích hợp cho Tài khoản dịch vụ mà bạn đang sử dụng cho công việc, như trong hình:

22f51012fa6b4a24.png

Bạn cũng có thể phải bật API EventArc – hãy đợi vài phút để các API này hoạt động đầy đủ.

Lỗi: Thiếu trình gọi Cloud Run

  1. Một nhận xét khác từ giao diện người dùng về việc cấp quyền cho GCF là (vai trò Người gọi Cloud Run):

be72e17294f2d3f3.png

Bạn có thể sửa lỗi này bằng cách chạy lệnh trong hình, tương tự như fix-permissions.sh

Vấn đề này được mô tả tại đây: https://cloud.google.com/functions/docs/securing/authenticating

Lỗi: Đã vượt quá hạn mức bộ nhớ

Lần đầu tiên tôi chạy, nhật ký có thể cho biết: "Đã vượt quá giới hạn bộ nhớ 244 MiB với 270 MiB được sử dụng. Hãy cân nhắc tăng giới hạn bộ nhớ, xem https://cloud.google.com/functions/docs/configuring/memory'". Một lần nữa, hãy thêm RAM vào GCF. Việc này rất dễ thực hiện trong giao diện người dùng. Sau đây là một trường hợp có thể xảy ra:

bed69d6ad0263114.png

Ngoài ra, bạn cũng có thể sửa tập lệnh triển khai Cloud Run để tăng MEM/CPU. Quá trình này mất nhiều thời gian hơn.

Lỗi: PubSub đã xuất bản

Việc tạo trình kích hoạt bằng GCF phiên bản 1 đã gây ra lỗi này một lần:

e5c338ee35ad4c24.png

Một lần nữa, bạn có thể dễ dàng khắc phục vấn đề này bằng cách chuyển đến IAM và cấp cho Tài khoản dịch vụ của bạn vai trò "Nhà xuất bản Pub/Sub".

Lỗi: Vertex AI chưa được sử dụng

Nếu bạn gặp lỗi này:

Permission Denied: 403 Vertex AI API has not been used in project YOUR_PROJECT before or it is disabled. Bật API này bằng cách truy cập vào https://console.developers.google.com/apis/api/aiplatform.googleapis.com/overview?project=YOR_PROJECT

Bạn chỉ cần bật Vertex AI API. Cách dễ nhất để bật TẤT CẢ API cần thiết là:

  1. https://console.cloud.google.com/vertex-ai
  2. Nhấp vào "bật tất cả API được đề xuất".

492f05ac377f3630.png

Lỗi: Không tìm thấy Trình kích hoạt EventArc.

Nếu bạn gặp lỗi này, vui lòng triển khai lại hàm.

8ec4fc11833d7420.png

Lỗi: 400 Tác nhân dịch vụ đang được cấp phép

400 Tác nhân dịch vụ đang được cấp phép ( https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents ). Bạn cần có tác nhân dịch vụ để đọc tệp Cloud Storage được cung cấp. Vì vậy, vui lòng thử lại sau vài phút.

Nếu điều này xảy ra, hãy đợi một lúc hoặc hỏi nhân viên của Google.

10. Mô-đun 8: Tạo SLO về tình trạng sẵn sàng

Trong Chương này, chúng tôi cố gắng đạt được điều này:

  1. Tạo SLI
  2. Tạo SLO dựa trên SLI
  3. Tạo cảnh báo dựa trên SLO

f63426182c052123.png

Đây là một chủ đề rất quan trọng đối với tác giả, vì Riccardo làm việc trong lĩnh vực SRE/DevOps của Google Cloud.

(câu hỏi mở) Tạo SLI và SLO cho ứng dụng này

Ứng dụng có tốt không nếu bạn không thể biết khi nào ứng dụng ngừng hoạt động?

SLO là gì?

Ôi trời! Google đã phát minh ra SLO! Để đọc thêm về vấn đề này, bạn có thể tham khảo:

Bước 1: Tạo SLI/SLO về khả năng đáp ứng

Hãy bắt đầu với SLO về tình trạng sẵn sàng, vì đây là chỉ số dễ đo lường nhất và có thể là quan trọng nhất.

May mắn là Cloud Run có hỗ trợ SLO được tích hợp sẵn, nhờ vào Istio.

Sau khi ứng dụng của bạn chạy trên Cloud Run, việc này sẽ rất dễ dàng và chỉ mất 30 giây.

  • Chuyển đến trang Cloud Run.
  • Nhấp/chọn ứng dụng của bạn.
  • Chọn thẻ SLOs.
  • Nhấp vào "+ Tạo SLO".
  • Phạm vi cung cấp, theo yêu cầu
  • Tiếp tục
  • Tháng theo lịch/99%.
  • nhấp vào "Tạo SLO".

e471c7ebdc56cdf6.png

Bước 2: Thiết lập tính năng Cảnh báo cho SLO này

Bạn nên tạo 2 cảnh báo:

  1. Một cảnh báo có tốc độ tiêu hao thấp ("Slowburn") để thông báo cho bạn qua email (mô phỏng phiếu yêu cầu hỗ trợ có mức độ ưu tiên thấp).
  2. Một cảnh báo có tỷ lệ tiêu hao cao ("Fastburn") để thông báo cho bạn qua SMS (mô phỏng phiếu yêu cầu hỗ trợ/máy nhắn tin có mức độ ưu tiên cao)

Chuyển đến SLO tab mà bạn đã dùng trước đó.

Làm việc này 2 lần:

314bfd6b9ef0a260.png

  • Nhấp vào "Create SLO Alert" (Tạo cảnh báo SLO) (nút 🔔 có dấu cộng bên trong, ở bên phải)
  • Thời lượng xem lại, Ngưỡng tốc độ tiêu hao:
  • [FAST]. Lần đầu: 60 phút/10 lần
  • [SLOW]. Thứ hai: 720 phút/2 lần
  • Kênh thông báo: nhấp vào Quản lý kênh thông báo
  • Đầu tiên, "Email" -> Thêm mới -> ..
  • Thứ hai, "SMS" -> Thêm mới -> Xác minh trên điện thoại.
  • Mẹo: Tôi thích dùng biểu tượng cảm xúc trong tên! Tính năng này rất thú vị khi minh hoạ.
  • khi hoàn tất, hãy nhấp vào biểu tượng chữ X lớn ở trên cùng bên phải.
  • Chọn điện thoại trước (nhanh), sau đó chọn email (chậm).
  • Thêm một số tài liệu mẫu như:
  • [PHP Amarcord] Riccardo told me to type sudo reboot or to check documentation in http://example.com/playbooks/1.php but I guess he was joking.

Bingo!

Kết quả cuối cùng

Chúng ta có thể coi như bài tập này đã hoàn thành khi bạn có 1 SLO đang hoạt động + 2 cảnh báo về tình trạng sẵn sàng, đồng thời cảnh báo này được gửi đến email và điện thoại của bạn.

Nếu muốn, bạn có thể thêm Độ trễ (và tôi thực sự khuyên bạn nên làm như vậy) hoặc thậm chí là một độ trễ phức tạp hơn. Đối với độ trễ, hãy chọn độ trễ mà bạn cho là hợp lý; nếu không chắc chắn, hãy chọn 200 mili giây.

11. Các bước tiếp theo

Bạn đã hoàn thành TẤT CẢ, còn thiếu gì nữa?

Một số điều cần suy ngẫm:

Chơi cùng Gemini

Bạn có thể dùng Gemini theo hai cách:

  1. Vertex AI. "Cách thức dành cho doanh nghiệp", kết hợp với GCP, mà chúng ta đã tìm hiểu trong chương 7 (GCF+Gemini). Tất cả quy trình xác thực đều hoạt động một cách kỳ diệu và các dịch vụ kết nối với nhau một cách mượt mà.
  2. AI của Google. "Cách của người tiêu dùng". Bạn có thể lấy khoá Gemini API tại đây và bắt đầu xây dựng các tập lệnh nhỏ có thể liên kết với bất kỳ khối lượng công việc nào bạn đã có (công việc độc quyền, các đám mây khác, máy chủ cục bộ, v.v.). Bạn chỉ cần thay thế khoá API và mã sẽ bắt đầu hoạt động một cách kỳ diệu.

Bạn nên thử khám phá (2) bằng các dự án cá nhân của riêng mình.

Nâng cấp giao diện người dùng

Tôi không giỏi về giao diện người dùng. Nhưng Gemini thì có! Bạn chỉ cần lấy một trang PHP và nói như sau:

I have a VERY old PHP application. I want to touch it as little as possible. Can you help me:

1. add some nice CSS to it, a single static include for tailwind or similar, whatever you prefer
2. Transform the image print with description into cards, which fit 4 per line in the canvas?

Here's the code:

-----------------------------------
[Paste your PHP page, for instance index.php - mind the token limit!]

Bạn có thể dễ dàng nhận được thông tin này trong chưa đầy 5 phút, chỉ cần một bản dựng Cloud Build! :)

Câu trả lời của Gemini rất hoàn hảo (nghĩa là tôi không cần phải thay đổi gì):

8a3d5fe37ec40bf8.png

Và đây là bố cục mới trong ứng dụng cá nhân của tác giả:

81620eb90ae3229a.png

Lưu ý: Mã được dán dưới dạng hình ảnh vì chúng tôi không muốn khuyến khích bạn lấy mã, mà muốn Gemini viết mã cho bạn, với các quy tắc ràng buộc về giao diện người dùng/giao diện người dùng sáng tạo của riêng bạn; tin tôi đi, sau đó bạn chỉ cần thực hiện những thay đổi rất nhỏ.

Bảo mật

Việc bảo mật đúng cách cho ứng dụng này không phải là mục tiêu của hội thảo kéo dài 4 giờ này, vì việc này sẽ làm tăng thời gian hoàn thành hội thảo này lên 1-2 lần.

Tuy nhiên, đây là một chủ đề cực kỳ quan trọng! Chúng tôi đã tổng hợp một số ý tưởng trong SECURITY.

12. Xin chúc mừng!

Xin chúc mừng 🎉🎉🎉 , bạn đã hiện đại hoá thành công ứng dụng PHP cũ bằng Google Cloud.

24cb9a39b1841fbd.png

Tóm lại, trong lớp học lập trình này, bạn đã tìm hiểu:

  • Cách triển khai cơ sở dữ liệu trong Google Cloud SQL và cách di chuyển cơ sở dữ liệu hiện có vào đó.
  • Cách đóng gói ứng dụng PHP bằng Docker và Buildpacks, đồng thời lưu trữ hình ảnh của ứng dụng đó vào Google Cloud Artifact Registry
  • Cách triển khai ứng dụng trong vùng chứa lên Cloud Run và chạy ứng dụng đó bằng Cloud SQL
  • Cách lưu trữ/sử dụng bí mật các tham số cấu hình nhạy cảm (chẳng hạn như mật khẩu cơ sở dữ liệu) bằng Trình quản lý bí mật của Google
  • Cách thiết lập quy trình CI/CD bằng Google Cloud Build để tự động tạo và triển khai Ứng dụng PHP mỗi khi bạn đẩy mã lên kho lưu trữ GitHub.
  • Cách dùng Cloud Storage để "đưa tài nguyên của ứng dụng lên đám mây"
  • Cách tận dụng công nghệ không máy chủ để xây dựng quy trình công việc tuyệt vời trên Google Cloud mà không cần can thiệp vào mã ứng dụng.
  • Sử dụng các chức năng đa phương thức của Gemini cho một trường hợp sử dụng phù hợp.
  • Triển khai các nguyên tắc SRE trong Google Cloud

Đây là một khởi đầu tuyệt vời cho hành trình Hiện đại hoá ứng dụng cùng Google Cloud!

🔁 Phản hồi

Nếu bạn muốn chia sẻ trải nghiệm của mình về hội thảo này, hãy cân nhắc việc điền vào biểu mẫu phản hồi này.

Chúng tôi rất mong nhận được ý kiến phản hồi cũng như yêu cầu kéo cho những đoạn mã mà bạn đặc biệt tâm đắc.

🙏 Cảm ơn bạn

Tác giả xin cảm ơn Mirko Gilioli và Maurizio Ipsale của Datatonic đã giúp viết bài và thử nghiệm giải pháp.