使用環境群組

Cloud 控制台中的 Apigee

如要在 Cloud 控制台中的 Apigee 中建立新的環境群組，請按照下列步驟操作：

1. 在瀏覽器中開啟 Cloud 控制台中的 Apigee UI。
2. 在左側導覽窗格中，依序選取「管理」>「環境」。
3. 在「環境」窗格中，選取「環境群組」。
4. 按一下「+ 建立環境群組」。
5. 輸入下列內容：
   • 環境群組名稱：環境群組的名稱。名稱開頭和結尾須為英數字元。最多可包含 63 個半形字元，且只能使用英數字元和連字號。名稱不得與貴機構中任何現有的環境群組名稱相同。

   • Hostames：可用於呼叫 Proxy 的主機名稱清單。每個主機名稱必須獨立成行。

     您也可以點選「使用這些網域設定 Google 負載平衡器」。 這會在 Cloud 控制台中開啟「負載平衡」頁面，您可以在其中設定主機名稱的負載平衡。

   • 環境：可選的環境清單，用於納入環境群組。
6. 按一下 [建立]。

傳統版 Apigee

如要在傳統 Apigee UI 中建立新的環境群組，請按照下列步驟操作：

1. 在 Apigee UI 中，依序選取「管理」>「環境」>「群組」。
2. 按一下「+ 環境群組」：

   

   系統會顯示「Add an Environment Group」對話方塊。

3. 輸入新環境群組的名稱：

   

   名稱只能使用小寫英文字母、數字和連字號。此外，開頭必須為英文字母，長度至少為兩個字元，結尾不得為連字號。有效的名稱包括 my-env-group 和 prod2。

4. 按一下「新增」。

   Apigee 會建立新的環境群組。這通常是快速的作業。

   作業成功後，Apigee 會透過橫幅確認已建立群組，如下所示：

   

   Apigee 也會為新群組指派預設主機名稱。

5. (選用) 按一下新群組的 create，為該群組指派其他主機名稱。

   Apigee 會顯示「環境群組詳細資料」窗格：

   

6. 將主機名稱新增至「Hostnames」欄位。每個主機名稱必須獨立成行。

7. 完成後按一下 [儲存]。

   您隨時可以使用相同的程序，在這個清單中新增及移除主機名稱。

Apigee API

如要使用 Apigee API 建立新的環境群組，請將 POST 要求傳送至 Create environment groups API。呼叫 API 前，請確認您有有效的權杖，如「取得 OAuth 2.0 存取權杖」一文所述。

以下 curl 指令範例說明建立新群組的語法：

curl -i $TOKEN -X POST \
  https://apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups?name=new-group-name

指定新群組名稱時，您只能使用小寫英文字母、數字和連字號 (a-z、A-Z 和 -)。您無法使用大寫英文字母或連字號以外的任何特殊字元。名稱開頭也必須為小寫英文字母。

如果您未指定任何其他參數，這個指令會建立新群組，但不會指派主機名稱。

您也可以在建立群組時指定主機名稱，方法是在要求的本文中將主機名稱指定為陣列。

以下範例會建立新的群組 my-group，並將三個新的主機名稱指派給新群組：

curl -i $TOKEN -X POST \
  https://apigee.googleapis.com/v1/organizations/org_name/envgroups?name=my-group \
  -d '{ \
    "hostnames": ["server1.mycompany.com", "server2.mycompany.com", "10.1.142.8"] \
  }'

日後，您可以向 Patch environment groups API 傳送 PATCH 要求，藉此變更清單中的主機名稱。

Cloud 控制台中的 Apigee

如要在 Apigee in Cloud 控制台中將環境新增至環境群組，請按照下列步驟操作：

1. 按照「建立環境」一文所述，建立環境。
2. 在 Cloud 控制台的 Apigee UI 中，選取左側導覽窗格中的「Management」>「Environments」。
3. 在「環境」窗格中，選取「環境群組」。
4. 在環境群組的列中，按一下「動作」下方的三點圖示選單，然後選取「編輯」。
5. 在「Edit Environment Group」窗格中的「Environments (Optional)」下方，選取要新增至環境群組的環境。
6. 按一下「更新」。

傳統版 Apigee

如要在傳統版 Apigee UI 中將環境新增至環境群組，請按照下列步驟操作：

1. 按照「建立環境」一文所述，建立環境。
2. 在 Apigee UI 中，依序選取「Admin」>「Environments」>「Groups」。
3. 在「未指派」下方查看不屬於環境群組的環境清單：

   

   請注意，您要指派哪些環境。

4. 找出要新增環境的環境群組，然後按一下旁邊的 create。

   「環境群組詳細資料」窗格會顯示：

   

5. 如要為這個群組新增環境，請在「環境」清單中按一下「+」。

   畫面上會顯示「Add environment」窗格：

   

6. 選取要加入群組的環境，然後按一下「新增」。

   Apigee 會將環境新增至群組。

Apigee API

如要使用 Apigee API 將新環境新增至環境群組，請傳送 POST 要求至 環境群組附加元件 API，如以下範例所示：

curl -H "Authorization: Bearer $TOKEN" -X POST
  "https://apigee.googleapis.com/v1/organizations/my-org/envgroups/test-group/attachments"
  -d '{
    "name": "my-attachment",
    "environment": "test"
  }'

其中：

• $TOKEN 會設為您的 OAuth 2.0 存取憑證，如「取得 OAuth 2.0 存取憑證」一節所述。
• 要求主體包含附件名稱和新環境的名稱。

要求主體包含 EnvironmentGroupAttachment 資源的例項，這是單一環境的簡單包裝函式。

如果成功，回應會包含新附件的詳細資料，包括建立時間戳記，例如：

{
  "name": "my-attachment",
  "environment": "test"
  "createdAt": "42"
}

Cloud 控制台中的 Apigee

如要在 Apigee in Cloud 控制台中從環境群組中移除環境，請按照下列步驟操作：

1. 在 Cloud 控制台的 Apigee UI 中，選取左側導覽窗格中的「Management」>「Environments」。
2. 在「環境」窗格中，選取「環境群組」。
3. 在環境群組的資料列中，按一下「動作」下方的三點圖示選單，然後選取「編輯」。
4. 在「編輯環境群組」窗格中的「環境 (選用)」下方，取消選取要從環境群組中移除的環境。
5. 按一下「更新」。

傳統版 Apigee

如要在傳統 Apigee UI 中從環境群組中移除環境，請按照下列步驟操作：

1. 在 Apigee UI 中，依序選取「管理」>「環境」>「總覽」。
2. 選取要移除的環境。
3. 在「群組」窗格中，將游標移至要移除環境的群組列結尾，然後按一下 。

Apigee API

如要使用 Apigee API 從環境群組中移除環境，請使用 EnvironmentGroupAttachment 資源中的 delete 方法，刪除與環境相對應的附件。

Cloud 控制台中的 Apigee

如要在 Apigee in Cloud 控制台中刪除環境群組，請按照下列步驟操作：

1. 在 Cloud 控制台的 Apigee UI 中，選取左側導覽窗格中的「Management」>「Environments」。
2. 在「環境」窗格中，選取「環境群組」。
3. 在環境群組的資料列中，按一下「Actions」下方的三點圖示選單，然後選取「Delete」。

傳統版 Apigee

如要在傳統版 Apigee UI 中刪除環境群組，請按照下列步驟操作：

1. 在 Apigee UI 中，依序選取「管理」>「環境」>「群組」。
2. 將游標移至要刪除的群組窗格。
3. 按一下 圖示。

Apigee API

如要使用 Apigee API 刪除環境群組，請在 EnvironmentGroup 資源中使用 delete 方法。

Cloud 控制台中的 Apigee

如要在 Cloud 控制台中的 Apigee 中，將主機名稱新增至環境群組，請按照下列步驟操作：

1. 在 Cloud 控制台的 Apigee UI 中，選取左側導覽窗格中的「Management」>「Environments」。
2. 在「環境」窗格中，選取「環境群組」。
3. 在環境群組的資料列中，按一下「動作」下方的三點圖示選單，然後選取「編輯」。
4. 在「Edit Environment Group」窗格中的「Hostnames」下方，輸入要新增至環境群組的主機名稱。
5. 按一下「更新」。

傳統版 Apigee

如要在傳統版 Apigee UI 中將主機名稱新增至環境群組，請按照下列步驟操作：

1. 在 Apigee UI 中，依序選取「Admin」>「Environments」>「Groups」。

2. 將游標懸停在群組資訊卡上，然後選取 create。

   「環境群組詳細資料」窗格會顯示：

   

3. 在「主機名稱」欄位中輸入新的主機。
4. 按一下「儲存」，將新主機新增至群組。

Apigee API

如要使用 Apigee API 將主機名稱新增至環境群組，請將 PATCH 要求傳送至 Patch 環境群組 API。請務必將 updateMask 參數設為 hostnames，並指定所需的主機名稱完整清單：請求中該欄位的值會取代現有清單。

以下範例會設定測試環境的主機名稱：

curl -H "Authorization: Bearer $TOKEN" -X PATCH
  "https://apigee.googleapis.com/v1/organizations/my-org/envgroups/test-group?updateMask=hostnames"
  -d '{
    "name": "my-hostnames",
    "hostnames": [
      "test-1.example.com",
      "test-2.example.com",
      "test-3.example.com"
    ]
  }'

其中：

• $TOKEN 會設為您的 OAuth 2.0 存取憑證，如「取得 OAuth 2.0 存取憑證」一節所述。
• 要求的酬載會指定主機名稱附件陣列的名稱，以及名稱本身的陣列。

如果要求成功，回應會包含 Operation 資源。