Create an Agent

Overview

Follow the steps below to define an agent and generate a bootstrap file that will be used when installing the agent within your internal environment or at one of the cloud providers.

Prerequisites

• Review the agent reference page
• Permissions to create an agent
• Optional:
  • Install the CLI

Create using the UI Console

1. Create a new agent by either:

   • Clicking Agents in the left menu and click New, or
   • Click the Create dropdown in the upper right corner and select Agent

2. Enter a unique name and optional description. Click Next (Tags).

3. Enter any optional tags. Click Create.

4. The console will display the bootstrap config JSON text that can be copied to the clipboard or downloaded. The Done button will not be active until the text is copied or downloaded. Save the text as a file. This file will be used when configuring an agent. Click Done.

Create using the CLI

1. At a command prompt, execute the following to create an agent:

copy
cpln agent create --name NEW_AGENT_NAME --org ORG_NAME > bootstrap-config.json

2. The output of the command will be the bootstrap config JSON text. Executing the command above will save the text in a file called bootstrap-config.json. This file will be used when configuring an agent.

Next Steps

Once the bootstrap config file has been generated and saved, follow the set up an agent guide to install and configure an agent:

• Amazon Web Services (AWS)
• Microsoft Azure
• Google Cloud Platform (GCP)
• Private Network