Instalação do software de renderização hospedada pelo cliente

O Looker exige um software de renderização chamado Chromium para enviar ou fazer o download de dados em formatos baseados em imagens (HTML e PNG ou arquivos PDF) e para usar recursos como tamanho do papel e expandir tabelas. Esta página explica como instalar o 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 as solicitações como maliciosas, fazendo com que elas sejam descartadas, o que atrasará os jobs renderizados.

O Projeto Chromium é um projeto de código aberto 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

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 fazer o download do 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 o Chromium 97, o Chromium 109 ou o Chromium 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 variável de ambiente CHROMIUM_PATH [environment variable(#optional_chromium_environment_variables).

Se você estiver instalando o Chromium em uma instalação do Looker em cluster, a versão do Chromium em cada nó precisa ser totalmente idêntica. Mesmo pequenas diferenças, como números de build diferentes, podem interferir nos recursos de renderização do Looker.

O que você precisa saber sobre a instalação do Chromium em distribuições específicas

O Looker oferece suporte a 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, é necessário instalar o navegador da Web Chromium e definir 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 usa 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 Microsoft OpenType (OTF) precisa ser instalado no sistema para que o Chromium seja iniciado. Os pacotes OTF usam extensões de arquivo .otf. Você pode fazer o download de qualquer pacote OTF, como este pacote OTF do Google Fonts.

Se os dados contiverem caracteres não ingleses, também será necessário instalar o pacote de fontes Google Noto (que tem vários GB de tamanho).

Depois de instalar esses pacotes, execute os seguintes comandos:

cd $HOME
rm -rf /tmp/fonts

Como instalar o Chromium

  1. 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

  2. É necessário criar um alias de chromium-browser como chromium ou exportar a variável de ambiente CHROMIUM_PATH. Para criar um alias de chromium-browser como chromium, coloque o seguinte no arquivo de shell aplicável ao seu sistema. Exemplo:

    alias chromium='chromium-browser'

    Para que esse alias seja conhecido pelo Looker, execute este comando na linha de comando:

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

  3. Depois de definir qualquer uma das variáveis de ambiente opcionais, reinicie o aplicativo Looker para que as variáveis entrem em vigor. Talvez também seja necessário reiniciar as sessões de terminal abertas ou o arquivo de shell de origem para que o terminal leia a nova configuração.

Depois de instalar o Chromium, você vai receber uma resposta válida da execução de chromium --version (se você não tiver definido a variável de ambiente CHROMIUM_PATH) ou da execução de $CHROMIUM_PATH --version (se você 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, padrão para chromium.

  • CHROMIUM_PID_DIR: caminho para onde a biblioteca pode armazenar arquivos PID do Chromium, padrão para chromium_pid_files no diretório de trabalho do aplicativo Looker.

  • CHROMIUM_PORT_RANGE_START e CHROMIUM_PORT_RANGE_END: o aplicativo Chromium precisa de um intervalo 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 essas duas variáveis de ambiente. As portas não usadas são selecionadas aleatoriamente no intervalo e são usadas apenas durante uma única renderização.

  • DISABLE_EXTERNAL_RENDER_ACCESS: os administradores de instâncias ou servidores do Looker hospedados pelo cliente que não têm acesso externo ou bloqueado à Internet precisam definir DISABLE_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 a produção do conteúdo. Algumas dessas solicitações podem ser descartadas devido à falta de conexão, resultando em tempos limite ou tempos de renderização muito longos. Definir essa variável de ambiente como true impede que o renderizador aguarde a conclusão de todas as solicitações. Algumas visualizações de mapa e algumas visualizações personalizadas instaladas no Marketplace do Looker podem exigir acesso à Internet.