MQTT <-> Cloud Pub/Sub connector

The MQTT <-> Cloud Pub/Sub connector is a set of software components aimed at interfacing MQTT brokers and clients with Cloud Pub/Sub.

This is not an official Google product.

Assumptions

The MQTT <-> Cloud Pub/Sub connector works under the following assumptions:

• It currently supports forwarding messages from MQTT topics to Cloud Pub/Sub topics. Support for the other way around may come in a future release, depending on demand.
• It doesn't map any MQTT semantics to Cloud Pub/Sub semantics, and vice versa.
• It doesn't support any kind of message processing. If you need any processing, you need to implement a message processing pipeline.
• It's not a MQTT broker.
• It expects that you provisioned and configured the MQTT broker to connect to, and the necessary Cloud Pub/Sub topics and subscriptions.
• It doesn't map MQTT client identities to Google Cloud identities.

Design and architecture

For more information about the design and the architecture of the MQTT <-> Cloud Pub/Sub connector, refer to the following documents:

• Overall design
• Development environment guide
• Build and release processes
• Authentication
• Configuration

Provision a test and validation runtime environment on Google Cloud

For more information about provisioning and configuring a test and validation runtime environment on Google Cloud, see Provision a test and validation runtime environment on Google Cloud document.

Contribute to this project

For more information about how to contribute to this project, refer to CONTRIBUTING.