1. 簡介
上次更新時間:2024 年 11 月 1 日
如何將舊版 PHP 應用程式翻新並遷移至 Google Cloud?
(📽️ 觀看 7 分鐘的程式碼實驗室簡介影片)
企業通常會在地端部署環境中執行需要翻新的舊版應用程式。也就是說,模型必須具備擴充性、安全性,且可部署在不同環境。
在本工作坊中,您將:
- 將 PHP 應用程式容器化。
- 改用代管資料庫服務 (Cloud SQL)。
- 部署至 Cloud Run (這是 GKE/Kubernetes 的免運作替代方案)。
- 使用 Identity and Access Management (IAM) 和 Secret Manager 保護應用程式。
- 透過 Cloud Build 定義 CI/CD 管道。Cloud Build 可連結至託管於熱門 Git 供應商 (例如 GitHub 或 GitLab) 的 Git 存放區,並在每次推送至 main 時觸發。
- 在 Cloud Storage 中託管應用程式圖片。這項作業是透過掛接完成,無須變更應用程式程式碼。
- 透過 Gemini 導入生成式 AI 功能,並透過 Cloud Functions (無伺服器) 進行自動化調度管理。
- 熟悉服務等級目標,並操作新翻新的應用程式。
按照這些步驟操作,即可逐步翻新 PHP 應用程式,提升擴充性、安全性和部署彈性。此外,遷移至 Google Cloud 後,您還能運用強大的基礎架構和服務,確保應用程式在雲端原生環境中順暢運作。
我們相信,您在完成這些簡單步驟後學到的知識,可以應用於您自己的應用程式和組織,並適用於不同的語言/堆疊和不同的用途。
關於應用程式
您要建立分支版本的應用程式 (程式碼,採用 MIT 授權) 是基本的 PHP 5.7 應用程式,具有 MySQL 驗證功能。這個應用程式的主要功能是提供平台,讓使用者上傳相片,管理員則可標記不當圖片。應用程式有兩個資料表:
- 使用者。預先編譯管理員。新使用者可以註冊。
- 圖片。隨附幾張範例圖片。登入的使用者可以上傳新相片。我們將在這裡施加魔法。
你的目標
我們想翻新舊版應用程式,以便在 Google Cloud 中執行。我們將運用 Google Cloud 的工具和服務,提升擴充性、強化安全性、自動管理基礎架構,並整合進階功能,例如使用 Cloud SQL、Cloud Run、Cloud Build、Secret Manager 等服務,處理圖片、監控及儲存資料。

更重要的是,我們希望逐步進行,讓您瞭解每個步驟背後的思考過程,而且通常每個步驟都會為後續步驟開啟新的可能性 (例如:單元 2 -> 3,以及 6 -> 7)。
還不確定嗎?請觀看這部 7 分鐘的 YouTube 影片。
軟硬體需求
- 已連上網際網路且安裝瀏覽器的電腦。
- 一些 GCP 抵免額。請參閱下一步。
- 您將使用 Cloud Shell。其中預先安裝了所有必要指令和 IDE。
- GitHub 帳戶。您需要這個權杖,才能使用自己的 Git 存放區分支原始程式碼 🧑🏻💻 gdgpescara/app-mod-workshop。您必須這麼做,才能擁有自己的 CI/CD 管道 (自動提交 -> 建構 -> 部署)
解決方案範例請見:
- 作者存放區:https://github.com/Friends-of-Ricc/app-mod-workshop
- 原始工作坊存放區,位於
.solutions/資料夾下,按章節分類。
本工作坊旨在透過 Cloud Shell (在瀏覽器中) 完成。
不過,您也可以嘗試從本機電腦執行。
2. 設定抵免額和分支

兌換 GCP 抵免額並設定 GCP 環境 [選用]
如要執行這個工作坊,您需要有具備一定額度的帳單帳戶。請使用本程式碼實驗室頂端橫幅中的抵免額,開始進行實驗室。如果您已連結帳單帳戶,可以略過這個步驟。
完成後,請開啟 Google Cloud 控制台,然後按一下左上方下拉式選單中顯示「無機構」的專案選取器,建立新專案。詳情請見下方

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

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

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

確認已在左上方選取新專案:
未選取 (不佳):

Selected (good):

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

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

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

如要透過視覺化方式完成,請按一下「Open Folder」,然後選取資料夾 (通常是主資料夾中的 app-mod-workshop)。
3. 單元 1:建立 SQL 執行個體
建立 Google Cloud SQL 執行個體
PHP 應用程式會連線至 MySQL 資料庫,因此我們需要將資料庫複製到 Google Cloud,才能輕鬆遷移。Cloud SQL 是完美選擇,可讓您在雲端執行全代管 MySQL 資料庫。步驟如下:
- 前往 Cloud SQL 頁面:https://console.cloud.google.com/sql/instances
- 按一下「建立執行個體」
- 啟用 API (如有需要)。這可能需要幾秒鐘。
- 選擇 MySQL。
- (我們正在努力為你提供最便宜的版本,這樣才能用得更久):
- 版本:Enterprise
- 預設:開發 (我們試過 Sandbox,但無法使用)
- Mysql 版本:5.7 (哇,好久以前的版本!)
- 執行個體 ID:選擇
appmod-phpapp(如果變更此 ID,請記得一併變更日後的指令碼和解決方案)。 - 密碼:可任意設定,但請記下,後續會以 CLOUDSQL_INSTANCE_PASSWORD 表示
- 區域:與應用程式其他部分選擇的區域相同 (例如米蘭 =
europe-west8) - 可用區可用性:單一可用區 (示範時為了節省費用)
點選「建立執行個體」按鈕,部署 Cloud SQL 資料庫。⌛這項作業約需 10 分鐘才能完成⌛。在此期間,請繼續閱讀說明文件。您也可以開始解決下一個模組 (「將 PHP 應用程式容器化」),因為該模組與第一部分的這個模組沒有依附關係 (直到您修正資料庫連線為止)。
注意:這個執行個體的費用約為每天 $7 美元。請務必在研討會結束後,將其獨立出來。
在 Cloud SQL 建立 image_catalog 資料庫和使用者
應用程式專案隨附 db/ 資料夾,內含兩個 SQL 檔案:
- 01_schema.sql:包含 SQL 程式碼,用於建立兩個資料表,分別存放使用者和圖片資料。
- 02_seed.sql:包含 SQL 程式碼,可將資料植入先前建立的資料表。
建立 image_catalog 資料庫後,就會用到這些檔案。步驟如下:
- 開啟執行個體,然後點選「資料庫」分頁標籤:
- 按一下「建立資料庫」
- 命名為
image_catalog(與 PHP 應用程式設定相同)。

接著建立資料庫使用者。這樣就能驗證 image_catalog 資料庫。
- 接著點選「使用者」分頁標籤
- 按一下「新增使用者帳戶」。
- 使用者:我們來建立一個:
- 使用者名稱:
appmod-phpapp-user - 密碼:選擇容易記住的密碼,或按一下「產生」
- 保留「Allow any host (%)」(允許任何主機 (%))。
- 按一下「新增」。
將資料庫開放給已知 IP。
請注意,Cloud SQL 中的所有資料庫一開始都是「獨立」的。您必須明確設定可存取的網路。
- 按一下執行個體
- 開啟「連線」選單
- 按一下「網路」分頁標籤。
- 按一下「授權網路」下方的連結。現在,請新增網路 (即子網路)。
- 現在,請選擇快速但不安全的設定,讓應用程式運作。您之後可以限制為信任的 IP:
- 名稱:「Everyone in the world - INSECURE」。
- 網路:「
0.0.0.0/0"」(注意:這是不安全的部分!) - 按一下「完成」
- 按一下 [Save] (儲存)。
畫面應如下所示:

注意:這個解決方案是折衷做法,可在 O(小時) 內完成工作坊。不過,請參閱安全性文件,確保正式版解決方案安全無虞!
測試資料庫連線
來看看先前建立的 image_catalog 使用者是否能正常運作。
存取執行個體中的「Cloud SQL Studio」,然後輸入資料庫、使用者和密碼進行驗證,如下所示:

進入後,即可開啟 SQL 編輯器,並繼續進行下一節。
從程式碼集匯入資料庫
使用 SQL 編輯器匯入 image_catalog 資料表和資料。從存放區中的檔案 (01_schema.sql 和 02_seed.sql) 複製 SQL 程式碼,然後依序執行。
完成後,image_catalog 應會顯示兩個資料表,分別是 users 和 images,如下所示:

如要測試,請在編輯器中執行下列指令:select * from images;
另外,請務必記下 Cloud SQL 執行個體的公開 IP 位址,稍後會用到。如要取得 IP,請前往 Cloud SQL 執行個體主頁面的「總覽」頁面。(「總覽」>「連線至這個執行個體」>「公開 IP 位址」)。
4. 單元 2:將 PHP 應用程式容器化

我們想為雲端建構這個應用程式。
也就是將程式碼封裝成 ZIP 檔案,其中包含在雲端執行程式碼所需的所有資訊。
封裝方式有以下幾種:
- Docker。非常熱門,但要正確設定相當複雜。
- Buildpacks。較不常見,但往往會「自動猜測」要建構和執行的內容。通常這樣就能解決問題!
在本工作坊中,我們假設您使用 Docker。
如果您選擇使用 Cloud Shell,請點選 Cloud 控制台右上方的圖示,重新開啟 Cloud Shell。

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

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 控制台中找到:

DB_NAME應維持不變:image_catalogDB_USER應為appmod-phpapp-userDB_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」(如要使用其他通訊埠,請點選「變更通訊埠」)

在瀏覽器中測試結果
現在,應用程式應如下所示:

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

太棒了!除了義大利文文字外,其他部分都正常運作!🎉🎉🎉
如果 Docker 化作業正確,但資料庫憑證有誤,可能會看到類似下方的內容:

再試一次,就快答對了!
儲存至 Artifact Registry [選用]
現在,您應該已準備好可運作的容器化 PHP 應用程式,可以部署至雲端。接著,我們需要一個雲端位置來儲存 Docker 映像檔,並讓 Cloud Run 等 Google Cloud 服務能存取該映像檔,以便進行部署。這項儲存解決方案稱為 Artifact Registry,是全代管的 Google Cloud 服務,專門用於儲存應用程式構件,包括 Docker 容器映像檔、Maven 套件、npm 模組等。
請使用適當的按鈕,在 Google Cloud Artifact Registry 中建立存放區。

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

回到本機開發環境,標記應用程式容器映像檔,並推送至剛建立的 Artifact Registry 存放區。請執行下列指令來完成這項操作。
- docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]
- docker push TARGET_IMAGE[:TAG]
結果應如下方螢幕截圖所示。

太棒了 🎉🎉🎉,你可以進入下一個等級。在此之前,請花 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

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 部署應用程式。您可以設定多個選項來達成目標。以下是最低限度的選項組合 (可透過指令列提供,或由工具透過互動式提示詢問):
- Cloud Run 服務名稱:您要為應用程式部署的 Cloud Run 服務。Cloud Run 服務會傳回網址,提供應用程式的端點。
- 執行應用程式的 Google Cloud 區域。(
--region區域) - 包裝應用程式的容器映像檔。
- 應用程式執行期間需要使用的環境變數。
- Allow-Unauthenticated 旗標:允許所有人存取應用程式,不需進一步驗證。
請參閱說明文件 (或向下捲動查看可能的解決方案),瞭解如何將這個選項套用至指令列。
部署作業會在幾分鐘內完成。如果一切正確,您應該會在 Google Cloud 控制台中看到類似下方的內容。


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

不含引數的「gcloud run deploy」
您可能已注意到,gcloud run deploy 會提出切中要點的問題,並填補您留下的空白。真是太棒了!
不過,在後續幾個單元中,我們會將這個指令新增至 Cloud Build 自動建構觸發條件,因此無法使用互動式問題。我們必須填寫指令中的每個選項。你想製作黃金gcloud run deploy --option1 blah --foo bar --region your-fav-region。該如何進行?
- 重複步驟 2、3、4,直到 gcloud 停止詢問問題:
- [LOOP]
gcloud run deploy,目前找到的選項 - [LOOP] 系統要求選項 X
- [LOOP] 搜尋公開文件,瞭解如何透過 CLI 設定 X,並新增
--my-option [my-value]選項。 - 現在請回到步驟 2,除非 gcloud 完成作業,且沒有其他問題。
- 這個 gcloud run deploy BLAH BLAH BLAH 指令太棒了!請將指令儲存到任一處,以便稍後在 Cloud Build 步驟中使用。
太棒了 🎉🎉🎉 您已成功在 Google Cloud 部署應用程式,完成翻新的第一步。
6. 單元 4:使用 Secret Manager 清除密碼

在上一個步驟中,我們已成功在 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
您現在已完成下列工作:
- 應用程式會從 ENV 動態讀取變數
- 您已從程式碼中移除資料庫密碼,因此安全性有所提升
現在可以將新的修訂版本部署至 Cloud Run。請前往 UI 手動設定環境變數:
- 前往 https://console.cloud.google.com/run
- 按一下應用程式
- 按一下「編輯及部署新的修訂版本」
- 在第一個分頁「容器」中,點選下方的「變數和密鑰」分頁
- 按一下「+ 新增變數」,然後新增所有必要變數。最終結果應如下所示:


這項功能完美無缺嗎?不會,大多數業者仍可看到您的 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」(資料保護) 區段下方找到該服務,如下方螢幕截圖所示。

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

- 現在點選「建立密鑰」,並為密鑰命名:
- 名稱:
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」,並使用最新版本。

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

請嘗試找出修正方式。如要解決這個問題,請前往「IAM & Admin」(IAM 與管理) 專區,變更授予的權限。祝您偵錯愉快!
找出問題後,請返回 Cloud Run 並重新部署新的修訂版本。結果應如下圖所示:

提示:開發人員控制台 (UI) 非常適合用來找出權限問題。請花點時間瀏覽 Cloud 實體的所有連結!
7. 單元 5:使用 Cloud Build 設定 CI/CD

為什麼要使用 CI/CD 管道?
到目前為止,你應該已經輸入 gcloud run deploy 幾次,可能還反覆回答了同一個問題。
不想再手動執行 gcloud run deploy 指令來部署應用程式嗎?如果每次將新變更推送至 Git 存放區時,應用程式都能自動部署,那該有多好?
如要使用 CI/CD 管道,您需要:
- 個人 Git 存放區:您應該已在步驟 2 將工作坊存放區分支至 GitHub 帳戶。如果尚未完成,請返回並完成該步驟。建立分支版本的存放區應如下所示:
https://github.com/<YOUR_GITHUB_USER>/app-mod-workshop - Cloud Build。這項服務不僅出色,而且價格實惠,可讓您為幾乎所有項目設定建構自動化功能:Terraform、Docker 化應用程式等。
本節將著重於設定 Cloud Build。
Cloud Build 登場!
我們將使用 Cloud Build 執行這項操作:
- 建構來源 (使用 Dockerfile)。您可以將其視為「大型 .zip 檔案」,其中包含建構及執行所需的一切 (「建構構件」)。
- 將這個構件推送至 Artifact Registry (AR)。
- 接著,將應用程式「php-amarcord」從 AR 部署至 Cloud Run
- 這會建立現有應用程式的新版本 (「修訂版本」,可視為包含新程式碼的層),並設定在推送成功時將流量導向新版本。
以下是 php-amarcord 應用程式的部分建構範例:

我們如何做到這一切?
- 只要建立一個完美的 YAML 檔案:
cloudbuild.yaml - 建立 Cloud Build 自動建構觸發條件。
- 透過 Cloud Build UI 連結至 GitHub 存放區。
建立觸發條件 (並連結存放區)
- 前往 https://console.cloud.google.com/cloud-build/triggers
- 點選「建立觸發條件」。
- 編譯:
- 名稱:有意義的名稱,例如
on-git-commit-build-php-app - 事件:推送至分支版本
- 來源:「連結新的存放區」

- 右側會開啟「連結存放區」視窗
- 來源供應商:「Github」(第一個)
- 「繼續」
- 驗證程序會在 GitHub 開啟視窗,進行交叉驗證。請按照流程操作,並耐心等候。如果您有許多存放區,可能需要一些時間。
- 「選取存放區」:選取帳戶/存放區,然後勾選「我瞭解…」部分。
- 如果看到錯誤訊息「您的所有存放區均未安裝 GitHub 應用程式」,請點選「安裝 Google Cloud Build」,然後按照指示操作。
按一下「連結」
- 答對了!存放區現已連結。
- 回到觸發條件部分…
- 設定:自動偵測 (*)
- 進階:選取服務帳戶「[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
- 並勾選「設為偏好的服務帳戶」

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 >「觸發條件」>「執行」)

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

您可以透過兩種方法來選擇刊登位置:
- 透過使用者介面:再次設定 ENV 變數
- 透過 CLI 製作「完美」指令碼。如需範例,請參閱 gcloud-run-deploy.sh。您需要調整一些設定,例如端點和專案編號。您可以在「Cloud 總覽」中找到專案編號。
如何將程式碼提交至 GitHub?
本工作坊不會說明如何以最佳方式將 git push 部署至 GitHub。不過,如果您在 Cloud Shell 中卡住,可以透過下列兩種方式解決:
- CLI。在本機新增安全殼層金鑰,並使用 git@github.com:YOUR_USER/app-mod-workshop.git (而非 http) 新增遠端存放區
- VSCode。如果使用 Cloud Shell 編輯器,可以前往「原始碼控制」分頁 (Ctrl + Shift + G),點選「同步處理變更」並按照指示操作。您應該可以向 VS Code 驗證 GitHub 帳戶,並輕鬆從該處提取/推送。

請務必在其他檔案中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

儲存空間

目前,應用程式會將狀態儲存在 Docker 容器中。如果機器故障、應用程式崩潰,或您推送新的修訂版本,系統就會排定新的修訂版本,並提供新的空白儲存空間:🙈
該如何修正這個問題?方法有很多種。
- 將圖片儲存在資料庫中。這是我最後對先前的 PHP 應用程式採取的做法。這是最簡單的解決方案,因為不會增加複雜度。但肯定會增加資料庫的延遲時間和負載!
- 將 Cloud Run 應用程式遷移至適合儲存空間的解決方案:GCE + 永久磁碟?GKE + Storage?注意:雖然控管能力提升,但靈活度會降低。
- 移至「GCS」GCS。Google Cloud Storage 為整個 Google Cloud 提供同級最佳的儲存空間,是最符合雲端慣例的解決方案。不過,我們必須使用 PHP 程式庫。我們是否有適用於 GCS 的 PHP 5.7 程式庫?
PHP 5.7是否支援Composer(Composer 支援的最早版本似乎是 PHP 5.3.2)? - 也許可以使用 Docker Sidecar?
- 或使用 GCS Cloud Run 磁碟區掛接。聽起來很棒。
🤔 遷移儲存空間 (開放式問題)
[開放式] 在這項練習中,請找出解決方案,以某種方式持續移動圖片。
驗收測試
我不想直接告訴你解決方法,但希望達到以下效果:
- 您上傳了
newpic.jpg。您會在應用程式中看到。 - 將應用程式升級至新版本。
newpic.jpg仍會顯示。
💡 可能的解決方案 (GCS Cloud Run 磁碟區掛接)
這個解決方案非常精妙,可讓我們實現有狀態的檔案上傳,同時完全不需修改程式碼 (除了顯示圖片說明,但這只是為了視覺效果,並不重要)。
這樣一來,您就能將資料夾從 Cloud Run 掛接至 GCS,因此:
- 上傳至 GCS 的所有內容都會顯示在應用程式中。
- 所有上傳到應用程式的內容,實際上都會上傳到 GCS
- 上傳至 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 的所有端點重複這個步驟。
您也可以透過使用者介面
- 在「磁碟區」分頁,建立指向 bucket 的磁碟區掛接點,類型為「Cloud Storage bucket」,例如名稱為「php_uploads」。
- 在「容器」>「磁碟區掛接」下方,將剛才建立的磁碟區掛接至應用程式要求的磁碟區掛接點。這取決於 Dockerfile,但可能看起來像
var/www/html/uploads/。
無論採用哪種方式,如果成功,編輯新的 Cloud Run 修訂版本時,應該會看到類似下方的畫面:

現在,請測試新應用程式,將一張新圖片上傳至 /upload.php 端點。
圖片應能順暢地在 GCS 上流動,完全不必編寫 PHP 程式碼:

發生什麼事了?
發生了非常神奇的事。
舊應用程式和舊程式碼仍可正常運作。新的現代化堆疊可讓我們將應用程式中的所有圖片/相片,輕鬆儲存在有狀態的 Cloud Bucket 中。現在,你可以盡情發揮:
- 想在每次收到含有「危險」或「裸露」內容的圖片時傳送電子郵件嗎?您不必修改 PHP 程式碼,就能完成這項操作。
- 想在每次收到圖片時,使用多模態版 Gemini 描述圖片,並將圖片和說明上傳至資料庫嗎?您不必修改 PHP 程式碼,你不相信我嗎?請繼續閱讀第 7 章。
我們才剛解鎖這個領域的巨大商機。
9. 單元 7:運用 Google Gemini 強化應用程式

現在,您擁有一個現代化的全新 PHP 應用程式 (就像 2024 年的 Fiat 126),並採用雲端化儲存空間。
如何運用?
必要條件
在上一章中,我們透過模型解決方案將圖片 /uploads/ 掛接至 GCS,實際上將應用程式邏輯與圖片儲存空間分開。
這項練習需要您:
- 已成功完成第 6 章 (儲存空間) 的練習。
- 建立 GCS bucket,用於存放使用者透過應用程式上傳的圖片。
設定 Cloud 函式 (Python)
您是否曾想過如何實作事件導向應用程式?例如:
- 當<事件>發生時 => 傳送電子郵件
- 當 <event> 發生時 => 如果 <condition> 為 true,則更新資料庫。
事件可以是任何內容,例如 BigQuery 中有新記錄、GCS 資料夾中的新物件有所變更,或 Pub/Sub 佇列中有新訊息等待處理。
Google Cloud 支援多種模式來達成這項目標。最值得注意的是:
- EventArc。瞭解如何接收 GCS 事件。適合在 Cloud 中建立 DAG,並根據 if-then-else 條件安排動作。
- Cloud Scheduler。例如,在雲端執行午夜 Cron 工作。
- Cloud Workflows。與 Eventarc 類似,可讓您
- Cloud Run Functions (也就是
lambdas)。 - Cloud Composer:基本上就是 Google 版的 Apache Airflow,也適合用於 DAG。
在本練習中,我們將深入探討 Cloud 函式,以取得相當驚人的結果。我們也會提供選修練習。
請注意,程式碼範例是根據 .solutions/ 提供
設定 Cloud 函式 (🐍 Python)
我們正嘗試建立一個非常宏大的全球氣候基金。
- 在 GCS 建立新圖片時…(可能是有人上傳到應用程式,但不限於此)
- .. 呼叫 Gemini 描述圖片,並取得圖片的文字說明 .. (建議檢查 MIME,確保是圖片,而非 PDF、MP3 或文字)
- .. and update the DB with this description. (可能需要修補資料庫,在
images資料表中新增description欄)。
修補資料庫,將 description 新增至圖片
- 開啟 Cloud SQL Studio:

- 輸入圖片資料庫的使用者名稱和密碼
- 插入這個 SQL,新增圖片說明資料欄:
ALTER TABLE images ADD COLUMN description TEXT;

這樣就完成了!現在請檢查是否成功:
SELECT * FROM images;
您應該會看到新的說明欄:

編寫 Gemini f(x)
注意:這個函式實際上是在 Gemini Code Assist 的協助下建立。
注意:建立這個函式時,可能會發生 IAM 權限錯誤。部分錯誤列在下方的「可能發生的錯誤」段落。
- 啟用 API
- 前往 https://console.cloud.google.com/functions/list
- 按一下「Create Function」(建立函式)
- 透過 API 精靈啟用 API:

您可以透過使用者介面或指令列建立 GCF。這裡將使用指令列。
.solutions/ 下方可能會有代碼
- 建立資料夾來託管程式碼,例如「gcf/」。進入資料夾。
- 建立
requirements.txt檔案:
google-cloud-storage
google-cloud-aiplatform
pymysql
- 建立 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
- 推送函式。您可以使用類似 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。

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

而且相當有效!我們可能也想更新前端,顯示該說明。
更新 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。美化後的版本可能如下所示:

結論
您在 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 權限問題。我會在這裡列出這些問題,並提供一些修正方式。
錯誤:服務帳戶權限不足
- 請注意,如要部署監聽 GCS bucket 的 GCF 函式,您必須為用於工作的服務帳戶設定適當權限,如圖所示:

您可能也需要啟用 EventArc API,並等待幾分鐘,讓 API 完全可用。
錯誤:缺少 Cloud Run 叫用者
- GCF 權限 UI 的另一則註解如下 (Cloud Run 叫用者角色):

只要執行圖片中的指令 (類似 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。在使用者介面中,這項操作非常簡單。以下是可能遇到的問題:

或者,您也可以修正 Cloud Run 部署指令碼,提高記憶體/CPU。這項作業需要較長時間。
錯誤:Pub/Sub 已發布
使用 GCF 第 1 版建立觸發條件時,曾出現以下錯誤:

同樣地,只要前往「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 的最簡單方法如下:
- https://console.cloud.google.com/vertex-ai
- 點選「啟用所有建議的 API」。

錯誤:找不到 Eventarc 觸發條件。
如果看到這個訊息,請重新部署函式。

錯誤: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:建立可用性服務等級目標
本章節將嘗試達成以下目標:
- 建立 SLI
- 依據服務水準指標建立服務等級目標
- 依據服務水準目標建立警告

Riccardo 在 Google Cloud 的 SRE/DevOps 領域工作,因此對這個主題非常感興趣。
(開放式) 為這個應用程式建立服務水準指標和服務等級目標
如果無法得知應用程式何時停機,那應用程式再好也沒用。
什麼是 SLO?
喔,SLO 是 Google 發明的!如要進一步瞭解,建議您參閱:
- SRE Book - chapter 2 - Implementing SLOs。(👉 更多 SRE 書籍)
- Art of SLOs (精彩影片)。這項訓練課程非常實用,可協助您瞭解如何為服務制定完美的服務等級目標。
- Coursera 的 SRE 課程。我也有貢獻!
步驟 1:建立可用性 SLI/SLO
首先,我們來看看可用性服務等級目標,因為這是最簡單,也可能是最重要的評估項目。
幸好 Cloud Run 內建 Istio,因此預先建構了服務等級目標支援。
應用程式在 Cloud Run 執行後,只要 30 秒就能輕鬆完成這項操作。
- 前往 Cloud Run 頁面。
- 按一下/選取應用程式。
- 選取「
SLOs」分頁標籤。 - 按一下「+ 建立服務等級目標」。
- 可用性,依要求
- 繼續
- 日曆月/99%。
- 點按「建立服務等級目標」。

步驟 2:設定這個服務等級目標的快訊
建議建立 2 個快訊:
- 一個是消耗率偏低 (「緩慢消耗」),會透過電子郵件通知您 (模擬低優先順序的票證)。
- 一個是消耗率較高 (「快速消耗」),會透過簡訊通知您 (模擬高優先順序票證/呼叫器)
前往先前的 SLO tab。
重複以下步驟兩次:

- 按一下「建立服務水準目標警告」(右側內含加號的 🔔 按鈕)
- 回溯時間長度、消耗率門檻:
- [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 有兩種版本:
- Vertex AI。「企業級做法」:與 GCP 緊密結合,我們在第 7 章 (GCF + Gemini) 探討過。所有驗證作業都能順利完成,服務之間也能完美互連。
- 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 的回覆非常完美 (也就是說,我不需要修改任何內容):

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

注意:程式碼是以圖片形式貼上,因為我們不希望您直接複製程式碼,而是希望您讓 Gemini 根據您自己的創意 UI/前端限制條件,為您編寫程式碼。相信我,您之後只需要進行非常微幅的修改。
安全性
妥善保護這個應用程式並非這場 4 小時研討會的目標,因為這會使完成研討會的時間增加 1 到 2 個數量級。
不過,這個主題非常重要!我們在 SECURITY 中收集了一些想法。
12. 恭喜!
恭喜 🎉🎉🎉,您已成功使用 Google Cloud 翻新舊版 PHP 應用程式。

以下重點摘錄這個程式碼實驗室介紹的內容:
- 如何在 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 協助撰寫文章及測試解決方案。
