Ten en cuenta que estás viendo la documentación de Looker. Para obtener documentación de Looker Studio, visita https://support.google.com/looker-studio.

Se usó la API de Cloud Translation para traducir esta página.

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 de papel y Expandir tablas. En esta página, se explica cómo instalar el software de renderización en una instancia de Looker alojada por el cliente.

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

El procesamiento de Chromium espera a que se completen todos los recursos solicitados por la página antes de enviar el estado "finalizado" Señal que le pide a Looker producir el contenido renderizado. Debido a la cantidad y la frecuencia de estas solicitudes de recursos, algunas redes pueden marcar de manera falsa las solicitudes como maliciosas, lo que provoca que se pierdan, lo que retrasará los trabajos renderizados.

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

Requisitos y requisitos previos de instalación de Chromium

Looker admite versiones de lanzamiento de todas las distribuciones principales de Linux empresariales, incluidas 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 se debe instalar en una ruta de acceso ejecutable en la máquina que aloja la instancia de Looker. La aplicación de Looker debe acceder a Chromium con el comando chromium o con una ruta de acceso 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 específicamente Chromium 102.x. 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, 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.

Si los datos contienen caracteres que no son del inglés, instala el paquete de Google Noto Fonts (que tiene un tamaño de varios GB), además de instalar Chromium. Para instalar este paquete de fuentes, ejecuta estos comandos en la 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   # Ignore any *.otc not found errors
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 se realiza correctamente, ocurrirá lo siguiente:

cd $HOME
rm -rf /tmp/fonts

Cómo instalar Chromium en Ubuntu

La aplicación de Looker debe acceder a Chromium con el comando chromium o con una ruta de acceso personalizada establecida con la variable de entorno CHROMIUM_PATH. En 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.

Looker recomienda que uses el comando sudo cuando realices pasos que requieran permisos elevados. No instales Chromium cuando hayas accedido como usuario raíz. Si instalas Chromium mientras accedes como usuario raíz, es posible que Looker no pueda ejecutar la renderización de PDF o PNG.

Las fuentes deben estar instaladas en el sistema para que se inicie Chromium. 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
```

Para instalar Chromium, ejecuta el siguiente comando:

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

Se debe incluir un alias a chromium-browser como chromium o exportar la variable de entorno CHROMIUM_PATH. Para asignar un alias a chromium-browser como chromium, coloca lo siguiente en el archivo ~/.bashrc:
```
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
```
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 las sesiones de la terminal abiertas 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.

Cómo instalar Chromium en Debian

Looker recomienda que uses el comando sudo cuando realices pasos que requieran permisos elevados. No instales Chromium cuando hayas accedido como usuario raíz. Si instalas Chromium mientras accedes como usuario raíz, es posible que Looker no pueda ejecutar la renderización de PDF o PNG.

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 con permisos de administrador.

Para que Chromium se inicie, las fuentes deben estar instaladas en el sistema. Puedes instalar fuentes usando la interfaz de línea de comandos ejecutando lo siguiente:
```
apt-get install fonts-freefont-otf
```

Para instalar Chromium, ejecuta lo siguiente:

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

Después de configurar cualquiera de las variables de entorno opcionales, reinicia la aplicación de Looker para que estas tengan efecto. Es posible que también debas reiniciar las sesiones 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 de $CHROMIUM_PATH --version si la configuraste.

Variables de entorno opcionales de Chromium

CHROMIUM_PATH: Ruta al objeto binario de Chromium; el valor predeterminado es chromium.
CHROMIUM_PID_DIR: Es la ruta de acceso a la que la biblioteca puede almacenar archivos de PID de Chromium. El valor predeterminado es 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 40,000 a 40,500, pero puedes anularlo configurando estas dos variables de entorno. Los puertos sin usar se seleccionan de forma aleatoria dentro del rango y solo se usan durante una única renderización.
DISABLE_EXTERNAL_RENDER_ACCESS: Los administradores de instancias o servidores de Looker alojados por el cliente que no tengan acceso externo o bloqueado a Internet deben configurar DISABLE_EXTERNAL_RENDER_ACCESS=true. Por lo general, el renderizador de Chromium esperará a que se completen todos los recursos que solicita la página antes de enviar el indicador "terminado" que le indica a Looker que produzca 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 estableces esta variable de entorno en true, se evita que el renderizador espere a que finalicen todas las solicitudes. Algunas visualizaciones de mapas y otras personalizadas que se instalan desde Looker Marketplace pueden requerir acceso a Internet.