由客户托管的呈现软件安装

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

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

Chromium 呈现会等到网页请求的所有资源完成后，再发送提示“已完成”信号来提示 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 建议仅使用 Chromium 97.x。如果您的 Looker 实例安装在 Debian 上，则 Chromium 需要安装 Debian 9（拉伸）或更高版本。

如果您在安装集群的 Looker 时安装 Chromium，则每个节点上的 Chromium 版本必须完全相同。即使是细微的差异（例如不同的 build 号），也可能会干扰 Looker 的渲染功能。

如果您的数据包含非英语字符，除了安装 Chromium 之外，还需要安装 Google Noto Fonts 软件包（大小为数 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   # Ignore any *.otc not found errors
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

  2. 如需安装 Chromium，请运行以下命令：

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

  3. 必须将 chromium-browser 别名指定为 chromium 或导出 CHROMIUM_PATH 环境变量。如需将 chromium-browser 别名为 chromium，请将以下内容放在 ~/.bashrc 文件中：

    alias chromium='chromium-browser'

    如需让 Looker 已知此别名，请在命令行中运行以下命令：

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

  4. 设置完任何可选环境变量后，请重启 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 并确保您不是以 root 身份运行的。

  1. 必须在系统中安装字体才能启动 Chromium。您可以运行以下命令来使用命令行界面安装字体：

    apt-get install fonts-freefont-otf

  2. 如需安装 Chromium，请运行以下命令：

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

  3. 设置完任何可选环境变量后，请重启 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 渲染程序会等到相应网页请求的所有资源完成后，才会将“已完成”信号提示 Looker 生成相应内容。其中一些请求可能会因没有连接而丢弃，进而导致超时或呈现时间过长。将此环境变量设置为 true 可阻止渲染程序等待所有请求完成。从 Looker Marketplace 安装的某些地图可视化设置和一些自定义可视化可能需要访问互联网。