// This assembly is included in the following assemblies:
//
// assembly-kafka-bridge-concepts.adoc

// Save the context of the assembly that is including this one.
// This is necessary for including assemblies in assemblies.
// See also the complementary step on the last line of this file.

:parent-context-kafka-bridge-quickstart: {context}

[id='assembly-kafka-bridge-quickstart-{context}']
= Kafka Bridge quickstart

:context: kafka-bridge-quickstart

Use this quickstart to try out the {ProductName} Kafka Bridge in your local development environment. You will learn how to:

* Deploy the Kafka Bridge to your Kubernetes cluster
* Expose the Kafka Bridge service to your local machine by using port-forwarding
* Produce messages to topics and partitions in your Kafka cluster
* Create a Kafka Bridge consumer
* Perform basic consumer operations, such as subscribing the consumer to topics and retrieving the messages that you produced

In this quickstart, HTTP requests are formatted as curl commands that you can copy and paste to your terminal. Access to a Kubernetes cluster is required; to run and manage a local Kubernetes cluster, use a tool such as Minikube, CodeReady Containers, or MiniShift.

Ensure you have the prerequisites and then follow the tasks in the order provided in this chapter.

.About data formats

In this quickstart, you will produce and consume messages in JSON format, not binary. For more information on the data formats and HTTP headers used in the example requests, see xref:con-requests-kafka-bridge-kafka-bridge-overview[].

.Prerequisites for the quickstart

* Cluster administrator access to a local or remote Kubernetes cluster. 
* {ProductName} is installed.
* A running Kafka cluster, deployed by the Cluster Operator, in a Kubernetes namespace.
* The Entity Operator is deployed and running as part of the Kafka cluster.  

include::../modules/proc-deploying-kafka-bridge-quickstart.adoc[leveloffset=+1]

include::../modules/proc-exposing-kafka-bridge-service-local-machine.adoc[leveloffset=+1]

include::../modules/proc-producing-messages-from-bridge-topics-partitions.adoc[leveloffset=+1]

include::../modules/proc-creating-kafka-bridge-consumer.adoc[leveloffset=+1]

include::../modules/proc-bridge-subscribing-consumer-topics.adoc[leveloffset=+1]

include::../modules/proc-bridge-retrieving-latest-messages-from-consumer.adoc[leveloffset=+1]

include::../modules/proc-bridge-committing-consumer-offsets-to-log.adoc[leveloffset=+1]

include::../modules/proc-bridge-seeking-offsets-for-partition.adoc[leveloffset=+1]

include::../modules/proc-bridge-deleting-consumer.adoc[leveloffset=+1]

:context: {parent-context-kafka-bridge-quickstart}
