.. _cos-docker-quickstart:

Quick Start using Community Components (Docker)
===============================================

This quick start shows you how to get up and running using |cc-components| using Docker containers. It
demonstrates the basic and most powerful capabilities, including creating topics, adding and modifying data, and stream processing
by using KSQL. In this quick start you will create |ak-tm| topics and streaming queries on these topics by using KSQL.

This quick start leverages the |cp| CLI, the |ak| CLI, and the KSQL CLI. For a rich UI-based experience, try out the
|cp| :ref:`quick start <ce-docker-quickstart>` with commercial components.

.. include:: includes/docker-prereqs.rst

.. step 1

.. _download-start-cc-docker:

Step 1: Download and Start |cp| Using Docker
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. include:: includes/cos-docker-step1.rst

.. step 2

.. include:: includes/cos-quickstart-step2.rst
    :start-after: step-2-intro-start
    :end-before: step-2-intro-start-end

#.  .. include:: includes/cos-quickstart-step2.rst
        :start-after: step-2-intro-start-end
        :end-before: step-2-users-end

    .. codewithvars:: bash

       docker-compose exec broker kafka-topics --create --bootstrap-server \
       localhost:9092 --replication-factor 1 --partitions 1 --topic users

    .. include:: includes/cos-quickstart-step2.rst
        :start-after: step-2-users-end
        :end-before: step-2-users-output-end

#.  .. include:: includes/cos-quickstart-step2.rst
        :start-after: step-2-users-output-end
        :end-before: step-2-pageviews-end

    .. codewithvars:: bash

       docker-compose exec broker kafka-topics --create --bootstrap-server \
       localhost:9092 --replication-factor 1 --partitions 1 --topic pageviews

    .. include:: includes/cos-quickstart-step2.rst
        :start-after: step-2-pageviews-end
        :end-before: step-2-pageviews-output-end

.. step 3

.. include:: includes/quickstart-step3.rst
   :start-after: step-3-start
   :end-before: step-3-mid

#.  .. include:: includes/quickstart-step3.rst
       :start-after: step-3-run-instance-start
       :end-before: step-3-run-instance-end

    ::

        wget https://github.com/confluentinc/kafka-connect-datagen/raw/master/config/connector_pageviews_cos.config
        curl -X POST -H "Content-Type: application/json" --data @connector_pageviews_cos.config http://localhost:8083/connectors

#.  .. include:: includes/quickstart-step3.rst
        :start-after: step-3-run-instance-end
        :end-before: step-3-run-another-instance-end

    .. codewithvars:: bash

         wget https://github.com/confluentinc/kafka-connect-datagen/raw/master/config/connector_users_cos.config
         curl -X POST -H "Content-Type: application/json" --data @connector_users_cos.config http://localhost:8083/connectors

.. tip:: The Kafka Connect Datagen connector was installed automatically when you started Docker Compose with the 
         ``--build`` argument in :ref:`download-start-cc-docker`. If you encounter issues with the Datagen Connector, 
         refer to the :ref:`whereis_datagen_cos_docker` in the 
         Troubleshooting section.

.. step 4

.. _cos-streams-tables:

.. include:: includes/cos-quickstart-step4.rst
    :start-after: start-cos-quickstartstart
    :end-before: cos-qs-step1-start

#. .. include:: includes/cos-quickstart-step4.rst
    :start-after: cos-qs-step1-start
    :end-before: cos-qs-step1-mid

   .. code:: bash

    docker-compose exec ksql-cli ksql http://ksql-server:8088

   .. include:: includes/cos-quickstart-step4.rst
    :start-after: cos-qs-step1-mid
    :end-before: cos-qs-step1-end

#. .. include:: includes/cos-quickstart-step4.rst
    :start-after: cos-qs-step1-end
    :end-before: cos-qs-step2-end

#. .. include:: includes/cos-quickstart-step4.rst
    :start-after: cos-qs-step2-end
    :end-before: cos-qs-step3-end

.. include:: includes/cos-quickstart-step4.rst
    :start-after: cos-qs-step3-end

.. step 5

.. include:: includes/cos-quickstart-step5.rst

.. step 6

.. include:: includes/quickstart-stop-docker-step6.rst

.. troubleshooting

.. include:: includes/cos-docker-quickstart-troubleshoot.rst

.. next steps

.. include:: includes/cos-quickstart-next-steps.rst