Looker 需要使用名为 Chromium 的渲染软件,才能以基于图片的格式(HTML 和 PNG 或 PDF 文件)发送或下载数据,以及使用纸张大小和展开表格等功能。本页介绍了如何在客户托管的 Looker 实例上安装渲染软件。
Chromium 呈现会等待页面请求的所有资源完成,然后发送“已完成”信号,以提示 Looker 生成呈现的内容。由于这些资源请求的数量和频率,某些网络可能会误将这些请求标记为恶意请求,导致这些请求被丢弃,从而延迟渲染作业的执行。
Chromium 项目是由 Google 发起的开源项目,旨在共享 Google Chrome 的非专有部分。
准备工作
在安装 Chromium 之前,请详细了解以下主题:
Chromium 安装要求和前提条件
本页面提供了有关安装 Chromium 的示例说明,这些说明与发行版本类型无关。您也可以下载 Chromium,然后按照本页面上的其余安装说明操作。
如需在 Looker 实例上运行 Chromium,您需要使用 Chromium 97、Chromium 109 或 Chromium 114。Chromium 必须安装到托管 Looker 实例的机器上的可执行路径中。Looker 应用需要使用 chromium
命令或使用使用 CHROMIUM_PATH
[环境变量](#optional_chromium_environment_variables) 设置的自定义路径来访问 Chromium。
如果您要在集群化 Looker 安装上安装 Chromium,则每个节点上的 Chromium 版本必须完全相同。即使是细微的差异(例如 build 号不同),也可能会干扰 Looker 的渲染功能。
关于在特定发行版上安装 Chromium 的注意事项
Looker 支持所有主要企业 Linux 发行版的发布版本,包括 Ubuntu(LTS 版本)、Debian 9+、RedHat Enterprise Linux (RHEL) 7+、CentOS 7+ 和 Amazon Linux。
对于 Ubuntu 安装,您必须安装 Chromium 网络浏览器,然后设置别名,以便 Looker 应用可以找到安装。
对于 Debian 安装,Chromium 需要 Debian 9 (stretch) 或更高版本。如果您的 Looker 实例使用的是 Docker 和精简版 Debian 安装,请安装 procps,并确保您不是以 root 身份运行。
安装字体软件包
系统上必须安装 Microsoft OpenType 字体 (OTF) 软件包,Chromium 才能启动。OTF 文件包使用 .otf
文件扩展名。您可以下载任何 OTF 软件包,例如 Google Fonts 中的此 OTF 软件包。
如果您的数据包含非英文字符,您还必须安装 Google Noto 字体软件包(大小为几 GB)。
安装这些软件包后,请运行以下命令:
cd $HOME
rm -rf /tmp/fonts
安装 Chromium
如需安装 Chromium,请运行适用于您系统的安装命令。例如:
apt-get update && apt-get install -y chromium-browser
您必须将
chromium-browser
别名为chromium
,或导出CHROMIUM_PATH
环境变量。如需将chromium-browser
别名为chromium
,请将以下内容放置在适用于您系统的 shell 文件中。例如:alias chromium='chromium-browser'
如需向 Looker 提供此别名,请在命令行中运行以下命令:
sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium
设置任何可选的环境变量后,请重启 Looker 应用,以便变量生效。您可能还需要重启所有打开的终端会话或源代码 shell 文件,才能让终端读取新配置。
安装 Chromium 后,您应该会通过运行 chromium --version
(如果您未设置 CHROMIUM_PATH
环境变量)或运行 $CHROMIUM_PATH --version
(如果您已设置 CHROMIUM_PATH
环境变量)获得有效响应。
可选的 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 安装的部分地图可视化图表和部分自定义可视化图表可能需要连接到互联网。