Important

You are viewing documentation for an older version of Confluent Platform. For the latest, click here.

Connecting Schema Registry to Confluent Cloud

You can install and configure Schema Registry on Confluent Cloud.

Prerequisites
  1. Download the package the Schema Registry tarball.

    $ wget https://s3-us-west-2.amazonaws.com/confluent.cloud/schema-registry/schema-registry-6da17dc.tar
    
  2. Uncompress the package and navigate to the schema-registry directory.

    $ tar xvf schema-registry-6da17dc.tar  cd schema-registry
    
  3. Configure Schema Registry by modifying config/schema-registry.ccloud.properties. You can reference the relevant properties in ~/.ccloud/config. For more information, see Schema Registry configuration options and Configuring PLAIN.

    Here are the most important settings, with inline comments:

    # 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 master
    # Schema Registry instance and for storing the registered schema data. Note that the SASL_SSL:// prefix is required.
    kafkastore.bootstrap.servers=SASL_SSL://<bootstrap-servers>
    
    # REQUIRED: Specifies Confluent Cloud authentication. Refer to the SASL
    # properties in ``~/.ccloud/config`` to get this info.
    kafkastore.sasl.jaas.config=<sasl-jaas-config>
    
    # 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
    
  4. Start Schema Registry with the schema-registry.ccloud.properties file specified.

    $ bin/schema-registry-start config/schema-registry.ccloud.properties
    

For more information about running a cluster, see the Schema Registry documentation.