Skip to main content

Go agent installation and configuration in a pipeline

Use this workflow with the Add New Go agent wizard to ensure you have all the steps covered for installing and configuring the Go agent in a pipeline. Using the wizard is the simplest way to deploy a new agent.

Before you begin

Make sure you have everything you need before you start.

  • The agent will need to be able to reach your Contrast instance. It can be a local/on-premise instance or a hosted instance. A proxy can be configured if the environment has limited network access.

  • It must use supported versions, frameworks, and tools

  • Understand the order of precedence

  • You will also need access to a command line interface (with a chosen directory for downloading the agent) and your organization's instance of Contrast

Start the Go agent wizard

  1. Select Add New at the top of the Contrast web interface.

  2. Select the Application card.

  3. Under Select a language, select Go.

  4. Select the operating system you are using.

Install the agent

  1. Under Select application deployment method, select Install in a pipeline.

  2. Under Select method to deploy pipelines, select GitHub or Bitbucket.

  3. Under Install an agent:

    1. Copy the displayed command to add a step to your GitHub action or Bitbucket pipeline.

    2. Copy the displayed command to the step running your application:

Configure the agent

Under Configure the agent, select the best options to get the configuration details that the agent needs to communicate with Contrast:

  1. Optionally, select Register the application.

    When you register an application, you can assign it to groups for access control. You can also assign tags and metadata to the application.

  2. Select Use Connection Token.

    This configuration method uses a single variable to specify authentication values. The Connection Token is the recommended configuration option.

    Copy the displayed code and set the variable in a location where the agent has access to it.

Verify the agent deployment

  1. Interact with your application as you normally would. For example, interact with your application's web interface or send API commands

  2. Go to the Contrast web interface and select Applications in the header.

  3. Verify that you see the name of your application in the list.

  4. Select servers in the header.

  5. Verify that you see the name of your local server in the list.