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:
-
Por meio de seu navegador, abra o console do IBM Cloud e efetue login em sua conta.
-
Selecione o
de navegação Menu de navegação e clique no
de infraestrutura > Rede > Serviços de caminho privado.
-
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.
-
Clique em Publicar no 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:
- Por meio de seu navegador, abra o console do IBM Cloud e efetue login em sua conta.
- Selecione o
do menu de navegação e clique em Infraestrutura > Rede > Serviços de caminho privado.
- 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.
- 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).
- 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:
- 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-76247b1fbbe1ibmcloud 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:
- 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:
-
Configure o seu Ambiente de API.
-
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>
-
-
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:
-
Configure o seu Ambiente de API.
-
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>
-
-
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-76247b1fbbe1ibmcloud 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.