Google pubsub source
The Google Pub/Sub sink connector allows you to write messages from Google Pub/Sub to Apache Pulsar.
The Google Cloud Pub/Sub source connector feeds data from Google Cloud Pub/Sub topics and writes data to Pulsar topics.
Quick start
Prerequisites
The prerequisites for connecting an Google PubSub source connector to external systems include:
- Create Google PubSub Topic in Google Cloud.
- Create the Gcloud ServiceAccount and create a public key certificate.
- Create the Gcloud Role, ensure the Google Cloud role have the following permissions:
- Grant the service account the above role permissions.
1. Create a connector
The following command shows how to use pulsarctl to create a builtin
connector. If you want to create a non-builtin
connector,
you need to replace --source-type google-pubsub
with --archive /path/to/pulsar-io-google-pubsub.nar
. You can find the button to download the nar
package at the beginning of the document.
If you are a StreamNative Cloud user, you need set up your environment first.
The --source-config
is the minimum necessary configuration for starting this connector, and it is a JSON string. You need to substitute the relevant parameters with your own.
If you want to configure more parameters, see Configuration Properties for reference.
You can also choose to use a variety of other tools to create a connector:
- pulsar-admin: The command arguments for
pulsar-admin
are similar to those ofpulsarctl
. You can find an example for StreamNative Cloud Doc. - RestAPI: You can find an example for StreamNative Cloud Doc.
- Terraform: You can find an example for StreamNative Cloud Doc.
- Function Mesh: The docker image can be found at the beginning of the document.
2. Write data to Google PubSub topic
Send some messages to the Google Cloud PubSub using the gcloud CLI tool
3. Show data by Pulsar Consumer
If your connector is created on StreamNative Cloud, you need to authenticate your clients. See Build applications using Pulsar clients for more information.
Configuration Properties
Before using the Google PubSub source connector, you need to configure it. This table outlines the properties and the descriptions.
Name | Type | Required | Sensitive | Default | Description |
---|---|---|---|---|---|
pubsubCredential | String | true | true | "" (empty string) | The credential (JSON string) for accessing the Google Cloud. It needs to be compressed and escaping before use. |
pubsubProjectId | String | true | false | "" (empty string) | The Google Cloud project ID. |
pubsubTopicId | String | true | false | ” ” (empty string) | The topic ID. It is used to read messages from or write messages to Google Cloud Pub/Sub topics. |