34 Bundles and CI/CD (Preview)

Bundles define how Oracle AI Data Platform Workbench resources are packaged, versioned, shared, and deployed across workspaces and environments.

You can create bundles for jobs and agents. A bundle is created in a Git folder so that the bundle files can be committed and pushed to a Git repository. The resources that you include in the bundle can come from any location in the workspace. If the selected resources reference supporting files or dependencies, such as notebooks, scripts, or compute, those references are included in the bundle so the resources can be deployed in another environment without manually recreating the same components.

You create bundles from your workspace and select the Oracle AI Data Platform Workbench resources to include at the time of creation. Existing bundles can be modified to add or remove resources. Bundling resources allows you to group related jobs and agents together and deploy them to other environments with their dependencies intact.

You can commit and push bundles to your Git repository through your Git folders. Users can then pull the bundles into their own environments and deploy them. Changes to bundle files are available to other environments after the changes are committed and pushed to the Git repository. Whenever users pull the updated bundle from the Git repository, they receive the latest committed resource files.

Bundle Concepts

Concept Meaning User Action
Git folder An AI Data Platform folder connected to a Git repository and branch. Bundles can be created only in Git folders. Create or open a Git folder before creating a bundle.
Bundle A deployable package that defines selected resources and their dependencies. Create the bundle from the workspace, then select resources such as jobs or agent flows.
Bundle content Generated files that describe resources, variables, target settings, and artifacts required for deployment. Review generated content after create or sync. Commit and push the bundle through Git when ready.
Target An environment or workspace configuration used when deploying the bundle outside the source environment. Provide values that must change by environment, such as workspace key, credential name, token key, or parameter defaults.
Deployed item A resource created or updated by a bundle deployment in the target workspace. Use the Deployment tab to deploy, review deployed items, run jobs, and purge deployed resources when needed.
Sync A bundle action that refreshes bundle resources and dependencies from the latest source resources. Run sync after changing bundled resources, then commit the refreshed bundle files to Git.

Before You Start

Check this list to make sure you have everything you need to start using Git bundles in your AI Data Platform workspace:
  • Create Git credentials and a Git folder that points to the repository and branch used for bundle files.
  • Confirm the source resources are in the workspace and are saved before creating or syncing the bundle.
  • For cross-environment deployment, confirm the target workspace has required permissions and compute capacity.
  • For jobs or notebooks that use secrets, create the required named credentials in the target credential store. Bundle files should reference credentials by name or variable, not contain secret values.
  • Commit and push bundle file changes after creating or syncing a bundle so other environments can pull the latest bundle definition.

Create a Bundle (Preview)

You can bundle Oracle AI Data Platform job and agent resources to create a package that can be deployed to another Git folder.

  1. Navigate to your workspace.
  2. Click Actions then click Create Bundle.
  3. Provide a name and description for your bundle.
  4. Click Browse and select the Git folder in your workspace where you want to create your bundle.
  5. Select the resources you want to include in the bundle from the listed options.
  6. Click Create.

    Note:

    Bundles are created in Git folders. If the selected location is not inside a Git folder, you cannot use Git to move the generated bundle files to another environment.

Deploy a Bundle (Preview)

You can deploy bundles from a Git folder to share resources and dependencies across workspaces and environments.

  1. Navigate to the bundle you want to deploy in your workspace.
  2. Click the Deployment tab.
  3. Optional: Review target values and overrides, if applicable.
  4. Click Deploy. You are notified when the deployment is complete.

    Note:

    On first deployment, the Deployment tab may show no deployed items until deployment succeeds. After a successful deployment, review the deployed resources, run jobs or agents as needed, and confirm runtime output.

Purge a Bundle (Preview)

You can purge a deployed bundle to remove the bundle resources from your workspace.

  1. Navigate to the bundle you want to purge resources for in your workspace.
  2. Click the Deployment tab.
  3. Click Purge.
  4. Enter Purge in the prompt. Click Purge.