由客戶代管的轉譯軟體安裝作業

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_PATH [環境變數(#optional_chromium_environment_variables) 設定的自訂路徑來存取 Chromium。

如果您要在 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,並確認您並未以 root 權限執行。

安裝字型套件

系統必須安裝 Microsoft OpenType 字型 (OTF) 套件,才能啟動 Chromium。OTF 套件會使用 .otf 檔案副檔名。您可以下載任何 OTF 套件,例如這個 Google Fonts 的 OTF 套件

如果資料包含非英文字元,您也必須安裝 Google Noto 字體套件 (大小為數 GB)。

安裝這些套件後,請執行下列指令:

cd $HOME
rm -rf /tmp/fonts

安裝 Chromium

  1. 如要安裝 Chromium,請執行適用於您系統的安裝指令。例如:

    apt-get update && apt-get install -y chromium-browser
    
  2. 您必須將 chromium-browser 別名為 chromium,或匯出 CHROMIUM_PATH 環境變數。如要將 chromium-browser 別名為 chromium,請將下列內容放入適用於您系統的殼層檔案中。例如:

    alias chromium='chromium-browser'
    

    如要讓 Looker 知道這個別名,請在指令列執行下列指令:

    sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium
    
  3. 設定任何選用的環境變數後,請重新啟動 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_STARTCHROMIUM_PORT_RANGE_END:Chromium 應用程式需要一系列通訊埠,才能在本機電腦上的程序之間進行通訊。預設範圍為 40000-40500,但您可以設定這兩個環境變數來覆寫預設值。系統會從範圍中隨機選取未使用的連接埠,且只會在單一轉譯期間使用。

  • DISABLE_EXTERNAL_RENDER_ACCESS:如果 Looker 執行個體或伺服器是由客戶代管,且沒有外部存取權或遭封鎖,管理員應設定 DISABLE_EXTERNAL_RENDER_ACCESS=true。通常,Chromium 轉譯器會等待頁面要求的所有資源完成,再傳送「完成」信號,提示 Looker 產生內容。部分要求可能會因連線中斷而遭到捨棄,導致逾時或算繪時間過長。將這個環境變數設為 true 可避免轉譯器等待所有要求完成。從 Looker Marketplace 安裝的部分地圖視覺化資料和自訂視覺化資料可能需要連上網際網路。