User Guide (Latest)

AI Workbench Integrations

Integrations are external systems and services, such as container registries and Git servers, that you connect to from NVIDIA AI Workbench to enable or expand functionality. After you connect, the integration is available in AI Workbench. For example, if you connect to Github, you can commit changes and publish your projects to your Github account from inside AI Workbench.

Some integrations are available in AI Workbench by default, and some custom integrations you can add to AI Workbench yourself as explained later. You must configure both default and custom integrations before you can use them. Currently, AI Workbench supports the following integrations.

Integration

Information

Default / Custom

GitHub GitHub Integration Default
GitLab GitLab Integration Default
Self-hosted GitLab Self-Hosted Gitlab Custom
NGC Private Registry NGC Private Registry Integration Default

Use this documentation to learn about the following:

You authenticate to an external system from your local AI Workbench location one time only. After you authenticate to an external system, you can access it from all of your projects and from all of your locations, including remote locations.

Depending on the integration, you can authenticate by using one of the following methods:

  • OAuth — This method uses an OAuth application. AI Workbench authenticates with the platform and then handles everything from there. For more information, see NVIDIA AI Workbench Data Privacy and Data Collection.

  • Personal Access Token (PAT) — A PAT is a key that you create in your GitHub or GitLab account. You save it in AI Workbench. By using a PAT, you can restrict AI Workbench permissions to whatever is available for the PAT.

  • API Key — An API key is a key that you create in NGC. You save it into your Local AI Workbench.

Integrations do not give the NVIDIA Corporation any access to your platform accounts or identifying information. Your credentials are always kept privately on your resources. You can revoke permissions at any time in your Local AI Workbench or in the platform itself. For details, see NVIDIA AI Workbench Data Privacy and Data Collection.

When you disconnect an integration, AI Workbench deletes the credentials AI Workbench has stored for the connection.

You can view and modify your integrations by using the AI Workbench Settings, or by using the CLI. The primary actions you perform with integrations are to connect to or disconnect from them.

Use the AI Workbench Settings

Use the following procedure to connect to your Git account, or other integrations, by using the AI Workbench settings. The following is the AI Workbench Settings window.

integration_settings.png

  1. Open the AI Workbench Settings.

  2. Select the Integrations page.

  3. Click Connect or Disconnect on the tile of the integration that you want to modify.

Ues the CLI

Use the following commands to work with your integrations by using the CLI.

Tip

If you are working in the CLI, and want to access the settings without opening the desktop application, see AI Workbench Settings.

  • To get information about your integrations, run the following code.

    Copy
    Copied!
                

    nvwb list integrations

  • To connect to an integration, run the following code.

    Copy
    Copied!
                

    nvwb connect integration <integration name>

  • To disconnect from an integration, run the following code.

    Copy
    Copied!
                

    nvwb disconnect integration <integration name>

Currently, AI Workbench supports custom integrations with self-hosted GitLab servers.

Use the AI Workbench Settings

Use the following procedure to add a custom integration by using the AI Workbench settings.

  1. Open the AI Workbench Settings.

  2. Select the Integrations page.

  3. Click Add Integration.

    The Add Integration window appears.

  4. Specify Integration Type, Display Name, and Authentication Method.

    For Integration Type, only Self-hosted GitLab is supported. Specify all additional information as explained in Self-Hosted Gitlab.

  5. Click Add.

    Your new integration appears on the Integrations page.

  6. Click Connect on your new integration when you are ready to start using it.

Use the CLI

Use the following procedure to add a custom integration by using the CLI.

Tip

If you are working in the CLI, and want to access the settings without opening the desktop application, see AI Workbench Settings.

  1. To create an integration, run the following code. The interactive dialog starts.

Copy
Copied!
            

nvwb create integration


  1. Select gitlab and press enter.

  2. Specify all additional information as explained in Self-Hosted Gitlab.

  3. After you complete the dialog, the list of your integrations appears. Verify that you see your new custom integration in the list.

  4. To connect to your new integration, run the following code.

Copy
Copied!
            

nvwb connect integration <integration name>


You can use either an OAuth flow or a Personal Access Token (PAT) to authenticate with GitHub. When you create a PAT, assign the following scopes:

  • repo

  • read:org

  • user

  • read:packages

AI Workbench needs access to your private repositories on GitHub. Based on your actions, AI Workbench acts on your behalf to create public or private repositories, and to push changes to your public and private repositories.

For more information about authenticating to GitHub, see Authorizing OAuth applications in GitHub.

You can use either an OAuth flow or a Personal Access Token (PAT) to authenticate with Gitlab. When you create a PAT, assign the following scopes:

  • api

AI Workbench needs full API access to GitLab. Based on your actions, AI Workbench acts on your behalf to create public or private repositories, and to push changes to your public and private repositories. With Gitlab PATs, there is no other option that allows write access to create new repositories on your behalf.

AI Workbench integrates with NVIDIA’s NGC Catalog to access base environment images stored in the private registry. Use this integration only if you are part of a program that needs access to the NGC Private Registry.

Integration with the NGC Private Registry supports the API Key authentication method only. Do not use personal keys. To generate your API key, log into NVIDIA’s NGC Catalog, navigate to the Setup page, and then click Generate API Key.

Previous Use Your Own Container
Next Credentials
© Copyright © 2024, NVIDIA Corporation. Last updated on Nov 4, 2024.