Objetivos

• Entenda os conceitos básicos de Private Path service.
• Implementar um aplicativo em uma conta sem expor nenhum terminal público.
• Exponha o aplicativo com Private Path service.
• Acesse o aplicativo de um cliente consumidor somente por meio de conectividade privada.

1. Um provedor implementa um aplicativo resiliente suportado por vários servidores virtuais espalhados por várias zonas
2. O provedor cria um Private Path network load balancer (NLB) configurado com conjuntos de back-end apontando para os servidores virtuais, distribuindo o carregamento entre os servidores com o algoritmo round-robin.
3. Um Private Path service referencia o Private Path NLB e especifica o endpoint de serviço usado pelos consumidores..
4. Os consumidores acessam o aplicativo do provedor por meio de gateways de terminal privado virtual Todo o tráfego permanece privado para o IBM Cloud.

Antes de Iniciar

Este tutorial requer:

• Uma IBM Cloud conta faturável para hospedar os recursos do provedor e do consumidor.
• Uma chave SSH do VPC para conectar-se às instâncias de servidor virtual provisionadas no tutorial

Criar os recursos do provedor e o aplicativo

Neste tutorial, você primeiro atua como um provedor e implementa um aplicativo. Em uma segunda fase, você assume a função do consumidor e chama o aplicativo. O aplicativo é um servidor da web simples do nginx

1. Acesse Schematics para criar uma nova área de trabalho.
2. Na etapa Especificar modelo:
   1. Defina a URL do repositório como https://github.com/IBM-Cloud/vpc-tutorials/tree/master/vpc-pps-basics/provider.
   2. Certifique-se de marcar Usar repositório completo.
   3. Configure a Versão do Terraform como terraform_v1.5
   4. Clique em Avançar.
3. Na etapa de detalhes do espaço de trabalho:
   1. Configure o nome da área de trabalho como pps-provider
   2. Selecione um Grupo de recursos e Local onde criar a área de trabalho. Isso não afetará os recursos criados para o tutorial.
   3. Clique em Avançar
4. Clique em Criar.

Na área de trabalho Configurações, em Variáveis:

1. Localize a variável " existing_ssh_key_name.
   1. Use o menu (veja) para Editar seu valor.
   2. Configure o valor para o nome da chave SSH criada na seção anterior ou para uma chave SSH existente.
   3. Salvar.
2. Opcionalmente, também é possível ajustar valores de outras variáveis como region, basename.

Finalmente crie os recursos:

1. Clique em Aplicar plano.
2. Aguarde o Schematics para concluir o fornecimento dos recursos.

Revise os recursos e o aplicativo do provedor

Executar Schematics para o provedor cria os recursos a seguir:

• uma nuvem privada virtual (VPC),
• três sub-redes, uma para cada zona,
• um mínimo de uma instância de servidor virtual em cada sub-rede,
• um Private Path NLB configurado com um conjunto de back-end incluindo todas as instâncias de servidor virtual,
• e um Private Path service.

1. Navegue para Nuvens privadas virtuais, Sub-redes e Instâncias de servidor virtual para revisar os recursos provisionados
2. Localize o Private Path NLB sob Balanceadores de carga.
3. Em Private Path serviços, selecione o Private Path servicecriado.
4. Nos detalhes do Private Path service, observe o Terminal em serviço configurado como vpc-pps.example.com. Observe que ele pode ser diferente se você especificou um basename customizado durante a configuração da área de trabalho Este é o terminal usado pelos consumidores para interagir com o seu aplicativo
5. Anote o CRN, pois é necessário transmitir essas informações para os consumidores Os consumidores usam o CRN para identificar seu aplicativo ao criar gateways de terminal privado virtual..

Seu Private Path service está quase pronto para ser compartilhado com os consumidores. Mas antes de publicar o Private Path service, é recomendado testar se ele está funcionando conforme o esperado.

Criar os recursos do consumidor..

Para verificar se o Private Path service está configurado corretamente, você implementará servidores virtuais para acessar o aplicativo, assim como qualquer consumidor de um Private Path service faria.

Até que um Private Path service seja publicado, ele só pode ser acessado dentro da mesma conta na qual é criado. Oferece uma boa oportunidade para testar o serviço antes de compartilhá-lo com outras pessoas. Este é o motivo pelo qual, neste estágio, o lado consumidor deste tutorial é fornecido na mesma conta que o aplicativo do provedor.

1. Acesse Schematics para criar uma nova área de trabalho.
2. Na etapa Especificar modelo:
   1. Defina a URL do repositório como https://github.com/IBM-Cloud/vpc-tutorials/tree/master/vpc-pps-basics/consumer.
   2. Certifique-se de marcar Usar repositório completo.
   3. Configure a Versão do Terraform como terraform_v1.5
   4. Clique em Avançar.
3. Na etapa de detalhes do espaço de trabalho:
   1. Configure o nome da área de trabalho como pps-consumer
   2. Selecione um Grupo de recursos e Local onde criar a área de trabalho. Isso não afetará os recursos criados para o tutorial.
   3. Clique em Avançar
4. Clique em Criar.

Na área de trabalho Configurações, na secção Variáveis:

1. Localize a variável " existing_ssh_key_name.
   1. Use o menu (veja) para Editar seu valor.
   2. Configure o valor para o nome da chave SSH usada para este tutorial.
   3. Salvar.
2. Localize a variável " provider_crn
   1. Editar seu valor.
   2. Configure o valor para o CRN Private Path service obtido anteriormente.
   3. Salvar.
3. Opcionalmente, também é possível ajustar os valores de outras variáveis como region, basename. region devem corresponder ao valor configurado na área de trabalho pps-provider.

Finalmente crie os recursos:

1. Clique em Aplicar plano.
2. Aguarde o Schematics para concluir o fornecimento dos recursos.

Revise os recursos e aplicativos do consumidor

Executar Schematics para o consumidor cria os recursos a seguir:

• uma nuvem privada virtual (VPC),
• duas sub-redes,
• uma instância de servidor virtual em cada sub-rede,
• um gateway de terminal privado virtual configurado com o CRN Private Path service e com um endereço IP em cada sub-rede

1. Navegue para Instâncias de servidor virtual para revisar as instâncias provisionados
2. Acesse Gateways do terminal privado virtual e observe que o gateway do terminal está marcado como Pendente.

Nesse estágio, o consumidor ainda não pode acessar o aplicativo do provedor. Ele está esperando a solicitação de conexão para o Private Path service ser revisado e permitido.

Aprovar a solicitação do consumidor

Atuando como o provedor do aplicativo,

1. Acesse o lista de serviços do Private Path.

2. Observe que o Private Path service que você criou tem solicitações de conexão pendentes a serem revisadas

3. Selecione o Private Path service.

4. Na tabela Solicitações de conexão localize a solicitação do consumidor.

5. Use o menu () para Permitir a conexão.

   O diálogo Permitir solicitação de conexão fornece uma opção para criar uma política para permitir automaticamente todas as solicitações do mesmo ID da conta. Deixe desmarcado por enquanto. No futuro, isso pode acelerar o processo de os consumidores solicitarem conexões dessa conta.

6. Clique em Permissão..

Testar a conectividade do consumidor para o provedor

Atuando como consumidor novamente,

1. Acesse Gateways do terminal privado virtual e observe que o gateway do terminal foi movido para Stable.

2. Anote o Terminal em serviço Ele deve ser vpc-pps.example.com, a menos que você tenha especificado um basename customizado durante a configuração da área de trabalho

3. Navegue para Instâncias de servidor virtual e localize o IP flutuante designado a uma das instâncias do consumidor As instâncias são nomeadas como vpc-pps-consumer-vsi-us-south-1 ou vpc-pps-consumer-vsi-us-south-2

4. Abra uma conexão SSH para uma das instâncias..

   ssh root@<floating-ip>
   

5. Acesse o aplicativo do provedor chamando o terminal em serviço.

   curl http://vpc-pps.example.com
   

   A saída deve ser semelhante a:

   Hello world from vpc-pps-provider-vsi-us-south-2
   

   Pode levar alguns minutos para que o nome de domínio seja resolvido corretamente para as instâncias de servidor virtual

6. Repita o comando curl várias vezes Observe como ele mostra uma saída diferente à medida que passa por todas as instâncias de servidor virtual conectadas ao conjunto de back-end do Private Path NLB.

Parabéns, seu Private Path service está funcionando conforme o esperado e está pronto para ser publicado para outros consumirem.

Expandir o tutorial

Este tutorial foca nos fundamentos do Private Path service com um aplicativo provedor em um VPC e um consumidor em outro VPC, todos dentro da mesma conta:

• A próxima etapa será publicar o Private Path service. Depois de publicado, os clientes em outras contas do IBM Cloud podem fazer uma solicitação de conexão para acessar o aplicativo.
• Comunicando informações de conexão aos consumidores, revisando solicitações de conexão e aperfeiçoando o processo com políticas de conta também fazem parte da integração bem-sucedida de consumidores.

Remover recursos

Para remover os recursos criados para este tutorial:

1. Acesse Schematics

   1. Selecione o espaço de trabalho " pps-consumer.
   2. Em Ações ..., selecione Destruir recursos.
   3. Digite pps-consumer e clique em Destruir..
   4. Aguarde Schematics para concluir a tarefa.
   5. Depois de concluído, selecione Excluir área de trabalho no menu Ações ....
   6. Digite pps-consumer e clique em Excluir..

2. Repita as mesmas etapas com a área de trabalho do pps-provider

   Pode ser necessário tentar novamente os Recursos de Destruição após alguns minutos se a exclusão da área de trabalho falhou porque o grupo de recursos não pôde ser excluído.

Dependendo do recurso, ele não é excluído imediatamente, mas retido (por padrão por 7 dias). É possível recuperar o recurso excluindo-o permanentemente ou restaurando-o dentro do período de retenção. Consulte este documento sobre como usar a recuperação de recurso.