由客户托管的渲染软件安装

Looker 需要使用名为 Chromium 的渲染软件以图片格式（HTML 和 PNG 或 PDF 文件）发送或下载数据，并且使用纸张大小和展开表格等功能。本页面介绍了如何在客户托管的 Looker 实例上安装渲染软件。

已为 Looker 托管的实例安装 Chromium。

Chromium 会等到网页请求完所有资源后，再发送“Finished”信号来提示 Looker 生成已呈现的内容。由于这些资源请求的数量和频率，某些网络可能会错误地将请求标记为恶意，从而导致请求丢失，这将使渲染作业延迟。

Chromium 项目是 Google 推出的一个开源项目，旨在共享 Google Chrome 浏览器的非专有部分。

Chromium 安装要求和前提条件

Looker 支持所有主要企业 Linux 发行版（包括 Ubuntu、Debian、RedHat、CentOS 和 Amazon Linux）的发布版本。本页介绍了如何在 Ubuntu、Debian 和 RedHat/CentOS/Amazon Linux 上安装 Chromium。

Chromium 必须安装到托管 Looker 实例的机器上的可执行文件路径中。Looker 应用需要使用 chromium 命令或通过通过 CHROMIUM_PATH 环境变量设置的自定义路径访问 Chromium。

如需在 Looker 实例上运行 Chromium，必须使用 Chromium 86 或更高版本，但 Looker 建议您使用最新的可用版本。如果您的 Looker 实例安装在 Debian 上，Chromium 会要求使用 Debian 9（拉伸）或更高版本。

如果您在安装的 Looker 上安装 Chromium，那么每个节点上的 Chromium 版本必须完全相同。即使是细微的差异（例如不同的版本号），也会影响 Looker 的渲染功能。

如果您的数据包含非英语字符，那么除了安装 Chromium 之外，您还需要安装 Google 诺托字体包。

此字体包的大小为数 GB。

如需安装此字体包，请在命令行中运行以下命令：

  mkdir -p /tmp/fonts
  cd /tmp/fonts
  curl -O https://noto-website-2.storage.googleapis.com/pkgs/Noto-unhinted.zip
  unzip Noto-unhinted.zip
  mkdir -p /usr/share/fonts/opentype/noto
  cp *.otf *.otc /usr/share/fonts/opentype/noto
  mkdir -p /usr/share/fonts/truetype/noto
  cp *.ttf /usr/share/fonts/truetype/noto
  chmod a+r -R /usr/share/fonts/*/noto
  fc-cache -f -v

如果成功，则：

  cd $HOME
  rm -rf /tmp/fonts

在 Ubuntu 上安装 Chromium

Looker 应用需要使用 chromium 命令或通过通过 CHROMIUM_PATH 环境变量设置的自定义路径访问 Chromium。对于 Ubuntu 安装，您必须安装 Chromium 网络浏览器，然后设置一个别名，这样 Looker 应用才能找到该安装。

在执行任何需要提升权限的步骤时，Looker 建议使用 sudo 命令。当您以根用户身份登录时，请勿安装 Chromium。如果您在以根用户身份登录时安装 Chromium，Looker 可能无法执行 PDF 或 PNG 呈现。

  1. 系统必须安装字体才能启动 Chromium。您可以使用命令行界面安装字体。例如，以下命令会在 Ubuntu 16.04 LTS 上安装默认字体：
    apt-get install fonts-freefont-otf
  1. 如需安装 Chromium，请运行以下命令：
    apt-get update && apt-get install -y chromium-browser
  1. 必须将 chromium-browser 别名为 chromium 或导出 CHROMIUM_PATH 环境变量。如需将 chromium-browser 别名为 chromium，请将以下代码放在 ~/.bashrc 文件中：
    alias chromium='chromium-browser'

To make this alias known to Looker, run this command on the command line:

    sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium
  1. 设置任何可选环境变量后，请重启 Looker 应用，使其生效。您可能还需要重启任何打开的终端会话，或运行 source ~/.bash_profile 以获取终端以读取新配置。

安装 Chromium 后，如果您尚未设置 CHROMIUM_PATH 环境变量，应该会收到 chromium --version 的有效响应；如果您已设置 CHROMIUM_PATH 环境变量，您应该会收到 $CHROMIUM_PATH --version 响应。

在 Debian 上安装 Chromium

在执行任何需要提升权限的步骤时，Looker 建议使用 sudo 命令。当您以根用户身份登录时，请勿安装 Chromium。如果您在以根用户身份登录时安装 Chromium，Looker 可能无法执行 PDF 或 PNG 呈现。

Chromium 需要使用 Debian 9（拉伸）或更高版本。

如果您的 Looker 实例使用 Docker 并安装了极简 Debian，请安装 procps 并确保您不是以根用户身份运行。

  1. 系统必须安装字体才能启动 Chromium。您可以通过运行以下命令，使用命令行界面安装字体：
    apt-get install fonts-freefont-otf
  1. 如需安装 Chromium，请运行以下命令：
    apt-get update && apt-get install -y chromium
  1. 设置任何可选环境变量后，请重启 Looker 应用，使其生效。您可能还需要重启任何打开的终端会话，或运行 source ~/.bash_profile 以获取终端以读取新配置。

安装 Chromium 后，如果您尚未设置 CHROMIUM_PATH 环境变量，应该会收到 chromium --version 的有效响应；如果您已设置 CHROMIUM_PATH 环境变量，您应该会收到 $CHROMIUM_PATH --version 响应。

可选的 Chromium 环境变量

  • CHROMIUM_PATH：Chromium 二进制文件的路径，默认为 chromium。

  • CHROMIUM_PID_DIR：库存储 Chromium PID 文件的路径，默认为 Looker 应用工作目录中的 chromium_pid_files。

  • CHROMIUM_PORT_RANGE_START &CHROMIUM_PORT_RANGE_END：Chromium 应用需要一系列端口才能在本地计算机上的进程之间进行通信。默认范围为 40000-40500，但您可以通过设置这两个环境变量来替换此默认值。从范围中随机选择未使用的端口，并且仅在单次渲染期间使用。

  • DISABLE_EXTERNAL_RENDER_ACCESS：如果客户托管的 Looker 实例或服务器没有外部访问权限或互联网访问权限，则管理员应设置 DISABLE_EXTERNAL_RENDER_ACCESS=true。通常，Chromium 渲染程序会等到网页请求的所有资源都完成后再调用“Finished”信号，提示 Looker 生成内容。其中一些请求可能会因没有连接而丢弃，从而导致超时或呈现时间非常长。将此环境变量设置为 true 可防止渲染程序等待所有请求完成。从 Looker Marketplace 安装的某些地图可视化图表和一些自定义可视化图表可能需要访问互联网。