Streamline Your Release Process: Oracle Integration + Git Repository Setup

 How to Export and Import Oracle Integration Projects Using Git

Version control makes Oracle Integration work easier to manage, review, and move between environments. In this walkthrough, you’ll learn how to connect Oracle Integration to a Git repository, export (push) projects and deployments to Git, and then import (pull) them into another instance.

 

Why use Git with Oracle Integration?

Using Git gives you a central place to store Oracle Integration assets, improve versioning control, and simplify project management, especially when you need to move content between a source and target instance.

 

Prerequisites

Before you start, make sure you have:

1. A Git repository
   This is where your exported Oracle Integration projects and deployments will be stored.
2. A branch
   Typically the default branch (for example, main) is fine unless you have a branching strategy.
3. A Git access token (API key)
   You’ll use this token to authenticate Oracle Integration to your repository.
4. Two Oracle Integration instances (optional but common)
• Source OIC Gen3: where you export from
• Target OIC Gen3: where you import into

 

Step 1: Create a Git repository

In GitHub (or your Git provider):

• Create a new repository (e.g., “integration wrapper”).
• Choose visibility (public/private based on your needs).
• Use the default branch (commonly main).

 

Step 2: Generate a personal access token

In GitHub:

1. Go to Settings
2. Navigate to Developer settings
3. Open Personal access tokens (fine-grained tokens)
4. Click Generate new token
5. Configure:
• Token name (e.g., “integration project token”)
• Expiration
• Repository scope (recommended: limit to the specific repo)
• Permissions: Contents = Read and Write (so you can pull and push)

Important: Copy and save the token somewhere secure you may not be able to view it again.

 

Step 3: Connect Oracle Integration to the repository

In Oracle Integration (source instance):

1. Go to Settings
2. Open Repositories

3. Add/configure the repository connection:
• Username (your Git username/owner)
• Repository name
• Branch (e.g., main)
• Token
4. Click Save

        

Repeat the same steps in the target instance as well, so it can pull content from the same repository.

 

Step 4: Export (push) deployment to Git

From your source instance:

1. Open the relevant deployment
2. Click Export
3. Choose Export to repository
4. Confirm exports

After export, your Git repository will contain a deployment folder and the exported deployment file inside it.

 

Step 5: Export (push) a project to Git

Still in the source instance:

1. Open Projects
2. Select the project you want
3. Click Export
4. Choose Export to repository
5. Confirm exports

Your repository should now also include a project folder with the project artifact.

 

Step 6: Import (pull) projects and deployments from Git

In the target instance:

Import a project

1. Go to Projects
2. Click Add / Download from repository
3. Select the project discovered from the connected Git repo
4. Click Import

Import a deployment

1. Go to Deployments
2. Click Download from repository
3. Select the deployment
4. Click Import

 

This works similarly to importing from a local file except Oracle Integration is pulled directly from Git.