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 (arquivos HTML, PNG ou PDF) e usar recursos como Tamanho do papel e Abrir 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 que produza o conteúdo renderizado. Devido ao número e à frequência dessas solicitações de recursos, algumas redes podem sinalizar erroneamente as solicitações como maliciosas, fazendo com que elas sejam descartadas, o que atrasará os trabalhos renderizados.

O Projeto Chromium é um projeto de código aberto iniciado pelo Google para compartilhar as partes não reservadas 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 exemplos de instruções para instalar o Chromium que são independentes do 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 usar 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 [link:environment_variables_optional_chromium].

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

Informações 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 empresariais do Linux, incluindo Ubuntu (versões LTS), Debian 9+, RedHat Enterprise Linux (RHEL) 7+, CentOS 7+ e Amazon Linux.

Para instalações do Ubuntu, você precisa 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 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 fonte Microsoft OpenType (OTF) precisa ser instalado no sistema para que o Chromium seja iniciado. Os pacotes OTF usam extensões de arquivo .otf. É possível fazer o download de qualquer pacote OTF, como este pacote OTF do Google Fonts.

Se os dados contiverem caracteres que não sejam em inglês, também será necessário instalar o pacote Google Noto Fonts (com vários GB).

Depois de instalar esses pacotes, execute os seguintes comandos:

cd $HOME
rm -rf /tmp/fonts

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 definir um alias para chromium-browser como chromium ou exportar a variável de ambiente CHROMIUM_PATH. Para definir 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 o Looker conheça esse alias, 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 do Looker para que as variáveis entrem em vigor. Talvez seja necessário reiniciar todas as sessões de terminal abertas ou gerar 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 você não tiver definido a variável de ambiente CHROMIUM_PATH) ou ao executar $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 chromium.

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

  • CHROMIUM_PORT_RANGE_START e CHROMIUM_PORT_RANGE_END: o aplicativo Chromium precisa de uma variedade de portas para se comunicar entre os 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 utilizadas são selecionadas aleatoriamente no intervalo e usadas apenas durante a duração de 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 devem definir DISABLE_EXTERNAL_RENDER_ACCESS=true. Normalmente, o renderizador do Chromium vai aguardar a conclusão de todos os recursos solicitados pela página antes de enviar o indicador "concluído" que solicita que o Looker produza o 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 o término de todas as solicitações. Algumas visualizações de mapa e personalizadas instaladas no Marketplace do Looker podem exigir acesso à Internet.