Git Integration (Preview)

You can connect your Oracle AI Data Platform Workbench instance to ingest, read, and write data to and from external Git repositories.

Git integration in AI Data Platform Workbench works by providing login credentials for Git accounts and creating folders that connect to Git repositories with those credentials to ingest data. You can store multiple sets of credentials to connect to different Git repositories or manage different levels of access to the same repositories. Administrators can select a set of credentials as the default profile for users and delete credentials when they're no longer needed.

You can manage your Git files entirely from within AI Data Platform Workbench, with utilities that allow you to push, pull, commit, and merge files as well as manage any merge conflicts that arise without having to leave the platform.

AI Data Platform Workbench also enables you to branch code from your Git repository as well as switch, merge, compare, and delete branches.

Git Folders in Oracle AI Data Platform Workbench (Preview)

Git folders in Oracle AI Data Platform Workbench allow you to interact with data hosted in a Git repository without leaving the platform.

Git folders are created in your Master Catalog using credentials you set up in your AI Data Platform Workbench settings. You connect your folder to a Git repository and use the AI Data Platform Workbench UI to push, pull, merge, rebase, and reset files in your repository.

You can manage RBAC permissions for your Git folder to control who can see the folder and what Git operations they are able to perform. For more information, see Git Folder Permissions (Preview).

Create a Git Folder (Preview)

You can create a folder in your Oracle AI Data Platform Workbench workspace connected to an external Git repository.

  1. On the home page, navigate to your workspace.
  2. Click Create catalog icon Create then click Git folder. You can also click Add in the top right and click Git folder.
  3. From the Select Git credentials drop-down list, select the Git credentials required to access the Git repository.
  4. Provide the Git repository URL. For example: example.git.path.
  5. Provide a name for the Git folder in your workspace.
  6. Provide the branch from the Git repository to connect to your folder.
  7. Click Create.

Edit Git Folder (Preview)

You can change the name and description for a Git folder in your workspace.

  1. On the home page, navigate to your workspace.
  2. Next to the Git folder want to modify, click Actions three dot icon Actions then click Edit.
  3. Modify the name and description for the folder.
  4. Click Save.

Delete Git Folder (Preview)

You can delete Git folders your own from your workspace.

Deleting a Git folder deletes the folder and any changes that have not been committed and pushed to the repository.
  1. On the home page, navigate to your workspace.
  2. Next to the Git folder want to modify, click Actions three dot icon Actions then click Delete.
  3. Click Delete.

Modify Git Folder Settings (Preview)

You can modify the credentials and repository URL used by a Git folder in your workspace.

  1. On the home page, navigate to your workspace.
  2. Click the Git folder you want to modify settings for.
  3. Click the Settings tab.
  4. From the drop-down list, select the new credentials for the Git folder.
  5. Enter the new Git repository URL.
  6. Click Save.

View Git Folder History (Preview)

You can view the history of commits to your Git folder from the History tab.

  1. Navigate to your Git folder and click the Git tab.
  2. Click the History tab.
  3. Click the Git button to view the history of commits on the Git site.

Create Git Branch (Preview)

You can create new Git branches from existing branches from Git folders in your workspace.

  1. Navigate to your Git folder and click the Git tab.
  2. From the Current branch drop-down list, select the branch you want to base your new branch on.
  3. Click Create Branch.
  4. Provide a name for your new branch,
  5. Click Create.

Delete Git Branch (Preview)

You can delete Git branches from your Git repository from inside your Oracle AI Data Platform Workbench workspace.

  1. Navigate to your Git folder and click the Git tab.
  2. From the Current branch drop-down list, select the branch you want to delete.
  3. Click Delete branch.
  4. Select all branches you want to delete.
  5. Optional: Select Force delete regardless of merge status to ignore warnings for any branches that have not been merged.
  6. Click Delete.

Git Pull (Preview)

You can select a branch a perform a Git pull from inside a Git folder in your workspace.

  1. Navigate to your Git folder and click the Git tab.
  2. Click the Pull tab.
  3. From the drop-down list, select the branch you want to pull from.
  4. Click Pull.
  5. Resolve any conflicts.
    • Click Keep local to overwrite with the local version.
    • Click Keep remote to overwrite with the remote version.
    • You can also make your own changes to resolve, then click Mark as resolved.
    • Click Abort pull to cancel the pull request.
  6. Enter a commit message and, optionally, a description for the pull.
  7. Click Commit pull.

Git Push (Preview)

You can select a branch a perform a Git push from inside a Git folder in your workspace.

  1. Navigate to your Git folder and click the Git tab.
  2. Click the Push tab.
  3. Select the files you want to push to the Git repository. Click a file to see the changes in the code window.
  4. Enter a commit message and, optionally, a description for the push.
  5. Click Commit push.

Merge Git Branches into Main (Preview)

You can merge branches back in the main trunk from inside a Git folder in your workspace.

  1. Navigate to your Git folder and click the Git tab.
  2. Click the Merge tab.
  3. From the drop-down list, select the branch you want to merge with the main.
  4. Click Merge.
  5. Resolve any conflicts.
    • Click Keep local to overwrite with the local version.
    • Click Keep remote to overwrite with the remote version.
    • You can also make your own changes to resolve, then click Mark as resolved.
    • Click Abort merge to cancel the merge request.
  6. Enter a commit message and, optionally, a description for the merge.
  7. Click Commit merge.

Git Rebase (Preview)

You can rebase a branch in your Git folder to apply changes from that Git branch to another branch.

Note:

Rebasing a branch requires a force push. Force pushing alters the history on the remote repository and can cause versioning issues for collaborators working on the same repository.
  1. Navigate to your Git folder and click the Git tab.
  2. Click the Rebase tab.
  3. From the Current branch drop-down list, select the branch to rebase.
  4. From the Rebase to branch drop-down list, select the branch to rebase the current branch to.
  5. Select Confirm rebase.
  6. Click Rebase.

Git Reset (Preview)

You can reset a branch in your Git folder to revert the content of that branch to a previous state.

Note:

Resetting a branch requires a force push. Force pushing alters the history on the current branch both locally in your workspace and the remote repository. The history of the branch is deleted and reset to the history of the remote reset branch.
  1. Navigate to your Git folder and click the Git tab.
  2. Click the Reset tab.
  3. From the Current branch drop-down list, select the branch to reset.
  4. From the Choose the remote branch you want the current branch "main" to be reset to drop-down list, select the branch in the remote Git repository to reset the current branch to.
  5. Select Confirm hard reset.
  6. Click Reset.

Bundles in Oracle AI Data Platform Workbench (Preview)

Bundles define how resources within AI Data Platform Workbench such as jobs (including notebooks and compute) and agent flows can be exported, shared, and deployed across environments.

You create bundles from your workspace and select the 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 resources that are dependent each other together and redeploy them to other environments without having to reconstruct important components in the target environment.

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 with connections and dependencies intact. When changes are made to resources in the bundle they remain in the source environment until they are committed to the Git repository. Whenever users that have deployed the bundles pull from the Git repository, they receive any updates to the resource files that have been committed and pushed.

Create a Bundle (Preview)

You can bundle Oracle AI Data Platform job and agent flow resources for committing to and deploying from Git repositories.

Note:

You can only create bundles in Git folders.
  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 folder in your worksapce where you want to create your bundle.
  5. Select the items you want to include in the bundle from the listed options.
  6. Click Create.

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. Click Deploy. You are notified when the deployment is complete.

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.