Publicar y anular la publicación de un servicio Private Path

Una vez verificada la correcta conexión a su servicio Private Path, debe publicar su servicio para su despliegue a los consumidores.

Si un servicio Private Path no está publicado, no se puede acceder a él fuera de la cuenta.

La publicación permite que cualquier cuenta solicite acceso al servicio Private Path. Si es necesario, también puede anular la publicación cuando el acceso esté restringido a la cuenta que creó el servicio Private Path.

Puede publicar y despublicar un servicio IBM Cloud® Private Path mediante la consola, CLI, API o Terraform.

Publicación de un servicio Private Path en la consola

Para publicar un servicio Private Path en la consola IBM Cloud, siga estos pasos:

  1. Desde el navegador, abra la consola de IBM Cloud e inicie sesión en su cuenta.

  2. Seleccione el ícono del menú de navegación, luego haga clic en el ícono de Infraestructura VPC > Red > Servicios de ruta privada.

  3. Localice el nombre de su nuevo servicio Private Path en la tabla y haga clic en el nombre para ver la página de detalles del servicio Private Path.

  4. Haga clic en Publicar en el menú Acciones Menú Acciones.

    La columna Publicación de la tabla Servicios de ruta privada para VPC cambia a Published.

El servicio de vía de acceso privada se expone ahora para que otras cuentas se conecten al servicio a través de pasarelas de punto final privado virtual (VPE).

Una vez publicado, el nombre del servicio Private Path es visible para los clientes que se conectan al servicio Private Path.

Anulación de la publicación de un servicio Private Path en la consola

Para anular la publicación de un servicio de ruta privada en la consola IBM Cloud, siga estos pasos:

  1. Desde el navegador, abra la consola de IBM Cloud e inicie sesión en su cuenta.
  2. Seleccione el icono Menú del menú Navegación y, a continuación, haga clic en Infraestructura > Red > Servicios de ruta privada.
  3. En la tabla Servicios de Private Path para VPC, localice el Private Path que desea despublicar y, a continuación, haga clic en el nombre de dicho servicio de Private Path.
  4. En la página de detalles del servicio Private Path, haga clic en el menú Acciones y, a continuación, en Anular publicación.
  5. Confirme que desea anular la publicación de su servicio Private Path.

Publicación de un servicio Private Path desde la CLI

El ejemplo siguiente muestra cómo utilizar la CLI para publicar un servicio de vía de acceso privada.

Antes de empezar, asegúrese de configurar el entorno de CLI.

Para publicar un servicio de vía de acceso privada desde la CLI, siga estos pasos:

  1. Escriba el mandato siguiente:
ibmcloud is private-path-service-gateway-publish PRIVATE_PATH_SERVICE_GATEWAY
    [--output JSON]
    [-f, --force]
    [-q, --quiet]

Donde:

PRIVATE_PATH_SERVICE_GATEWAY
Indica el ID o nombre del servicio Private Path.
--output
Indica el formato de salida, sólo se admite JSON. Valores posibles: JSON.
-q, --quiet
Suprime la salida detallada.

Ejemplos de mandato

  • Publicar un servicio Private Path: ibmcloud is ppsgp r006-01cd30f7-e6f2-432f-9520-76247b1fbbe1 ibmcloud is private-path-service-gateway-publish cli-ppsg-0

Anulación de la publicación de un servicio Private Path desde la CLI

El siguiente ejemplo muestra cómo utilizar la CLI para despublicar un servicio Private Path.

Antes de empezar, asegúrese de configurar el entorno de CLI.

Para anular la publicación de un servicio Private Path desde la CLI, siga estos pasos:

  1. Escriba el mandato siguiente:
ibmcloud is private-path-service-gateway-unpublish PRIVATE_PATH_SERVICE_GATEWAY
    [--output JSON]
    [-f, --force]
    [-q, --quiet]

Donde:

PRIVATE_PATH_SERVICE_GATEWAY
Indica el ID o nombre del servicio Private Path.
--output
Indica el formato de salida, sólo se admite JSON. Valores posibles: JSON.
-q, --quiet
Suprime la salida detallada.

Publicación de un servicio de vía de acceso privada con la API

Para publicar un servicio de vía de acceso privada con la API, siga estos pasos:

  1. Configure el entorno de la API.

  2. Almacene los valores siguientes en variables que se utilizarán en el mandato de la API:

    • ppsgId-Obtener el servicio de vía de acceso privada y, a continuación, llenar la variable:

      export ppsgId=<your_ppsg_id>
      
  3. Cuando todas las variables estén iniciadas, publique su servicio Private Path:

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

Anulación de la publicación de un servicio Private Path con la API

Para anular la publicación de un servicio Private Path con la API, siga estos pasos:

  1. Configure el entorno de la API.

  2. Almacene los valores siguientes en variables que se utilizarán en el mandato de la API:

    • ppsgId-Obtener el servicio de vía de acceso privada y, a continuación, llenar la variable:

      export ppsgId=<your_ppsg_id>
      
  3. Cuando todas las variables estén iniciadas, anule la publicación de su servicio 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 {}'
    

Ejemplos de mandato

  • Publicar un servicio Private Path: ibmcloud is ppsgunp r006-01cd30f7-e6f2-432f-9520-76247b1fbbe1 ibmcloud is private-path-service-gateway-unpublish cli-ppsg-0

Publicación de un servicio Private Path con Terraform

El siguiente ejemplo publica una red Private Path utilizando Terraform:

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

Para obtener documentación sobre los recursos de Terraform, consulte el Registro de Terraform.

Anulación de la publicación de un servicio Private Path con Terraform

Terraform soportará esta función cuando alcance la Disponibilidad General (GA) y se publique oficialmente.

El siguiente ejemplo despublica una red Private Path utilizando Terraform:

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

Para obtener documentación sobre los recursos de Terraform, consulte el Registro de Terraform.

Próximos pasos

  1. Comunicar información de conexión a los consumidores
  2. Revisar solicitudes de conexión y Crear políticas de cuenta