Nachdem Sie der Instanz den ersten benutzerdefinierten Endpunkt (primären Endpunkt) hinzugefügt haben, müssen Sie die Befehlszeile in einer Shell verwenden, wenn Sie die Instanz aktualisieren möchten, um weitere Endpunkte (alternative Endpunkte) hinzuzufügen. Die OCI-Konsole bietet einen Shell-Editor, mit dem Sie alternative Endpunkte hinzufügen und aktualisieren können.

1. Suchen Sie auf der Seite "Visual Builder-Instanzen" die Instanz, mit der Sie arbeiten möchten, und öffnen Sie die Detailseite. Wenn Sie Hilfe beim Suchen der Seite "Instanzen" oder der Instanz benötigen, finden Sie weitere Informationen unter Visual Builder-Instanz anzeigen und verwalten.
2. Wählen Sie im Header das Menü Entwicklertools aus, und wählen Sie Cloud Shell aus, um den Cloud Shell-Editor zu öffnen.
   
   

   
   Beschreibung der Abbildung admin-console-developertools.png

   
   

   Der Cloud-Shell-Editor wird unten im Browserfenster geöffnet:

   
   

   
   Beschreibung der Abbildung admin-console-cloudshell.png

   
   

   Es kann eine Minute dauern, bis der Editor initialisiert wird.

3. Prüfen Sie im Shell-Editor, ob die Shell korrekt funktioniert.

   Der Shell-Editor ist kontextabhängig. Daher gibt der Befehl Details zur Instanz zurück, die auf der Detailseite geöffnet ist.

   Geben Sie den folgenden get-Befehl an der Eingabeaufforderung ein:

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

   Für den Parameter id müssen Sie die OCID der Instanz angeben, die auf der Registerkarte "Details" aufgeführt ist. Um die <OCID> der Instanz zu kopieren, klicken Sie neben der OCID auf Kopieren.

   Wenn Sie den Befehl ausführen, sollten Sie Details zur Instanz im Shell-Editor anzeigen.

4. Führen Sie den Befehl update im Shell-Editor aus.

   Mit dem Befehl update können Sie vorhandene alternative Endpunkte aktualisieren und neue alternative Endpunkte erstellen.

   Hinweis
   
   

   Im Befehl update müssen Sie die OCID der Instanz für den Parameter id angeben und ein JSON-Array mit den Details jedes alternativen Endpunkts in der Instanz als Payload des Parameters alternate-custom-endpoints aufnehmen:

   • Wenn Sie ein Zertifikat für einen alternativen Endpunkt mit einem Vault speichern, müssen Sie den Hostnamen und die Zertifikats-Secret-OCID jedes Endpunkts in die Payload aufnehmen:

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

   • Wenn Sie WAF für das Zertifikat eines alternativen Endpunkts verwenden, müssen Sie nur den Hostnamen in die Payload aufnehmen:

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

   • Wenn Sie beim Ausführen des Befehls update keinen Endpunkt in die Payload aufnehmen, wird der Endpunkt gelöscht.

   • So aktualisieren Sie die Details eines alternativen Endpunkts:

     Führen Sie den Befehl update aus. Wenn Sie den Befehl ausführen, bestätigen Sie, dass Sie die Details jedes alternativen Endpunkts in die Instanz aufgenommen haben. Beispiel: Wenn Sie zwei alternative Endpunkte in Ihrer Instanz haben und einen davon aktualisieren möchten, sieht der Befehl update in etwa wie folgt aus:

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

     Beachten Sie, dass die Payload des Parameters alternate-custom-endpoints die Details für die beiden alternativen Endpunkte (hostname.com und hostname1.com) enthält, obwohl Sie in diesem Fall nur einen Endpunkt aktualisieren.

   • So erstellen Sie einen neuen alternativen Endpunkt:

     Standardmäßig können Sie bis zu drei alternative Endpunkte in Ihrer Instanz erstellen. Wenn Sie mehr als dies benötigen, wenden Sie sich an VB Dev Ops, um das Limit zu erhöhen.

     1. Bestätigen Sie, dass Sie den Hostnamen für den neuen alternativen Endpunkt mit WAF oder einem Vault und Secret konfiguriert haben.

        Weitere Informationen finden Sie unter Load Balancer erstellen und Hostnamen konfigurieren und Vault für einen benutzerdefinierten Endpunkt konfigurieren.

     2. Führen Sie den Befehl update aus. Wenn Sie den Befehl ausführen, bestätigen Sie zusätzlich zu den Details des neuen Endpunkts, dass Sie die Details jedes vorhandenen alternativen Endpunkts in die Instanz aufgenommen haben, genau wie beim Aktualisieren der Details des alternativen Endpunkts. Beispiel: Wenn Sie einen alternativen Endpunkt in Ihrer Instanz (hostname.com) haben und einen neuen Endpunkt (hostname1.com) erstellen möchten, sieht der Befehl update möglicherweise folgendermaßen aus:

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

        Beachten Sie, dass die Details, die Sie beim Aktualisieren der Details des alternativen Endpunkts im Befehl update angeben müssen, mit denen beim Erstellen eines neuen alternativen Endpunkts übereinstimmen.

     3. Konfigurieren Sie den DNS-Datensatz für den neuen Endpunkt.

        Nachdem Sie einen alternativen Endpunkt erstellt haben, müssen Sie zum Konfigurieren des DNS-Datensatzes für den neuen Endpunkt entweder den CNAME (den Hostnamen) oder die IP-Adresse des Load Balancers angeben.

        Hinweis
        
        Der Load Balancer für einen alternativen Endpunkt kann sich vom Load Balancer für die Instanz unterscheiden. Sie müssen ein Ticket bei VB Dev Ops einreichen, um die Details zu überprüfen. Beachten Sie, dass dies eine einmalige Aktion ist. Nach der Konfiguration werden die Load-Balancer-Details daher nicht geändert.