New

Integrating Torque with CircleCI

  • 19 April 2021
  • 0 replies
  • 203 views

To integrate Torque with the CircleCI plugin, make sure to complete all four steps, as detailed in this article:

Note that plugin only supports sandbox environments.

Step 1: Enable CircleCI to use 3rd party tools

  1. On the Settings > Security page for your organization, enable use of 3rd-party orbs.
  2. If your project was added to CircleCI before version 2.1, on the Project Settings > Advanced Settings page, enable "pipelines" to use the orbs key.

Step 2: Declare Torque in the CircleCI config file

  1. Add a single line to your version 2.1 .circleci/config.yml file:
    version: 2.1
  2. Import the orbs key in your .circleci/yml/config.yml file.
  3. Add the orbs stanza below your version, invoking the orb:
    orbs: 
    torque: quali/torque@1.0.0

Step 3: Define required environment variables for Torque

  1. While logged in to CircleCI, in a separate browser window In Torque, open the Settings page and select Integrations
  2. Under the CircleCI icon, select Connect.
  3. Copy the automatically generated token value and return to the CircleCI browser window.
  4. From your CircleCI dashboard, select Project Settings > Build Settings > Environment Variables.
  5. Add the following Environment Variables:

    TORQUE_SERVER = Torque Server URL (https://app.qtorque.io)

    TORQUE_TOKEN = In Torque, the automatically generated token from step 3

    TORQUE_SPACE = Torque space name

Step 4: Use Torque's tasks in your CircleCI workflow

  1. In the config.yml, declare the torque/start-sandbox and torque/end-sandbox commands to start and stop the sandbox in Torque. Review examples here.
  2. See the parameters list for orb behavior command customization here.

For additional information, see quali/torque Orb on circleci.com, check out this live code example on Github. 

 


This topic has been closed for comments