Looker 需要名為 Chromium 的算繪軟體,才能以圖片格式 (HTML 和 PNG 或 PDF 檔案) 傳送或下載資料,以及使用「紙張大小」和「展開表格」等功能。本頁說明如何在客戶託管的 Looker 執行個體上安裝算繪軟體。
Chromium 算繪作業會等待網頁要求的所有資源完成,然後傳送「完成」信號,提示 Looker 產生算繪內容。由於資源要求數量和頻率過高,部分網路可能會誤將要求標示為惡意,導致要求遭到捨棄,進而延遲工作算繪。
Chromium 專案是 Google 發起的開放原始碼專案,旨在分享 Google Chrome 的非專有部分。
事前準備
安裝 Chromium 前,請先瞭解下列主題:
Chromium 安裝需求和必要條件
本頁提供安裝 Chromium 的範例操作說明,與發布類型無關。你也可以下載 Chromium,然後按照這個頁面上的其餘安裝說明操作。
如要在 Looker 執行個體上執行 Chromium,必須使用 Chromium 97、Chromium 109 或 Chromium 114。您必須在 Looker 執行個體的主機上,將 Chromium 安裝到可執行路徑。Looker 應用程式需要使用 chromium 指令存取 Chromium,或使用以 CHROMIUM_PATH [環境變數(#optional_chromium_environment_variables) 設定的自訂路徑。
如果您要在叢集 Looker 安裝中安裝 Chromium,每個節點上的 Chromium 版本必須完全相同。即使是微小的差異 (例如不同的建構版本號碼),也可能干擾 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,並確保您不是以根使用者身分執行。
安裝字型套件
系統必須安裝 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,請在適用於您系統的殼層檔案中加入下列內容。例如:alias chromium='chromium-browser'如要讓 Looker 知道這個別名,請在指令列執行下列指令:
sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium設定任何選用的環境變數後,請重新啟動 Looker 應用程式,讓變數生效。您可能也需要重新啟動所有開啟的終端機工作階段,或提供殼層檔案來源,讓終端機讀取新設定。
安裝 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 安裝的自訂視覺化圖表可能需要存取網際網路。