應用程式翻新研討會

1. 簡介

上次更新時間:2024 年 11 月 1 日

如何將舊版 PHP 應用程式翻新並遷移至 Google Cloud?

(📽️ 觀看 7 分鐘的程式碼實驗室簡介影片)

企業通常會在地端部署環境中執行需要翻新的舊版應用程式。也就是說,模型必須具備擴充性、安全性,且可部署在不同環境。

在本工作坊中,您將:

  1. 將 PHP 應用程式容器化。
  2. 改用代管資料庫服務 (Cloud SQL)。
  3. 部署至 Cloud Run (這是 GKE/Kubernetes 的免運作替代方案)。
  4. 使用 Identity and Access Management (IAM) 和 Secret Manager 保護應用程式。
  5. 透過 Cloud Build 定義 CI/CD 管道。Cloud Build 可連結至託管於熱門 Git 供應商 (例如 GitHub 或 GitLab) 的 Git 存放區,並在每次推送至 main 時觸發。
  6. 在 Cloud Storage 中託管應用程式圖片。這項作業是透過掛接完成,無須變更應用程式程式碼。
  7. 透過 Gemini 導入生成式 AI 功能,並透過 Cloud Functions (無伺服器) 進行自動化調度管理。
  8. 熟悉服務等級目標,並操作新翻新的應用程式。

按照這些步驟操作,即可逐步翻新 PHP 應用程式,提升擴充性、安全性和部署彈性。此外,遷移至 Google Cloud 後,您還能運用強大的基礎架構和服務,確保應用程式在雲端原生環境中順暢運作。

我們相信,您在完成這些簡單步驟後學到的知識,可以應用於您自己的應用程式和組織,並適用於不同的語言/堆疊和不同的用途。

關於應用程式

您要建立分支版本的應用程式 (程式碼,採用 MIT 授權) 是基本的 PHP 5.7 應用程式,具有 MySQL 驗證功能。這個應用程式的主要功能是提供平台,讓使用者上傳相片,管理員則可標記不當圖片。應用程式有兩個資料表:

  • 使用者。預先編譯管理員。新使用者可以註冊。
  • 圖片。隨附幾張範例圖片。登入的使用者可以上傳新相片。我們將在這裡施加魔法。

你的目標

我們想翻新舊版應用程式,以便在 Google Cloud 中執行。我們將運用 Google Cloud 的工具和服務,提升擴充性、強化安全性、自動管理基礎架構,並整合進階功能,例如使用 Cloud SQL、Cloud Run、Cloud Build、Secret Manager 等服務,處理圖片、監控及儲存資料。

445f7a9ae37e9b4d.png

更重要的是,我們希望逐步進行,讓您瞭解每個步驟背後的思考過程,而且通常每個步驟都會為後續步驟開啟新的可能性 (例如:單元 2 -> 3,以及 6 -> 7)。

還不確定嗎?請觀看這部 7 分鐘的 YouTube 影片。

軟硬體需求

  • 已連上網際網路且安裝瀏覽器的電腦。
  • 一些 GCP 抵免額。請參閱下一步。
  • 您將使用 Cloud Shell。其中預先安裝了所有必要指令和 IDE。
  • GitHub 帳戶。您需要這個權杖,才能使用自己的 Git 存放區分支原始程式碼 🧑🏻‍💻 gdgpescara/app-mod-workshop。您必須這麼做,才能擁有自己的 CI/CD 管道 (自動提交 -> 建構 -> 部署)

解決方案範例請見:

本工作坊旨在透過 Cloud Shell (在瀏覽器中) 完成。

不過,您也可以嘗試從本機電腦執行。

2. 設定抵免額和分支

6dafc658860c0ce5.png

兌換 GCP 抵免額並設定 GCP 環境 [選用]

如要執行這個工作坊,您需要有具備一定額度的帳單帳戶。請使用本程式碼實驗室頂端橫幅中的抵免額,開始進行實驗室。如果您已連結帳單帳戶,可以略過這個步驟。

完成後,請開啟 Google Cloud 控制台,然後按一下左上方下拉式選單中顯示「無機構」的專案選取器,建立新專案。詳情請見下方

bd7548f78689db0b.png

如果沒有專案,請建立新專案,如下方螢幕截圖所示。右上角有「新增專案」選項。

6c82aebcb9f5cd47.png

請務必按照下列步驟,將新專案連結至 GCP 試用帳單帳戶。

f202527d254893fb.png

現在可以開始使用 Google Cloud Platform 了。如果您是初學者,或只想在 Cloud 環境中執行所有操作,可以點選左上角的按鈕,存取 Cloud Shell 和編輯器,如下所示。

7d732d7bf0deb12e.png

確認已在左上方選取新專案:

未選取 (不佳):

c2ffd36a781b276a.png

Selected (good):

594563c158f4f590.png

從 GitHub 建立應用程式分支版本

  1. 前往試用版應用程式:https://github.com/gdgpescara/app-mod-workshop
  2. 按一下 🍴「fork」。
  3. 如果沒有 GitHub 帳戶,請建立新帳戶。
  4. 視需要編輯。

734e51bfc29ee5df.png

  1. 使用下列指令複製應用程式程式碼
  2. git clone https://github.com/YOUR-GITHUB-USER/YOUR-REPO-NAME
  1. 使用偏好的編輯器開啟複製的專案資料夾。如果選擇 Cloud Shell,請點選「開啟編輯器」,如下所示。

40f5977ea4c1d1cb.png

如下圖所示,Google Cloud Shell 編輯器提供您所需的一切

a4e5ffb3e9a35e84.png

如要透過視覺化方式完成,請按一下「Open Folder」,然後選取資料夾 (通常是主資料夾中的 app-mod-workshop)。

3. 單元 1:建立 SQL 執行個體

645902e511a432a6.png

建立 Google Cloud SQL 執行個體

PHP 應用程式會連線至 MySQL 資料庫,因此我們需要將資料庫複製到 Google Cloud,才能輕鬆遷移。Cloud SQL 是完美選擇,可讓您在雲端執行全代管 MySQL 資料庫。步驟如下:

  1. 前往 Cloud SQL 頁面:https://console.cloud.google.com/sql/instances
  2. 按一下「建立執行個體」
  3. 啟用 API (如有需要)。這可能需要幾秒鐘。
  4. 選擇 MySQL。
  5. (我們正在努力為你提供最便宜的版本,這樣才能用得更久):
  • 版本:Enterprise
  • 預設:開發 (我們試過 Sandbox,但無法使用)
  • Mysql 版本:5.7 (哇,好久以前的版本!)
  1. 執行個體 ID:選擇 appmod-phpapp (如果變更此 ID,請記得一併變更日後的指令碼和解決方案)。
  2. 密碼:可任意設定,但請記下,後續會以 CLOUDSQL_INSTANCE_PASSWORD 表示
  3. 區域:與應用程式其他部分選擇的區域相同 (例如米蘭 = europe-west8)
  4. 可用區可用性:單一可用區 (示範時為了節省費用)

點選「建立執行個體」按鈕,部署 Cloud SQL 資料庫。⌛這項作業約需 10 分鐘才能完成⌛。在此期間,請繼續閱讀說明文件。您也可以開始解決下一個模組 (「將 PHP 應用程式容器化」),因為該模組與第一部分的這個模組沒有依附關係 (直到您修正資料庫連線為止)。

注意:這個執行個體的費用約為每天 $7 美元。請務必在研討會結束後,將其獨立出來。

在 Cloud SQL 建立 image_catalog 資料庫和使用者

應用程式專案隨附 db/ 資料夾,內含兩個 SQL 檔案:

  1. 01_schema.sql:包含 SQL 程式碼,用於建立兩個資料表,分別存放使用者和圖片資料。
  2. 02_seed.sql:包含 SQL 程式碼,可將資料植入先前建立的資料表。

建立 image_catalog 資料庫後,就會用到這些檔案。步驟如下:

  1. 開啟執行個體,然後點選「資料庫」分頁標籤:
  2. 按一下「建立資料庫」
  3. 命名為 image_catalog (與 PHP 應用程式設定相同)。

997ef853e5ebd857.png

接著建立資料庫使用者。這樣就能驗證 image_catalog 資料庫。

  1. 接著點選「使用者」分頁標籤
  2. 按一下「新增使用者帳戶」。
  3. 使用者:我們來建立一個:
  • 使用者名稱:appmod-phpapp-user
  • 密碼:選擇容易記住的密碼,或按一下「產生」
  • 保留「Allow any host (%)」(允許任何主機 (%))。
  1. 按一下「新增」。

將資料庫開放給已知 IP。

請注意,Cloud SQL 中的所有資料庫一開始都是「獨立」的。您必須明確設定可存取的網路。

  1. 按一下執行個體
  2. 開啟「連線」選單
  3. 按一下「網路」分頁標籤。
  4. 按一下「授權網路」下方的連結。現在,請新增網路 (即子網路)。
  • 現在,請選擇快速但不安全的設定,讓應用程式運作。您之後可以限制為信任的 IP:
  • 名稱:「Everyone in the world - INSECURE」。
  • 網路:「0.0.0.0/0"」(注意:這是不安全的部分!)
  • 按一下「完成」
  1. 按一下 [Save] (儲存)。

畫面應如下所示:

5ccb9062a7071964.png

注意:這個解決方案是折衷做法,可在 O(小時) 內完成工作坊。不過,請參閱安全性文件,確保正式版解決方案安全無虞!

測試資料庫連線

來看看先前建立的 image_catalog 使用者是否能正常運作。

存取執行個體中的「Cloud SQL Studio」,然後輸入資料庫、使用者和密碼進行驗證,如下所示:

d56765c6154c11a4.png

進入後,即可開啟 SQL 編輯器,並繼續進行下一節。

從程式碼集匯入資料庫

使用 SQL 編輯器匯入 image_catalog 資料表和資料。從存放區中的檔案 (01_schema.sql 和 02_seed.sql) 複製 SQL 程式碼,然後依序執行。

完成後,image_catalog 應會顯示兩個資料表,分別是 users 和 images,如下所示:

65ba01e4c6c2dac0.png

如要測試,請在編輯器中執行下列指令:select * from images;

另外,請務必記下 Cloud SQL 執行個體的公開 IP 位址,稍後會用到。如要取得 IP,請前往 Cloud SQL 執行個體主頁面的「總覽」頁面。(「總覽」>「連線至這個執行個體」>「公開 IP 位址」)。

4. 單元 2:將 PHP 應用程式容器化

e7f0e9979d8805f5.png

我們想為雲端建構這個應用程式。

也就是將程式碼封裝成 ZIP 檔案,其中包含在雲端執行程式碼所需的所有資訊。

封裝方式有以下幾種:

  • Docker。非常熱門,但要正確設定相當複雜。
  • Buildpacks。較不常見,但往往會「自動猜測」要建構和執行的內容。通常這樣就能解決問題!

在本工作坊中,我們假設您使用 Docker。

如果您選擇使用 Cloud Shell,請點選 Cloud 控制台右上方的圖示,重新開啟 Cloud Shell。

ec6a6b90b39e03e.png

頁面底部會開啟一個方便使用的殼層,您應該已在設定步驟中建立程式碼分支。

6999b906c0dedeb7.png

Docker

如果您想自行控管,這個解決方案最適合您。當您需要設定特定程式庫,並插入某些不明顯的行為 (例如上傳 chmod、應用程式中的非標準執行檔等) 時,這種做法就很合理。

由於我們最終要將容器化應用程式部署至 Cloud Run,請參閱這份說明文件。您會如何將其從 PHP 8 向後移植到 PHP 5.7?或許你可以用 Gemini 幫忙。或者,您也可以使用這個預先建立的版本:

# 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

最新 Dockerfile 版本請見這裡。

為了在本機測試應用程式,我們需要變更 config.php 檔案,讓 PHP 應用程式連線至 Google Cloud SQL 上的 MySQL 資料庫。根據您先前的設定,填入空白處:

<?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 是 Cloud SQL 公開 IP 位址,您可以在 SQL 控制台中找到:

bd27071bf450a8d0.png

  • DB_NAME 應維持不變:image_catalog
  • DB_USER 應為 appmod-phpapp-user
  • DB_PASS 是您選擇的。請以單引號括住,並視需要逸出。

此外,您也可以請 Gemini 將少數 🇮🇹 義大利文內容翻譯成英文!

現在您已取得 Dockerfile,並設定 PHP 應用程式連線至資料庫,接著就來試試看吧!

如果尚未安裝 Docker,請先安裝 (連結)。如果您使用的是 Cloud Shell,就不需要執行這項操作 (是不是很棒?)。

現在,請嘗試使用適當的 Docker 建構和執行指令,建構並執行容器化 PHP 應用程式。

# 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

如果一切運作正常,連線至本機主機時,應該會看到下列網頁!應用程式現在會在通訊埠 8080 執行,請依序點選「網頁預覽」圖示 (眼睛圖案的瀏覽器) 和「透過以下通訊埠預覽:8080」(如要使用其他通訊埠,請點選「變更通訊埠」)

33a24673f4550454.png

在瀏覽器中測試結果

現在,應用程式應如下所示:

2718ece96b1f18b6.png

如果使用 Admin/admin123 登入,應該會看到類似下方的畫面。

68b62048c2e86aea.png

太棒了!除了義大利文文字外,其他部分都正常運作!🎉🎉🎉

如果 Docker 化作業正確,但資料庫憑證有誤,可能會看到類似下方的內容:

e22f45b79bab86e1.png

再試一次,就快答對了!

儲存至 Artifact Registry [選用]

現在,您應該已準備好可運作的容器化 PHP 應用程式,可以部署至雲端。接著,我們需要一個雲端位置來儲存 Docker 映像檔,並讓 Cloud Run 等 Google Cloud 服務能存取該映像檔,以便進行部署。這項儲存解決方案稱為 Artifact Registry,是全代管的 Google Cloud 服務,專門用於儲存應用程式構件,包括 Docker 容器映像檔、Maven 套件、npm 模組等。

請使用適當的按鈕,在 Google Cloud Artifact Registry 中建立存放區。

e1123f0c924022e6.png

選擇有效的名稱、格式和適合儲存構件的區域。

4e516ed209c470ee.png

回到本機開發環境,標記應用程式容器映像檔,並推送至剛建立的 Artifact Registry 存放區。請執行下列指令來完成這項操作。

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

結果應如下方螢幕截圖所示。

1e498feb4e88be9f.png

太棒了 🎉🎉🎉,你可以進入下一個等級。在此之前,請花 2 分鐘嘗試上傳/登入/登出,並熟悉應用程式端點。稍後會用到。

可能發生的錯誤

如果發生容器化錯誤,請嘗試使用 Gemini 說明及修正錯誤,並提供下列資訊:

  • 目前的 Dockerfile
  • 收到的錯誤
  • [視需要] 執行的 PHP 程式碼。

上傳權限。也請試試 /upload.php 端點,並嘗試上傳圖片。您可能會收到以下錯誤訊息。如果是,請在 Dockerfile 中修正 chmod/chown。

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" (或 "Errore di connessione: could not find driver"). 確認 Dockerfile 具備適用於 mysql (pdo_mysql) 的適當 PDO 程式庫,以便連線至資料庫。歡迎參考這裡的解決方案,汲取靈感。

無法將要求轉送至後端。無法連線至通訊埠 8080 上的伺服器。這表示您可能公開了錯誤的通訊埠。請務必公開 Apache/Nginx 實際提供服務的通訊埠。這並非易事。如果可以,請盡量將通訊埠設為 8080 (Cloud Run 會更方便)。如要保留通訊埠 80 (例如 Apache 需要),請使用其他指令執行:

$ 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. 單元 3:將應用程式部署至 Cloud Run

9ffca42774f6c5d1.png

Cloud Run 可帶來的優勢

問得好!幾年前,您肯定會選擇 Google App Engine。

簡單來說,Cloud Run 採用較新的技術堆疊,部署更輕鬆、成本更低,且不使用時會縮減至 0。Cloud Run 可靈活執行任何無狀態容器,並與多項 Google Cloud 服務整合,因此非常適合用於部署微服務和現代化應用程式,不僅能盡量減少工作負擔,還能大幅提升效率。

具體來說,Cloud Run 是 Google Cloud 的全代管平台,可讓您在無伺服器環境中執行無狀態容器化應用程式。這項服務會自動處理所有基礎架構,並根據傳入流量從零開始擴充資源,並在閒置時縮減資源,因此符合成本效益且效率高。Cloud Run 支援任何語言或程式庫,只要封裝在容器中即可,因此開發彈性極高。這項服務與其他 Google Cloud 服務完美整合,適合用於建構微服務、API、網站和事件導向應用程式,不必管理伺服器基礎架構。

必要條件

如要完成這項工作,您必須在本機電腦上安裝 gcloud。如果沒有,請參閱這裡的操作說明。如果您使用的是 Google Cloud Shell,則不必採取任何行動。

部署前…

如果您是在本機環境中工作,請使用下列指令向 Google Cloud 驗證:

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

系統應該會透過瀏覽器上的 OAuth 登入程序驗證您的身分。請務必透過 Chrome 登入,並使用與登入 Google Cloud 時相同的帳戶 (例如 vattelapesca@gmail.com),且該帳戶已啟用計費功能。

使用下列指令啟用 Cloud Run API:

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

現在一切已準備就緒,可以部署至 Cloud Run。

透過 gcloud 將應用程式部署至 Cloud Run

gcloud run deploy 指令可讓您在 Cloud Run 部署應用程式。您可以設定多個選項來達成目標。以下是最低限度的選項組合 (可透過指令列提供,或由工具透過互動式提示詢問):

  1. Cloud Run 服務名稱:您要為應用程式部署的 Cloud Run 服務。Cloud Run 服務會傳回網址,提供應用程式的端點。
  2. 執行應用程式的 Google Cloud 區域。(--region 區域)
  3. 包裝應用程式的容器映像檔。
  4. 應用程式執行期間需要使用的環境變數。
  5. Allow-Unauthenticated 旗標:允許所有人存取應用程式,不需進一步驗證。

請參閱說明文件 (或向下捲動查看可能的解決方案),瞭解如何將這個選項套用至指令列。

部署作業會在幾分鐘內完成。如果一切正確,您應該會在 Google Cloud 控制台中看到類似下方的內容。

ef1029fb62f8de81.pngf7191d579c21ca3e.png

按一下 Cloud Run 提供的網址,測試應用程式。驗證完成後,您應該會看到類似下方的畫面。

d571a90cd5a373f9.png

不含引數的「gcloud run deploy」

您可能已注意到,gcloud run deploy 會提出切中要點的問題,並填補您留下的空白。真是太棒了!

不過,在後續幾個單元中,我們會將這個指令新增至 Cloud Build 自動建構觸發條件,因此無法使用互動式問題。我們必須填寫指令中的每個選項。你想製作黃金gcloud run deploy --option1 blah --foo bar --region your-fav-region。該如何進行?

  1. 重複步驟 2、3、4,直到 gcloud 停止詢問問題:
  2. [LOOP] gcloud run deploy,目前找到的選項
  3. [LOOP] 系統要求選項 X
  4. [LOOP] 搜尋公開文件,瞭解如何透過 CLI 設定 X,並新增 --my-option [my-value] 選項。
  5. 現在請回到步驟 2,除非 gcloud 完成作業,且沒有其他問題。
  6. 這個 gcloud run deploy BLAH BLAH BLAH 指令太棒了!請將指令儲存到任一處,以便稍後在 Cloud Build 步驟中使用。

如需可能的解決方案,請參閱這裡。請參閱說明文件。

太棒了 🎉🎉🎉 您已成功在 Google Cloud 部署應用程式,完成翻新的第一步。

6. 單元 4:使用 Secret Manager 清除密碼

95cd57b03b4e3c73.png

在上一個步驟中,我們已成功在 Cloud Run 部署及執行應用程式。不過,我們採用了不安全的做法:以明文形式提供部分密鑰。

第一次疊代:更新 config.php 以使用 ENV

您可能已經注意到,我們將資料庫密碼直接放入 config.php 檔案的程式碼中。這項設定適合用於測試,以及確認應用程式是否正常運作。但您無法在正式環境中提交/使用這類程式碼。密碼 (和其他資料庫連線參數) 應動態讀取,並在執行階段提供給應用程式。變更 config.php 檔案,讓系統從 ENV 變數讀取資料庫參數。如果失敗,建議您設定預設值。這樣一來,如果無法載入 ENV,網頁輸出內容就會顯示是否使用預設值。填寫空白處,並替換 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();
?>

由於應用程式已容器化,您需要提供一種方式,將 ENV 變數提供給應用程式。這可以透過幾種方式完成:

  • 在建構時,於 Dockerfile 中設定。使用 ENV DB_VAR=ENV_VAR_VALUE 語法,將 4 個參數新增至先前的 Dockerfile。這會設定預設值,可在執行階段覆寫。舉例來說,您可以在這裡設定「DB_NAME」和「DB_USER」,但無法在其他地方設定。
  • 在執行階段。您可以透過 CLI 或 UI 為 Cloud Run 設定這些變數。您可以在這裡設定所有 4 個變數 (除非您想保留 Dockerfile 中的預設值)。

在本機主機中,您可能需要將 ENV 變數放入 .env 檔案 (請查看 solutions 資料夾)。

此外,請務必將 .env 新增至 .gitignore,以免將密鑰推送至 GitHub!

echo .env >> .gitignore

接著,您可以在本機測試執行個體:

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

您現在已完成下列工作:

  1. 應用程式會從 ENV 動態讀取變數
  2. 您已從程式碼中移除資料庫密碼,因此安全性有所提升

現在可以將新的修訂版本部署至 Cloud Run。請前往 UI 手動設定環境變數:

  • 前往 https://console.cloud.google.com/run
  • 按一下應用程式
  • 按一下「編輯及部署新的修訂版本」
  • 在第一個分頁「容器」中,點選下方的「變數和密鑰」分頁
  • 按一下「+ 新增變數」,然後新增所有必要變數。最終結果應如下所示:

7a5fbfa448544d3.pngf2780c35585388ca.png

這項功能完美無缺嗎?不會,大多數業者仍可看到您的 PASS。這可以透過 Google Cloud Secret Manager 減輕影響。

第二個疊代:Secret Manager

密碼已從程式碼中消失,大功告成!不過,我們安全了嗎?

任何可存取 Google Cloud 控制台的使用者,仍可查看您的密碼。事實上,只要存取 Cloud Run YAML 部署檔案,就能擷取該值。或者,如果您嘗試編輯或部署新的 Cloud Run 修訂版本,密碼會顯示在「變數和密鑰」部分,如下方螢幕截圖所示。

Google Cloud Secret Manager 是一項安全、集中的服務,用於管理 API 金鑰、密碼、憑證和其他密鑰等機密資訊。

您可以透過精細的權限和強大的加密功能,儲存、管理及存取密鑰。Secret Manager 與 Google Cloud 的 Identity and Access Management (IAM) 整合,可讓您控管哪些人能存取特定密鑰,確保資料安全性並符合法規遵循。

這項服務也支援自動密鑰輪替和版本管理,可簡化密鑰生命週期管理,並強化 Google Cloud 服務中應用程式的安全性。

如要存取 Secret Manager,請從漢堡選單前往「Security」(安全性) 服務,然後在「Data Protection」(資料保護) 區段下方找到該服務,如下方螢幕截圖所示。

6df83a1c3cb757f6.png

進入該頁面後,請啟用 Secret Manager API,如下圖所示。

a96c312e2c098db1.png

  • 現在點選「建立密鑰」,並為密鑰命名:
  • 名稱:php-amarcord-db-pass
  • 密鑰值:您的資料庫密碼 (忽略「上傳檔案」部分)。
  • 為這個 Secret 連結加上註解,看起來應像 projects/123456789012/secrets/php-amarcord-db-pass。這是密鑰的專屬指標 (適用於 Terraform、Cloud Run 等)。這個數字就是您的專屬專案編號。

提示:請盡量使用一致的密鑰命名慣例,由左至右指定,例如:cloud-devrel-phpamarcord-dbpass

  • 機構 (與公司)
  • 團隊 (機構內部)
  • 應用程式 (團隊內)
  • 變數名稱 (應用程式內)

這樣一來,您就能使用簡單的正則運算式,找出單一應用程式的所有密鑰。

建立新的 Cloud Run 修訂版本

現在我們有了新的 Secret,需要移除 DB_PASS ENV 變數,並以新的 Secret 取代。舉例來說:

  • 使用 Google Cloud 控制台存取 Cloud Run
  • 選擇應用程式。
  • 按一下「編輯及部署新的修訂版本」
  • 找到「變數與密鑰」分頁。
  • 使用「+ 參照密鑰」按鈕重設 DB_PASS ENV 變數。
  • 請為參照的 Secret 使用相同的「DB_PASS」,並使用最新版本。

9ed4e35be7654dcb.png

完成後,您應該會收到下列錯誤訊息

da0ccd7af39b04ed.png

請嘗試找出修正方式。如要解決這個問題,請前往「IAM & Admin」(IAM 與管理) 專區,變更授予的權限。祝您偵錯愉快!

找出問題後,請返回 Cloud Run 並重新部署新的修訂版本。結果應如下圖所示:

e89f9ca780169b6b.png

提示:開發人員控制台 (UI) 非常適合用來找出權限問題。請花點時間瀏覽 Cloud 實體的所有連結!

7. 單元 5:使用 Cloud Build 設定 CI/CD

ba49b033c11be94c.png

為什麼要使用 CI/CD 管道?

到目前為止,你應該已經輸入 gcloud run deploy 幾次,可能還反覆回答了同一個問題。

不想再手動執行 gcloud run deploy 指令來部署應用程式嗎?如果每次將新變更推送至 Git 存放區時,應用程式都能自動部署,那該有多好?

如要使用 CI/CD 管道,您需要:

  1. 個人 Git 存放區:您應該已在步驟 2 將工作坊存放區分支至 GitHub 帳戶。如果尚未完成,請返回並完成該步驟。建立分支版本的存放區應如下所示:https://github.com/<YOUR_GITHUB_USER>/app-mod-workshop
  2. Cloud Build。這項服務不僅出色,而且價格實惠,可讓您為幾乎所有項目設定建構自動化功能:Terraform、Docker 化應用程式等。

本節將著重於設定 Cloud Build。

Cloud Build 登場!

我們將使用 Cloud Build 執行這項操作:

  • 建構來源 (使用 Dockerfile)。您可以將其視為「大型 .zip 檔案」,其中包含建構及執行所需的一切 (「建構構件」)。
  • 將這個構件推送至 Artifact Registry (AR)。
  • 接著,將應用程式「php-amarcord」從 AR 部署至 Cloud Run
  • 這會建立現有應用程式的新版本 (「修訂版本」,可視為包含新程式碼的層),並設定在推送成功時將流量導向新版本。

以下是 php-amarcord 應用程式的部分建構範例:

f30f42d4571ad5e2.png

我們如何做到這一切?

  1. 只要建立一個完美的 YAML 檔案:cloudbuild.yaml
  2. 建立 Cloud Build 自動建構觸發條件。
  3. 透過 Cloud Build UI 連結至 GitHub 存放區。

建立觸發條件 (並連結存放區)

  • 前往 https://console.cloud.google.com/cloud-build/triggers
  • 點選「建立觸發條件」。
  • 編譯:
  • 名稱:有意義的名稱,例如 on-git-commit-build-php-app
  • 事件:推送至分支版本
  • 來源:「連結新的存放區」替代文字
  • 右側會開啟「連結存放區」視窗
  • 來源供應商:「Github」(第一個)
  • 「繼續」
  • 驗證程序會在 GitHub 開啟視窗,進行交叉驗證。請按照流程操作,並耐心等候。如果您有許多存放區,可能需要一些時間。
  • 「選取存放區」:選取帳戶/存放區,然後勾選「我瞭解…」部分。
  • 如果看到錯誤訊息「您的所有存放區均未安裝 GitHub 應用程式」,請點選「安裝 Google Cloud Build」,然後按照指示操作。
  • 23e0e0f1219afea3.png按一下「連結」
  • bafd904ec07122d2.png
  • 答對了!存放區現已連結。
  • 回到觸發條件部分…
  • 設定:自動偵測 (*)
  • 進階:選取服務帳戶「[PROJECT_NUMBER]-compute@developer.gserviceaccount.com」
  • xxxxx 是專案 ID
  • 預設運算服務帳戶適合用於實驗室,但請勿在正式環境中使用!(瞭解詳情)。
  • 其他設定則保持不變。
  • 點選「建立」按鈕。

(*) 這是最簡單的方法,因為系統會檢查 Dockerfile 或 cloudbuild.yaml。不過,cloudbuild.yaml 可讓您真正決定要在哪個步驟執行什麼操作。

超能使者

現在,除非您將「服務帳戶使用者」角色授予 Cloud Build 服務帳戶 (什麼是服務帳戶?「機器人」的電子郵件地址,代表您執行工作,在本例中是在雲端建構內容!

除非您授權給 SA,否則 SA 將無法建構及部署。幸好這很簡單!

  • 依序前往「Cloud Build」>「設定」。
  • 「[PROJECT_NUMBER]-compute@developer.gserviceaccount.com」服務帳戶
  • 勾選下列方塊:
  • Cloud Run
  • Secret Manager
  • 服務帳戶
  • Cloud Build
  • 並勾選「設為偏好的服務帳戶」

8715acca72286a46.png

Cloud Build YAML 在哪裡?

強烈建議您花點時間建立自己的 Cloud Build YAML。

不過,如果您沒有時間,或不想花時間,可以從這個解決方案資料夾中取得一些靈感:.solutions

現在,您可以將變更推送至 GitHub,並觀察 Cloud Build 的運作。

設定 Cloud Build 可能會有些難度。請預留時間來回溝通:

  • 正在 https://console.cloud.google.com/cloud-build/builds;region=global 查看記錄
  • 正在尋找錯誤。
  • 修正程式碼,然後重新發出 git commit/git push。
  • 有時錯誤不在程式碼中,而是在某些設定中。在這種情況下,您可以透過使用者介面發出新的建構作業 (Cloud Build >「觸發條件」>「執行」)

97acd16980a144ab.png

請注意,如果使用這個解決方案,您仍須完成一些工作。舉例來說,您需要為新建立的開發/正式環境端點設定 ENV 變數:

3da8723e4ff80c0a.png

您可以透過兩種方法來選擇刊登位置:

  • 透過使用者介面:再次設定 ENV 變數
  • 透過 CLI 製作「完美」指令碼。如需範例,請參閱 gcloud-run-deploy.sh。您需要調整一些設定,例如端點和專案編號。您可以在「Cloud 總覽」中找到專案編號。

如何將程式碼提交至 GitHub?

本工作坊不會說明如何以最佳方式將 git push 部署至 GitHub。不過,如果您在 Cloud Shell 中卡住,可以透過下列兩種方式解決:

  1. CLI。在本機新增安全殼層金鑰,並使用 git@github.com:YOUR_USER/app-mod-workshop.git (而非 http) 新增遠端存放區
  2. VSCode。如果使用 Cloud Shell 編輯器,可以前往「原始碼控制」分頁 (Ctrl + Shift + G),點選「同步處理變更」並按照指示操作。您應該可以向 VS Code 驗證 GitHub 帳戶,並輕鬆從該處提取/推送。

f0d53f839c7fa3b6.png

請務必在其他檔案中git add clodubuild.yaml,否則無法運作。

深度與淺度「開發/正式環境同等性」[選用]

如果您是從這裡複製模型版本,就會有兩個相同的 DEV 和 PROD 版本。這很棒,而且符合十二因子應用程式的規則 10。

不過,我們使用兩個不同的網頁端點,讓應用程式指向同一個資料庫。這對工作坊來說已經足夠,但在實際情況下,您需要花一些時間建立適當的正式環境。這表示您需要兩個資料庫 (一個用於開發,一個用於正式環境),並選擇資料庫的位置,以便進行災難復原/高可用性。這超出本工作坊的範圍,但值得思考。

如果您有時間進行「深度」製作,請務必考量所有需要複製的資源,例如:

  • Cloud SQL 資料庫 (可能還有 SQL 執行個體)。
  • GCS 值區
  • Cloud 函式。
  • 您可以在開發階段使用 Gemini 1.5 Flash 模型 (更便宜、更快速),並使用 Gemini 1.5 Pro (更強大)。

一般來說,每次對應用程式執行操作時,請務必仔細思考:正式版是否應採用相同的值?如果沒有,請加倍努力。當然,使用 Terraform 會輕鬆許多,您可以在資源中插入環境 (-dev、-prod) 做為後置字串。

8. 單元 6:改用 Google Cloud Storage

a680e0f287dd2dfb.png

儲存空間

dc3a4b8ea92aaef6.png

目前,應用程式會將狀態儲存在 Docker 容器中。如果機器故障、應用程式崩潰,或您推送新的修訂版本,系統就會排定新的修訂版本,並提供新的空白儲存空間:🙈

該如何修正這個問題?方法有很多種。

  1. 將圖片儲存在資料庫中。這是我最後對先前的 PHP 應用程式採取的做法。這是最簡單的解決方案,因為不會增加複雜度。但肯定會增加資料庫的延遲時間和負載!
  2. 將 Cloud Run 應用程式遷移至適合儲存空間的解決方案:GCE + 永久磁碟?GKE + Storage?注意:雖然控管能力提升,但靈活度會降低。
  3. 移至「GCS」GCS。Google Cloud Storage 為整個 Google Cloud 提供同級最佳的儲存空間,是最符合雲端慣例的解決方案。不過,我們必須使用 PHP 程式庫。我們是否有適用於 GCS 的 PHP 5.7 程式庫?PHP 5.7 是否支援 Composer (Composer 支援的最早版本似乎是 PHP 5.3.2)?
  4. 也許可以使用 Docker Sidecar?
  5. 或使用 GCS Cloud Run 磁碟區掛接。聽起來很棒。

🤔 遷移儲存空間 (開放式問題)

[開放式] 在這項練習中,請找出解決方案,以某種方式持續移動圖片。

驗收測試

我不想直接告訴你解決方法,但希望達到以下效果:

  1. 您上傳了 newpic.jpg。您會在應用程式中看到。
  2. 將應用程式升級至新版本。
  3. newpic.jpg 仍會顯示。

💡 可能的解決方案 (GCS Cloud Run 磁碟區掛接)

這個解決方案非常精妙,可讓我們實現有狀態的檔案上傳,同時完全不需修改程式碼 (除了顯示圖片說明,但這只是為了視覺效果,並不重要)。

這樣一來,您就能將資料夾從 Cloud Run 掛接至 GCS,因此:

  1. 上傳至 GCS 的所有內容都會顯示在應用程式中。
  2. 所有上傳到應用程式的內容,實際上都會上傳到 GCS
  3. 上傳至 GCS 的物件會產生神奇效果 (第 7 章)。

注意:請詳閱 FUSE 細則。如果效能是問題,則不建議這樣做。

建立 GCS bucket

GCS 是 Google Cloud 的全方位儲存服務。這項服務經過實戰考驗,所有需要儲存空間的 GCP 服務都會使用。

請注意,Cloud Shell 會將 PROJECT_ID 匯出為 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/"

設定 Cloud Run,將 bucket 掛接至 /uploads/ 資料夾

現在來看看優雅的部分。我們會建立磁碟區 php_uploads,並指示 Cloud Run 在 MOUNT_PATH 上執行 FUSE 掛接 (類似 /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"

現在,請針對要指向 Cloud Storage 的所有端點重複這個步驟。

您也可以透過使用者介面

  1. 在「磁碟區」分頁,建立指向 bucket 的磁碟區掛接點,類型為「Cloud Storage bucket」,例如名稱為「php_uploads」。
  2. 在「容器」>「磁碟區掛接」下方,將剛才建立的磁碟區掛接至應用程式要求的磁碟區掛接點。這取決於 Dockerfile,但可能看起來像 var/www/html/uploads/。

無論採用哪種方式,如果成功,編輯新的 Cloud Run 修訂版本時,應該會看到類似下方的畫面:

6c2bb98fc1b0e077.png

現在,請測試新應用程式,將一張新圖片上傳至 /upload.php 端點。

圖片應能順暢地在 GCS 上流動,完全不必編寫 PHP 程式碼:

70032b216afee2d7.png

發生什麼事了?

發生了非常神奇的事。

舊應用程式和舊程式碼仍可正常運作。新的現代化堆疊可讓我們將應用程式中的所有圖片/相片,輕鬆儲存在有狀態的 Cloud Bucket 中。現在,你可以盡情發揮:

  • 想在每次收到含有「危險」或「裸露」內容的圖片時傳送電子郵件嗎?您不必修改 PHP 程式碼,就能完成這項操作。
  • 想在每次收到圖片時,使用多模態版 Gemini 描述圖片,並將圖片和說明上傳至資料庫嗎?您不必修改 PHP 程式碼,你不相信我嗎?請繼續閱讀第 7 章。

我們才剛解鎖這個領域的巨大商機。

9. 單元 7:運用 Google Gemini 強化應用程式

c00425f0ad83b32c.png

現在,您擁有一個現代化的全新 PHP 應用程式 (就像 2024 年的 Fiat 126),並採用雲端化儲存空間。

如何運用?

必要條件

在上一章中,我們透過模型解決方案將圖片 /uploads/ 掛接至 GCS,實際上將應用程式邏輯與圖片儲存空間分開。

這項練習需要您:

  • 已成功完成第 6 章 (儲存空間) 的練習。
  • 建立 GCS bucket,用於存放使用者透過應用程式上傳的圖片。

設定 Cloud 函式 (Python)

您是否曾想過如何實作事件導向應用程式?例如:

  • 當<事件>發生時 => 傳送電子郵件
  • 當 <event> 發生時 => 如果 <condition> 為 true,則更新資料庫。

事件可以是任何內容,例如 BigQuery 中有新記錄、GCS 資料夾中的新物件有所變更,或 Pub/Sub 佇列中有新訊息等待處理。

Google Cloud 支援多種模式來達成這項目標。最值得注意的是:

在本練習中,我們將深入探討 Cloud 函式,以取得相當驚人的結果。我們也會提供選修練習。

請注意,程式碼範例是根據 .solutions/ 提供

設定 Cloud 函式 (🐍 Python)

我們正嘗試建立一個非常宏大的全球氣候基金。

  1. 在 GCS 建立新圖片時…(可能是有人上傳到應用程式,但不限於此)
  2. .. 呼叫 Gemini 描述圖片,並取得圖片的文字說明 .. (建議檢查 MIME,確保是圖片,而非 PDF、MP3 或文字)
  3. .. and update the DB with this description. (可能需要修補資料庫,在 images 資料表中新增 description 欄)。

修補資料庫,將 description 新增至圖片

  1. 開啟 Cloud SQL Studio:

b92b07c4cba658ef.png

  1. 輸入圖片資料庫的使用者名稱和密碼
  2. 插入這個 SQL,新增圖片說明資料欄:

ALTER TABLE images ADD COLUMN description TEXT;

3691aced78a6389.png

這樣就完成了!現在請檢查是否成功:

SELECT * FROM images;

您應該會看到新的說明欄:

bed69d6ad0263114.png

編寫 Gemini f(x)

注意:這個函式實際上是在 Gemini Code Assist 的協助下建立。

注意:建立這個函式時,可能會發生 IAM 權限錯誤。部分錯誤列在下方的「可能發生的錯誤」段落。

  1. 啟用 API
  2. 前往 https://console.cloud.google.com/functions/list
  3. 按一下「Create Function」(建立函式)
  4. 透過 API 精靈啟用 API:

d22b82658cfd4c48.png

您可以透過使用者介面或指令列建立 GCF。這裡將使用指令列。

.solutions/ 下方可能會有代碼

  1. 建立資料夾來託管程式碼,例如「gcf/」。進入資料夾。
  2. 建立 requirements.txt 檔案:
google-cloud-storage
google-cloud-aiplatform
pymysql
  1. 建立 Python 函式。程式碼範例: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. 推送函式。您可以使用類似 gcf/push-to-gcf.sh 的指令碼。

附註 1:請務必使用正確的值來設定環境變數,或直接在頂端新增 (GS_BUCKET=blah、..):

附註 2:這項操作會推送所有本機程式碼 (.),因此請務必將程式碼放在特定資料夾中,並像專業人士一樣使用 .gcloudignore,避免推送大型程式庫。(範例)。

#!/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

注意:在本範例中,系統會叫用 generate_caption 方法,Cloud 函式則會將 GCS 事件和所有相關資訊 (值區名稱、物件名稱等) 傳遞給該方法。請花點時間對該事件 Python dict 進行偵錯。

測試函式

單元測試

這個函式包含許多變動部分。您可能需要測試所有單一項目。

gcf/test.py 中有範例。

Cloud Functions UI

您也可以花點時間在 UI 上探索函式。每個分頁都值得探索,尤其是 Source (我最喜歡)、Variables、Trigger 和 Logs。您會花很多時間在 Logs 排解錯誤 (另請參閱本頁底部的可能錯誤)。此外,請務必查看 Permissions。

cf3ded30d532a2c7.png

E2E 測試

現在要手動測試函式!

  1. 前往應用程式並登入
  2. 上傳圖片 (不要太大,我們發現大圖片會發生問題)
  3. 在使用者介面上確認圖片已上傳。
  4. 在 Cloud SQL Studio 確認說明已更新。登入並執行這項查詢:SELECT * FROM images。

43a680b12dbbdda0.png

而且相當有效!我們可能也想更新前端,顯示該說明。

更新 PHP 以顯示 [選用]

我們已證明應用程式可以運作。不過,如果使用者也能看到該說明,那就更好了。

我們不需要成為 PHP 專家,也能將說明新增至 index.php。這段程式碼應該會執行 (沒錯,這也是 Gemini 幫我寫的!):

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

請根據個人喜好,將這段程式碼放在 foreach 內。

在後續步驟中,我們也會看到更美觀的使用者介面版本,這要歸功於 Gemini Code Assist。美化後的版本可能如下所示:

fdc12de0c88c4464.png

結論

您在 GCS 上建立新物件時觸發了 Cloud 函式,該函式能像人類一樣為圖片內容加上註解,並自動更新資料庫。太厲害了!

接下來該怎麼做?您可以按照相同的邏輯,實現兩項絕佳功能。

[optional] Add further Cloud Functions [open ended]

我想到幾項額外功能。

📩 電子郵件觸發條件

電子郵件觸發條件:每當有人傳送相片時,系統就會傳送電子郵件給您。

  • 太常收到通知?新增其他限制:大圖片,或 Gemini 內容包含「裸露/裸體/暴力」字詞的圖片。
  • 建議您查看 EventArc。

🚫 自動管理不當圖片

目前,人類管理員會將圖片標記為「不當」。不如讓 Gemini 處理繁複工作,管理聊天室?新增測試,標記不當觸發內容,並按照先前函式學到的方法更新資料庫。也就是說,您基本上只要採用先前的函式、變更提示,並根據答案更新資料庫即可。

注意事項:生成式 AI 的輸出內容無法預測。確保 Gemini 的「創意輸出內容」符合規範。您可以要求確定性答案,例如 0 到 1 的信心分數、JSON 等。您可以透過多種方式達成此目的,例如:* 使用 Python 程式庫 pydantic、langchain 等。* 使用 Gemini 結構化輸出。

提示:您可以設定多個函式,或使用單一提示強制要求 JSON 格式的回覆 (如上所述,搭配「Gemini 結構化輸出」效果極佳),例如:

要生成這張圖片,提示詞應該怎麼寫?

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

您可以在提示中加入其他欄位,取得更多洞察資訊,例如:這項產品有什麼優點?不好的地方?你認得這個地方嗎?是否有文字 (OCR 變得再簡單不過):

  • goods:「看起來很好吃」
  • bads:「看起來是不健康的食物」
  • OCR:「Da consumare preferibilmente prima del 10 Novembre 2024」
  • location:「Pescara, Lungomare」

雖然通常最好有 N 函式來處理 N 結果,但如果能有一個函式處理 10 件事,那會非常有成就感。如要瞭解做法,請參閱 Riccardo 的文章。

可能發生的錯誤 (多為 IAM/權限問題)

我第一次開發這個解決方案時,遇到了一些 IAM 權限問題。我會在這裡列出這些問題,並提供一些修正方式。

錯誤:服務帳戶權限不足

  1. 請注意,如要部署監聽 GCS bucket 的 GCF 函式,您必須為用於工作的服務帳戶設定適當權限,如圖所示:

22f51012fa6b4a24.png

您可能也需要啟用 EventArc API,並等待幾分鐘,讓 API 完全可用。

錯誤:缺少 Cloud Run 叫用者

  1. GCF 權限 UI 的另一則註解如下 (Cloud Run 叫用者角色):

be72e17294f2d3f3.png

只要執行圖片中的指令 (類似 fix-permissions.sh),即可修正這項錯誤

如要瞭解這個問題,請參閱:https://cloud.google.com/functions/docs/securing/authenticating

錯誤:超出記憶體上限

第一次執行時,記錄可能會顯示:「已使用 270 MiB,超過 244 MiB 的記憶體限制。建議您提高記憶體限制,詳情請參閱 https://cloud.google.com/functions/docs/configuring/memory。再次為 GCF 新增 RAM。在使用者介面中,這項操作非常簡單。以下是可能遇到的問題:

bed69d6ad0263114.png

或者,您也可以修正 Cloud Run 部署指令碼,提高記憶體/CPU。這項作業需要較長時間。

錯誤:Pub/Sub 已發布

使用 GCF 第 1 版建立觸發條件時,曾出現以下錯誤:

e5c338ee35ad4c24.png

同樣地,只要前往「IAM」,將「Pub/Sub 發布者」角色授予服務帳戶,即可輕鬆修正這個問題。

錯誤:未使用 Vertex AI

如果收到這則錯誤訊息:

Permission Denied: 403 Vertex AI API has not been used in project YOUR_PROJECT before or it is disabled. 請前往 https://console.developers.google.com/apis/api/aiplatform.googleapis.com/overview?project=YOR_PROJECT 啟用。

只要啟用 Vertex AI API 即可。啟用「所有」必要 API 的最簡單方法如下:

  1. https://console.cloud.google.com/vertex-ai
  2. 點選「啟用所有建議的 API」。

492f05ac377f3630.png

錯誤:找不到 Eventarc 觸發條件。

如果看到這個訊息,請重新部署函式。

8ec4fc11833d7420.png

錯誤:400 服務代理正在佈建

400 Service agents are being provisioned ( https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents ). Service agents are needed to read the Cloud Storage file provided. 請幾分鐘後再試。

如果發生這種情況,請稍候片刻或詢問 Google 員工。

10. 單元 8:建立可用性服務等級目標

本章節將嘗試達成以下目標:

  1. 建立 SLI
  2. 依據服務水準指標建立服務等級目標
  3. 依據服務水準目標建立警告

f63426182c052123.png

Riccardo 在 Google Cloud 的 SRE/DevOps 領域工作,因此對這個主題非常感興趣。

(開放式) 為這個應用程式建立服務水準指標和服務等級目標

如果無法得知應用程式何時停機,那應用程式再好也沒用。

什麼是 SLO?

喔,SLO 是 Google 發明的!如要進一步瞭解,建議您參閱:

步驟 1:建立可用性 SLI/SLO

首先,我們來看看可用性服務等級目標,因為這是最簡單,也可能是最重要的評估項目。

幸好 Cloud Run 內建 Istio,因此預先建構了服務等級目標支援。

應用程式在 Cloud Run 執行後,只要 30 秒就能輕鬆完成這項操作。

  • 前往 Cloud Run 頁面。
  • 按一下/選取應用程式。
  • 選取「SLOs」分頁標籤。
  • 按一下「+ 建立服務等級目標」。
  • 可用性,依要求
  • 繼續
  • 日曆月/99%。
  • 點按「建立服務等級目標」。

e471c7ebdc56cdf6.png

步驟 2:設定這個服務等級目標的快訊

建議建立 2 個快訊:

  1. 一個是消耗率偏低 (「緩慢消耗」),會透過電子郵件通知您 (模擬低優先順序的票證)。
  2. 一個是消耗率較高 (「快速消耗」),會透過簡訊通知您 (模擬高優先順序票證/呼叫器)

前往先前的 SLO tab。

重複以下步驟兩次:

314bfd6b9ef0a260.png

  • 按一下「建立服務水準目標警告」(右側內含加號的 🔔 按鈕)
  • 回溯時間長度、消耗率門檻:
  • [FAST]。第一:60 分鐘/10 次
  • [SLOW]。第二:720 分鐘/2 次
  • 通知管道:點選「管理通知管道」
  • 首先,依序點選「電子郵件」->「新增」-> ..
  • 第二,依序點選「簡訊」->「新增」-> 在手機上驗證。
  • 提示:我喜歡在名稱中使用表情符號!示範時很有趣。
  • 完成後,按一下右上角的大 X。
  • 先選取電話 (快速),再選取電子郵件 (慢速)。
  • 新增一些範例說明文件,例如:
  • [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。

答對了!

最終結果

當您有 1 個可用的服務水準目標 + 2 個可用性快訊,且快訊會傳送至您的電子郵件和手機時,即可視為完成這項練習。

您可以視需要新增「延遲」(強烈建議您這麼做),甚至更複雜的指標。延遲時間請選擇您認為合理的數值,如有疑問,請選擇「200 毫秒」。

11. 後續步驟

你已完成所有工作,還缺什麼?

請考量以下幾點:

Play with Gemini

Gemini 有兩種版本:

  1. Vertex AI。「企業級做法」:與 GCP 緊密結合,我們在第 7 章 (GCF + Gemini) 探討過。所有驗證作業都能順利完成,服務之間也能完美互連。
  2. Google AI「消費者方式」。您從這裡取得 Gemini API 金鑰,並開始建構小型指令碼,這些指令碼可以繫結至您已有的任何工作負載 (專屬工作、其他雲端、本機主機等)。您只需替換 API 金鑰,程式碼就會開始神奇地運作。

建議您嘗試在自己的個人專案中探索 (2)。

UI Lifting

我不擅長設計 UI。但 Gemini 可以!你可以只使用一個 PHP 網頁,並說出類似以下內容:

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!]

只要使用 Cloud Build,不到 5 分鐘就能輕鬆完成!:)

Gemini 的回覆非常完美 (也就是說,我不需要修改任何內容):

8a3d5fe37ec40bf8.png

以下是作者個人應用程式的新版面配置:

81620eb90ae3229a.png

注意:程式碼是以圖片形式貼上,因為我們不希望您直接複製程式碼,而是希望您讓 Gemini 根據您自己的創意 UI/前端限制條件,為您編寫程式碼。相信我,您之後只需要進行非常微幅的修改。

安全性

妥善保護這個應用程式並非這場 4 小時研討會的目標,因為這會使完成研討會的時間增加 1 到 2 個數量級。

不過,這個主題非常重要!我們在 SECURITY 中收集了一些想法。

12. 恭喜!

恭喜 🎉🎉🎉,您已成功使用 Google Cloud 翻新舊版 PHP 應用程式。

24cb9a39b1841fbd.png

以下重點摘錄這個程式碼實驗室介紹的內容:

  • 如何在 Google Cloud SQL 部署資料庫,以及如何將現有資料庫遷移至該資料庫。
  • 如何使用 Docker 和 Buildpacks 將 PHP 應用程式容器化,並將映像檔儲存至 Google Cloud Artifact Registry
  • 如何將容器化應用程式部署至 Cloud Run,並搭配 Cloud SQL 執行
  • 如何使用 Google Secret Manager 秘密儲存/使用機密設定參數 (例如資料庫密碼)
  • 如何使用 Google Cloud Build 設定 CI/CD 管道,以便在每次將程式碼推送至 GitHub 存放區時,自動建構及部署 PHP 應用程式。
  • 如何使用 Cloud Storage 將應用程式資源「雲端化」
  • 如何運用無伺服器技術,在 Google Cloud 上建構出色的工作流程,而不必修改應用程式程式碼。
  • 根據合適的用途,使用多模態版 Gemini 功能。
  • 在 Google Cloud 實踐 SRE 原則

您已成功踏出第一步,開始使用 Google Cloud 翻新應用程式!

🔁 意見回饋

如果想分享對這場工作坊的體驗,歡迎填寫這份意見回饋表單。

歡迎提供意見回饋,也歡迎您針對特別滿意的程式碼提交提取要求。

🙏 謝謝

作者在此感謝 Datatonic 的 Mirko Gilioli 和 Maurizio Ipsale 協助撰寫文章及測試解決方案。