Guía de Instalación

En ésta sección te explicaremos cómo obtener la última versión de suite-composer y cómo instalarla en tu sistema operativo utilizando docker.

Docker es una plataforma de código abierto diseñada para agilizar la creación, implementación y ejecución de aplicaciones en entornos ligeros y portátiles conocidos como contenedores.

Imágenes: Las imágenes son plantillas ligeras que contienen lo esencial para ejecutar una aplicación o sistema. Se utilizan para crear contenedores y pueden compartirse.

Contenedores: Los contenedores son como pequeñas cajas que contienen todo lo necesario para que una aplicación se ejecute, como código, bibliotecas y configuraciones.

Para ejecutar suite-composer-0.1.0-beta es necesario tener instalado docker.

Instalación de la Imagen en tu Sistema:

Obtiene la última versión de suite-composer con el siguiente comando:

$ docker pull comdigis/arm64v8-composer

Importante señalar que actualmente suite-composer soporta las siguientes arquitecturas: arm64, arm64v8 y x86_64.

Visita docker hub para encontrar tu imagen compatible.

Inicialización del servidor PulseAudio:

Para iniciar el servidor PulseAudio, utiliza el siguiente comando:

$ pulseaudio --load=module-native-protocol-tcp --exit-idle-time=-1

Este comando carga el módulo module-native-protocol-tcp que permite la comunicación a través del protocolo TCP, y establece el tiempo de inactividad (--exit-idle-time) en -1, lo que significa que el servidor no se cerrará automáticamente debido a la inactividad.

Inicializando

Para ejecutar suite-composer desde macOS (m1), debes ejecutar el siguiente comando.

$ docker volume create suite-composer-volume \
    && docker run -it -p 22:22 -p 8080:8080 --name suite-composer \
       -v suite-composer-volume:/home/suite \
       -e PULSE_SERVER="docker.for.mac.localhost" \
       -v ~/.config/pulse/cookie:/home/suite/.config/pulse/cookie \
       comdigis/arm64v8-composer:latest

Para ejecutar suite-composer desde macOS (Intel), debes ejecutar el siguiente comando.

$ docker volume create suite-composer-volume \
    && docker run -it -p 22:22 -p 8080:8080 --name suite-composer \
       -v suite-composer-volume:/home/suite \
       -e PULSE_SERVER="docker.for.mac.localhost" \
       -v ~/.config/pulse/cookie:/home/suite/.config/pulse/cookie \
       --platform linux/arm64 \
       -v /usr/bin/qemu-aarch64-static:/usr/bin/qemu-aarch64-static \
       comdigis/arm64v8-composer:latest

Para ejecutar suite-composer desde Linux (arm64), debes ejecutar el siguiente comando.

$ docker volume create suite-composer-volume \
    && docker run -it -p 22:22 -p 8080:8080 --name suite-composer \
       -v suite-composer-volume:/home/suite \
       -e PULSE_SERVER=unix:${XDG_RUNTIME_DIR}/pulse/native \
			 -v ${XDG_RUNTIME_DIR}/pulse/native:${XDG_RUNTIME_DIR}/pulse/native \
			 -v ~/.config/pulse/cookie:/root/.config/pulse/cookie \
       comdigis/arm64v8-composer:latest

Para ejecutar suite-composer desde Linux (x86_64), debes ejecutar el siguiente comando.

$ docker volume create suite-composer-volume \
    && docker run -it -p 22:22 -p 8080:8080 --name suite-composer \
       -v suite-composer-volume:/home/suite \
       -e PULSE_SERVER=unix:${XDG_RUNTIME_DIR}/pulse/native \
			 -v ${XDG_RUNTIME_DIR}/pulse/native:${XDG_RUNTIME_DIR}/pulse/native \
			 -v ~/.config/pulse/cookie:/root/.config/pulse/cookie \
       --platform linux/arm64 \
       -v /usr/bin/qemu-aarch64-static:/usr/bin/qemu-aarch64-static \
       comdigis/arm64v8-composer:latest

Probando la Instalación

Para probar la unidad puedes iniciar sesión desde el exterior para obtener el token. Recomendamos utilizar Postman o CURL.

curl --location --request POST 'https://IP_DE_TU_DISPOSITIVO:8080/api/auth/authenticate' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'username=admin' \
--data-urlencode 'password=admin'

Por defecto el usuario y la contraseña serán admin

Una vez autenticado puede realizar la primera interacción por HTTP (no olvides de reemplazar el token por el que acabas de obtener).

curl --location --request POST 'https://IP_DE_TU_DISPOSITIVO:8080/api/interaction/ask' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE1Njk2Mzc1NTguNjIzNTI0LCJpc3MiOiJLaXR1cmUiLCJhZG1pbiI6dHJ1ZSwic3ViIjoiYWRtaW4ifQ.p-1x12EUoBmpCZRoTNTYlFxhFVh1OV8E5sjQ2InyIY8' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'utterance=que hora es'

El sistema debería responderte 200 OK con la hora actual.