Installation du logiciel de rendu hébergée par le client

Looker nécessite un logiciel appelé Chromium pour envoyer ou télécharger des données dans des formats basés sur des images (fichiers HTML et PNG ou PDF), et pour utiliser des fonctionnalités telles que Taille du papier et Développer les tableaux. Cette page explique comment installer un logiciel de rendu sur une instance de Looker hébergée par le client.

Chromium est déjà installé pour les instances hébergées par Looker.

Le rendu Chromium attend que toutes les ressources demandées par la page soient terminées avant d'envoyer le signal "terminé" qui invite Looker à produire le contenu affiché. En raison du nombre et de la fréquence de ces demandes de ressources, certains réseaux peuvent envoyer à tort des requêtes comme malveillantes et les faire tomber, ce qui retarde les tâches de rendu.

Le projet Chromium est un projet Open Source lancé par Google pour partager les parties non propriétaires de Google Chrome.

Conditions requises et conditions d'installation de Chromium

Looker est compatible avec les versions de toutes les principales distributions Linux d'entreprise, y compris Ubuntu, Debian, RedHat, CentOS et Amazon Linux. Cette page explique comment installer Chromium sur Ubuntu, Debian et RedHat/CentOS/Amazon Linux.

Chromium doit être installé dans un chemin exécutable sur la machine qui héberge l'instance Looker. L'application Looker doit accéder à Chromium à l'aide de la commande chromium ou d'un chemin personnalisé défini avec la variable d'environnement CHROMIUM_PATH.

Pour exécuter Chromium sur une instance Looker, Chromium 86 ou une version ultérieure est requis, mais Looker recommande d'utiliser la dernière version disponible. Si votre instance Looker est installée sur Debian, Chromium nécessite Debian 9 (Stretch) ou une version ultérieure.

Si vous installez Chromium sur une installation Looker en cluster, la version de Chromium sur chaque nœud doit être complètement identique. Même des différences mineures, telles que des numéros de build différents, peuvent interférer avec les fonctionnalités de rendu de Looker.

Si vos données contiennent des caractères qui ne sont pas en anglais, installez le package Google Noto Fonts en plus de Chromium.

Ce package de police fait plusieurs Go.

Pour installer ce package de police, exécutez les commandes suivantes dans votre ligne de commande:

  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 l'opération réussit:

  cd $HOME
  rm -rf /tmp/fonts

Installer Chromium sur Ubuntu

L'application Looker doit accéder à Chromium à l'aide de la commande chromium ou d'un chemin personnalisé défini avec la variable d'environnement CHROMIUM_PATH. Pour les installations Ubuntu, vous devez installer le navigateur Web Chromium, puis définir un alias afin que l'application Looker puisse trouver l'installation.

Looker recommande d'utiliser la commande sudo lorsque vous effectuez des étapes nécessitant des autorisations élevées. N'installez pas Chromium lorsque vous êtes connecté en tant qu'utilisateur racine. Si vous installez Chromium en étant connecté en tant qu'utilisateur racine, Looker risque de ne pas pouvoir exécuter le rendu des fichiers PDF ou PNG.

  1. Les polices doivent être installées sur le système pour que Chromium démarre. Vous pouvez installer des polices à l'aide de l'interface de ligne de commande. Par exemple, cette commande installe les polices par défaut sur Ubuntu 16.04 LTS:
    apt-get install fonts-freefont-otf
  1. Pour installer Chromium, exécutez la commande suivante:
    apt-get update && apt-get install -y chromium-browser
  1. Vous devez définir l'alias chromium-browser sur chromium ou exporter la variable d'environnement CHROMIUM_PATH. Pour créer l'alias chromium-browser en tant que chromium, placez le code suivant dans le fichier ~/.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. Après avoir défini l'une des variables d'environnement facultatives, redémarrez l'application Looker pour qu'elle prenne effet. Vous devrez peut-être aussi redémarrer des sessions de terminal ouvertes ou exécuter source ~/.bash_profile pour que le terminal puisse lire la nouvelle configuration.

Après avoir installé Chromium, vous devriez recevoir une réponse valide de chromium --version si vous n'avez pas défini la variable d'environnement CHROMIUM_PATH ou $CHROMIUM_PATH --version si vous avez défini la variable d'environnement CHROMIUM_PATH.

Installer Chromium sur Debian

Looker recommande d'utiliser la commande sudo lorsque vous effectuez des étapes nécessitant des autorisations élevées. N'installez pas Chromium lorsque vous êtes connecté en tant qu'utilisateur racine. Si vous installez Chromium en étant connecté en tant qu'utilisateur racine, Looker risque de ne pas pouvoir exécuter le rendu des fichiers PDF ou PNG.

Chromium nécessite Debian 9 (stretch) ou une version ultérieure.

Si votre instance Looker utilise Docker avec une installation Debian simple, installez procps et assurez-vous que vous ne vous exécutez pas en mode root.

  1. Les polices doivent être installées sur le système pour que Chromium démarre. Vous pouvez installer des polices à l'aide de l'interface de ligne de commande en exécutant la commande suivante:
    apt-get install fonts-freefont-otf
  1. Pour installer Chromium, exécutez la commande suivante:
    apt-get update && apt-get install -y chromium
  1. Après avoir défini l'une des variables d'environnement facultatives, redémarrez l'application Looker pour qu'elle prenne effet. Vous devrez peut-être aussi redémarrer des sessions de terminal ouvertes ou exécuter source ~/.bash_profile pour que le terminal puisse lire la nouvelle configuration.

Après avoir installé Chromium, vous devriez recevoir une réponse valide de chromium --version si vous n'avez pas défini la variable d'environnement CHROMIUM_PATH ou $CHROMIUM_PATH --version si vous avez défini la variable d'environnement CHROMIUM_PATH.

Variables d'environnement Chromium facultatives

  • CHROMIUM_PATH: chemin d'accès au binaire Chromium, défini par défaut sur chromium.

  • CHROMIUM_PID_DIR : chemin d'accès à la bibliothèque dans lequel les fichiers PID Chromium peuvent être stockés. La valeur par défaut est chromium_pid_files dans le répertoire de travail de l'application Looker.

  • CHROMIUM_PORT_RANGE_START & CHROMIUM_PORT_RANGE_END : l'application Chromium a besoin de plusieurs ports pour communiquer entre les processus sur la machine locale. La plage par défaut est comprise entre 40000 et 40500, mais vous pouvez remplacer cette plage par défaut en définissant ces deux variables d'environnement. Les ports inutilisés sont sélectionnés au hasard dans la plage et ne sont utilisés que pendant la durée d'un seul rendu.

  • DISABLE_EXTERNAL_RENDER_ACCESS : les administrateurs d'instances ou de serveurs Looker hébergés par le client qui n'ont pas d'accès Internet externe ou bloqué doivent définir DISABLE_EXTERNAL_RENDER_ACCESS=true. Généralement, le moteur de rendu Chromium attend que toutes les ressources demandées par la page soient terminées avant d'envoyer le signal "terminé" qui invite Looker à produire le contenu. Certaines de ces requêtes peuvent être ignorées en raison de l'absence de connexion, ce qui entraîne des délais avant expiration ou de très longs délais d'affichage. Définir cette variable d'environnement sur true empêche le moteur de rendu d'attendre la fin de toutes les requêtes. Certaines visualisations de carte et certaines visualisations personnalisées installées à partir de Looker Marketplace peuvent nécessiter un accès à Internet.