Create Connectors
Prerequisites
Before deploying a connector to StreamNative Cloud, make sure the following prerequisites have been met:
A running external data system service.
A running Pulsar Cluster on StreamNative Cloud and the required environment has been set up.
At least one of the required tools: pulsarctl, pular-admin, or the Terraform module. For a quickstart of setting up
pulsarctl
andpulsar-admin
, see set up client tools.
Create a built-in connector
Tip
Before creating a connector, it’s highly recommended to do the following:
- Check connector availability to ensure the version number of the connector you want to create is supported on StreamNative Cloud.
- Go to StreamNative Hub and find the connector-specific docs of your version for configuration reference.
The following example shows how to create a data generator source connector named test
on Streamnative Cloud using different tools.
To create a data generator source connector named test
, run the following command.
➜ pulsarctl sources create --archive builtin://data-generator --destination-topic-name public/default/dg-test --source-config '{"sleepBetweenMessages": 60}' --name test
You should see the following output:
Created test successfully
If you want to verify whether the data generator source connector has been created successfully, run the following command:
➜ pulsarctl sources list
You should see the following output:
+---------------------+
| PULSAR SOURCES NAME |
+---------------------+
| test |
+---------------------+
Tip
If you want to create a sink connector, use the pulsarctl sinks create
command.
For all the common configurations of built-in connectors, see Configuration reference.