BalenaBlocks son imágenes de contenedor preconstruidas que los desarrolladores pueden usar para agregar funcionalidad importante a sus aplicaciones de múltiples contenedores, lo que permite una rápida creación de prototipos y desarrollo. En este tutorial, aprenderás a integrar fácilmente Ubidots en tu aplicación balena añadiendo el bloque de Ubidots a una Flota.
Requisitos
balena CLI instalado
Una Flota de balena con un dispositivo creado dentro.
NOTA: En el tutorial, se asume que ya sabes cómo crear una flota y un dispositivo en balena, en caso de que necesites orientación sobre cómo hacerlo, puedes consultar la documentación de balena aquí , y también puedes referirte a los dos primeros pasos de este tutorial para comenzar con balena y Ubidots.
1. Crea tu aplicación
Puedes usar cualquiera de los ejemplos que se encuentran en este repositorio, para este tutorial, usaremos la versión de Python y crearemos la aplicación o proyecto en una computadora local copiando el ejemplo que se encuentra allí.
El código dentro del archivo main.py genera datos aleatorios que se envían a un dispositivo y también a una variable usando MQTT a un broker que se ejecuta en el Bloque de Ubidots.
2. Agrega el bloque de Ubidots a tu proyecto
El docker-compose.yml incluye el Ubidots balenaBlock contenedor junto con su red MQTT requerida y el volumen. Siempre que desees agregar el bloque de Ubidots a una aplicación balena, asegúrate de incluir nuestra imagen, red y volumen en tu archivo docker-compose.yml de la siguiente manera.
version: '2'services: ubidots-balena: image: bh.cr/ubidots/ubidots networks: - ubidots-mqtt restart: always volumes: - ubidots-config:/ubidots/confignetworks: ubidots-mqtt:volumes: ubidots-config:
No olvides incluir tu token de Ubidots como una variable de dispositivo como se puede ver a continuación.
3. Despliega tu aplicación usando el balena CLI
Mientras estés en la carpeta donde tienes tu proyecto, inicia sesión en tu cuenta de balena usando el balena CLI y luego ejecuta el comando:
balena push <nombre de tu flota>
Una vez que el proceso concluya, verás el id de la versión y la versión junto con la imagen de un unicornio.
4. Verifica los datos transmitidos a Ubidots
Deberías poder ver los datos recibidos por Ubidots en tu cuenta de la siguiente manera.
La etiqueta del dispositivo será la misma que el UUID proporcionado por balena.