Los tutoriales de esta sección se ejecutan en un entorno de desarrollo usando Docker para empaquetar las dependencias y configuraciones necesarias para ejecutar el Conector MongoDB para Apache Kafka. Asegúrate de completar los pasos de configuración del entorno de desarrollo antes de continuar con los tutoriales.
Requisitos
Crea o inicia sesión en tu cuenta de Docker para descargar los contenedores que necesitas para este tutorial. Para saber cómo crear una cuenta e instalar Docker Desktop, consulta los pasos de registro y descarga en el Inicio rápido de Docker Hub.
Una aplicación de terminal y un shell. Para usuarios de macOS, use Terminal o una aplicación similar. Para usuarios de Windows, use PowerShell.
Opcional. Instala Git para descargar los archivos de instalación. Para saber cómo instalar Git, consulta la página de descargas de Git.
Configura tu entorno de desarrollo con Docker
Clonar o descargar el repositorio de tutoriales
A continuación, clone el repositorio git del tutorial con el siguiente comando:
git clone https://github.com/mongodb-university/kafka-edu.git
Si no tiene git instalado, puede descargar el archivo zip.
Ejecutar el entorno de desarrollo
Seleccione la pestaña que coincida con su sistema operativo para obtener instrucciones sobre cómo ejecutar los comandos de esta guía:
Navega al directorio del tutorial "mongodb-kafka-base" dentro del repositorio o del archivo descomprimido usando la consola bash. Si clonaste el repositorio con Git, tu comando será similar al siguiente:
cd kafka-edu/docs-examples/mongodb-kafka-base/
Navegue al directorio del tutorial "mongodb-kafka-base" dentro del repositorio o del archivo descomprimido usando PowerShell. Si clonó el repositorio con Git, su comando será similar al siguiente:
cd kafka-edu\docs-examples\mongodb-kafka-base\
Inicie la imagen de Docker con el siguiente comando:
docker-compose -p mongo-kafka up -d --force-recreate
Nota
Asignaciones de puertos
El entorno sandbox asigna los siguientes servicios a los puertos de su máquina host:
El servidor sandbox MongoDB se asigna al puerto
35001en su máquina hostEl servidor sandbox Kafka Connect JMX está asignado al puerto
35000de tu máquina host
Estos puertos deben estar libres para iniciar el sandbox.
La imagen "mongo-kafka-base" crea un contenedor Docker que incluye todos los servicios que necesita en el tutorial y los ejecuta en una red compartida llamada "mongodb-kafka-base_localnet", como se muestra en el siguiente diagrama:
Cuando el comando se completa exitosamente, genera el siguiente texto:
... Creating zookeeper ... done Creating broker ... done Creating schema-registry ... done Creating connect ... done Creating rest-proxy ... done Creating mongo1 ... done Creating mongo1-setup ... done
Verificar la configuración exitosa
Confirme que el entorno de desarrollo se inició correctamente ejecutando los siguientes comandos:
docker exec mongo1 status
Este comando debería generar la siguiente información si el entorno de desarrollo de Docker se configuró correctamente:
Kafka topics: "topic": "docker-connect-status", "topic": "docker-connect-offsets", "topic": "docker-connect-configs", "topic": "__consumer_offsets", The status of the connectors: Currently configured connectors [] Version of MongoDB Connector for Apache Kafka installed: {"class":"com.mongodb.kafka.connect.MongoSinkConnector","type":"sink","version":"1.8.0"} {"class":"com.mongodb.kafka.connect.MongoSourceConnector","type":"source","version":"1.8.0"}
Como no ha iniciado los conectores, la lista de estado y configuración están vacías.
La configuración de su entorno de desarrollo está completa y puede continuar con el siguiente paso del tutorial.
Tip
Conectar al entorno de desarrollo MongoDB
Puede conectarse al clúster MongoDB que se ejecuta en su entorno de desarrollo con la siguiente cadena de conexión:
mongodb://localhost:35001/?directConnection=true