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

Looker nécessite un logiciel de rendu appelé Chromium pour envoyer ou télécharger des données dans des formats basés sur des images (fichiers HTML, 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.

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 à générer le contenu affiché. En raison du nombre et de la fréquence de ces requêtes de ressources, certains réseaux peuvent les signaler à tort comme étant malveillantes, ce qui les fait tomber, ce qui retarde vos 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.

Avant de commencer

Avant d'installer Chromium, renseignez-vous sur les sujets suivants:

Exigences et prérequis d'installation de Chromium

Cette page fournit des exemples d'instructions d'installation de Chromium, qui sont indépendants du type de distribution. Vous pouvez également télécharger Chromium, puis suivre les instructions d'installation restantes sur cette page.

Pour exécuter Chromium sur une instance Looker, vous devez disposer de Chromium 97, Chromium 109 ou Chromium 114. Chromium doit être installé dans un chemin d'accès 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 d'accès personnalisé défini avec la variable d'environnement CHROMIUM_PATH [variable d'environnement(#optional_chromium_environment_variables).

Si vous installez Chromium sur une installation Looker en cluster, la version de Chromium sur chaque nœud doit être entièrement identique. Même de légères différences, comme des numéros de build différents, peuvent interférer avec les fonctionnalités de rendu de Looker.

Informations à connaître sur l'installation de Chromium sur des distributions spécifiques

Looker est compatible avec les versions de toutes les principales distributions Linux d'entreprise, y compris Ubuntu (versions LTS), Debian 9 et versions ultérieures, RedHat Enterprise Linux (RHEL) 7 et versions ultérieures, CentOS 7 et versions ultérieures, et Amazon Linux.

Pour les installations Ubuntu, vous devez installer le navigateur Web Chromium, puis définir un alias pour que l'application Looker puisse trouver l'installation.

Pour les installations Debian, Chromium nécessite Debian 9 (stretch) ou version ultérieure. Si votre instance Looker utilise Docker avec une installation Debian basique, installez procps et assurez-vous de ne pas l'exécuter en tant que root.

Installer des packages de polices

Un package de polices Microsoft OpenType (OTF) doit être installé sur le système pour que Chromium démarre. Les packages OTF utilisent des extensions de fichier .otf. Vous pouvez télécharger n'importe quel package OTF, comme ce package OTF de Google Fonts.

Si vos données contiennent des caractères non anglais, vous devez également installer le package de polices Google Noto (qui fait plusieurs Go).

Après avoir installé ces paquets, exécutez les commandes suivantes:

cd $HOME
rm -rf /tmp/fonts

Installer Chromium

  1. Pour installer Chromium, exécutez la commande d'installation applicable à votre système. Exemple :

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

  2. Vous devez créer un alias de chromium-browser en tant que chromium ou exporter la variable d'environnement CHROMIUM_PATH. Pour définir un alias chromium-browser en tant que chromium, placez le code suivant dans le fichier shell applicable à votre système. Exemple :

    alias chromium='chromium-browser'

    Pour que Looker connaisse cet alias, exécutez la commande suivante dans la ligne de commande:

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

  3. Une fois que vous avez défini l'une des variables d'environnement facultatives, redémarrez l'application Looker pour que les variables prennent effet. Vous devrez peut-être également redémarrer les sessions de terminal ouvertes ou sourcer votre fichier shell pour que le terminal lise la nouvelle configuration.

Une fois Chromium installé, vous devriez obtenir une réponse valide en exécutant 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, par défaut chromium.

  • CHROMIUM_PID_DIR: chemin d'accès où la bibliothèque peut stocker les fichiers PID Chromium. La valeur par défaut est chromium_pid_files dans le répertoire de travail de l'application Looker.

  • CHROMIUM_PORT_RANGE_START et CHROMIUM_PORT_RANGE_END: l'application Chromium a besoin d'une plage de ports pour communiquer entre les processus sur l'ordinateur local. La plage par défaut est 40000-40500, mais vous pouvez remplacer cette valeur par défaut en définissant ces deux variables d'environnement. Les ports inutilisés sont sélectionnés de manière aléatoire dans la plage et ne sont utilisés que pendant la durée d'un seul rendu.

  • DISABLE_EXTERNAL_RENDER_ACCESS: les administrateurs des instances ou des 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. En règle générale, 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 abandonnées en raison d'une absence de connexion, ce qui entraîne des délais avant expiration ou des temps de rendu très longs. 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 cartographiques et certaines visualisations personnalisées installées depuis le Marketplace Looker peuvent nécessiter une connexion Internet.