Criar e Atualizar Pontos Finais Alternativos

Após adicionar o primeiro ponto final personalizado (ponto final principal) à sua instância, você precisará usar a linha de comando em um shell quando quiser atualizar a instância para adicionar mais pontos finais (pontos finais alternativos). A Console do OCI fornece um editor de shell que você pode usar para adicionar e atualizar pontos finais alternativos.

Além disso, quando chegar a hora de atualizar o certificado SSL em um segredo, você precisará usar a linha de comando para acionar uma atualização de instância após atualizar o segredo no vault associado. Para obter detalhes, consulte Atualizar um Segredo em um Vault.

Observação

Se você mesmo não estiver gerenciando sua instância, o que significa que sua instância foi gerenciada pela Oracle, depois que você for migrado para sua própria tenancy, será responsável por gerenciar os pontos finais alternativos e os vaults associados da sua instância. Isso inclui a atualização dos certificados SSL para pontos finais alternativos.

Para criar e atualizar pontos finais alternativos em uma instância do Visual Builder, use a linha de comando para enviar um payload JSON por meio do comandovb-instance update. No comando, o payload é incluído como parâmetros alternate-custom-endpoints. Para obter detalhes sobre o comando vb-instance update, consulte vb-instance update no OCI CLI Command Reference e UpdateCustomEndpointDetails Reference na API do Visual Builder.

ADVERTÊNCIA:

Ao atualizar detalhes do ponto final alternativo usando a linha de comando, sua carga útil deve incluir os detalhes de cada ponto final alternativo na sua instância, incluindo os detalhes dos pontos finais que não estão sendo atualizados. Por exemplo, se sua instância tiver dois pontos finais alternativos e você quiser atualizar o segredo no vault para um dos pontos finais alternativos, o payload ainda deverá conter os detalhes de ambos os pontos finais alternativos.

Para criar ou atualizar um ponto final alternativo:

  1. Na página Instâncias do Visual Builder, localize a instância com a qual você deseja trabalhar e abra sua página de detalhes. Se precisar de ajuda para localizar a página Instâncias ou a instância, consulte Exibir e Gerenciar a Instância do Visual Builder.
  2. Selecione o menu Ferramentas do desenvolvedor no cabeçalho e, em seguida, selecione Cloud Shell para abrir o editor do Cloud Shell.


    O editor do Cloud Shell é aberto na parte inferior da janela do navegador:



    Pode levar um minuto para o editor ser inicializado.

  3. No editor de shell, verifique se o shell está funcionando corretamente.

    O editor de shell é sensível ao contexto, de modo que o comando retorna detalhes sobre a instância aberta na página de detalhes.

    Informe o seguinte comando get no prompt:

    oci visual-builder vb-instance get --id <OCID>

    Para o parâmetro id, você precisa fornecer o OCID da instância, que é listado na guia Detalhes. Para copiar o <OCID> da instância, clique em Copiar ao lado do OCID.

    Ao executar o comando, você deverá ver detalhes sobre a instância no editor de shell.

  4. Execute o comando update no editor de shell.

    Você usa o comando update para atualizar pontos finais alternativos existentes e criar novos pontos finais alternativos.

    Observação

    No comando update, você precisa fornecer o OCID da instância para o parâmetro id e incluir um array JSON que contenha os detalhes de cada ponto final alternativo na instância como o payload do parâmetro alternate-custom-endpoints:

    • Se você estiver usando um vault para armazenar um certificado para um ponto final alternativo, precisará incluir no payload o nome do host e o OCID do segredo do certificado de cada ponto final:

      --alternate-custom-endpoints '[{"hostname":"hostname.com","certificateSecretId":"<SECRET_ID>"}]'
    • Se você estiver usando o WAF para um certificado de ponto final alternativo, só precisará incluir o nome do host no payload:

      --alternate-custom-endpoints '[{"hostname":"hostname.com"}]'
    • Se você não incluir um ponto final no payload quando executar o comando update, o ponto final será excluído.

    • Para atualizar os detalhes de um ponto final alternativo:

      Execute o comando update. Ao executar o comando, confirme se você incluiu os detalhes de cada ponto final alternativo na instância. Por exemplo, se você tiver dois pontos finais alternativos na sua instância e quiser atualizar um deles, o comando update poderá ter a seguinte aparência:

      oci visual-builder vb-instance update --id <VB_INSTANCE_OCID> 
      --alternate-custom-endpoints '[{"hostname":"hostname.com","certificateSecretId":"<SECRET_ID>"},
      {"hostname":"hostname1.com","certificateSecretId":"<SECRET_ID>"}]'

      Observe que, embora nesse caso você esteja atualizando apenas um ponto final, o payload do parâmetro alternate-custom-endpoints contém os detalhes dos dois pontos finais alternativos (hostname.com e hostname1.com).

    • Para criar um novo ponto final alternativo:

      Por padrão, você pode criar até três pontos finais alternativos em sua instância. Se precisar de mais do que isso, entre em contato com o VB Dev Ops para aumentar o limite.

      1. Confirme se você configurou o nome do host para o novo ponto final alternativo usando o WAF ou um vault e um segredo.

        Para obter detalhes, consulte Criar um Balanceador de Carga e Configurar um Nome de Host e Configurar um Vault para um Ponto Final Personalizado.

      2. Execute o comando update. Quando você executar o comando, além dos detalhes do novo ponto final, confirme se você incluiu os detalhes de cada ponto final alternativo existente na instância, da mesma forma que faria ao atualizar os detalhes do ponto final alternativo. Por exemplo, se você tiver um ponto final alternativo na sua instância (hostname.com) e quiser criar um novo (hostname1.com), o comando update poderá ter a seguinte aparência:
        oci visual-builder vb-instance update --id <VB_INSTANCE_OCID> 
        --alternate-custom-endpoints '[{"hostname":"hostname.com","certificateSecretId":"<SECRET_ID>"},
        {"hostname":"hostname1.com","certificateSecretId":"<SECRET_ID>"}]'

        Observe que os detalhes que você precisa fornecer no comando update ao atualizar os detalhes do ponto final alternativo são os mesmos da criação de um novo ponto final alternativo.

      3. Configure o registro de DNS para o novo ponto final.

        Após criar um ponto final alternativo, para configurar o registro de DNS para o novo ponto final, você precisa fornecer o CNAME (o nome do host) ou o endereço IP do balanceador de carga.

        Observação

        O balanceador de carga de um ponto final alternativo pode ser diferente do balanceador de carga da instância. Você precisará registrar um tíquete no VB Dev Ops para verificar os detalhes. Observe que essa é uma ação única; portanto, uma vez configurada, os detalhes do balanceador de carga não serão alterados.