Penginstalan software rendering yang dihosting pelanggan

Looker memerlukan software rendering yang disebut Chromium untuk mengirim atau mendownload data dalam format berbasis gambar — file HTML dan PNG atau PDF — serta untuk menggunakan fitur seperti Ukuran kertas dan Meluaskan tabel. Halaman ini menjelaskan cara menginstal software rendering pada instance Looker yang dihosting pelanggan.

Chromium sudah diinstal untuk instance yang dihosting Looker.

Rendering Chromium menunggu semua resource yang diminta oleh halaman selesai sebelum mengirimkan sinyal "selesai" yang meminta Looker untuk menghasilkan konten yang dirender. Karena jumlah dan frekuensi permintaan resource ini, beberapa jaringan dapat salah menandai permintaan sebagai berbahaya, menyebabkan permintaan tersebut turun, yang akan menunda tugas yang Anda render.

Proyek Chromium adalah proyek sumber terbuka yang dimulai oleh Google untuk berbagi bagian non-milik dari Google Chrome.

Persyaratan dan prasyarat penginstalan Chromium

Looker mendukung versi rilis semua distribusi Linux perusahaan utama, termasuk Ubuntu, Debian, RedHat, CentOS, dan Amazon Linux. Halaman ini memberikan petunjuk untuk menginstal Chromium di Ubuntu, Debian, dan RedHat/CentOS/Amazon Linux.

Chromium harus diinstal ke jalur yang dapat dieksekusi di komputer yang menghosting instance Looker. Aplikasi Looker perlu mengakses Chromium menggunakan perintah chromium atau melalui jalur kustom yang ditetapkan dengan variabel lingkungan CHROMIUM_PATH.

Untuk menjalankan Chromium di instance Looker, Chromium 86 atau yang lebih baru diperlukan, tetapi Looker merekomendasikan penggunaan Chromium 97.x secara khusus. Jika instance Looker Anda diinstal di Debian, Chromium memerlukan Debian 9 (stretch) atau yang lebih baru.

Jika Anda menginstal Chromium pada penginstalan Looker yang dikelompokkan, versi Chromium di setiap node harus sepenuhnya identik. Bahkan perbedaan kecil, seperti nomor build yang berbeda, dapat mengganggu kemampuan rendering Looker.

Jika data Anda berisi karakter non-bahasa Inggris, instal paket Google Noto Fonts (ukurannya beberapa GB) selain menginstal Chromium. Untuk menginstal paket font ini, jalankan perintah ini di command line Anda:

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

Jika berhasil, maka:

cd $HOME
rm -rf /tmp/fonts

Menginstal Chromium di Ubuntu

Aplikasi Looker perlu mengakses Chromium menggunakan perintah chromium atau melalui jalur kustom yang ditetapkan dengan variabel lingkungan CHROMIUM_PATH. Untuk penginstalan di Ubuntu, Anda harus menginstal browser web Chromium, lalu menetapkan alias agar aplikasi Looker dapat menemukan penginstalannya.

Looker merekomendasikan penggunaan perintah sudo saat melakukan langkah apa pun yang memerlukan izin yang lebih tinggi. Jangan menginstal Chromium saat Anda login sebagai pengguna root. Jika Anda menginstal Chromium saat login sebagai pengguna root, Looker mungkin tidak dapat menjalankan rendering PDF atau PNG.

  1. Font harus diinstal di sistem agar Chromium dapat memulai. Anda dapat menginstal font menggunakan antarmuka command line. Misalnya, perintah ini menginstal font default di Ubuntu 16.04 LTS:

    apt-get install fonts-freefont-otf
    
  2. Untuk menginstal Chromium, jalankan:

    apt-get update && apt-get install -y chromium-browser
    
  3. Harus berupa alias chromium-browser sebagai chromium atau mengekspor variabel lingkungan CHROMIUM_PATH. Untuk membuat alias chromium-browser sebagai chromium, tempatkan baris berikut dalam file ~/.bashrc:

    alias chromium='chromium-browser'
    

    Agar alias ini diketahui oleh Looker, jalankan perintah ini di command line:

    sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium
    
  4. Setelah menetapkan variabel lingkungan opsional, mulai ulang aplikasi Looker agar dapat diterapkan. Anda mungkin juga perlu memulai ulang sesi terminal yang terbuka, atau menjalankan source ~/.bash_profile agar terminal membaca konfigurasi baru.

Setelah menginstal Chromium, Anda akan mendapatkan respons yang valid dari chromium --version jika belum menetapkan variabel lingkungan CHROMIUM_PATH atau $CHROMIUM_PATH --version jika telah menetapkan variabel lingkungan CHROMIUM_PATH.

Menginstal Chromium di Debian

Looker merekomendasikan penggunaan perintah sudo saat melakukan langkah apa pun yang memerlukan izin yang lebih tinggi. Jangan menginstal Chromium saat Anda login sebagai pengguna root. Jika Anda menginstal Chromium saat login sebagai pengguna root, Looker mungkin tidak dapat menjalankan rendering PDF atau PNG.

Chromium memerlukan Debian 9 (stretch) atau yang lebih baru.

Jika instance Looker Anda menggunakan Docker dengan penginstalan Debian sederhana, instal procps dan pastikan Anda tidak berjalan sebagai root.

  1. Font harus diinstal di sistem agar Chromium dapat memulai. Anda dapat menginstal font menggunakan antarmuka command line dengan menjalankan:

    apt-get install fonts-freefont-otf
    
  2. Untuk menginstal Chromium, jalankan:

    apt-get update && apt-get install -y chromium
    
  3. Setelah menetapkan variabel lingkungan opsional, mulai ulang aplikasi Looker agar dapat diterapkan. Anda mungkin juga perlu memulai ulang sesi terminal yang terbuka, atau menjalankan source ~/.bash_profile agar terminal membaca konfigurasi baru.

Setelah menginstal Chromium, Anda akan mendapatkan respons yang valid dari chromium --version jika belum menetapkan variabel lingkungan CHROMIUM_PATH atau $CHROMIUM_PATH --version jika telah menetapkan variabel lingkungan CHROMIUM_PATH.

Variabel lingkungan Chromium opsional

  • CHROMIUM_PATH: Jalur ke biner Chromium, defaultnya adalah chromium.

  • CHROMIUM_PID_DIR: Jalur tempat library dapat menyimpan file PID Chromium, setelan defaultnya adalah chromium_pid_files di direktori kerja aplikasi Looker.

  • CHROMIUM_PORT_RANGE_START & CHROMIUM_PORT_RANGE_END: Aplikasi Chromium memerlukan berbagai port untuk berkomunikasi antar-proses di komputer lokal. Rentang defaultnya adalah 40000-40500, tetapi Anda dapat mengganti default ini dengan menetapkan kedua variabel lingkungan ini. Port yang tidak digunakan dipilih secara acak dari rentang dan hanya digunakan selama durasi render tunggal.

  • DISABLE_EXTERNAL_RENDER_ACCESS: Admin instance atau server Looker yang dihosting pelanggan dan tidak memiliki akses Internet eksternal atau yang diblokir harus menetapkan DISABLE_EXTERNAL_RENDER_ACCESS=true. Biasanya, perender Chromium akan menunggu semua resource yang diminta oleh halaman selesai sebelum perender mengirimkan sinyal "selesai" yang meminta Looker untuk membuat konten. Beberapa permintaan ini mungkin dibatalkan karena kurangnya koneksi, mengakibatkan waktu tunggu habis atau waktu render yang sangat lama. Menyetel variabel lingkungan ini ke true akan mencegah perender menunggu semua permintaan selesai. Beberapa visualisasi peta dan beberapa visualisasi kustom yang diinstal dari Looker Marketplace mungkin memerlukan akses Internet.