管理修訂版本

當您部署到服務或變更服務的設定時，系統會建立不可變更的修訂版本。

以下是修訂內容的注意事項：

  • 您可以指定新版本接收所有、部分或完全不接收流量，也可以逐步推出新版本、在多個版本之間拆分流量，以及從版本復原。詳情請參閱「復原、漸進式推出及流量遷移」。
  • 您可以選擇使用修訂版本標記，測試未提供流量的修訂版本。
  • 您不必手動刪除修訂版本，但如果想這麼做也可以。
  • 未放送的修訂版本不會耗用任何資源，也不會產生費用。
  • 每項服務最多可有 1, 000 個修訂版本。如果超過這個上限，系統會自動刪除較舊的修訂版本。
  • 系統會自動指派修訂版本尾碼。如要使用自己的版本尾碼，可以使用 gcloud CLI 參數 --revision-suffix。

必要的角色

如要取得管理 Cloud Run 服務和修訂版本所需的權限，請要求管理員授予您 Cloud Run 服務的 Cloud Run 開發人員 (roles/run.developer) IAM 角色。

如需與 Cloud Run 相關聯的 IAM 角色和權限清單，請參閱 Cloud Run IAM 角色和 Cloud Run IAM 權限。如果 Cloud Run 服務與Google Cloud API (例如 Cloud 用戶端程式庫) 介接，請參閱服務身分設定指南。 如要進一步瞭解如何授予角色，請參閱部署權限和管理存取權。

查看服務的修訂版本清單

控制台

在專案中查看修訂版本清單：

  1. 前往 Cloud Run

  2. 在服務清單中找出所需服務，然後按一下。

  3. 按一下「Revisions」(修訂版本) 分頁，顯示該服務的目前修訂版本清單。

    修訂版本清單

gcloud

如要查看特定服務的修訂版本清單：

  1. 從專案可用服務清單中，尋找您的服務名稱。

    gcloud run services list

  2. 使用下列指令來取得剛找到的服務的所有修訂版本：

    gcloud run revisions list --service SERVICE --region REGION

    取代

    • SERVICE 改為您的服務名稱。
    • 將 REGION 替換為服務的 Google Cloud 區域。

Cloud Code

如要使用 Cloud Code 查看修訂版本清單，請參閱 IntelliJ 和 Visual Studio Code 的 Cloud Run 探索器指南。

用戶端程式庫

如要透過程式碼查看修訂版本清單，請執行下列操作：

REST API

如要查看修訂版本清單，請將 GET HTTP 要求傳送至 Cloud Run Admin API revisions 端點。

例如使用 curl：

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE-NAME/revisions

取代：

  • ACCESS_TOKEN 帳戶的有效存取權杖，該帳戶必須具備查看修訂版本的 IAM 權限。 舉例來說，如果您已登入 gcloud，可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中，您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
  • 將 SERVICE-NAME 改為服務名稱。
  • 將 REGION 替換為服務的 Google Cloud 區域。
  • 將 PROJECT-ID 改成 Google Cloud 專案 ID。

查看修訂版本詳細資料

控制台

如要在專案中查看修訂版本的詳細資料：

  1. 前往 Cloud Run

  2. 在服務清單中選取服務。

  3. 按一下「Revisions」(修訂版本) 分頁，顯示該服務的目前修訂版本清單。

  4. 選取您要的服務修訂版本：

  5. 查看最右側的「DETAILS」(詳細資料) 面板，瞭解修訂版本特定資訊，例如已部署容器映像檔的網址、配置的記憶體容量、環境變數，以及可能的建構和來源存放區資訊。

    圖片

gcloud

如要在專案中查看修訂版本的詳細資料：

  1. 從專案可用服務清單中，尋找您的服務名稱。

    gcloud run services list

  2. 使用下列指令來取得剛找到的服務的所有修訂版本：

    gcloud run revisions list --service SERVICE --region REGION

    取代

    • SERVICE 改為您的服務名稱。
    • 將 REGION 替換為服務的 Google Cloud 區域。

  3. 使用下列指令查看特定修訂版本的更多詳細資料： 

    gcloud run revisions describe REVISION --region REGION
     取代

    • REVISION 改為您要進一步瞭解的修訂版本名稱。
    • 將 REGION 替換為服務的 Google Cloud 區域。

    您可以使用 --format 標記設定輸出內容的格式。例如，以 YAML 格式表示： 

    gcloud run revisions describe REVISION --region REGION --format yaml

Cloud Code

如要使用 Cloud Code 查看修訂版本詳細資料，請參閱 IntelliJ 和 Visual Studio Code 的 Cloud Run 探索器指南。

用戶端程式庫

如要透過程式碼查看修訂版本的詳細資料：

REST API

如要查看修訂版本的詳細資料，請將 GET HTTP 要求傳送至 Cloud Run Admin API revisions 端點。

例如使用 curl：

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE-NAME/revisions/REVISION-NAME

取代：

  • ACCESS_TOKEN 帳戶的有效存取權杖，該帳戶須具備查看服務詳細資料的 IAM 權限。舉例來說，如果您已登入 gcloud，可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中，您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
  • 將 SERVICE-NAME 改為服務名稱。
  • 將 REVISION-NAME 替換為修訂版本名稱。
  • 將 REGION 替換為服務的 Google Cloud 區域。
  • 將 PROJECT-ID 改成 Google Cloud 專案 ID。

請注意，非最新的修訂版本可能會顯示 RETIRED 狀態，這表示 Cloud Run 已淘汰該特定修訂版本所需的基礎架構。

「詳細資料」面板中的建構和來源存放區資訊

如果啟用 Artifact Analysis API，且容器是使用 Cloud Build 建構，則「詳細資料」面板會顯示建構資訊。

此外，如果使用 Cloud Build 觸發條件建構容器，來源存放區資訊也會顯示在「詳細資料」面板中。

刪除修訂版本

刪除修訂版本常見的用途是確保不會誤用特定修訂版本。

在下列情況下，您無法刪除修訂版本：

  • 能夠接收流量，
  • 這是服務的唯一修訂版本，
  • 這是服務的最新修訂版本。

刪除修訂版本時，該修訂版本使用的容器映像檔並不會從 Container Registry 或 Artifact Registry 中自動刪除。如要從登錄檔刪除容器映像檔，請參閱 Container Registry 或 Artifact Registry 的刪除說明。

刪除修訂版本後即無法復原。

您可以使用主控台或指令列：

控制台

如何刪除修訂版本

  1. 前往 Cloud Run

  2. 在服務清單中找出所需服務，然後按一下。

  3. 按一下「Revisions」(修訂版本) 分頁，顯示該服務的目前修訂版本清單。

  4. 找出要刪除的服務修訂版本。

  5. 按一下修訂版本左側的三點垂直橢圓，顯示「刪除」選單。

    revision-delete

  6. 按一下「刪除」即可刪除修訂版本。

gcloud

如要刪除修訂版本，請使用下列指令：

gcloud run revisions delete REVISION --region REGION

取代

  • REVISION 改成您要刪除的修訂版本名稱。
  • 將 REGION 替換為服務的 Google Cloud 區域。

用戶端程式庫

如要從程式碼中刪除修訂版本，請按照下列步驟操作：

REST API

如要刪除修訂版本，請將 DELETE HTTP 要求傳送至 Cloud Run Admin API revisions 端點。

例如使用 curl：

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X DELETE \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE-NAME/revisions/REVISION-NAME

取代：

  • ACCESS_TOKEN，並提供帳戶的有效存取權杖，該帳戶必須具備刪除服務的 IAM 權限。舉例來說，如果您已登入 gcloud，可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中，您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
  • 將 SERVICE-NAME 改為服務名稱。
  • 將 REVISION-NAME 替換為修訂版本名稱。
  • 將 REGION 替換為服務的 Google Cloud 區域。
  • 將 PROJECT-ID 改成 Google Cloud 專案 ID。

後續步驟

修訂版本部署完成後，您可以執行下列操作：