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 de papel y Expandir 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 solicitó la página antes de enviar el indicador "finalizado" que le indica a Looker que genere el contenido renderizado. Debido a la cantidad y la frecuencia de estas solicitudes de recursos, algunas redes pueden marcar erróneamente las solicitudes como maliciosas, lo que provoca que se descarten y retrasa los trabajos renderizados.

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

Antes de comenzar

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

Requisitos y requisitos previos para la instalación de Chromium

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

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

Si instalas Chromium en una instalación de Looker en clúster, la versión de Chromium en cada nodo debe ser completamente idéntica. Incluso las diferencias menores, como los diferentes números de compilación, pueden interferir en las capacidades de renderización de Looker.

Aspectos que debes saber sobre la instalación de Chromium en distribuciones específicas

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

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

Para 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 no ejecutarlo como raíz.

Instala paquetes de fuentes

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

Si tus datos contienen caracteres que no son en inglés, también debes instalar el paquete de fuentes Noto de Google (que tiene un tamaño de varios GB).

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

cd $HOME
rm -rf /tmp/fonts

Cómo instalar Chromium

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

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

  2. Debes asignar un alias a chromium-browser como chromium o exportar la variable de entorno CHROMIUM_PATH. Para crear un alias de chromium-browser como 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 el siguiente comando en la línea de comandos:

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

  3. Después de configurar cualquiera de las variables de entorno opcionales, reinicia la aplicación de Looker para que las variables puedan aplicarse. Es posible que también debas reiniciar las sesiones de terminal abiertas o ejecutar el archivo de shell para que la terminal lea la nueva configuración.

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

Variables de entorno de Chromium opcionales

  • CHROMIUM_PATH: Es la ruta de acceso al objeto binario de Chromium. El valor predeterminado es chromium.

  • CHROMIUM_PID_DIR: Es la ruta de acceso a la ubicación en la que la biblioteca puede almacenar archivos PID de Chromium. De forma predeterminada, se establece en chromium_pid_files en el directorio de trabajo de la aplicación de Looker.

  • CHROMIUM_PORT_RANGE_START y CHROMIUM_PORT_RANGE_END: La aplicación de Chromium necesita un rango de puertos para comunicarse entre los procesos de la máquina local. El rango predeterminado es de 40000 a 40500, pero puedes anular este valor predeterminado configurando ambas variables de entorno. Los puertos no utilizados se seleccionan de forma aleatoria del rango 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 tienen acceso externo o bloqueado a Internet deben establecer DISABLE_EXTERNAL_RENDER_ACCESS=true. Por lo general, el renderizador de Chromium espera a que se completen todos los recursos que solicita la página antes de enviar el indicador "finalizado" que le 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 genera tiempos de espera o tiempos de renderización muy largos. Si se establece esta variable de entorno en true, se evita que el renderizador espere a que finalicen todas las solicitudes. Es posible que algunas visualizaciones de mapas y algunas visualizaciones personalizadas que se instalan desde Looker Marketplace requieran acceso a Internet.