Crear y actualizar puntos finales alternativos

Después de agregar el primer punto final personalizado (punto final principal) a la instancia, debe utilizar la línea de comandos en un shell cuando desee actualizar la instancia para agregar más puntos finales (puntos finales alternativos). La consola de OCI proporciona un editor de shell que puede utilizar para agregar y actualizar puntos finales alternativos.

Además, cuando llegue el momento de actualizar el certificado SSL en un secreto, debe utilizar la línea de comandos para disparar una actualización de instancia después de actualizar el secreto en el almacén asociado. Para obtener más información, consulte Actualización de un secreto en un almacén.

Nota

Si no ha gestionado su instancia usted mismo, lo que significa que Oracle ha gestionado su instancia, después de migrarla a su propio arrendamiento, será responsable de gestionar los puntos finales alternativos y los almacenes asociados de su instancia. Esto incluye la actualización de los certificados SSL para puntos finales alternativos.

Para crear y actualizar puntos finales alternativos en una instancia de Visual Builder, utilice la línea de comandos para enviar una carga útil de JSON mediante el comandovb-instance update. En el comando, la carga útil se incluye como parámetros alternate-custom-endpoints. Para obtener más información sobre el comando vb-instance update, consulte vb-instance update en la Referencia de comandos de la CLI de OCI y Referencia UpdateCustomEndpointDetails en la API de Visual Builder.

ADVERTENCIA:

Al actualizar los detalles de punto final alternativo mediante la línea de comandos, la carga útil debe incluir los detalles de cada punto final alternativo de la instancia, incluidos los detalles de los puntos finales que no se están actualizando. Por ejemplo, si la instancia tiene dos puntos finales alternativos y desea actualizar el secreto en el almacén para uno de los puntos finales alternativos, la carga útil debe contener los detalles de ambos puntos finales alternativos.

Para crear o actualizar un punto final alternativo:

  1. En la página Instancias de Visual Builder, busque la instancia con la que desea trabajar y abra la página de detalles. Si necesita ayuda para buscar la página Instancias o la instancia, consulte Visualización y gestión de la instancia de Visual Builder.
  2. Seleccione el menú Herramientas para desarrolladores en la cabecera y, a continuación, seleccione Cloud Shell para abrir el editor de Cloud Shell.


    El editor de Cloud Shell se abre en la parte inferior de la ventana del explorador:



    Puede que el editor tarde un minuto en inicializarse.

  3. En el editor de shell, compruebe que el shell funciona correctamente.

    El editor de shell es sensible al contexto, por lo que el comando devuelve detalles sobre la instancia abierta en la página de detalles.

    Introduzca el siguiente comando get en el símbolo del sistema:

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

    Para el parámetro id, debe proporcionar el OCID de la instancia, que se muestra en el separador Detalles. Para copiar el <OCID> de la instancia, haga clic en Copiar junto al OCID.

    Al ejecutar el comando, debería ver detalles sobre la instancia en el editor de shell.

  4. Ejecute el comando update en el editor de shell.

    El comando update se utiliza para actualizar los puntos finales alternativos existentes y para crear nuevos puntos finales alternativos.

    Nota

    En el comando update, debe proporcionar el OCID de la instancia para el parámetro id e incluir una matriz JSON que contenga los detalles de cada punto final alternativo de la instancia como carga útil del parámetro alternate-custom-endpoints:

    • Si utiliza un almacén para almacenar un certificado para un punto final alternativo, debe incluir en la carga útil el nombre de host y el OCID del secreto de certificado de cada punto final:

      --alternate-custom-endpoints '[{"hostname":"hostname.com","certificateSecretId":"<SECRET_ID>"}]'
    • Si utiliza WAF para un certificado de punto final alternativo, solo tiene que incluir el nombre de host en la carga útil:

      --alternate-custom-endpoints '[{"hostname":"hostname.com"}]'
    • Si no puede incluir un punto final en la carga útil al ejecutar el comando update, se suprime el punto final.

    • Para actualizar los detalles de un punto final alternativo:

      Ejecute el comando update. Al ejecutar el comando, confirme que ha incluido los detalles de cada punto final alternativo en la instancia. Por ejemplo, si tiene dos puntos finales alternativos en la instancia y desea actualizar uno de ellos, el comando update podría tener un aspecto similar al siguiente:

      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>"}]'

      Tenga en cuenta que, aunque en este caso solo está actualizando un punto final, la carga útil del parámetro alternate-custom-endpoints contiene los detalles de los dos puntos finales alternativos (hostname.com y hostname1.com).

    • Para crear un nuevo punto final alternativo:

      Por defecto, puede crear hasta tres puntos finales alternativos en la instancia. Si necesita más que esto, póngase en contacto con las operaciones de desarrollo de VB para aumentar el límite.

      1. Confirme que ha configurado el nombre de host para el nuevo punto final alternativo mediante WAF o un almacén y un secreto.

        Para obtener más información, consulte Creación de un equilibrador de carga y configuración de un nombre de host y Configuración de un almacén para un punto final personalizado.

      2. Ejecute el comando update. Al ejecutar el comando, además de los detalles del nuevo punto final, confirme que ha incluido los detalles de cada punto final alternativo existente en la instancia, tal como lo haría al actualizar los detalles del punto final alternativo. Por ejemplo, si tiene un punto final alternativo en la instancia (hostname.com) y desea crear uno nuevo (hostname1.com), el comando update podría tener un aspecto similar al siguiente:
        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>"}]'

        Tenga en cuenta que los detalles que debe proporcionar en el comando update al actualizar los detalles de punto final alternativo son los mismos que al crear un nuevo punto final alternativo.

      3. Configure el registro de DNS para el nuevo punto final.

        Después de crear un punto final alternativo, para configurar el registro DNS para el nuevo punto final, debe proporcionar el CNAME (nombre de host) o la dirección IP del equilibrador de carga.

        Nota

        El equilibrador de carga de un punto final alternativo puede ser diferente del equilibrador de carga de la instancia. Tendrá que presentar un ticket con operaciones de desarrollo de VB para verificar los detalles. Tenga en cuenta que se trata de una acción puntual, por lo que una vez configurada, los detalles del equilibrador de carga no cambiarán.