Produktions-Build-Jobs erstellen und konfigurieren

Bevor Sie Build-Jobs und Pipelines konfigurieren und ausführen, müssen Sie Folgendes wissen:

• Stellen Sie sicher, dass die Quell- und die Zielinstanz dasselbe Release aufweisen. Dabei werden dieselben Standard- und One-off-Patches in beiden Umgebungen eingespielt.
• Wenn Sie den Entwicklungs-Packaging-Job so konfiguriert haben, dass die in visual-application.json definierte Version der Anwendung überschrieben wird, rufen Sie die neue Version ab. Sie konfigurieren den Packaging-Job der Produktion so, dass er dieselbe Version verwendet.
• VB Studio kann stattdessen die Build-Jobs und die Pipeline für Sie erstellen und aktivieren. Wählen Sie im Einstellungseditor der Erweiterung unter "Erstellen und Veröffentlichen" die Produktionsverzweigung aus, und klicken Sie auf CI/CD-Pipeline erstellen. Anschließend können Sie die neu erstellten Build-Jobs nach Bedarf ändern. Beispiel: Im Deployment-Job ist das Deployment-Ziel immer die Umgebung, die mit dem Workspace verknüpft ist. Daher müssen Sie die Zielinstanz in die Produktionsinstanz ändern.

Der Packaging-Job generiert ein Erweiterungsartefakt, das für das Deployment in der Produktionsinstanz bereit ist.

1. Klicken Sie im linken Navigator auf Builds .
2. Klicken Sie auf der Registerkarte Jobs auf + Job erstellen.
3. Geben Sie im Dialogfeld "Neuer Job" unter Name einen eindeutigen Namen ein.
4. Geben Sie unter Beschreibung die Beschreibung des Jobs ein.
5. Wählen Sie unter Vorlage die Vorlage Systemstandard OL7 für Visual Builder aus.
6. Klicken Sie auf Erstellen.
7. Klicken Sie auf Konfigurieren .
8. Klicken Sie auf die Registerkarte Git.
9. Wählen Sie in der Liste Git hinzufügen die Option Git aus.
10. Wählen Sie unter Repository das Git-Repository aus. Wählen Sie unter Verzweigung oder Tag die Produktionsverzweigung aus.
11. Klicken Sie auf die Registerkarte Schritte.
12. Wählen Sie unter Schritt hinzufügen die Option Anwendungserweiterung und dann Package aus.
13. Standardmäßig vermindert der Packaging-Schritt den Quellcode der Anwendung, bevor der Build ausgeführt wird. Wenn Sie die Quelldateien nicht minifizieren möchten, deaktivieren Sie das Kontrollkästchen Erweiterung optimieren.

    Minifizierung ist ein Prozess, bei dem unnötige Zeichen (wie Leerräume, neue Zeilen und Kommentare) aus dem Quellcode entfernt und die Größe der Dateien reduziert werden, sodass die Übertragung von Dateien weniger Bandbreite und Speicherplatz verbraucht.

    Hinweis
    
    Wenn Sie das Kontrollkästchen Erweiterung optimieren deaktivieren, wird folgende Warnung angezeigt: Optimierung nicht ausgewählt. Packaging ohne eine Optimierung kann zu Performanceproblemen führen, daher sollten Sie diese Option nur zum Debugging oder zur Fehlerbehebung verwenden.
14. (Optional) Wenn Sie den Namen der Artefaktdatei ändern möchten, geben Sie unter Artefakt erstellen den neuen Namen ein. Als Best Practice wird empfohlen, den Standardwert extension.vx beizubehalten. Sie können ihn jedoch ändern.
    Wenn Sie sie ändern, müssen Sie auch den neuen Namen im Feld Zu archivierende Dateien (Schritt 18) sowie im Feld Artefakt erstellen des Deployment-Jobs verwenden. Siehe Build-Job für Produktions-Deployment erstellen.
15. (Optional) Wenn Sie den Entwicklungs-Packaging-Job so konfiguriert haben, dass die Standardversion der Erweiterung überschrieben wird, die in der Datei visual-application.json definiert ist, geben Sie dieselbe Version unter Erweiterungsversion an.
16. Klicken Sie im Fenster "Jobkonfiguration" auf die Registerkarte Nach Erstellung.
17. Wählen Sie unter Aktion nach Build hinzufügen die Option Artefakt-Archiver aus.
18. Geben Sie unter Zu archivierende Dateien den Build-Artefaktnamen ein.

    Sie können Platzhalter verwenden. Beispiel: *.vx. Stellen Sie sicher, dass Sie den Pfad für das Build-Artefakt der Anwendungserweiterung angeben.

    Wenn Sie einen Wert in das Feld Zielverzeichnis unter Artefakte kopieren für den Deployment-Job eingegeben haben, wird er als Unterverzeichnis des Workspace betrachtet und muss Teil des Artefaktpfads im Feld Artefakt erstellen sein.

19. Wenn Sie die alten Artefakte des Build verwerfen möchten, klicken Sie auf Einstellungen . Aktivieren Sie in der Registerkarte Allgemein das Kontrollkästchen Alte Builds verwerfen, und geben Sie die Verwerfen-Optionen an.
20. Klicken Sie auf Speichern.

Der Deployment-Job stellt das Artefakt der Erweiterung bereit, das im Packaging-Job generiert wurde, in der Produktionsinstanz der Oracle Cloud-Anwendung. Bevor Sie den Job erstellen, stellen Sie sicher, dass Sie über Zugangsdaten verfügen, mit denen VB Studio auf die PROD-Instanz der Oracle Cloud-Anwendung zugreifen kann.

1. Klicken Sie im linken Navigator auf Builds .
2. Klicken Sie auf der Registerkarte Jobs auf + Job erstellen.
3. Geben Sie im Dialogfeld "Neuer Job" unter Name einen eindeutigen Namen ein.
4. Geben Sie unter Beschreibung die Beschreibung des Jobs ein.
5. Wählen Sie unter Vorlage die Vorlage Systemstandard OL7 für Visual Builder aus.
6. Klicken Sie auf Erstellen.
7. Klicken Sie auf Konfigurieren .
8. Klicken Sie auf die Registerkarte Vor Erstellung.
9. Wählen Sie unter Aktion vor Erstellung hinzufügen die Option Artefakte kopieren aus.
10. Wählen Sie unter Aus Job den Packaging-Job aus, der das Artefakt der Erweiterung generiert hat.
11. Wählen Sie unter Welchen Build eine der folgenden Optionen aus:
    • Letzter erfolgreicher Build (Standard)
    • Letzter unbegrenzt beibehaltener Build
    • Upstream-Build in dieser Pipelineinstanz
    • Durch Permalink angegeben
    • Spezifischer Build
    • Von Build-Parameter angegeben

    Je nachdem, was Sie auswählen, werden Sie möglicherweise aufgefordert, auszuwählen, welcher Permalink-, Build- oder Build-Parameter verwendet werden soll.
12. Übernehmen Sie für andere Felder die Standardwerte, oder lassen Sie sie leer.
13. Klicken Sie auf die Registerkarte Schritte.
14. Wählen Sie unter Schritt hinzufügen die Option Anwendungserweiterung und dann Bereitstellen aus.

    Diese Abbildung zeigt die Seite "Build-Job bereitstellen", die teilweise ausgefüllt wurde.
    
    Beschreibung der Abbildung oracle-deploy-build-step.png
    

15. Wählen Sie unter Zielinstanz die Umgebung mit der Produktionsinstanz der Oracle Cloud-Anwendung aus.
16. 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 für diesen Build-Schritt eine einmalige Autorisierung erforderlich ist, um OAuth-Anforderungen an die Oracle Cloud Applications-Instanz Ihrer Umgebung zu verarbeiten. Klicken Sie auf Autorisieren, und geben Sie Zugangsdaten für den Zugriff auf Ihre Oracle Cloud Applications-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. Geben Sie dann die Zugangsdaten eines Benutzers ein, der auf die Oracle Cloud Applications-Instanz zugreifen kann, und zwar unter Benutzername und Kennwort. Diese Zugangsdaten müssen die eines lokalen Benutzers sein, keine föderierte Identität, und sie dürfen keine Multifaktor-Authentifizierung erfordern.

    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).

    Im Feld Build-Artefakt muss derselbe Artefaktname angezeigt werden, der im Packaging-Build-Schritt verwendet wurde. Bestätigen Sie diesen Wert, insbesondere wenn der Packaging-Job einen anderen Artefaktnamen als den Standardnamen extension.vx verwendet hat.
17. Klicken Sie auf Speichern.

Um den Zugriff einzuschränken, kann der Projekteigentümer einen Job als privat markieren. Benutzer, die keinen Zugriff haben, können den Build-Job auf der Seite Jobüberblick anzeigen. Sie können jedoch die Seite Jobdetails nicht anzeigen oder die Build-Details anzeigen. Außerdem können sie die Jobkonfiguration nicht anzeigen oder bearbeiten oder den Build-Job löschen/aktivieren/deaktivieren. Darüber hinaus kann der Projekteigentümer ein Glob-Muster verwenden, das in einer Regel definiert ist, um jeden Job zu schützen, dessen Name mit dem angegebenen Muster übereinstimmt.

1. Klicken Sie im linken Navigator auf Projektadministration .
2. Wählen Sie die Kachel Builds aus.
3. Wählen Sie die Registerkarte Jobschutz aus.

   Die Seite "Jobschutz" wird angezeigt.

   
   
   Beschreibung der Abbildung job-protection-page-initial.png
   

4. Wählen Sie im Bereich "Regeln nach" oberhalb der Liste "Jobs/Regeln" eines der folgenden Optionsfelder aus:
   • Wählen Sie Jobname aus, um einen Job aus der Liste auszuwählen.

     Wenn Ihr Projekt viele Jobs hat, können Sie Schwierigkeiten haben, den spezifischen Job zu finden, den Sie schützen möchten. Mit der Leiste Filterjob können Sie schnell den Job suchen, dem Sie die eingeschränkten Einstellungen hinzufügen möchten.

     Klicken Sie mit der rechten Maustaste auf die Jobliste, um zusätzliche Sortieroptionen anzuzeigen. Klicken Sie auf Nach Jobname sortieren oder Nach privatem Job sortieren, um die Liste entsprechend zu sortieren. Klicken Sie erneut auf die Sortieroption, um zwischen aufsteigender und absteigender Reihenfolge zu wechseln.

     
     
     

     Wenn ein Job über das Sperrsymbol verfügt, wurde er bereits geschützt. Die Einschränkungen eines geschützten Jobs können weiterhin geändert, entfernt oder die Liste der autorisierten Benutzer und Gruppen kann weiterhin geändert werden.

     Das Dialogfeld Jobschutz wird angezeigt.

     
     
     Beschreibung der Abbildung job-protection-open.png
     

     Wenn ein Job nicht direkt geschützt, sondern durch eine Regel geschützt ist, werden in einer Informationsmeldung wie der folgenden die Regeln <ExampleRegex05> angezeigt, die den jeweiligen Job schützen:

     This job is protected by the following glob pattern rules matching this job name: <ExampleRegex05>

   • Wählen Sie Glob-Muster aus, um eine Zeichenfolge anzugeben, die mit dem Jobnamen abgeglichen wird.

     Dies wird angezeigt, wenn noch keine Regeln definiert wurden.

     
     
     Beschreibung der Abbildung job-protection-page-glob-pattern-selected.png
     

     Mit der glob-Syntax können Sie Musterabgleichsverhalten angeben. Diese Platzhalterzeichen können in globalen Mustern verwendet werden: *, **, ?, [], {} und \.

     Wählen Sie entweder eine vorhandene Schutzregel aus der Liste aus, oder klicken Sie auf + Regel, um das Dialogfeld Neue Schutzregel anzuzeigen und eine neue zu erstellen.

     Das Dialogfeld "Schutzregel" wird angezeigt.
     
     Beschreibung der Abbildung protection-rule-dialog-populated.png
     Hier haben wir einen Namen (Testregel) und ein Glob-Muster (test*) eingegeben, und wir sind im Begriff, auf Erstellen zu klicken, um eine neue Jobschutzregel zu erstellen.

5. Aktivieren Sie das Kontrollkästchen PRIVATE.
   Dies wird angezeigt, nachdem Sie die Option "Privat" für einen Job ausgewählt haben.

   
   
   Beschreibung der Abbildung job-protection-private.png
   

   Nur autorisierte Benutzer und Gruppen können die Seite "Jobdetails" anzeigen, den Job bearbeiten oder den Job manuell ausführen. Wenn der Job in einer Pipeline von einem unautorisierten Benutzer oder einer nicht autorisierten Gruppe ausgelöst wird, oder wenn er durch SCM oder einen Timer ausgelöst wird, wird er nicht initiiert.

   Dies wird angezeigt, nachdem Sie die Option "Privat" für eine Schutzregel ausgewählt haben.

   
   
   Beschreibung der Abbildung job-protection-rule-private.png
   

6. Klicken Sie in das Feld Autorisierte Benutzer/Gruppen, um ein Dialogfeld anzuzeigen, in dem die Gruppen und Benutzer des Projekts aufgeführt sind, aus denen Sie auswählen können.

   Unter "Benutzer" können Sie eine vereinfachte Liste aller Benutzer anzeigen, die Mitglieder der Gruppe(n) sind, sowie der Benutzer, die einzeln hinzugefügt wurden. Beispiel: Die Mitglieder der Entwicklungsgruppe (Clara Coder, Don Developer und Tina Testsuite) werden in der Liste "Benutzer" zusammen mit Alex Admin angezeigt, der einzeln hinzugefügt wurde. Wählen Sie aus der Liste eine oder mehrere Gruppen und/oder Benutzer aus. Vergessen Sie nicht, sich selbst hinzuzufügen.

   
   
   Beschreibung der Abbildung authorized-groups-users.png
   

   Dies wird für den Job myProtectedJob angezeigt, nachdem Sie Alex Admin als autorisierten Benutzer ausgewählt haben.

   
   
   Beschreibung der Abbildung job-protection-private-authorized-user.png
   

   Dies wird für die Schutzregel "Testregel" angezeigt, nachdem Sie Alex Admin als autorisierten Benutzer ausgewählt haben.

   
   
   Beschreibung der Abbildung job-protection-rule-authorized-user.png
   

7. Aktivieren Sie die Kontrollkästchen, damit Projektmitglieder private Jobs manuell starten und/oder Commits und Trigger automatisch private Jobs starten können:

   • Aktivieren Sie das Kontrollkästchen Manuelles Starten dieses privaten Jobs für jedes Projektmitglied zulassen, damit jedes Projektmitglied, nicht nur autorisierte Benutzer, den Job manuell starten kann.

     Dies wird angezeigt, nachdem Sie das Kontrollkästchen Jedes Projektmitglied darf diesen privaten Job manuell starten für den Job myProtectedJob aktiviert haben.

     
     
     Beschreibung der Abbildung job-protection-private-both-checkboxes-selected.png
     

     Beachten Sie, dass VB Studio beim Aktivieren des ersten Kontrollkästchens automatisch das zweite Kontrollkästchen aktiviert, mit dem Commits und Trigger den privaten Job starten und ausgraut werden können. Mit dieser Einstellung können nur autorisierte Benutzer und Gruppen die Seite "Jobdetails" anzeigen oder den Job bearbeiten. Jeder Projektmitarbeiter kann den Job jedoch starten und ausführen. Darüber hinaus werden SCM-Commits oder -Trigger den Job automatisch starten und ausführen.

     Dies wird angezeigt, nachdem Sie das Kontrollkästchen Jedes Projektmitglied darf diesen privaten Job manuell starten für die Schutzregel "Testregel" aktiviert haben.

     
     
     Beschreibung der Abbildung job-protection-page-both-check-boxes.png
     

   • Aktivieren Sie nur das Kontrollkästchen Commits und Trigger dürfen diesen privaten Job starten, wenn SCM-Commits und -Trigger diesen Job automatisch ausführen sollen.

     
     
     Beschreibung der Abbildung job-protection-private-allow-commits-triggers.png
     

     Wenn nur dieses Kontrollkästchen aktiviert ist, führen periodische Trigger jeden Job oder jede Pipeline aus, einschließlich privater Jobs, die so festgelegt sind, dass Commits und Trigger den privaten Job starten können. Wenn eine Pipeline jedoch einen privaten Job enthält, bei dem diese Option ausgewählt ist und ein nicht autorisierter Benutzer versucht, die Pipeline manuell auszuführen, wird der private Job nicht ausgeführt, regelmäßige Trigger und SCM-Commits werden jedoch ausgeführt.

     Lassen Sie das Kontrollkästchen deaktiviert, wenn der Job nicht gestartet werden soll, wenn er von einem SCM-Commit oder -Timer ausgelöst wird.

     Hinweis
     
     

     Best Practice:

     Wenn Sie das Kontrollkästchen aktivieren, damit der geschützte Build durch einen SCM-Commit ausgelöst wird, müssen Sie die Verzweigung schützen, an die der Build-Job gebunden ist. Wenn Sie dies nicht tun, kann jeder den geschützten Build auslösen, indem er einen Commit macht, um ihn auszulösen.

     Dies wird angezeigt, wenn Sie für die Testregel die Option Commits und Trigger starten, die mit diesem Glob-Muster übereinstimmen ausgewählt haben.

     
     
     Beschreibung der Abbildung job-protection-page-allow-commits-triggers.png
     

8. Klicken Sie auf Speichern.

   Der Aktivitätsstream zeigt alle Änderungen am Schutzstatus eines Jobs an, z.B. das Ändern des Jobschutzes von öffentlich in privat oder privat in öffentlich oder das Ändern eines privaten Jobs, um Commits und Trigger zuzulassen.