Commercetools

Commercetools 連接器可讓您連線至 commercetools 專案，並對 commercetools 實體執行支援的動作。

事前準備

使用 Commercetools 連接器前，請先完成下列工作：

  • 在 Google Cloud 專案中：
    • 確認已設定網路連線。如要瞭解網路模式，請參閱「網路連線」。
    • 將 roles/connectors.admin IAM 角色授予設定連接器的使用者。
    • 將下列 IAM 角色授予要用於連接器的服務帳戶：
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      服務帳戶是特殊的 Google 帳戶類型，主要用於代表需要驗證且必須取得授權才能存取 Google API 資料的非人類使用者。如果您沒有服務帳戶，請務必建立服務帳戶。詳情請參閱「建立服務帳戶」。

    • 啟用下列服務：
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (連接器 API)

      如要瞭解如何啟用服務，請參閱「啟用服務」。

    如果先前未為專案啟用這些服務或權限，系統會在設定連接器時提示您啟用。

設定連接器

連線是特定資料來源的連線，也就是說，如果您有多個資料來源，則必須為每個資料來源建立個別的連線。如要建立連線，請按照下列步驟操作：

  1. 在 Cloud 控制台中，前往「Integration Connectors」 >「Connections」頁面，然後選取或建立 Google Cloud 專案。

    前往「連線」頁面

  2. 按一下「+ 建立新連線」，開啟「建立連線」頁面。
  3. 在「位置」部分，選擇連線的位置。
    1. 區域：從下拉式清單中選取位置。

      如需所有支援地區的清單，請參閱「位置」一節。

    2. 點按「Next」。
  4. 在「連線詳細資料」部分中，完成下列操作：
    1. 連接器：從可用連接器的下拉式清單中選取「Commercetools」。
    2. 連接器版本：從可用版本的下拉式清單中選取連接器版本。
    3. 在「Connection Name」欄位中，輸入連線例項的名稱。

      連線名稱必須符合下列條件：

      • 連線名稱可以包含英文字母、數字或連字號。
      • 字母必須為小寫。
      • 連線名稱的開頭必須為英文字母，結尾則須為英文字母或數字。
      • 連結名稱不得超過 49 個半形字元。
    4. 視需要輸入連線例項的「Description」(說明)。
    5. 您可以選擇啟用 Cloud Logging，然後選取記錄層級。根據預設，記錄層級會設為 Error。
    6. 服務帳戶：選取具備必要角色的服務帳戶。
    7. 視需要設定連線節點設定：

      • 節點數量下限：輸入連線節點數量下限。
      • 節點數量上限：輸入連線節點數量上限。

      節點是用來處理交易的連線單位 (或備用資源)。處理的交易量越多，就需要越多節點；反之，處理的交易量越少，就需要越少節點。如要瞭解節點對連接器定價的影響，請參閱「 連線節點的定價」。如果您未輸入任何值，系統會預設將最小節點設為 2 (以提高可用性)，並將最大節點設為 50。

  5. 在「目的地」部分，輸入要連線的遠端主機 (後端系統) 詳細資料。
    • 驗證伺服器位址：在「Host address」欄位中，指定 commercetools 例項驗證目的地的主機名稱。例如：https://auth.REGION.gcp.commercetools.com 。
    • 服務網址：在「主機位址」欄位中，指定 commercetools 執行個體的主機名稱。例如：https://api.REGION.gcp.commercetools.com 。
      1. 如要與後端系統建立私人連線，請按照下列步驟操作：
        1. 建立 PSC 服務連結。
        2. 建立端點連結，然後在「主機位址」欄位輸入端點連結的詳細資料。
      2. 如果您想建立與後端系統的公開連線，並提供額外的安全性，建議您為連線設定靜態外連 IP 位址，然後設定防火牆規則，只允許特定靜態 IP 位址進入白名單。
  6. 您也可以按一下「+ 新增標籤」，以鍵/值組合的形式為連結新增標籤。
  7. 點按「Next」。
  8. 在「Authentication」部分中，輸入驗證詳細資料。
    1. 在 commercetool 介面上建立的 API 用戶端中，輸入 commercetools 用戶端 ID。
    2. 使用 commercetools 用戶端密碼建立密鑰。
    3. 設定範圍。例如 manage_project:PROJECT_NAME。
    4. 請設定存取權存證的請求格式，做為標頭。
    5. 設定 OAuth 或權杖的權杖要求路徑。
    6. 點按「Next」。
  9. 查看：查看連線和驗證詳細資料。
  10. 按一下 [建立]。

實體、作業和動作

所有整合連接器都為已連結應用程式的物件提供一層抽象層。您只能透過這個抽象層級存取應用程式的物件。抽象概念會以實體、作業和動作的形式提供給您。

  • 實體： 實體可視為已連結應用程式或服務中的物件或屬性集合。實體的定義與連接器至連接器的定義不同。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。

    不過，連接器可能不支援或沒有任何實體，在這種情況下，Entities 清單會是空白。

  • 作業： 作業是指您可對實體執行的活動。您可以對實體執行下列任一操作：

    從可用清單中選取實體後，系統會產生可用於該實體的作業清單。如需作業的詳細說明，請參閱連接器工作中的實體作業。不過，如果連接器不支援任何實體作業，則 Operations 清單中不會列出這些不支援的作業。

  • 動作： 動作是透過連接器介面提供給整合項目的一流函式。動作可讓您變更實體或多個實體，而這些變更會因連接器而異。通常，動作會有一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，在這種情況下，Actions 清單會為空白。

在整合中使用 Commercetools 連線

建立連線後，即可在 Apigee Integration 和 Application Integration 中使用。您可以透過「連接器」工作，在整合中使用連線。

向 Google Cloud 社群尋求協助

如有任何問題，歡迎在 Cloud 論壇中發問並討論這個連接器。

後續步驟