Penginstalan software rendering yang dihosting pelanggan

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

Rendering Chromium menunggu semua resource yang telah 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 secara keliru menandai permintaan sebagai berbahaya, sehingga menyebabkan permintaan tersebut dibatalkan, yang akan menunda tugas yang dirender.

Project Chromium adalah project open source yang dimulai oleh Google untuk membagikan bagian non-proprietary Google Chrome.

Sebelum memulai

Sebelum menginstal Chromium, pelajari lebih lanjut topik berikut:

Persyaratan dan prasyarat penginstalan Chromium

Halaman ini memberikan contoh petunjuk untuk menginstal Chromium yang tidak bergantung pada jenis distribusinya. Anda juga dapat mendownload Chromium, lalu mengikuti petunjuk penginstalan lainnya di halaman ini.

Untuk menjalankan Chromium di instance Looker, diperlukan Chromium 97, Chromium 109, atau Chromium 114. Chromium harus diinstal ke jalur yang dapat dieksekusi di komputer yang menghosting instance Looker. Aplikasi Looker perlu mengakses Chromium menggunakan perintah chromium atau menggunakan jalur kustom yang ditetapkan dengan CHROMIUM_PATH [variabel lingkungan(#optional_chromium_environment_variables).

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

Hal-hal yang perlu diketahui tentang menginstal Chromium di distribusi tertentu

Looker mendukung versi rilis semua distribusi Linux perusahaan utama, termasuk Ubuntu (rilis LTS), Debian 9+, RedHat Enterprise Linux (RHEL) 7+, CentOS 7+, dan Amazon Linux.

Untuk penginstalan Ubuntu, Anda harus menginstal browser web Chromium, lalu menyetel alias agar aplikasi Looker dapat menemukan penginstalan.

Untuk penginstalan Debian, Chromium memerlukan Debian 9 (stretch) atau yang lebih baru. Jika instance Looker Anda menggunakan Docker dengan penginstalan Debian dasar, instal procps dan pastikan Anda tidak berjalan sebagai root.

Menginstal paket font

Paket font Microsoft OpenType (OTF) harus diinstal di sistem agar Chromium dapat dimulai. Paket OTF menggunakan ekstensi file .otf. Anda dapat mendownload paket OTF apa pun, seperti paket OTF dari Google Fonts ini.

Jika data Anda berisi karakter non-Inggris, Anda juga harus menginstal paket Font Noto Google (yang berukuran beberapa GB).

Setelah menginstal paket ini, jalankan perintah berikut:

cd $HOME
rm -rf /tmp/fonts

Menginstal Chromium

  1. Untuk menginstal Chromium, jalankan perintah penginstalan yang berlaku untuk sistem Anda. Contoh:

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

  2. Anda harus membuat alias chromium-browser sebagai chromium atau mengekspor variabel lingkungan CHROMIUM_PATH. Untuk membuat alias chromium-browser sebagai chromium, tempatkan kode berikut dalam file shell yang berlaku untuk sistem Anda. Contoh:

    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

  3. Setelah Anda menetapkan salah satu variabel lingkungan opsional, mulai ulang aplikasi Looker agar variabel dapat diterapkan. Anda mungkin juga perlu memulai ulang sesi terminal yang terbuka, atau memanggil file shell, agar terminal dapat membaca konfigurasi baru.

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

Variabel lingkungan Chromium opsional

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

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

  • CHROMIUM_PORT_RANGE_START & CHROMIUM_PORT_RANGE_END: Aplikasi Chromium memerlukan rentang 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 satu render.

  • DISABLE_EXTERNAL_RENDER_ACCESS: Admin instance atau server Looker yang dihosting pelanggan yang tidak memiliki akses internet eksternal atau diblokir harus menyetel 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 menghasilkan konten. Beberapa permintaan ini mungkin dibatalkan karena tidak ada koneksi, sehingga menyebabkan timeout atau waktu rendering yang sangat lama. Menetapkan variabel lingkungan ini ke true akan mencegah perender menunggu semua permintaan selesai. Beberapa visualisasi peta dan visualisasi kustom yang diinstal dari Looker Marketplace mungkin memerlukan akses internet.