O Looker exige um software de renderização chamado Chromium para enviar ou baixar dados em formatos baseados em imagens (arquivos HTML e PNG ou PDF) e usar recursos como Tamanho do papel e Expandir tabelas. Esta página explica como instalar um software de renderização em uma instância do Looker hospedada pelo cliente.
A renderização do Chromium aguarda a conclusão de todos os recursos solicitados pela página antes de enviar o sinal "concluído", que solicita ao Looker a produção do conteúdo renderizado. Devido ao número e à frequência dessas solicitações de recursos, algumas redes podem sinalizar falsamente as solicitações como maliciosas, fazendo com que elas sejam descartadas, o que atrasa os jobs renderizados.
O projeto Chromium é de código aberto e foi iniciado pelo Google para compartilhar as partes não proprietárias do Google Chrome.
Antes de começar
Antes de instalar o Chromium, saiba mais sobre os seguintes tópicos:
- Requisitos e pré-requisitos de instalação do Chromium
- Informações importantes sobre a instalação do Chromium em distribuições específicas
- Instalar pacotes de fontes
Requisitos e pré-requisitos de instalação do Chromium
Esta página fornece instruções de exemplo para instalar o Chromium, que são independentes de um tipo de distribuição. Você também pode baixar o Chromium e seguir as instruções de instalação restantes nesta página.
Para executar o Chromium em uma instância do Looker, é necessário ter o Chromium 97, 109 ou 114. O Chromium precisa ser instalado em um caminho executável na máquina que hospeda a instância do Looker. O aplicativo Looker precisa acessar o Chromium usando o comando chromium
ou um caminho personalizado definido com a CHROMIUM_PATH
[variável de ambiente(#optional_chromium_environment_variables).
Se você estiver instalando o Chromium em uma instalação em cluster do Looker, a versão do Chromium em cada nó precisará ser totalmente idêntica. Até mesmo pequenas diferenças, como números de build diferentes, podem interferir nos recursos de renderização do Looker.
Informações importantes sobre a instalação do Chromium em distribuições específicas
O Looker é compatível com versões de lançamento de todas as principais distribuições Linux empresariais, incluindo Ubuntu (versões LTS), Debian 9+, RedHat Enterprise Linux (RHEL) 7+, CentOS 7+ e Amazon Linux.
Para instalações do Ubuntu, instale o navegador Chromium e defina um alias para que o aplicativo Looker possa encontrar a instalação.
Para instalações do Debian, o Chromium exige o Debian 9 (stretch) ou mais recente. Se a instância do Looker usar o Docker com uma instalação básica do Debian, instale o procps e verifique se você não está executando como raiz.
Instalar pacotes de fontes
Um pacote de fontes OpenType (OTF) da Microsoft precisa ser instalado no sistema para que o Chromium seja iniciado. Os pacotes OTF usam extensões de arquivo .otf
. Você pode baixar qualquer pacote OTF, como este pacote OTF do Google Fonts.
Se os dados contiverem caracteres que não sejam em inglês, instale também o pacote de fontes Noto do Google (que tem vários GB).
Depois de instalar esses pacotes, execute os seguintes comandos:
cd $HOME
rm -rf /tmp/fonts
Instalar o Chromium
Para instalar o Chromium, execute o comando de instalação aplicável ao seu sistema. Exemplo:
apt-get update && apt-get install -y chromium-browser
É preciso criar um alias de
chromium-browser
comochromium
ou exportar a variável de ambienteCHROMIUM_PATH
. Para criar um alias dechromium-browser
comochromium
, coloque o seguinte no arquivo de shell aplicável ao seu sistema. Exemplo:alias chromium='chromium-browser'
Para que o Looker reconheça esse alias, execute este comando na linha de comando:
sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium
Depois de definir qualquer uma das variáveis de ambiente opcionais, reinicie o aplicativo Looker para que as variáveis entrem em vigor. Talvez seja necessário reiniciar as sessões de terminal abertas ou usar o arquivo de shell para que o terminal leia a nova configuração.
Depois de instalar o Chromium, você vai receber uma resposta válida ao executar chromium --version
(se não tiver definido a variável de ambiente CHROMIUM_PATH
) ou $CHROMIUM_PATH --version
(se tiver definido a variável de ambiente CHROMIUM_PATH
).
Variáveis de ambiente opcionais do Chromium
CHROMIUM_PATH
: caminho para o binário do Chromium. O padrão échromium
.CHROMIUM_PID_DIR
: caminho para onde a biblioteca pode armazenar arquivos PID do Chromium. O padrão échromium_pid_files
no diretório de trabalho do aplicativo Looker.CHROMIUM_PORT_RANGE_START
eCHROMIUM_PORT_RANGE_END
: o aplicativo Chromium precisa de uma variedade de portas para se comunicar entre processos na máquina local. O intervalo padrão é 40000-40500, mas você pode substituir esse padrão definindo as duas variáveis de ambiente. As portas não usadas são selecionadas aleatoriamente no intervalo e usadas apenas durante uma única renderização.DISABLE_EXTERNAL_RENDER_ACCESS
: administradores de instâncias ou servidores do Looker hospedados pelo cliente que não têm acesso à Internet externa ou bloqueada precisam definirDISABLE_EXTERNAL_RENDER_ACCESS=true
. Normalmente, o renderizador do Chromium aguarda a conclusão de todos os recursos solicitados pela página antes de enviar o sinal "concluído", que solicita ao Looker para produzir o conteúdo. Algumas dessas solicitações podem ser descartadas por falta de conexão, resultando em tempos limite ou tempos de renderização muito longos. Definir essa variável de ambiente comotrue
impede que o renderizador espere a conclusão de todas as solicitações. Algumas visualizações de mapa e personalizadas instaladas no Looker Marketplace podem exigir acesso à Internet.