---
sourceDocument: Australia IT Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/it-service-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia IT Service Management

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# Onboard Argo CD using Workspace

# Onboard Argo CD to DevOps Change Velocity -- Workspace {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read  
Connect to your Argo CD instance using the DevOps Change Workspace playbook to automate the deployment of applications from GitHub repositories.

## Before you begin

Complete the tasks specified in the [Getting started with DevOps Change Velocity](https://servicenow-prod.fluidtopics.net/zYfXM71OMizgQDlC6XiIiA "Learn about the setup process for DevOps Change Velocity that is required before configuring integrations with your toolchain.") topic.

Role required: sn_devops.admin or sn_devops.tool_owner

## Procedure

1. Navigate to WorkspacesDevOps Change Workspace and use one of the following options to open the Playbook to onboard Argo CD.

   | Option | Steps |
   | Homepage | 1. Select the Connect tool widget 2. On the  Connect to a tool  modal, select Argo CD from the Orchestration category. {#onboard-argo-cd-to-devops-change-velocity-workspace__ol_e5j_4y1_fwb} |
   | Applications module | 1. Select Applications (![Applications icon.]()). 2. Select an existing application, or create one. To create an application, see [Create an application - Classic](https://servicenow-prod.fluidtopics.net/oMhI9exh6yQ3ocq8_41FzQ "Create applications using the Classic UI or the Service Catalog."). 3. From the  Recommended actions  pane, select the  Connect a tool  card. 4. On the  Connect to a tool  modal, select Argo CD from the Orchestration category. {#onboard-argo-cd-to-devops-change-velocity-workspace__ol_u24_mz1_fwb} |
   | Tools module | 1. Select Tools (![Tools icon.]()). 2. From the Capability list, select Orchestration. 3. Select Connect a tool. 4. On the  Connect to a tool  modal, select Argo CD. {#onboard-argo-cd-to-devops-change-velocity-workspace__ol_fjs_k1b_fwb} |
   |-|-|

   {#onboard-argo-cd-to-devops-change-velocity-workspace__choicetable_m3t_ky1_fwb}
2. Specify a name for the tool in the Tool name field, and select Next.  
3. On the Argo CD instance details playbook activity:
   1. Enter the URL of your Argo CD instance.
   2. Enter the login credentials of the Argo CD instance.  
      Note:  
      To generate a token for the user in Argo CD, go to Accounts. Ensure that the user has the capability: apiKey. For more information, see [Argo CD documentation](https://argo-cd.readthedocs.io/en/stable/operator-manual/user-management/#create-new-user).
   3. **Optional:** Select the MID Server option and enter its details if your Argo CD instance is attached to a MID Server.  
      A MID server is required if your tool instance is hosted on-prem. For more information about MID server, see [MID Server selection](https://www.servicenow.com/docs/access?context=c_MIDServerSelector&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US).

   {#onboard-argo-cd-to-devops-change-velocity-workspace__substeps_lfr_qqz_2wb}  
4. Select Connect.
5. Specify the access for the tool.  
   1. If you want to control access to the tool, add the groups that must be given access to the tool in the Maintained by field.  
      The tasks these users in the groups can perform depends on the role assigned to them.
      * DevOps Tool Owner role: Can view and edit the tool.
      * DevOps App Owner role: Can view the tool and can associate, discover, import historical data, and modify pipeline steps (if applicable) of the tool's objects (such as plans, repositories, and pipelines).
      * DevOps Administrator role: Can edit all tools.
      * Other DevOps roles: Can view the tool.
      {#onboard-argo-cd-to-devops-change-velocity-workspace__ul_csp_h5c_xwb}  
      Note:  
      If you don't select a group and skip this step, all users with the DevOps Tool Owner role will be able to edit the tool.
   2. If you choose to control access to the tool, the All App Owners can view and associate tool objects to applications option becomes available for selection.

      This option enables all users
      having the DevOps App Owner role to access the tool. If selected, they'll be able to view, associate, discover, import historical data, and modify pipeline steps (if applicable) of the tool's
      objects.
   3. Select Assign.

   {#onboard-argo-cd-to-devops-change-velocity-workspace__ol_slg_2tz_cxb}

6. From the Summary page, select View tool record to review the details of the connected instance.  
{#onboard-argo-cd-to-devops-change-velocity-workspace__steps_pcd_k54_gxb}

## Result

You've successfully onboarded your Argo CD tool to DevOps Change Velocity.

*[\>]: and then