Deploying Custom Connectors

Deploy and register your custom connectors in Kubernetes and Docker.

Kubernetes

Deploying Custom Connectors in Kubernetes

Prerequisites

• You have developed your custom connector. See Developing Custom Connectors.

Procedure

Custom connectors are packaged as container images. First, build and publish the image to a registry. Then, deploy it using the connectware-agent Helm chart. Finally, register it in the Connectware Admin UI.

1. Publish your custom connector to your preferred container registry.

2. Use the connectware-agent Helm chart - just as you would when installing an agent - to deploy your custom connector on Kubernetes. Make the following customizations in your values.yaml file:

   • Custom registry: Override the default image registry to point to your registry. See Configuring Registries and Pull Secrets.

   • Image name & tag: Specify the image name and tag of your custom connector. See Managing Container Image Parameters for the connectware-agent Helm Chart.

   Once the custom connector is deployed, access the Admin UI to register it and make it available for use.

3. To register the custom connector as an agent in Connectware, log in to the Admin UI and select User > Client Registry.

4. In the Client Registry view, click Unlock to allow the agent to register with Connectware.

1. Once the client appears in the list, click it.

1. In the Grant Access dialog, click Allow. By default, the default permissions are assigned to the client.

Result: You can now use your custom connector.

Docker

Deploying Custom Connectors in Docker

Prerequisites

• You have developed your custom connector. See Developing Custom Connectors.

Procedure

Custom connectors rely on pre-built Docker images, requiring you to specify the image tag during the build process.

1. Create a docker-compose.yml file. The following code example deploys the agent with a server with the BASEIMAGE_VERSION tag set to 2.0.0.

docker-compose build --build-arg BASEIMAGE_VERSION=2.0.0

Example

version: '2.4'
services:
  # Run the example server
  server:
    build: .
    network_mode: host # Using host network
    entrypoint: ''
    command: sh -c 'cd /app/src/protocols/custom/utils && node runServer.js'

  agent:
    build: .
    network_mode: host # Using host network
    volumes:
      - agentData:/data
    environment:
      CYBUS_HOSTNAME_INGRESS: localhost # Assuming Cybus Connectware to be reachable on local system
      CYBUS_AGENT_MODE: distributed
      CYBUS_AGENT_NAME: CustomConnectorAgent
      CYBUS_LOG_LEVEL: info

volumes:
  agentData:

1. To deploy your custom connector, use the following code:

docker-compose up -d

Once the custom connector is deployed, access the Admin UI to register it and make it available for use.

3. To register the custom connector as an agent in Connectware, log in to the Admin UI and select User > Client Registry. 4. In the Client Registry view, click Unlock to allow the agent to register with Connectware.

1. Once the client is registered, click it.

1. In the Grant Access dialog, click Allow. By default, the default permissions are assigned to the client.

Result: You can now use your custom connector.