發布和取消發布私有路徑服務

驗證 與 Private Path 服務的成功連線 後,您必須向使用者發布您的服務以進行部署。

如果私有路徑服務未發布,則無法在帳戶外部存取它。

Publishing 允許任何帳戶要求存取 Private Path 服務。 如果需要,您也可以取消發布,其中建立私人路徑服務的帳戶的存取權限受到限制。

您可以使用主控台、CLI、API 或 Terraform 發佈或取消發佈 IBM Cloud® Private Path 服務。

在主控台中發佈私有路徑服務

若要在IBM Cloud控制台中發佈私有路徑服務,請依照下列步驟操作:

  1. 從瀏覽器開啟 IBM Cloud 主控台,登入您的帳戶。

  2. 選取導覽功能表 導覽功能表圖示,然後按一下基礎結構 VPC 圖示 > 網路 > 私人路徑服務。

  3. 在表格中找到新的專用路徑服務的名稱,然後按一下該名稱以查看專用路徑服務詳細資訊頁面。

  4. 按一下 Actions(行動)功能表中的 Publish(發佈 )功能表 動)。

    VPC 的私有路徑服務表中的發布欄位變更為 Published。

現在會公開「專用路徑」服務,讓其他帳戶透過「虛擬專用端點 (VPE)」閘道連接至服務。

發布後,連接到專用路徑服務的客戶可以看到專用路徑服務名稱。

在主控台中解除發佈私有路徑服務

若要在IBM Cloud控制台中取消發布專用路徑服務,請執行下列步驟:

  1. 從瀏覽器開啟 IBM Cloud 主控台,登入您的帳戶。
  2. 選取導覽 功能表功能表圖示,然後按一下基礎結構 > 網路 > 私人路徑服務。
  3. 在 VPC 的專用路徑服務表中,找到要取消發佈的專用路徑,然後按一下該專用路徑服務的名稱。
  4. 在專用路徑服務詳細資訊頁面上,按一下操作選單,然後按一下取消發布。
  5. 確認您想要取消發佈您的專用路徑服務。

從 CLI 發布專用路徑服務

下列範例顯示如何使用 CLI 來發佈「專用路徑」服務。

開始之前,請確定 設定 CLI 環境。

若要從 CLI 發佈「專用路徑」服務,請遵循下列步驟:

  1. 輸入下列指令:
ibmcloud is private-path-service-gateway-publish PRIVATE_PATH_SERVICE_GATEWAY
    [--output JSON]
    [-f, --force]
    [-q, --quiet]

其中:

PRIVATE_PATH_SERVICE_GATEWAY
表示 Private Path 服務的 ID 或名稱。
--output
表示輸出格式,僅支援 JSON。 下列其中一項:JSON。
-q, --quiet
抑制詳細輸出。

指令範例

  • 發佈私人路徑服務: ibmcloud is ppsgp r006-01cd30f7-e6f2-432f-9520-76247b1fbbe1 ibmcloud is private-path-service-gateway-publish cli-ppsg-0

從 CLI 取消發布專用路徑服務

以下範例顯示如何使用 CLI 取消發布專用路徑服務。

開始之前,請確定 設定 CLI 環境。

若要從 CLI 取消發布專用路徑服務,請執行下列步驟:

  1. 輸入下列指令:
ibmcloud is private-path-service-gateway-unpublish PRIVATE_PATH_SERVICE_GATEWAY
    [--output JSON]
    [-f, --force]
    [-q, --quiet]

其中:

PRIVATE_PATH_SERVICE_GATEWAY
表示 Private Path 服務的 ID 或名稱。
--output
表示輸出格式,僅支援 JSON。 下列其中一項:JSON。
-q, --quiet
抑制詳細輸出。

使用 API 發佈專用路徑服務

若要使用 API 發佈「專用路徑」服務,請遵循下列步驟:

  1. 設定 API 環境。

  2. 將下列值儲存在要在 API 指令中使用的變數中:

    • ppsgId-取得「專用路徑」服務,然後移入變數:

      export ppsgId=<your_ppsg_id>
      
  3. 當所有變數都啟動後,發布您的私有路徑服務:

    curl -X POST -sH "Authorization:${iam_token}" \
    "$vpc_api_endpoint/v1/private_path_service_gateways/$ppsgId/publish?version=$api_version&generation=2" \
    -d {}'
    

使用 API 取消發布私有路徑服務

若要使用 API 取消發布專用路徑服務,請執行下列步驟:

  1. 設定 API 環境。

  2. 將下列值儲存在要在 API 指令中使用的變數中:

    • ppsgId-取得「專用路徑」服務,然後移入變數:

      export ppsgId=<your_ppsg_id>
      
  3. 啟動所有變數後,取消發布您的 Private Path 服務:

    curl -X POST -sH "Authorization:${iam_token}" \
    "$vpc_api_endpoint/v1/private_path_service_gateways/$ppsgId/unpublish?version=$api_version&generation=2" \
    -d {}'
    

指令範例

  • 發佈私人路徑服務: ibmcloud is ppsgunp r006-01cd30f7-e6f2-432f-9520-76247b1fbbe1 ibmcloud is private-path-service-gateway-unpublish cli-ppsg-0

使用 Terraform 發布私有路徑服務

以下範例使用 Terraform 發布 Private Path 網路:

resource "ibm_is_private_path_service_gateway_operations" "publish" {
  published = true
  private_path_service_gateway = ibm_is_private_path_service_gateway.ppsg.id
}

有關 Terraform 資源的說明文件,請參閱 Terraform Registry。

使用 Terraform 取消發布私人路徑服務

Terraform 將在達到通用可用性 (GA) 並正式發布後支援此功能。

以下範例使用 Terraform 取消發布 Private Path 網路:

resource "ibm_is_private_path_service_gateway_operations" "publish" {
  published = false
  private_path_service_gateway = ibm_is_private_path_service_gateway.ppsg.id
}

有關 Terraform 資源的說明文件,請參閱 Terraform Registry。

下一步

  1. 將連線資訊傳達給消費者
  2. 檢閱連線要求 及 建立帳戶原則