Connecting Schema Registry to Confluent Cloud

You can connect an on-premise Schema Registry to Confluent Cloud as described in this section.

Tip

Prerequisites

Note

The Confluent Platform installation provides the binaries for Schema Registry that run locally and connect to your Confluent Cloud cluster. You do not have to start the other Confluent Platform services.

Configure and connect

  1. Configure Schema Registry by modifying etc/schema-registry/schema-registry.properties. The minimally required Schema Registry property settings for Confluent Cloud are provided below:

    # If set to true, API requests that fail will include extra debugging information, including stack traces.
debug=false

# REQUIRED: Specifies the bootstrap servers for your Kafka cluster. It is used for selecting the primary
# Schema Registry instance and for storing the registered schema data.
kafkastore.bootstrap.servers=<bootstrap-servers>

# REQUIRED: Specifies Confluent Cloud authentication.
kafkastore.sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required \
  username="<api-key>" \
  password="<api-secret>";

# Configures Schema Registry to use SASL authentication.
kafkastore.sasl.mechanism=PLAIN

# Configures Schema Registry for SSL encryption.
kafkastore.security.protocol=SASL_SSL

# Specifies the name of the topic to store schemas in.
kafkastore.topic=_schemas

# Specifies the address the socket server listens on. The format is
# "listeners = listener_name://host_name:port". For example, "listeners = PLAINTEXT://your.host.name:9092".
listeners=http://0.0.0.0:8081

    For more information, see Schema Registry configuration options, Configuring PLAIN, and Configure Confluent Cloud Schema Registry (for native cloud Schema Registry).

  2. Start Schema Registry with the schema-registry.properties file specified.

    bin/schema-registry-start etc/schema-registry/schema-registry.properties

Suggested Reading