Publicar e cancelar a publicação de um serviço de caminho privado

Depois de verificar uma conexão bem-sucedida ao seu serviço de caminho privado, você deve publicar seu serviço para implantação nos consumidores.

Se um serviço de caminho privado não for publicado, ele não poderá ser acessado fora da conta.

A publicação permite que qualquer conta solicite acesso ao serviço Private Path. Se necessário, você também pode cancelar a publicação onde o acesso é restrito à conta que criou o serviço Private Path.

Você pode publicar e cancelar a publicação de um serviço do IBM Cloud® Private Path usando o console, a CLI, a API ou o Terraform.

Publicação de um serviço de caminho privado no console

Para publicar um serviço de caminho privado no console IBM Cloud, siga estas etapas:

  1. Por meio de seu navegador, abra o console do IBM Cloud e efetue login em sua conta.

  2. Selecione o ícone Menu de navegação Menu de navegação e clique no ícone VPC de infraestrutura > Rede > Serviços de caminho privado.

  3. Localize o nome de seu novo serviço de caminho privado na tabela e clique no nome para exibir a página de detalhes do serviço de caminho privado.

  4. Clique em Publicar no menu Ações Menu Ações.

    A coluna Publicação na tabela Serviços de caminho privado para VPC é alterada para Published.

O serviço Private Path agora é exposto para outras contas se conectarem ao serviço por meio de gateways do Virtual Private Endpoint (VPE).

Após a publicação, o nome do serviço de caminho privado fica visível para os clientes que se conectam ao serviço de caminho privado.

Cancelar a publicação de um serviço de caminho privado no console

Para cancelar a publicação de um serviço de caminho privado no console IBM Cloud, siga estas etapas:

  1. Por meio de seu navegador, abra o console do IBM Cloud e efetue login em sua conta.
  2. Selecione o ícone Menu do menu de navegação e clique em Infraestrutura > Rede > Serviços de caminho privado.
  3. Na tabela Serviços de caminho privado para VPC, localize o caminho privado que você deseja cancelar a publicação e clique no nome desse serviço de caminho privado.
  4. Na página de detalhes do serviço Private Path, clique no menu Actions (Ações ) e, em seguida, clique em Unpublish (Cancelar publicação).
  5. Confirme que você deseja cancelar a publicação do serviço Private Path.

Publicação de um serviço de caminho privado na CLI

O exemplo a seguir mostra como usar a CLI para publicar um serviço de Caminho privado.

Antes de começar, certifique-se de configurar seu ambiente da CLI.

Para publicar um serviço de Caminho privado por meio da CLI, siga estas etapas:

  1. Insira o comando a seguir:
ibmcloud is private-path-service-gateway-publish PRIVATE_PATH_SERVICE_GATEWAY
    [--output JSON]
    [-f, --force]
    [-q, --quiet]

Em que:

PRIVATE_PATH_SERVICE_GATEWAY
Indica a ID ou o nome do serviço de caminho privado.
--output
Indica o formato de saída, somente JSON é compatível. Um de: JSON.
-q, --quiet
Suprime a saída detalhada

Exemplos de comando

  • Publicar um serviço de caminho privado: ibmcloud is ppsgp r006-01cd30f7-e6f2-432f-9520-76247b1fbbe1 ibmcloud is private-path-service-gateway-publish cli-ppsg-0

Cancelar a publicação de um serviço de caminho privado na CLI

O exemplo a seguir mostra como usar a CLI para cancelar a publicação de um serviço de caminho privado.

Antes de começar, certifique-se de configurar seu ambiente da CLI.

Para cancelar a publicação de um serviço de caminho privado na CLI, siga estas etapas:

  1. Insira o comando a seguir:
ibmcloud is private-path-service-gateway-unpublish PRIVATE_PATH_SERVICE_GATEWAY
    [--output JSON]
    [-f, --force]
    [-q, --quiet]

Em que:

PRIVATE_PATH_SERVICE_GATEWAY
Indica a ID ou o nome do serviço de caminho privado.
--output
Indica o formato de saída, somente JSON é compatível. Um de: JSON.
-q, --quiet
Suprime a saída detalhada

Publicando um serviço de Caminho privado com a API

Para publicar um serviço Private Path com a API, siga estas etapas:

  1. Configure o seu Ambiente de API.

  2. Armazene os valores a seguir nas variáveis a serem usadas no comando da API:

    • ppsgId-Obtenha seu serviço Private Path e, em seguida, preencha a variável:

      export ppsgId=<your_ppsg_id>
      
  3. Quando todas as variáveis forem iniciadas, publique seu serviço 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 {}'
    

Cancelar a publicação de um serviço de caminho privado com a API

Para cancelar a publicação de um serviço de caminho privado com a API, siga estas etapas:

  1. Configure o seu Ambiente de API.

  2. Armazene os valores a seguir nas variáveis a serem usadas no comando da API:

    • ppsgId-Obtenha seu serviço Private Path e, em seguida, preencha a variável:

      export ppsgId=<your_ppsg_id>
      
  3. Quando todas as variáveis forem iniciadas, cancele a publicação do serviço 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 {}'
    

Exemplos de comando

  • Publicar um serviço de caminho privado: ibmcloud is ppsgunp r006-01cd30f7-e6f2-432f-9520-76247b1fbbe1 ibmcloud is private-path-service-gateway-unpublish cli-ppsg-0

Publicação de um serviço de caminho privado com o Terraform

O exemplo a seguir publica uma rede de caminho privado usando o 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 obter documentação sobre os recursos do Terraform, consulte o Registro do Terraform.

Cancelar a publicação de um serviço de caminho privado com o Terraform

O Terraform oferecerá suporte a esse recurso depois que ele atingir a Disponibilidade Geral (GA) e for oficialmente lançado.

O exemplo a seguir cancela a publicação de uma rede de caminho privado usando o 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 obter documentação sobre os recursos do Terraform, consulte o Registro do Terraform.

Próximas etapas

  1. Comunicar informações de conexão aos consumidores
  2. Revisar solicitações de conexão e Criar políticas de conta