34 Bundles und CI/CD (Vorschau)

Bundles definieren, wie Oracle AI Data Platform Workbench-Ressourcen in Workspaces und Umgebungen gepackt, versioniert, gemeinsam genutzt und bereitgestellt werden.

Sie können Bundles für Jobs und Agents erstellen. Ein Bundle wird in einem Git-Ordner erstellt, sodass die Bundle-Dateien festgeschrieben und in ein Git-Repository übertragen werden können. Die Ressourcen, die Sie in das Bundle aufnehmen, können von einem beliebigen Speicherort im Workspace stammen. Wenn die ausgewählten Ressourcen unterstützende Dateien oder Abhängigkeiten wie Notizbücher, Skripte oder Compute referenzieren, sind diese Referenzen im Bundle enthalten, sodass die Ressourcen in einer anderen Umgebung bereitgestellt werden können, ohne dieselben Komponenten manuell neu zu erstellen.

Sie erstellen Bundles aus Ihrem Workspace und wählen die Oracle AI Data Platform Workbench-Ressourcen aus, die zum Zeitpunkt der Erstellung aufgenommen werden sollen. Vorhandene Bundles können geändert werden, um Ressourcen hinzuzufügen oder zu entfernen. Durch das Zusammenfassen von Ressourcen können Sie zugehörige Jobs und Agents zusammenfassen und in anderen Umgebungen bereitstellen, wobei deren Abhängigkeiten intakt sind.

Sie können Bundles über Ihre Git-Ordner festschreiben und in Ihr Git-Repository pushen. Anschließend können Benutzer die Bundles in ihre eigenen Umgebungen ziehen und bereitstellen. Änderungen an Bundle-Dateien sind in anderen Umgebungen verfügbar, nachdem die Änderungen festgeschrieben und an das Git-Repository übertragen wurden. Wenn Benutzer das aktualisierte Bundle aus dem Git-Repository abrufen, erhalten sie die neuesten festgeschriebenen Ressourcendateien.

Bundle-Konzepte

Konzept Bedeutung Benutzeraktion
Git-Ordner Ein AI Data Platform-Ordner, der mit einem Git-Repository und einer Verzweigung verbunden ist. Bundles können nur in Git-Ordnern erstellt werden. Erstellen oder öffnen Sie einen Git-Ordner, bevor Sie ein Bundle erstellen.
Bündel Ein bereitstellbares Package, das die ausgewählten Ressourcen und ihre Abhängigkeiten definiert. Erstellen Sie das Bundle aus dem Workspace, und wählen Sie dann Ressourcen wie Jobs oder Agent-Abläufe aus.
Bundle-Inhalt Generierte Dateien, die Ressourcen, Variablen, Zieleinstellungen und Artefakte beschreiben, die für das Deployment erforderlich sind. Prüfen Sie generierten Inhalt nach dem Erstellen oder Synchronisieren. Schreiben Sie das Bundle fest, und pushen Sie es, wenn Sie bereit sind.
Target Eine Umgebung oder Workspace-Konfiguration, die beim Deployment des Bundles außerhalb der Quellumgebung verwendet wird. Geben Sie Werte an, die sich nach Umgebung ändern müssen, wie Workspace-Schlüssel, Zugangsdatenname, Tokenschlüssel oder Parameterstandardwerte.
Bereitgestelltes Element Eine Ressource, die von einem Bundle-Deployment im Ziel-Workspace erstellt oder aktualisiert wurde. In der Registerkarte "Deployment" können Sie bereitgestellte Elemente bereitstellen, prüfen, Jobs ausführen und bereitgestellte Ressourcen bei Bedarf löschen.
Synchronisierung Eine Bundle-Aktion, die Bundle-Ressourcen und -Abhängigkeiten aus den neuesten Quellressourcen aktualisiert. Führen Sie die Synchronisierung aus, nachdem Sie gebündelte Ressourcen geändert haben, und schreiben Sie die aktualisierten Bundle-Dateien dann in Git fest.

Bevor Sie beginnen

Aktivieren Sie diese Liste, um sicherzustellen, dass Sie alles haben, was Sie für die Verwendung von Git-Bundles in Ihrem AI Data Platform-Workspace benötigen:
  • Erstellen Sie Git-Zugangsdaten und einen Git-Ordner, der auf das Repository und die Verzweigung verweist, die für Bundle-Dateien verwendet werden.
  • Bestätigen Sie, dass sich die Quellressourcen im Workspace befinden und gespeichert werden, bevor Sie das Bundle erstellen oder synchronisieren.
  • Stellen Sie bei einem umgebungsübergreifenden Deployment sicher, dass der Ziel-Workspace über die erforderlichen Berechtigungen und Compute-Kapazität verfügt.
  • Erstellen Sie für Jobs oder Notizbücher, die Secrets verwenden, die erforderlichen benannten Zugangsdaten im Zielzugangsdatenspeicher. Bundle-Dateien müssen Zugangsdaten nach Name oder Variable referenzieren und keine Secret-Werte enthalten.
  • Speichern und übertragen Sie Änderungen an Bundle-Dateien, nachdem Sie ein Bundle erstellt oder synchronisiert haben, damit andere Umgebungen die neueste Bundle-Definition abrufen können.

Bundle erstellen (Vorschau)

Sie können Oracle AI Data Platform-Job- und Agent-Ressourcen bündeln, um ein Package zu erstellen, das in einem anderen Git-Ordner bereitgestellt werden kann.

  1. Navigieren Sie zu Ihrem Workspace.
  2. Klicken Sie auf Aktionen und dann auf Bundle erstellen.
  3. Geben Sie einen Namen und die Beschreibung für das Bundle an.
  4. Klicken Sie auf Durchsuchen, und wählen Sie den Git-Ordner in Ihrem Workspace aus, in dem Sie das Bundle erstellen möchten.
  5. Wählen Sie die Ressourcen aus, die Sie in das Bundle aufnehmen möchten.
  6. Klicken Sie auf Create.

    Hinweis:

    Bundles werden in Git-Ordnern erstellt. Wenn sich der ausgewählte Speicherort nicht in einem Git-Ordner befindet, können Sie Git nicht verwenden, um die generierten Bundle-Dateien in eine andere Umgebung zu verschieben.

Bundle bereitstellen (Vorschau)

Sie können Bundles aus einem Git-Ordner bereitstellen, um Ressourcen und Abhängigkeiten über Workspaces und Umgebungen hinweg gemeinsam zu nutzen.

  1. Navigieren Sie zu dem Bundle, das Sie in Ihrem Workspace bereitstellen möchten.
  2. Klicken Sie auf die Registerkarte "Deployment".
  3. Optional: Prüfen Sie ggf. Zielwerte und Überschreibungen.
  4. Klicken Sie auf Bereitstellen. Sie werden benachrichtigt, wenn das Deployment abgeschlossen ist.

    Hinweis:

    Beim ersten Deployment kann die Registerkarte Deployment keine bereitgestellten Elemente anzeigen, bis das Deployment erfolgreich ist. Prüfen Sie nach einem erfolgreichen Deployment die bereitgestellten Ressourcen, führen Sie Jobs oder Agents nach Bedarf aus, und bestätigen Sie die Laufzeitausgabe.

Bundle löschen (Vorschau)

Sie können ein bereitgestelltes Bundle löschen, um die Bundle-Ressourcen aus Ihrem Workspace zu entfernen.

  1. Navigieren Sie zu dem Bundle, für das Sie Ressourcen in Ihrem Workspace löschen möchten.
  2. Klicken Sie auf die Registerkarte "Deployment".
  3. Klicken Sie auf Löschen.
  4. Geben Sie in der Eingabeaufforderung Löschen ein. Klicken Sie auf Löschen.