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

O Looker requer um software de renderização denominado Chromium para enviar ou transferir dados em formatos baseados em imagens (ficheiros HTML e PNG ou PDF) e para usar funcionalidades como Tamanho do papel e Expandir tabelas. Esta página explica como instalar software de renderização numa instância alojada pelo cliente do Looker.

A renderização do Chromium aguarda que todos os recursos pedidos pela página sejam concluídos antes de enviar o sinal "concluído" que solicita ao Looker para produzir o conteúdo renderizado. Devido ao número e à frequência destes pedidos de recursos, algumas redes podem sinalizar incorretamente os pedidos como maliciosos, o que faz com que sejam ignorados e atrasa os trabalhos renderizados.

O projeto Chromium é um projeto de código aberto iniciado pela Google para partilhar 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. Também pode transferir o Chromium e, em seguida, seguir as restantes instruções de instalação nesta página.

Para executar o Chromium numa instância do Looker, é necessário o Chromium 97, o Chromium 109 ou o Chromium 114. O Chromium tem de ser instalado num caminho executável na máquina que aloja a instância do Looker. A aplicação Looker precisa de aceder ao Chromium através do comando chromium ou de um caminho personalizado definido com a CHROMIUM_PATH [variável de ambiente(#optional_chromium_environment_variables).

Se estiver a instalar o Chromium numa instalação do Looker em cluster, a versão do Chromium em cada nó tem de ser totalmente idêntica. Mesmo pequenas diferenças, como números de compilação diferentes, podem interferir com as capacidades de renderização do Looker.

Aspetos a ter em conta sobre a instalação do Chromium em distribuições específicas

O Looker suporta versões de lançamento de todas as principais distribuições Linux empresariais, incluindo Ubuntu (lançamentos LTS), Debian 9+, RedHat Enterprise Linux (RHEL) 7+, CentOS 7+ e Amazon Linux.

Para instalações do Ubuntu, tem de instalar o navegador de Internet Chromium e, em seguida, definir um alias para que a aplicação Looker possa encontrar a instalação.

Para instalações do Debian, o Chromium requer o Debian 9 (stretch) ou posterior. Se a sua instância do Looker usar o Docker com uma instalação básica do Debian, instale o procps e certifique-se de que não está a ser executado como raiz.

Instale pacotes de tipos de letra

Tem de instalar um pacote de fontes Microsoft OpenType (OTF) no sistema para iniciar o Chromium. Os pacotes OTF usam extensões de ficheiros .otf. Pode transferir qualquer pacote OTF, como este pacote OTF do Google Fonts.

Se os seus dados contiverem carateres que não sejam em inglês, também tem de instalar o pacote de tipos de letra Google Noto (que tem vários GB).

Depois de instalar estes 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. Por exemplo:

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

  2. Tem de definir o 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 ficheiro de shell aplicável ao seu sistema. Por exemplo:

    alias chromium='chromium-browser'

    Para que o Looker reconheça este alias, execute este comando na linha de comandos:

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

  3. Depois de definir qualquer uma das variáveis de ambiente opcionais, reinicie a aplicação Looker para que as variáveis possam entrar em vigor. Também pode ter de reiniciar as sessões de terminal abertas ou obter o ficheiro de shell para que o terminal leia a nova configuração.

Depois de instalar o Chromium, deve receber uma resposta válida ao executar chromium --version (se não tiver definido a variável de ambiente CHROMIUM_PATH) ou ao executar $CHROMIUM_PATH --version (se tiver definido a variável de ambiente CHROMIUM_PATH).

Variáveis de ambiente do Chromium opcionais

  • CHROMIUM_PATH: caminho para o ficheiro binário do Chromium. O valor predefinido é chromium.

  • CHROMIUM_PID_DIR: caminho para onde a biblioteca pode armazenar ficheiros PID do Chromium. O valor predefinido é chromium_pid_files no diretório de trabalho da aplicação Looker.

  • CHROMIUM_PORT_RANGE_START e CHROMIUM_PORT_RANGE_END: a aplicação Chromium precisa de um intervalo de portas para comunicar entre processos na máquina local. O intervalo predefinido é 40000-40500, mas pode substituir esta predefinição definindo ambas as 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 alojados pelo cliente que não tenham acesso à Internet externo ou bloqueado devem definir DISABLE_EXTERNAL_RENDER_ACCESS=true. Normalmente, o renderizador do Chromium aguarda que todos os recursos pedidos pela página sejam concluídos antes de o renderizador enviar o sinal "concluído" que solicita ao Looker a produção do conteúdo. Algumas destas solicitações podem ser ignoradas devido à falta de ligação, o que resulta em limites de tempo ou tempos de renderização muito longos. Se definir esta variável de ambiente como true, impede que o renderizador aguarde a conclusão de todos os pedidos. Algumas visualizações de mapas e algumas visualizações personalizadas instaladas a partir do mercado do Looker podem exigir acesso à Internet.