Après avoir ajouté la première adresse personnalisée (adresse principale) à votre instance, vous devez utiliser la ligne de commande dans un shell pour mettre à jour l'instance afin d'ajouter d'autres adresses (adresses de remplacement). La console OCI fournit un éditeur de shell que vous pouvez utiliser pour ajouter et mettre à jour d'autres adresses.

1. Sur la page Instances Visual Builder, recherchez l'instance à utiliser et ouvrez sa page de détails. Si vous avez besoin d'aide pour trouver la page Instances ou l'instance, reportez-vous à Affichage et gestion de l'instance Visual Builder.
2. Sélectionnez le menu Outils de développeur dans l'en-tête, puis sélectionnez Cloud Shell pour ouvrir l'éditeur Cloud Shell.
   
   

   
   Description de l'image admin-console-developertools.png

   
   

   L'éditeur de shell Cloud s'ouvre en bas de la fenêtre du navigateur :

   
   

   
   Description de l'image admin-console-cloudshell.png

   
   

   L'initialisation de l'éditeur peut prendre une minute.

3. Dans l'éditeur de shell, vérifiez que le shell fonctionne correctement.

   L'éditeur de shell est contextuel, de sorte que la commande renvoie les détails de l'instance ouverte sur la page de détails.

   Entrez la commande get suivante à l'invite :

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

   Pour le paramètre id, vous devez fournir l'OCID de l'instance, qui est répertorié dans l'onglet Détails. Pour copier l'<OCID> de l'instance, cliquez sur Copier en regard de l'OCID.

   Lorsque vous exécutez la commande, vous devez voir les détails de l'instance dans l'éditeur de shell.

4. Exécutez la commande update dans l'éditeur de shell.

   Utilisez la commande update pour mettre à jour des adresses alternatives existantes et en créer de nouvelles.

   Remarque
   
   

   Dans la commande update, vous devez fournir l'OCID de l'instance pour le paramètre id, et inclure un tableau JSON contenant les détails de chaque adresse alternative dans l'instance en tant que charge utile du paramètre alternate-custom-endpoints :

   • Si vous utilisez un coffre pour stocker un certificat pour une autre adresse, vous devez inclure dans la charge utile le nom d'hôte et l'OCID de clé secrète de certificat de chaque adresse :

     --alternate-custom-endpoints '[{"hostname":"hostname.com","certificateSecretId":"<SECRET_ID>"}]'

   • Si vous utilisez WAF pour un certificat d'adresse de remplacement, vous devez uniquement inclure le nom d'hôte dans la charge utile :

     --alternate-custom-endpoints '[{"hostname":"hostname.com"}]'

   • Si vous n'incluez pas d'adresse dans la charge utile lorsque vous exécutez la commande update, l'adresse est supprimée.

   • Pour mettre à jour les détails d'une autre adresse, procédez comme suit :

     Exécutez la commande update. Lorsque vous exécutez la commande, vérifiez que vous avez inclus les détails de chaque autre adresse de l'instance. Par exemple, si votre instance comporte deux adresses alternatives et que vous voulez en mettre à jour l'une, la commande update peut se présenter comme suit :

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

     Bien que dans ce cas, vous ne mettiez à jour qu'une seule adresse, la charge utile du paramètre alternate-custom-endpoints contient les détails des deux autres adresses (hostname.com et hostname1.com).

   • Pour créer une autre adresse, procédez comme suit :

     Par défaut, vous pouvez créer jusqu'à trois autres adresses dans votre instance. Si vous avez besoin de plus, contactez VB Dev Ops pour augmenter la limite.

     1. Vérifiez que vous avez configuré le nom d'hôte pour la nouvelle adresse alternative à l'aide de WAF ou d'un coffre et d'une clé secrète.

        Pour plus de détails, reportez-vous à Création d'un équilibreur de charge et configuration d'un nom d'hôte et à Configuration d'un coffre pour une adresse personnalisée.

     2. Exécutez la commande update. Lorsque vous exécutez la commande, en plus des détails de la nouvelle adresse, vérifiez que vous avez inclus les détails de chaque autre adresse existante dans l'instance, comme vous le feriez lors de la mise à jour des détails de l'autre adresse. Par exemple, si votre instance contient une autre adresse (hostname.com) et que vous voulez en créer une (hostname1.com), la commande update peut se présenter comme suit :

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

        Les détails que vous devez fournir dans la commande update lors de la mise à jour des détails d'autre adresse sont les mêmes que lors de la création d'une autre adresse.

     3. Configurez l'enregistrement DNS pour la nouvelle adresse.

        Après avoir créé une autre adresse, pour configurer l'enregistrement DNS de la nouvelle adresse, vous devez fournir le CNAME (nom d'hôte) ou l'adresse IP de l'équilibreur de charge.

        Remarque
        
        L'équilibreur de charge d'une autre adresse peut être différent de l'équilibreur de charge de l'instance. Vous devrez déposer un ticket auprès de VB Dev Ops pour vérifier les détails. Il s'agit d'une action unique. Une fois configurée, les détails de l'équilibreur de charge ne changeront pas.