Projekt für Entwicklung erstellen und einrichten

1. Melden Sie sich bei VB Studio an. Siehe Auf VB Studio von der Oracle Cloud-Homepage zugreifen.
2. Klicken Sie auf der Seite "Organisation" auf + Erstellen.
3. Geben Sie auf der Seite Projektdetails einen eindeutigen Namen und eine eindeutige Beschreibung für das Projekt ein.
4. Wählen Sie unter Sicherheit die Datenschutzeinstellung des Projekts aus.

   Ein privates Projekt ist nur für eingeladene Benutzer zugänglich. Benutzer, die nicht eingeladen sind, können nicht darauf zugreifen oder Änderungen daran vornehmen. Sie können Benutzer nach der Erstellung des Projekts einladen.

   Ein gemeinsames Projekt ist für alle Benutzer der Organisation zugänglich. Jeder Benutzer kann den Quellcode anzeigen, Probleme erstellen oder aktualisieren, Wiki-Seiten bearbeiten und mit Projekt-Builds interagieren. Nur eingeladene Benutzer können jedoch Aktualisierungen am Quellcode in Git-Repositorys vornehmen, Build-Jobs erstellen und ausführen sowie Deployment-Vorgänge ausführen.

5. Geben Sie unter Bevorzugte Sprache die Sprache für die E-Mail-Benachrichtigungen an, die Ihre Projektbenutzer erhalten sollen. Sie können die Sprache ändern, in der die Benutzeroberfläche in Ihren Benutzereinstellungen angezeigt wird.
6. Klicken Sie auf Weiter.
7. Wählen Sie auf der Seite Vorlage die Vorlage Leeres Projekt aus, und klicken Sie auf Weiter.
8. Wählen Sie auf der Seite "Eigenschaften" den Wiki-Markup-Typ aus, und klicken Sie auf Fertigstellen.

Nachdem das Projekt bereitgestellt wurde, wird die Projekt-Homepage geöffnet, auf der Sie eine Übersicht über die Provisioning-Aktivitäten des Projekts anzeigen können. Prüfen Sie den Aktivitätsfeed auf Fehler.

1. Klicken Sie im Navigationsmenü auf Umgebungen und dann auf + Umgebung erstellen.
2. Unter Umgebungsname und Beschreibung geben Sie einen eindeutigen Namen und die Beschreibung an, und klicken Sie auf Erstellen.
3. Klicken Sie auf der Registerkarte Serviceinstanzen der Umgebung auf Instanz hinzufügen.
4. Suchen Sie die Visual Builder-Instanz, und fügen Sie sie hinzu:
   1. Stellen Sie sicher, dass der Instanztyp auf Visual Builder und "Instanz hinzufügen mit" auf Instanzliste gesetzt ist. Dies ist der bevorzugte Ansatz.
   2. Klicken Sie neben OCI-Details auf , wählen Sie die Region und das Compartment aus, in der sich Ihre Visual Builder-Instanz befindet, und klicken Sie auf Aktualisieren.
   3. Wählen Sie die Visual Builder-Instanz aus der Instanzliste des ausgewählten Compartments aus, und klicken Sie auf Hinzufügen.

   Wenn die hinzuzufügende Instanz nicht angezeigt wird (weil sie mit einem anderen OCI-Account verbunden ist), wählen Sie unter "Instanz hinzufügen mit" die Option Visual Builder-Zugangsdaten aus. Geben Sie unter Basis-URL die URL der Visual Builder-Instanz ein, aktualisieren Sie gegebenenfalls den Instanznamen, geben Sie die Zugangsdaten eines Benutzers ein, der auf die Visual Builder-Instanz zugreifen kann, unter Benutzername und Kennwort, und klicken Sie auf Hinzufügen. Beachten Sie jedoch, dass Sie mit diesem Ansatz OAuth nicht für diese Umgebung im Deployment-Build-Job einrichten können, der von der Aktion "Veröffentlichen" im Designer verwendet wird (je nach Setup).

5. Wenn Ihre Zielinstanz eine andere Identitätsdomain als Ihre VB Studio-Instanz verwendet, werden OAuth-Token (über dreibeinige OAuth-Abläufe) verwendet, um den programmgesteuerten Zugriff auf die Instanz zu sichern. Bevor OAuth-Token erstellt werden können, müssen Sie eine Autorisierung angeben, um OAuth-Token abzurufen. Klicken Sie auf Autorisieren, wenn Sie dazu aufgefordert werden, und melden Sie sich dann mit Zugangsdaten an, um eine Verbindung zur Zielinstanz herzustellen und diese bereitzustellen.

Wenn Sie fertig sind, wird im Feed "Letzte Aktivitäten" auf der Projekthomepage die neu erstellte Umgebung zusammen mit der hinzugefügten Visual Builder-Instanz aufgeführt.

1. Klicken Sie im Navigationsfenster auf Workspaces .
2. Klicken Sie auf Neu, und wählen Sie Neue visuelle Anwendung aus.
3. Fügen Sie unter Workspace-Name einen Namen für Ihren Workspace hinzu.
4. Wählen Sie unter Entwicklungsumgebung die Umgebung aus, die Sie im vorherigen Schritt erstellt haben.
5. Ändern Sie unter Visuelle Anwendungsvorlage nicht den Standardwert (Standard-VB-Anwendung).
6. Wählen Sie unter Git-Repository die Option Neues Repository erstellen aus, und geben Sie einen Repository-Namen und einen Arbeitsverzweigungsnamen ein.

Wenn eine visuelle Anwendung über einen neuen Workspace erstellt wird, ist sie so konfiguriert, dass sie direkt in der Visual Builder-Entwicklungsinstanz bereitgestellt wird, ohne dass eine CI/CD-Pipeline verwendet wird. Bei Bedarf können Sie stattdessen die CI/CD-Pipeline für die Zielverzweigung aktivieren, zu der Sie zusammenführen.

Wenn Sie CI/CD-Pipelines nicht für das Deployment verwenden, überspringen Sie diesen Schritt.

1. Klicken Sie im Navigationsmenü von Visual Builder Studio auf Builds .
2. Klicken Sie auf der Registerkarte Jobs auf den Deployment-Job. Wenn Sie einen Workspace erstellen, werden die Packaging- und Deployment-Jobs automatisch erstellt, und der Name des Repositorys wird übernommen. (Sie werden jedoch deaktiviert, bis Sie sie aktivieren.)
3. Klicken Sie auf Konfigurieren und dann auf die Registerkarte Schritte.
4. Stellen Sie unter Zielinstanz sicher, dass die in Schritt 2 erstellte Umgebung ausgewählt ist.

5. Geben Sie im Abschnitt "Autorisierung" den Autorisierungstyp an, um diesen Build-Schritt auszuführen. Wenn OAuth verwenden standardmäßig ausgewählt ist, wird die Meldung Authorization is required angezeigt, die angibt, dass dieser Build-Schritt eine einmalige Autorisierung benötigt, um OAuth-Anforderungen an die Visual Builder-Instanz Ihrer Umgebung zu verarbeiten. Klicken Sie auf Autorisieren, und geben Sie Zugangsdaten für den Zugriff auf Ihre Visual Builder-Instanz ein. Sie können den Job auch manuell ausführen und die Zugangsdaten eingeben, wenn Sie dazu aufgefordert werden.

   In beiden Fällen wird empfohlen, die OAuth-Verbindung während der anfänglichen Konfiguration zu autorisieren. Wenn Sie diesen Schritt überspringen, können Sie Ihre Änderungen nicht im Designer veröffentlichen. Sie müssen die erforderliche Autorisierung abschließen, bevor Sie versuchen, Änderungen bereitzustellen.

   Nach der Autorisierung wird die Meldung Authorization has been provided angezeigt.

   Hinweis
   
   OAuth ist der empfohlene Autorisierungstyp. Verwenden Sie die Basisauthentifizierung nur, wenn Probleme beim Einrichten einer OAuth-Verbindung auftreten. Um die Basisauthentifizierung zu verwenden, wählen Sie Basisauthentifizierung verwenden aus, und geben Sie dann die Zugangsdaten eines Benutzers ein, der auf die Visual Builder-Instanz zugreifen kann, unter Benutzername und Kennwort.

   OAuth-Token (Zugriff und Aktualisierung) werden während der regulären Verwendung neu gestartet. Ein Aktualisierungstoken wird verwendet, um ein Zugriffstoken abzurufen, wenn ein Benutzer auf die Zielinstanz zugreift. Dieses Aktualisierungstoken ist in der Regel sieben Tage lang gültig. (Die Tokenablaufzeit wird in der IDCS-Ressourcenanwendung festgelegt und kann je nach Ihren Sicherheitsanforderungen unterschiedlich sein.) Wenn sich der Benutzer innerhalb des Zeitraums von sieben Tagen bei der Zielinstanz authentifiziert, generiert das aktive Aktualisierungstoken ein neues Zugriffstoken und ein neues Aktualisierungstoken. Dieser Zyklus wird unbegrenzt fortgesetzt, solange das Aktualisierungstoken gültig bleibt. Wenn das Aktualisierungstoken während längerer Zeiträume der Inaktivität abläuft (z.B. wenn Sie im Urlaub sind), klicken Sie auf Autorisierung erneuern (oder führen Sie den Job manuell aus, sodass Sie aufgefordert werden, abgelaufene OAuth-Token zu autorisieren).

6. (Optional) Wählen Sie Benutzerdefinierte Dateinamen verwenden aus, und fügen Sie Details zu benutzerdefinierten Dateinamen hinzu.
7. (Optional) Um die Standardversion der Anwendung zu überschreiben, geben Sie die neue Version in der Anwendungsversion an. Lassen Sie das Feld leer, um die in der Datei visual-application.json der Anwendung definierte Version zu verwenden.

   Deaktivieren Sie das Kontrollkästchen Anwendungsversion in URL einschließen nicht.

8. (Optional) Geben Sie unter Anwendungsprofil das Profil der Entwicklungsanwendung an. Lassen Sie das Feld leer, um das Standardprofil der Anwendung zu verwenden.

   Mit Anwendungsprofilen können Sie verschiedene Kombinationen von Servern und Sicherheitseinstellungen für jede Ihrer Umgebungen definieren und diese beim Deployment der Anwendung in einer Umgebung verwenden. Weitere Informationen finden Sie unter Was sind Anwendungsprofile?

9. (Optional) Um die Datenbank der vorhandenen Anwendung zu verwenden, wählen Sie in Datenmanagement die Option Vorhandene Umgebungsdaten beibehalten aus. Um eine bereinigte Datenbank für die Anwendung zu verwenden, wählen Sie in Datenmanagement die Option Bereinigte Datenbank verwenden aus.
10. Klicken Sie auf Speichern.