Looker richiede un software di rendering chiamato Chromium per inviare o scaricare i dati in formati basati su immagini (file HTML, PNG o PDF) e per utilizzare funzionalità come Formato 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 segnalare erroneamente le richieste come dannose, causando un calo, con un conseguente ritardo dei job di cui è stato eseguito il 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 release 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 Chromium 97.x nello specifico. Se la tua istanza di Looker è installata su Debian, Chromium richiede Debian 9 (stretch) o versioni successive.
Se installi Chromium su un'installazione di Looker in cluster, la versione di Chromium su ciascun nodo deve essere completamente identica. Anche piccole differenze, ad esempio numeri di build diversi, possono interferire con le funzionalità di rendering di Looker.
Se i dati contengono caratteri non inglesi, installa il pacchetto di caratteri Google Noto (di dimensioni diverse da GB) oltre all'installazione di Chromium. Per installare questo pacchetto di caratteri, esegui il comando 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 # Ignore any *.otc not found errors
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
Se l'operazione ha esito positivo, procedi nel seguente modo:
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 esegui 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 essere in grado di eseguire il rendering PDF o PNG.
Per poter avviare Chromium, sul dispositivo devono essere installati caratteri. 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
Per installare Chromium, esegui:
apt-get update && apt-get install -y chromium-browser
Devi assegnare un alias
chromium-browser
achromium
o esportare la variabile di ambienteCHROMIUM_PATH
. Per impostare l'aliaschromium-browser
comechromium
, inserisci quanto segue nel file~/.bashrc
:alias chromium='chromium-browser'
Per rendere noto l'alias a Looker, esegui questo comando dalla riga di comando:
sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium
Dopo aver impostato una delle variabili di ambiente facoltative, riavvia l'applicazione Looker per renderle effettive. Potrebbe anche essere necessario riavviare qualsiasi sessione del terminale aperta oppure 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
o $CHROMIUM_PATH --version
se hai impostato la variabile di ambiente CHROMIUM_PATH
.
Installazione di Chromium su Debian
Looker consiglia di utilizzare il comando sudo
quando esegui 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 essere in grado di eseguire il rendering PDF o PNG.
Chromium richiede Debian 9 (stretch) o versioni successive.
Se la tua istanza di Looker utilizza Docker con un'installazione Debian semplice, installa procps e assicurati che non sia in esecuzione come root.
Per poter avviare Chromium, sul dispositivo devono essere installati caratteri. Puoi installare i caratteri utilizzando l'interfaccia a riga di comando eseguendo questo comando:
apt-get install fonts-freefont-otf
Per installare Chromium, esegui:
apt-get update && apt-get install -y chromium
Dopo aver impostato una delle variabili di ambiente facoltative, riavvia l'applicazione Looker per renderle effettive. Potrebbe anche essere necessario riavviare qualsiasi sessione del terminale aperta oppure 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
o $CHROMIUM_PATH --version
se hai impostato la variabile di ambiente CHROMIUM_PATH
.
Variabili di ambiente Chromium facoltative
CHROMIUM_PATH
: percorso al programma binario di Chromium, il valore predefinito èchromium
.CHROMIUM_PID_DIR
: percorso verso la posizione in cui la libreria può archiviare i file PID di Chromium, impostato sul valore predefinitochromium_pid_files
nella directory di lavoro dell'applicazione Looker.CHROMIUM_PORT_RANGE_START
eCHROMIUM_PORT_RANGE_END
: l'applicazione Chromium ha bisogno di una serie di porte per comunicare tra i processi sulla macchina locale. L'intervallo predefinito è 40000-40500, ma puoi sostituire questo valore predefinito impostando entrambe le variabili di ambiente. Le porte non utilizzate vengono selezionate in modo casuale nell'intervallo e vengono utilizzate solo per la durata di un singolo rendering.DISABLE_EXTERNAL_RENDER_ACCESS
: gli amministratori di istanze o server Looker ospitati dal cliente senza accesso a Internet bloccato o esterno devono impostareDISABLE_EXTERNAL_RENDER_ACCESS=true
. In genere, il renderer di Chromium attende il completamento di tutte le risorse richieste dalla pagina prima che il renderer invii l'indicatore "finito" che chiede a Looker di produrre il contenuto. Alcune di queste richieste potrebbero essere ignorate a causa della mancanza di connessione, causando timeout o tempi di rendering molto lunghi. L'impostazione di questa variabile di ambiente sutrue
impedisce al renderer di attendere il completamento di tutte le richieste. Alcune visualizzazioni di mappa e alcune visualizzazioni personalizzate installate da Looker Marketplace potrebbero richiedere l'accesso a Internet.