Git Repositories

Add and manage an external Git repository to store the package or project files.

About Git Repositories

You can use an external Git repository in a public Git account to store your integration projects or packages. A project or package corresponds to a folder or a container for organizing your integrations.

The external Git repositories supported are as follows:

Note
The Git support for Projects feature is available upon request for Enterprise Plus tier. Contact IBM support.

Key Points to Remember when Using Git Repositories

Overview: Storing Project Files in Git

The basic flow to store your project files in a Git repository is as follows:

  1. Configure your Git account information to securely connect to your private Git repositories within IBM webMethods Integration (SaaS), facilitating the storage of your project assets. You can configure your Git account details on the Version Control page. For more information, see Configuring Git Accounts.

  2. Link the Git account details to a project to store the project assets. For more information, see Linking Projects to a Git Repository.

After successfully linking to a project, the project files are stored in the configured Git repository.

Note
To view, update, or delete any of the configured Git accounts, see Viewing Configured Git Accounts.

Configuring Git Accounts

Before you begin

Basic Flow

  1. Click Profile () > Settings from the IBM webMethods Integration title bar. A list of various settings applicable for IBM webMethods Integration appears.

  2. Click Version Control. The Version Control page appears, listing all existing Git accounts related to the logged in user.

    Note
    Git accounts linked to projects before version 11.0.7 are considered shared and only Administrators can view and manage them. Users who want to commit changes to such a project are prompted to enter a Git username and access token when committing for the first time.
  3. In the Version Control page, click (). The Add git account page appears.

  4. Provide the following details in the Add git account page:

    • Source Control - Account: Unique name for the account. The source control account name must only contain alphanumeric characters, underscores, and spaces. It cannot begin with a space and exceed 36 characters.

    • Username: User name used to access the Git server.

    • Hostname: Name of the Git server.

      Note
      Do not add http:// or https:// in front of the host name. For example, forGutHub, enter github.com or github.enterprise.com, where enterprise is the name of your organization.
    • Personal Access Token: Personal access token for the Git account. This is applicable if you have selected GitHub and Gitlab providers.

    • App Password: User-based access tokens for connecting with Bitbucket Cloud. This is applicable if you have selected Bitbucket provider.

  5. Click Validate and do one of the following:

    • If the Token Expiry Date field displays a date, verify that this is the correct date when the personal access token expires. The date is provided in your Git repository.

    • If the Token Expiry Date field displays as No expiry, this means that the personal access token is valid for lifetime.

    If the validation is successful, the Add button is enabled.

  6. Click Add. The Git repository account is saved and listed in the Version Control page.

Note
Click the corresponding Edit and Delete icons in the Action(s) column to modify or delete a Git account. You cannot delete an account that is linked to an existing project. To delete an account, you must first remove all projects that are linked to the account.

Viewing Configured Git Accounts

Administrators can view the details of all configured Git accounts in the Version Control page. Other users can view, edit, or delete only the accounts they add themselves.

The displayed accounts are grouped based on the Host name. Access the Version Control page by clicking Profile () > Settings > Version Control in the IBM webMethods Integration title bar. Additionally, you can add, edit, or delete Git accounts from the Version Control page.

Sample Screen for Admin Users

Sample Screen for Non-Admin Users

The following details are displayed in a tabular format for the configured Git accounts: