管理修訂版本

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

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

  • 您可以指定新版本接收所有、部分或完全不接收流量,也可以逐步推出新版本、在多個版本之間拆分流量,以及從版本復原。詳情請參閱「復原、漸進式推出及流量遷移」。

  • 您可以選擇使用修訂版本標記,測試未提供流量的修訂版本。

  • 不必手動刪除修訂版本,但如果想這麼做也可以。

  • 未放送的修訂版本不會耗用任何資源,也不會產生費用。

  • 每項服務最多可有 1, 000 個修訂版本。如果超過這個上限,系統會自動刪除較舊的修訂版本。

  • 系統會自動指派修訂版本尾碼。如要使用自己的版本尾碼,請使用 Google Cloud CLI 參數 --revision-suffix

查看服務的修訂版本清單

主控台

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

  1. 前往 Google Cloud 控制台的 Knative Serving:

    前往 Knative serving

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

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

    修訂版本清單

指令列

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

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

    gcloud run services list
  2. 在下列指令中指定服務名稱,即可列出該服務的所有修訂版本:

     gcloud run revisions list --service SERVICE

    SERVICE 改為您的服務名稱。

查看修訂版本詳細資料

控制台

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

  1. 前往 Google Cloud 控制台的 Knative Serving:

    前往 Knative serving

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

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

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

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

    圖片

指令列

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

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

     gcloud run services list

  2. 在下列指令中指定服務名稱,即可列出該服務的所有修訂版本:

     gcloud run revisions list --service SERVICE

    SERVICE 改為您的服務名稱。

  3. 在下列指令中指定修訂版本的名稱,即可顯示該修訂版本的詳細資料:

     gcloud run revisions describe REVISION

    REVISION 替換為要進一步瞭解的修訂版本名稱。

     gcloud run revisions describe REVISION --format yaml

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

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

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

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

刪除修訂版本

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

在下列情況下,您無法刪除修訂版本:

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

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

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

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

控制台

如要刪除修訂版本,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的 Knative Serving:

    前往 Knative serving

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

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

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

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

    revision-delete

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

指令列

如要刪除修訂版本,請使用下列指令:

gcloud run revisions delete REVISION

REVISION 替換為要刪除的修訂版本名稱。

後續步驟

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