Link an application to source control

Linking an application to source control allows application developers to manage changes from a GIT repository.

Before you begin

  • Role required: admin or source_control
  • Create a dedicated GIT repository for the application. For increased security, enable multi-factor authentication for the GIT repository.
  • Generate an access token that the source control integration can use instead of a password and multi-factor authentication passkey. Search for personal access token on GitHub or GitLab.
  • Restrict permissions on the access token to allow read and write access to the GIT repository.
  • Verify that the sub-production instance has network access to the GIT repository.
Note: The source control integration does not support linking to global applications.

About this task

The source control integration does not support linking to an application on a production instance. Instead install applications on a production instance from the application repository, an update set, or the ServiceNow Store.

Procedure

  1. Open the application you want to link to source control in Studio.
  2. Navigate to Source Control > Link to Source Control.
    Studio displays the Link to Source Control dialog box.
    Link to Source Control dialog box
  3. Enter the connection details for the GIT repository.
    Table 1. Source control connection details
    Field Description
    URL The URL to the GIT repository where you want to save application files.
    User name The user credentials to access the GIT repository.
    Password The password credentials or access token to access the GIT repository.
    Comment An optional description of the repository or application.
    Note: All application developers on the instance share a single set of repository credentials.
  4. Click Submit.
    The system validates the connection and user credentials and displays a success message.
    Figure 1. Link to Source Control success

    All application developers on the instance can use the linked GIT repository to manage changes.