Adding Agents to your pipeline

Overview

Adding agents to your Gluesync pipeline is done through the pipeline creation or editing wizard. If the agent you need isn’t available in your current pipeline configuration, you can add it directly from the wizard interface.

Adding an agent

Step 1: Access the pipeline wizard

  1. Navigate to the pipeline creation or editing wizard in the Gluesync Web UI;

  2. Enter the Source or Target wizard configuration step.

Step 2: Initiate agent addition

If your desired agent isn’t available in the current selection:

  1. Click on the Add Agent button in the pipeline wizard;

  2. This will open the agent addition flow.

Agent addition flow interface

Step 3: Select the agent

From the agent addition panel:

  1. Browse the left panel showing all available agents;

  2. The list will show either source or target agents depending on your current step in the wizard;

  3. Select the agent you want to add;

  4. Click the right-pointing arrow to proceed with deployment

Agent selection panel

Step 4: Configure agent settings

Basic configuration

  • Agent nickname: A randomly generated name is provided by default

    • We recommend giving agents meaningful names that help identify their purpose

    • Example: For an agent connecting to IBM i production database, name it "IBM i PROD"

Default resource allocation

By default, agents are deployed with no resource limits or requirements, allowing the container orchestrator to manage resource allocation automatically. This works well for most deployments.

Deployment

  1. After configuring your agent settings, click the Verify & Proceed button at the bottom right

  2. The system will:

    • Pull the agent from the repository

    • Begin the deployment process

    • Complete deployment (typically takes less than a minute, depending on network bandwidth and local cache availability)

Best practices

  • Naming convention: Use descriptive names that indicate the database and environment (e.g., "PostgreSQL PROD", "MongoDB STAGING")

  • Resource planning: Start with default allocations and only customize if you have specific performance requirements

  • SSL security: Keep SSL enabled unless you have specific security requirements that necessitate disabling it

  • Testing: Test agent connections after deployment to ensure proper configuration

Troubleshooting

  • Deployment timeout: If deployment takes longer than expected, check network connectivity and repository availability

  • Resource conflicts: If you encounter resource allocation errors, review your advanced settings against available system resources

  • Agent unavailable: Ensure the Gluesync Conductor module is properly installed and running

Related topics