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 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 à produire le contenu rendu. En raison du nombre et de la fréquence de ces demandes de ressources, certains réseaux peuvent les signaler à tort comme malveillantes, ce qui les fait échouer et retarde vos tâches rendues.

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

Avant de commencer

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

Exigences et prérequis pour l'installation de Chromium

Cette page fournit des exemples d'instructions pour installer Chromium, indépendamment 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 en utilisant la commande chromium ou un chemin d'accès personnalisé défini avec la variable d'environnement CHROMIUM_PATH.

Si vous installez Chromium sur une installation Looker en cluster, la version de Chromium sur chaque nœud doit être parfaitement identique. Même des différences mineures, comme des numéros de version différents, peuvent interférer avec les capacité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 pour les entreprises, y compris Ubuntu (versions LTS), Debian 9+, RedHat Enterprise Linux (RHEL) 7+, CentOS 7+ 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 requiert Debian 9 (stretch) ou version ultérieure. Si votre instance Looker utilise Docker avec une installation Debian de base, installez procps et assurez-vous de ne pas l'exécuter en tant que root.

Installer des packages de polices

Un package de police Microsoft OpenType (OTF) doit être installé sur le système pour que Chromium puisse démarrer. Les packages OTF utilisent l'extension de fichier .otf. Vous pouvez télécharger n'importe quel package OTF, tel que 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 pèse plusieurs Go).

Après avoir installé ces packages, 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 chromium-browser comme alias de chromium, placez le code suivant dans le fichier shell qui s'applique à votre système. Exemple :

    alias chromium='chromium-browser'

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

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

  3. Après avoir défini l'une des variables d'environnement facultatives, redémarrez l'application Looker pour que les variables soient prises en compte. Vous devrez peut-être également redémarrer les sessions de terminal ouvertes ou la source de votre fichier shell pour que le terminal lise la nouvelle configuration.

Après avoir installé Chromium, 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, qui est défini par défaut sur chromium.

  • CHROMIUM_PID_DIR : chemin d'accès à l'emplacement 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 la remplacer 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 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 chargées avant d'envoyer le signal "terminé" qui invite Looker à générer le contenu. Il est possible que certaines de ces requêtes soient abandonnées en raison d'un manque de connexion, ce qui entraîne des délais avant expiration ou des temps de rendu très longs. Si vous définissez cette variable d'environnement sur true, le moteur de rendu n'attend pas la fin de toutes les requêtes. Certaines visualisations de cartes et certaines visualisations personnalisées installées depuis le Marketplace Looker peuvent nécessiter un accès à Internet.