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

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

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

  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. É preciso 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 o Looker reconheç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 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 e CHROMIUM_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 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 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 como true 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.