.. _cloud-connect-clients:

Connecting |ak-tm| Clients to |ccloud|
======================================

The :devx-examples:`confluentinc/examples|clients/cloud/` GitHub repo provides hello world examples of Kafka clients connecting to |ccloud| in many different programming languages, including Java, Python, Go, Scala, |confluent-cli|, Ruby, Groovy, Kotlin, Node, kafkacat, .NET, C, Clojure, and others.
All the examples include a producer and consumer, and where relevant, Avro data with |sr-ccloud|.

Prerequisites:
    - Before connecting a client application to |ccloud|, you should increase the timeout for API version requests
      from the default value of 10 seconds. You can change this with librdkafka ``api.version.request.timeout.ms``
      parameter. For more information, see the
      `librdkafka configuration documentation <https://github.com/edenhill/librdkafka/blob/master/CONFIGURATION.md>`_.
    - Depending on your operating system and configuration, you might have to specify the location of your client
      config for SSL (``ssl.ca.location``). For example, if your OS does not provide root CA certificates, or if
      the certificates are stored in a non-standard location.

.. _cloud-dotnet-config:

Connecting to |ccloud| from a .NET Application
----------------------------------------------

You can configure the Confluent .NET Client for |ak| to connect to a |ak| cluster in |ccloud|.

#.  Install the `Confluent .NET Client for Apache Kafka <https://github.com/confluentinc/confluent-kafka-dotnet>`_.

#.  Customize the `.NET Confluent Cloud example <https://github.com/confluentinc/confluent-kafka-dotnet/tree/master/examples/ConfluentCloud>`_
    for your |ccloud| cluster, specifically ``bootstrap.servers``, ``sasl.username``, and ``sasl.password``.

#.  Integrate with your environment.


.. _cloud-kafka-go-config:

Connecting to |ccloud| from a Go Application
--------------------------------------------

You can configure the Confluent Golang Client for |ak| to connect to a |ak| cluster in |ccloud|.

#.  Install the `Confluent Golang Client for Apache Kafka <https://github.com/confluentinc/confluent-kafka-go>`_.

    .. important:: The Confluent Golang Client for |ak| depends on librdkafka, which must be installed separately.

#.  Customize the `Golang Confluent Cloud example <https://github.com/confluentinc/confluent-kafka-go/blob/master/examples/confluent_cloud_example/confluent_cloud_example.go>`_
    for your |ccloud| cluster, specifically ``bootstrap.servers``, ``sasl.username``, and ``sasl.password``.

#.  Integrate with your environment.

.. _cloud-python-config:

Connecting to |ccloud| from a Python Application
------------------------------------------------

You can configure the Confluent Python Client for |ak| to connect to a |ak| cluster in |ccloud|.

#.  Install the `Confluent Python Client for Apache Kafka <https://github.com/confluentinc/confluent-kafka-python>`_.

#.  Customize the `Python Confluent Cloud example <https://github.com/confluentinc/confluent-kafka-python/blob/master/examples/confluent_cloud.py>`_
    for your |ccloud| cluster, specifically ``bootstrap.servers``, ``sasl.username``, and ``sasl.password``.

#.  Integrate with your environment.

Examples and Demo
-----------------

-  To view a working example of hybrid |ak-tm| clusters from self-hosted to |ccloud|, see the :ref:`Confluent Cloud demo<quickstart-demos-ccloud>`.
-  For example configs for all |cp| components and clients connecting to |ccloud|, see :devx-examples:`template examples for components|ccloud/template_delta_configs`.
-  To look at all the code used in the |ccloud| demo, see the :devx-examples:`Confluent Cloud demo examples|ccloud`.