管理服務生命週期

本頁說明如何使用 Google Cloud CLI gcloud endpoints services 指令,管理代管服務的生命週期。

如要處理進階用途,可以使用 Service Management API 以程式輔助方式管理服務。詳情請參閱「開始使用 Service Management API」一文。

簡介

代管服務是一種簡單的資源,可從邏輯上代表與服務基礎架構整合的服務,例如 Gmail API 和 Spanner API。代管服務本身只有兩個不可變更的屬性,即服務名稱供應商專案,但代管服務的實作項目可提供各種功能。舉例來說,Cloud Storage API 為數百萬名開發人員和企業提供全球規模的物件儲存空間。

代管服務有一組服務消費者、不可變更的服務設定記錄,以及不可變更的服務發布記錄。最新服務推出作業所參照的服務設定代表服務的目前狀態,涵蓋服務的所有層面,從顯示名稱到指標定義,再到速率限制。如需規格,請參閱 google.api.Service

本頁面將說明如何建立及管理服務生命週期。如要進一步瞭解服務管理,請參閱操作指南

建立 Service

如要建立服務,請完成下列步驟。

  1. 在電腦上安裝並初始化 gcloud CLI

  2. 建立專屬的生產者專案來代管服務。專屬專案可為服務提供最佳安全防護和隔離措施。您也可以將服務擁有權轉移給其他團隊,甚至是其他公司。

  3. 為專案啟用 Service Management API 和 Service Control API。

  4. 為專案啟用 Cloud Billing。如要將服務與 Service Infrastructure 整合,您需要使用多項付費 Google Cloud 產品,包括 Service Control API、Cloud Logging API 和 Cloud Monitoring API。

  5. 為服務準備簡單的服務設定 YAML 檔案,如下所示:

    # Filename: endpointsapis.yaml
    type: google.api.Service
    config_version: 3
    # Update the next line to use your own service name.
    name: endpointsapis.appspot.com
    # Update the next line to use your own producer project id.
    producer_project_id: endpointsapis
    
  6. 執行 gcloud 指令,部署空白服務設定來建立服務:

    gcloud endpoints services deploy endpointsapis.yaml
    

服務建立程序大約需要一分鐘。完成後,您應該就能在 Google Cloud 控制台的「Endpoints」頁面中看到服務。

列出服務

如要列出專案中的服務,可以使用下列指令:

gcloud endpoints services list --project endpointsapis

描述服務

如要說明服務及其設定,可以使用下列指令:

gcloud endpoints services describe endpointsapis.appspot.com

刪除服務

如果不再需要某項服務,可以使用下列指令刪除:

gcloud endpoints services delete endpointsapis.appspot.com

注意:所有服務都必須保留刪除資料 30 天。

取消刪除服務

您可以在保留期限內使用下列指令,還原服務:

gcloud endpoints services undelete endpointsapis.appspot.com

後續步驟

Service Management API 使用服務管理的宣告式模型。建立服務後,您需要推送不可變更的服務設定和服務發布作業,才能達到服務的所需狀態。服務設定可用於設定 Google Cloud 基礎架構服務,以支援您的服務,包括 Cloud Billing、Cloud Logging、Cloud Monitoring 和 Identity and Access Management。

如要進一步瞭解服務設定,請參閱「管理服務設定」。如要進一步瞭解服務推出作業,請參閱管理服務推出作業