Instalación del software de renderización alojada por el cliente

Looker requiere un software de renderización llamado Chromium para enviar o descargar datos en formatos basados en imágenes (archivos HTML y PNG o PDF) y para usar funciones como Tamaño del papel y Ampliar tablas. En esta página se explica cómo instalar software de renderización en una instancia de Looker alojada por el cliente.

La renderización de Chromium espera a que se completen todos los recursos que ha solicitado la página antes de enviar la señal "finished" (finalizado) que indica a Looker que genere el contenido renderizado. Debido al número y la frecuencia de estas solicitudes de recursos, algunas redes pueden marcar erróneamente las solicitudes como maliciosas, lo que provoca que se rechacen y, por lo tanto, que se retrasen los trabajos renderizados.

El proyecto Chromium es un proyecto de código abierto que Google puso en marcha para compartir las partes no propietarias de Google Chrome.

Antes de empezar

Antes de instalar Chromium, consulta más información sobre los siguientes temas:

Requisitos y requisitos previos de instalación de Chromium

En esta página se proporcionan instrucciones de ejemplo para instalar Chromium que son independientes del tipo de distribución. También puedes descargar Chromium y seguir las instrucciones de instalación que se indican en esta página.

Para ejecutar Chromium en una instancia de Looker, se necesita Chromium 97, Chromium 109 o Chromium 114. Chromium debe instalarse en una ruta ejecutable en el equipo que aloja la instancia de Looker. La aplicación Looker necesita acceder a Chromium mediante el comando chromium o mediante una ruta personalizada definida con la CHROMIUM_PATH [variable de entorno(#optional_chromium_environment_variables).

Si vas a instalar Chromium en una instalación de Looker en clúster, la versión de Chromium de cada nodo debe ser exactamente la misma. Incluso las diferencias menores, como los diferentes números de compilación, pueden interferir en las funciones de renderización de Looker.

Información sobre la instalación de Chromium en distribuciones específicas

Looker admite versiones de lanzamiento de las principales distribuciones de Linux para empresas, incluidas Ubuntu (versiones LTS), Debian 9+, Red Hat Enterprise Linux (RHEL) 7+, CentOS 7+ y Amazon Linux.

En las instalaciones de Ubuntu, debes instalar el navegador web Chromium y, a continuación, definir un alias para que la aplicación Looker pueda encontrar la instalación.

En las instalaciones de Debian, Chromium requiere Debian 9 (stretch) o una versión posterior. Si tu instancia de Looker usa Docker con una instalación básica de Debian, instala procps y asegúrate de que no se esté ejecutando como root.

Instalar paquetes de fuentes

Para que Chromium se inicie, debe instalarse en el sistema un paquete de fuentes OpenType (OTF) de Microsoft. Los paquetes OTF usan la extensión de archivo .otf. Puedes descargar cualquier paquete OTF, como este paquete OTF de Google Fonts.

Si sus datos contienen caracteres que no son del alfabeto inglés, también debe instalar el paquete de fuentes Noto de Google (que ocupa varios GB).

Después de instalar estos paquetes, ejecuta los siguientes comandos:

cd $HOME
rm -rf /tmp/fonts

Instalar Chromium

  1. Para instalar Chromium, ejecuta el comando de instalación que corresponda a tu sistema. Por ejemplo:

    apt-get update && apt-get install -y chromium-browser

  2. Debes asignar el alias chromium-browser como chromium o exportar la variable de entorno CHROMIUM_PATH. Para asignar el alias chromium-browser a chromium, coloca lo siguiente en el archivo de shell que corresponda a tu sistema. Por ejemplo:

    alias chromium='chromium-browser'

    Para que Looker conozca este alias, ejecuta este comando en la línea de comandos:

    sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium

  3. Después de definir cualquiera de las variables de entorno opcionales, reinicia la aplicación Looker para que las variables surtan efecto. También es posible que tengas que reiniciar las sesiones de terminal abiertas o ejecutar el archivo de shell para que el terminal lea la nueva configuración.

Después de instalar Chromium, deberías obtener una respuesta válida al ejecutar chromium --version (si no has definido la variable de entorno CHROMIUM_PATH) o $CHROMIUM_PATH --version (si has definido la variable de entorno CHROMIUM_PATH).

Variables de entorno de Chromium opcionales

  • CHROMIUM_PATH: ruta al archivo binario de Chromium. El valor predeterminado es chromium.

  • CHROMIUM_PID_DIR: ruta a la ubicación donde la biblioteca puede almacenar archivos PID de Chromium. El valor predeterminado es chromium_pid_files en el directorio de trabajo de la aplicación Looker.

  • CHROMIUM_PORT_RANGE_START y CHROMIUM_PORT_RANGE_END: la aplicación Chromium necesita un intervalo de puertos para comunicarse entre procesos en la máquina local. El intervalo predeterminado es 40000-40500, pero puedes anularlo configurando ambas variables de entorno. Los puertos no utilizados se seleccionan aleatoriamente del intervalo y solo se usan durante la duración de una sola renderización.

  • DISABLE_EXTERNAL_RENDER_ACCESS: Los administradores de instancias o servidores de Looker alojados por el cliente que no tengan acceso a Internet externo o que lo tengan bloqueado deben definir DISABLE_EXTERNAL_RENDER_ACCESS=true. Normalmente, el renderizador de Chromium espera a que se completen todos los recursos solicitados por la página antes de enviar la señal "finished" (finalizado) que indica a Looker que genere el contenido. Es posible que algunas de estas solicitudes se descarten debido a la falta de conexión, lo que provoca que se agote el tiempo de espera o que los tiempos de renderización sean muy largos. Si se asigna el valor true a esta variable de entorno, el renderizador no esperará a que finalicen todas las solicitudes. Es posible que algunas visualizaciones de mapas y algunas visualizaciones personalizadas instaladas desde Looker Marketplace requieran acceso a Internet.