Cloud customer?
 Upgrade in MyJFrog >

Search





Working with an older version? JFrog Artifactory 6.x | JFrog Xray 2.x | JFrog Mission Control 3.x | JFrog Distribution 1.x |


Skip to end of metadata
Go to start of metadata

Overview

Pipelines Integrations provide the mechanisms that enable an external service to inter-operate with Pipelines, as well as securely store the credentials for access to that service. They are necessary for Pipelines to connect to a pipeline source, and for pipelines to access external services through resources and steps.  Integrations  must be added and managed by an administrator user. 

Two types of integrations can be added:

  • Pipelines: These integrations can be used in pipeline YAML definitions. 
  • Admin: These integrations can be used while creating dynamic node pools, and adding extension and template sources. These integration cannot be used in pipeline YAML definitions.
    The types of integrations that can be added/managed here are:
    • Cloud service: For creating dynamic nodes in a dynamic node pool. For example,  AWS ,  Google Cloud ,   Azure Keys , or other.
      Dynamic nodes are build nodes that are spun up and down on-demand by Pipelines from a cloud service. They are managed through dynamic node pools.
    • Kubernetes : For creating dynamic nodes in a dynamic node pool.
    • Source control: For Pipelines extensibility source repositories. For example,  GitHub ,  Bitbucket , or other.

Administrator users can create, view and edit integrations. Non-administrator users can only view integrations.

Page Contents

Administering Integrations

The following actions can only be performed by administrator users to configure Pipelines for operation.

Adding an Integration

To add an integration:

  1. Go to Administration | Pipelines | Integrations and  click  Add an Integration .


  2. In the resulting Add New Integration display, depending on the type of integration you need, click either Pipelines or Admin.
  3. Click the Integration Type field and select one from the dropdown list. For example, a GitHub Integration enables a pipeline to assign source control repositories in GitHub to GitRepo resources.


  4. After the integration type is selected, enter the remaining settings as presented.

  5. For the following integrations, you have the option of testing the integration while creating/editing it. The test validates all the details you have entered, including the URL, user credentials, and the token for sufficient permissions on the repository.

    • Artifactory
    • BitBucket
    • BitBucket Server
    • Distribution
    • GitHub
    • GitHub Enterprise
    • GitLab

    To test an integration, enter all the relevant details and click Test Connection. The details entered for the integration is validated and an appropriate message for success or failure is displayed. 


  6. Click Create to create the integration.

The integration you created appears on the Integrations page.

These integrations also appear on the Application | Pipelines | Integrations page.


Restricting Integration Use

By default, an integration is available to all Pipelines users. However, you may restrict use of an integration to pipeline configs that are loaded from a particular set of pipeline sources and the users that have been given permissions to use those pipeline sources.

You can establish those usage restrictions when you add or modify an integration.

  1. Uncheck the option to Allow all pipeline sources to use this integration.
  2. In the revealed interface, select from the list of available pipeline sources and move the row(s) (by click-and-drag or arrow button) to the list of included pipeline sources.
  3. When finished, click Create (if adding an integration) or Save (if editing).

Viewing Integrations

To view the list of integrations already added and available for use, go to either Application | Pipelines | Integrations or Administration | Pipelines | Integrations

The Integrations page displays the list of integrations that have been installed and are available to you to use according to your Jfrog platform user credentials. Integrations that are restricted to use by certain pipeline sources will not be shown unless your user account has been granted permissions  for those pipeline sources.

Each row of the integrations list includes the following:

Integration Name
The friendly name of the integration
Type
The integration type
Usage

Shows where the integration can be used:

  • Pipeline: Can be used in pipeline YAML definitions
  • Admin: Can be used while creating dynamic node pools, extension sources or template sources.
Created By
The user that created the integration
Updated By
The user that last edited the integration settings
Updated At
The time and date of the last edit
Click on the Name  of the integration to view its settings. If the integration is for dynamic nodes, it will show which node pools use it.

Modifying an Integration

You can modify (edit) an integration by hovering over its row in the list, and clicking the Edit button.

Alternately, you can view the integration, then click Edit.

Once you complete your permitted changes, click Save.

Deleting an Integration

You can delete an integration by hovering over its row in the list, and clicking the Delete button.

Alternately, you can view the integration, then click Delete.

Copyright © 2021 JFrog Ltd.