Tutorial part 5: Clone the application on a different instance

Clone the application from the remote repository to develop it on another instance.

Before you begin

Complete Tutorial part 4: Install and use a third-party library.

Role required: admin

About this task

If you have access to another instance, you can install the application from the remote repository onto the instance to support development across instances.

Note:

The instance and your user on the instance must meet the same requirements mentioned at the beginning of this tutorial.

Cloning is intended for developing an application on multiple non-production instances and managing it in a single repository. To publish an application and deploy it to a production instance, use the Application Repository. For more information, see ServiceNow application repository.

Procedure

1. Push your changes to the remote repository.
   1. From the Activity Bar, select the Source Control view ().
   2. From the Changes list, select the Stage All Tracked Changes icon ().
   3. From the Untracked Changes list, select the Stage All Untracked Changes icon ().
      All of your changes should be in the Staged Changes list.
   4. In the message box, enter a commit message.
   5. Select the Commit icon ().
   6. Select the More actions menu icon () and select Push.

      

   All of your changes are available in the remote repository. You or other developers can clone the application onto another instance.

2. Log in to another ServiceNow instance.
3. Navigate to All > App Development > ServiceNow IDE.
4. Create a workspace or open an existing one.
5. Configure basic authentication in the ServiceNow IDE to connect to the remote repository.
   1. Use one of the following keyboard shortcuts to open the command palette:
      • Windows: Ctrl-Shift-P
      • Mac: Cmd-Shift-P
   2. Enter Git: Set IDE Git credentials and press Enter.
   3. From the New Git credential form, select Basic auth.
   4. On the form, fill in the fields.

      Table 1. New Git credential form

      Field	Description
      Git repository URL	The HTTPS URL to the Git repository you created in GitHub. For example: https://github.com/<owner>/hello-world.git.
      Git username	Your GitHub user name.
      Personal access token	The personal access token that you generated from GitHub.

   5. Select Submit.
6. Clone the application.
   1. Use one of the following keyboard shortcuts to open the command palette:
      • Windows: Ctrl-Shift-P
      • Mac: Cmd-Shift-P
   2. Enter Git: Clone and press Enter.
   3. Enter the HTTPS URL to the remote Git repository and press Enter.

Result

The application is added to the instance with the files from the remote repository.

What to do next

Continue to Tutorial part 6: Learn more about the ServiceNow IDE.