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 Format 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 requêtes de ressources, certains réseaux peuvent les signaler à tort comme malveillantes, ce qui les fait abandonner et 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, découvrez les sujets suivants :

Conditions requises et prérequis pour l'installation de Chromium

Cette page fournit des exemples d'instructions d'installation de Chromium qui sont indépendantes d'un 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 [environment variable(#optional_chromium_environment_variables).

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

Points à connaître concernant 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+, 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 nécessite Debian 9 (stretch) ou une version ultérieure. Si votre instance Looker utilise Docker avec une installation Debian de base, installez procps et assurez-vous de ne pas exécuter en tant qu'utilisateur racine.

Installer des packages de polices

Un package de polices Microsoft OpenType (OTF) doit être installé sur le système pour que Chromium puisse démarrer. Les packages OTF utilisent des extensions 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 Google Noto Fonts (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 chromium-browser en tant que chromium ou exporter la variable d'environnement CHROMIUM_PATH. Pour créer 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 puissent prendre effet. Vous devrez peut-être également redémarrer les sessions de terminal ouvertes ou la source de votre fichier shell pour que le terminal puisse lire 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 en exécutant $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 à l'emplacement où la bibliothèque peut stocker les fichiers PID Chromium, par défaut 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 la machine locale. 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'un manque de connexion, ce qui entraîne des délais d'attente 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 de cartes et certaines visualisations personnalisées installées à partir du Marketplace Looker peuvent nécessiter un accès à Internet.