Instalación de software de procesamiento 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, PNG o PDF) y usar funciones como Tamaño del papel y Expandir tablas. En esta página, se explica cómo instalar software de procesamiento en una instancia de Looker alojada por el cliente.

Chromium ya está instalado para las instancias alojadas en Looker.

La renderización de Chromium espera a que se completen todos los recursos solicitados por la página antes de enviar el indicador "finalizado" que le indica a Looker que produzca el contenido procesado. Debido a la cantidad y la frecuencia de estas solicitudes de recursos, algunas redes pueden marcar falsamente las solicitudes como maliciosas, lo que hace que se pierdan, lo que retrasará los trabajos renderizados.

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

Requisitos y requisitos previos de instalación de Chromium

Looker admite versiones de actualización de todas las distribuciones empresariales de Linux, como Ubuntu, Debian, Red Hat, CentOS y Amazon Linux. En esta página, se proporcionan instrucciones para instalar Chromium en Ubuntu, Debian y RedHat/CentOS/Amazon Linux.

Chromium debe instalarse en una ruta ejecutable en la máquina que aloja la instancia de Looker. La aplicación de Looker debe acceder a Chromium mediante el comando chromium o mediante una ruta personalizada establecida con la variable de entorno CHROMIUM_PATH.

Para ejecutar Chromium en una instancia de Looker, se requiere Chromium 86 o una versión posterior, pero Looker recomienda usar la última versión disponible. Si tu instancia de Looker está instalada en Debian, Chromium requiere Debian 9 (stretch) o una versión posterior.

Si instalas Chromium en una instalación de Looker agrupada en clústeres, 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 con las capacidades de renderización de Looker.

Si tus datos contienen caracteres no ingleses, instala el paquete Google Noto Fonts además de instalar Chromium.

Este paquete de fuentes tiene varios GB de tamaño.

Para instalar este paquete de fuentes, ejecute estos comandos en su línea de comandos:

  mkdir -p /tmp/fonts
  cd /tmp/fonts
  curl -O https://noto-website-2.storage.googleapis.com/pkgs/Noto-unhinted.zip
  unzip Noto-unhinted.zip
  mkdir -p /usr/share/fonts/opentype/noto
  cp *.otf *.otc /usr/share/fonts/opentype/noto
  mkdir -p /usr/share/fonts/truetype/noto
  cp *.ttf /usr/share/fonts/truetype/noto
  chmod a+r -R /usr/share/fonts/*/noto
  fc-cache -f -v

Si el proceso se realiza correctamente, ocurrirá lo siguiente:

  cd $HOME
  rm -rf /tmp/fonts

Instalación de Chromium en Ubuntu

La aplicación de Looker necesita acceder a Chromium mediante el comando chromium o mediante una ruta de acceso personalizada establecida con la variable de entorno CHROMIUM_PATH. En las instalaciones de Ubuntu, debe instalar el navegador web Chromium y, luego, establecer un alias para que la aplicación de Looker pueda encontrar la instalación.

Looker recomienda usar el comando sudo cuando se realicen pasos que requieran permisos elevados. No instales Chromium cuando accedas como usuario raíz. Si instalas Chromium cuando accedes como usuario raíz, es posible que Looker no pueda ejecutar el procesamiento de PDF o PNG.

  1. Las fuentes deben estar instaladas en el sistema para que Chromium pueda iniciarse. Puedes instalar fuentes con la interfaz de línea de comandos. Por ejemplo, este comando instala las fuentes predeterminadas en Ubuntu 16.04 LTS:
    apt-get install fonts-freefont-otf
  1. Para instalar Chromium, ejecuta lo siguiente:
    apt-get update && apt-get install -y chromium-browser
  1. Debes alias chromium-browser como chromium o exportar la variable de entorno CHROMIUM_PATH. Para agregar un alias a chromium-browser como chromium, coloca lo siguiente en el archivo ~/.bashrc:
    alias chromium='chromium-browser'

To make this alias known to Looker, run this command on the command line:

    sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium
  1. Después de configurar cualquiera de las variables de entorno opcionales, reinicia la aplicación de Looker para que se apliquen. Es posible que también debas reiniciar cualquier sesión de terminal abierta o ejecutar source ~/.bash_profile para que la terminal lea la configuración nueva.

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

Instala Chromium en Debian

Looker recomienda usar el comando sudo cuando se realicen pasos que requieran permisos elevados. No instales Chromium cuando accedas como usuario raíz. Si instalas Chromium cuando accedes como usuario raíz, es posible que Looker no pueda ejecutar el procesamiento de PDF o PNG.

Chromium requiere Debian 9 (stretch) o 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 raíz.

  1. Las fuentes deben estar instaladas en el sistema para que Chromium pueda iniciarse. Para instalar fuentes con la interfaz de línea de comandos, ejecuta lo siguiente:
    apt-get install fonts-freefont-otf
  1. Para instalar Chromium, ejecuta lo siguiente:
    apt-get update && apt-get install -y chromium
  1. Después de configurar cualquiera de las variables de entorno opcionales, reinicia la aplicación de Looker para que se apliquen. Es posible que también debas reiniciar cualquier sesión de terminal abierta o ejecutar source ~/.bash_profile para que la terminal lea la configuración nueva.

Después de instalar Chromium, deberías obtener una respuesta válida de 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 opcionales de Chromium

  • CHROMIUM_PATH: Ruta al objeto binario de Chromium; el valor predeterminado es chromium.

  • CHROMIUM_PID_DIR: Ruta de acceso donde la biblioteca puede almacenar archivos PID de Chromium, la configuración predeterminada es chromium_pid_files en el directorio de trabajo de la aplicación de Looker.

  • CHROMIUM_PORT_RANGE_START &CHROMIUM_PORT_RANGE_END: La aplicación Chromium necesita un rango de puertos para comunicarse entre procesos en la máquina local. El rango predeterminado es 40000-40500, pero puede anular este valor predeterminado configurando ambas variables de entorno. Los puertos sin usar se seleccionan al azar del rango y solo se usan mientras dure un procesamiento.

  • DISABLE_EXTERNAL_RENDER_ACCESS: Los administradores de instancias o servidores de Looker alojados por el cliente que no tengan acceso a Internet externo o bloqueado deben configurar DISABLE_EXTERNAL_RENDER_ACCESS=true. Por lo general, el procesador de Chromium esperará a que se completen todos los recursos solicitados por la página antes de enviar el indicador "finalizado" que le indica a Looker que produzca el contenido. Algunas de estas solicitudes pueden descartarse debido a la falta de conexión, lo que genera tiempos de espera o tiempos de procesamiento muy largos. Establecer esta variable de entorno en true evita que el procesador espere a que finalicen todas las solicitudes. Algunas visualizaciones de mapas y algunas personalizadas que se instalan desde Looker Marketplace pueden requerir acceso a Internet.