Installazione del software di rendering in hosting presso il cliente

Looker richiede un software di rendering chiamato Chromium per inviare o scaricare dati in formati basati su immagini, ovvero file HTML e 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.

Il rendering di Chromium attende il completamento di tutte le risorse richieste dalla pagina prima di inviare il segnale "fine" che richiede a Looker di produrre i contenuti sottoposti a rendering. A causa del numero e della frequenza di queste richieste di risorse, alcune reti possono contrassegnare erroneamente le richieste come dannose, causando la loro eliminazione, il che ritarderà i job di rendering.

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

Prima di iniziare

Prima di installare Chromium, scopri di più sui seguenti argomenti:

Requisiti e prerequisiti di installazione di Chromium

Questa pagina fornisce istruzioni di esempio per l'installazione di Chromium indipendenti da un tipo di distribuzione. Puoi anche scaricare Chromium e seguire le istruzioni di installazione rimanenti in questa pagina.

Per eseguire Chromium su un'istanza di Looker, sono necessari Chromium 97, Chromium 109 o Chromium 114. Chromium deve essere installato in un percorso eseguibile sulla macchina che ospita l'istanza di Looker. L'applicazione Looker deve accedere a Chromium utilizzando il comando chromium o un percorso personalizzato impostato con la [variabile di ambiente CHROMIUM_PATH](#optional_chromium_environment_variables).

Se stai installando Chromium su un'installazione di Looker in cluster, la versione di Chromium su ogni nodo deve essere completamente identica. Anche piccole differenze, come numeri di build diversi, possono interferire con le funzionalità di rendering di Looker.

Informazioni sull'installazione di Chromium su distribuzioni specifiche

Looker supporta le versioni di rilascio di tutte le principali distribuzioni Linux aziendali, tra cui Ubuntu (versioni LTS), Debian 9+, RedHat Enterprise Linux (RHEL) 7+, CentOS 7+ e Amazon Linux.

Per le installazioni di Ubuntu, devi installare il browser web Chromium e poi impostare un alias in modo che l'applicazione Looker possa trovare l'installazione.

Per le installazioni di Debian, Chromium richiede Debian 9 (stretch) o versioni successive. Se la tua istanza di Looker utilizza Docker con un'installazione Debian di base, installa procps e assicurati di non eseguire l'accesso come utente root.

Installare i pacchetti di caratteri

Per l'avvio di Chromium, sul sistema deve essere installato un pacchetto di caratteri Microsoft OpenType (OTF). I pacchetti OTF utilizzano le estensioni di file .otf. Puoi scaricare qualsiasi pacchetto OTF, ad esempio questo pacchetto OTF da Google Fonts.

Se i tuoi dati contengono caratteri non inglesi, devi anche installare il pacchetto di caratteri Google Noto (che ha una dimensione di diversi GB).

Dopo aver installato questi pacchetti, esegui i seguenti comandi:

cd $HOME
rm -rf /tmp/fonts

Installare Chromium

  1. Per installare Chromium, esegui il comando di installazione applicabile al tuo sistema. Ad esempio:

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

  2. Devi creare un alias di chromium-browser come chromium o esportare la variabile di ambiente CHROMIUM_PATH. Per creare un alias di chromium-browser come chromium, inserisci quanto segue nel file della shell applicabile al tuo sistema. Ad esempio:

    alias chromium='chromium-browser'

    Per rendere noto questo alias a Looker, esegui questo comando nella riga di comando:

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

  3. Dopo aver impostato una delle variabili di ambiente facoltative, riavvia l'applicazione Looker in modo che le variabili possano avere effetto. Potresti anche dover riavviare le sessioni del terminale aperte o eseguire l'origine del file della shell per consentire al terminale di leggere la nuova configurazione.

Dopo aver installato Chromium, dovresti ricevere una risposta valida dall'esecuzione di chromium --version (se non hai impostato la variabile di ambiente CHROMIUM_PATH) o dall'esecuzione di $CHROMIUM_PATH --version (se hai impostato la variabile di ambiente CHROMIUM_PATH).

Variabili di ambiente Chromium facoltative

  • CHROMIUM_PATH: percorso del file 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 e CHROMIUM_PORT_RANGE_END: l'applicazione Chromium richiede un intervallo di porte per la comunicazione tra i processi sulla macchina locale. L'intervallo predefinito è 40000-40500, ma puoi sostituirlo impostando entrambe queste variabili di ambiente. Le porte inutilizzate vengono selezionate in modo casuale dall'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 che non hanno accesso a internet esterno o bloccato devono impostare DISABLE_EXTERNAL_RENDER_ACCESS=true. In genere, il renderer di Chromium attende il completamento di tutte le risorse richieste dalla pagina prima di inviare il segnale "fine" che richiede a Looker di produrre i contenuti. Alcune di queste richieste potrebbero essere eliminate a causa della mancanza di connessione, con conseguenti timeout o tempi di rendering molto lunghi. Se imposti questa variabile di ambiente su true, il renderer non attenderà il completamento di tutte le richieste. Alcune visualizzazioni di mappe e alcune visualizzazioni personalizzate installate da Looker Marketplace potrebbero richiedere l'accesso a internet.