Installazione di software di rendering ospitato dal cliente

Looker richiede un software di rendering chiamato Chromium per inviare o scaricare dati in formati basati su immagini (file HTML e PNG o PDF) e per utilizzare funzionalità quali Dimensioni carta ed Espandi tabelle. Questa pagina spiega come installare il software di rendering su un'istanza di Looker ospitata dal cliente.

Chromium è già installato per le istanze ospitate da Looker.

Il rendering di Chromium attende che tutte le risorse richieste dalla pagina siano completate prima di inviare l'indicatore "terminato" che chiede a Looker di produrre i contenuti visualizzati. A causa del numero e della frequenza di queste richieste di risorse, alcune reti possono falsificare le richieste come dannose, causando un calo, il che ritarderà i job sottoposti a rendering.

Il progetto Chromium è un progetto open source avviato da Google per condividere le parti non proprietarie di Google Chrome.

Requisiti e prerequisiti per l'installazione di Chromium

Looker supporta le versioni di rilascio di tutte le principali distribuzioni Linux aziendali, tra cui Ubuntu, Debian, RedHat, CentOS e Amazon Linux. Questa pagina fornisce istruzioni per installare Chromium su Ubuntu, Debian e RedHat/CentOS/Amazon Linux.

Chromium deve essere installato in un percorso eseguibile sul computer che ospita l'istanza di Looker. L'applicazione Looker deve accedere a Chromium utilizzando il comando chromium o tramite un percorso personalizzato impostato con la variabile di ambiente CHROMIUM_PATH.

Per eseguire Chromium su un'istanza di Looker, è necessario Chromium 86 o versioni successive, ma Looker consiglia di utilizzare la versione più recente disponibile. Se la tua istanza di Looker è installata su Debian, Chromium richiede Debian 9 (stretch) o versioni successive.

Se installi Chromium in un'installazione di Looker in cluster, la versione di Chromium su ciascun nodo deve essere completamente identica. Anche piccole differenze, come numeri di build diversi, possono interferire con il rendering di Looker.

Se i dati contengono caratteri non inglesi, installa il pacchetto Google Noto Fonts, oltre a installare Chromium.

Le dimensioni di questo pacchetto di caratteri sono diverse.

Per installare questo pacchetto di caratteri, esegui questi comandi nella riga di comando:

  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

In caso di esito positivo,

  cd $HOME
  rm -rf /tmp/fonts

Installare Chromium su Ubuntu

L'applicazione Looker deve accedere a Chromium utilizzando il comando chromium o tramite un percorso personalizzato impostato con la variabile di ambiente CHROMIUM_PATH. Per le installazioni di Ubuntu devi installare il browser web Chromium e quindi impostare un alias in modo che l'applicazione Looker possa trovare l'installazione.

Looker consiglia di utilizzare il comando sudo quando esegue passaggi che richiedono autorizzazioni elevate. Non installare Chromium se hai eseguito l'accesso come utente root. Se installi Chromium dopo aver eseguito l'accesso come utente root, Looker potrebbe non riuscire a eseguire il rendering in PDF o PNG.

  1. Per iniziare, i caratteri devono essere installati nel sistema. Puoi installare i caratteri utilizzando l'interfaccia a riga di comando. Ad esempio, questo comando installa i caratteri predefiniti su Ubuntu 16.04 LTS:
    apt-get install fonts-freefont-otf
  1. Per installare Chromium, esegui:
    apt-get update && apt-get install -y chromium-browser
  1. È necessario alias chromium-browser come chromium o esportare la variabile di ambiente CHROMIUM_PATH. Per alias chromium-browser come chromium, inserisci quanto segue nel file ~/.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. Dopo aver impostato una qualsiasi variabile di ambiente facoltativa, riavvia l'applicazione Looker in modo che abbia effetto. Potrebbe anche essere necessario riavviare le sessioni del terminale aperte o eseguire source ~/.bash_profile per far sì che il terminale legga la nuova configurazione.

Dopo aver installato Chromium, dovresti ricevere una risposta valida da chromium --version se non hai impostato la variabile di ambiente CHROMIUM_PATH oppure $CHROMIUM_PATH --version se hai impostato la variabile di ambiente CHROMIUM_PATH.

Installare Chromium su Debian

Looker consiglia di utilizzare il comando sudo quando esegue passaggi che richiedono autorizzazioni elevate. Non installare Chromium se hai eseguito l'accesso come utente root. Se installi Chromium dopo aver eseguito l'accesso come utente root, Looker potrebbe non riuscire a eseguire il rendering in PDF o PNG.

Chromium richiede Debian 9 (stretch) o versioni successive.

Se la tua istanza di Looker utilizza Docker con un'installazione Debian essenziale, installa procps e assicurati che non sia in esecuzione come root.

  1. Per iniziare, i caratteri devono essere installati nel sistema. Puoi installare i caratteri utilizzando l'interfaccia a riga di comando eseguendo questo comando:
    apt-get install fonts-freefont-otf
  1. Per installare Chromium, esegui:
    apt-get update && apt-get install -y chromium
  1. Dopo aver impostato una qualsiasi variabile di ambiente facoltativa, riavvia l'applicazione Looker in modo che abbia effetto. Potrebbe anche essere necessario riavviare le sessioni del terminale aperte o eseguire source ~/.bash_profile per far sì che il terminale legga la nuova configurazione.

Dopo aver installato Chromium, dovresti ricevere una risposta valida da chromium --version se non hai impostato la variabile di ambiente CHROMIUM_PATH oppure $CHROMIUM_PATH --version se hai impostato la variabile di ambiente CHROMIUM_PATH.

Variabili di ambiente facoltative di Chromium

  • CHROMIUM_PATH: percorso del programma binario di Chromium, il valore predefinito è chromium.

  • CHROMIUM_PID_DIR: percorso in cui la libreria può archiviare i file PID di Chromium, il valore predefinito è chromium_pid_files nella directory di lavoro dell'applicazione Looker.

  • CHROMIUM_PORT_RANGE_START & CHROMIUM_PORT_RANGE_END: l'applicazione Chromium ha bisogno di una gamma di porte per comunicare tra i processi sulla macchina locale. L'intervallo predefinito è 40000-40500, ma puoi sostituirlo impostando entrambe queste variabili di ambiente. Le porte non utilizzate vengono selezionate in modo casuale dall'intervallo e vengono utilizzate solo per la durata di una singola visualizzazione.

  • DISABLE_EXTERNAL_RENDER_ACCESS: gli amministratori di istanze o server Looker ospitati dal cliente che non hanno accesso a Internet esterno o bloccato devono impostare DISABLE_EXTERNAL_RENDER_ACCESS=true. In genere, il renderer di Chromium attende che tutte le risorse richieste dalla pagina siano completate prima che il renderer invii l'indicatore "terminated" che chiede a Looker di produrre il contenuto. Alcune di queste richieste potrebbero essere ignorate a causa della mancanza di connessione, con conseguente timeout o tempi di rendering molto lunghi. L'impostazione di questa variabile di ambiente su true impedisce al renderer di attendere il completamento di tutte le richieste. Alcune visualizzazioni mappa e alcune visualizzazioni personalizzate installate da Looker Marketplace potrebbero richiedere l'accesso a Internet.