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 Luaskan 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 mengirim 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, sehingga menyebabkan permintaan tersebut dihapus, yang akan menunda tugas yang dirender.
Project Chromium adalah project open source yang dimulai oleh Google untuk membagikan bagian non-eksklusif Google Chrome.
Sebelum memulai
Sebelum menginstal Chromium, pelajari topik berikut lebih lanjut:
- Persyaratan dan prasyarat penginstalan Chromium
- Hal-hal yang perlu diketahui tentang menginstal Chromium di distribusi tertentu
- Menginstal paket font
Persyaratan dan prasyarat penginstalan Chromium
Halaman ini memberikan contoh petunjuk untuk menginstal Chromium yang tidak bergantung pada jenis distribusi. 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 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.
Hal-hal yang perlu diketahui tentang cara menginstal Chromium di distribusi tertentu
Looker mendukung versi rilis dari 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 menetapkan 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 menjalankannya sebagai root.
Menginstal paket font
Paket font OpenType (OTF) Microsoft 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 Google Noto Fonts (yang berukuran beberapa GB).
Setelah menginstal paket ini, jalankan perintah berikut:
cd $HOME
rm -rf /tmp/fonts
Menginstal Chromium
Untuk menginstal Chromium, jalankan perintah penginstalan yang berlaku untuk sistem Anda. Contoh:
apt-get update && apt-get install -y chromium-browser
Anda harus membuat alias
chromium-browser
sebagaichromium
atau mengekspor variabel lingkunganCHROMIUM_PATH
. Untuk membuat aliaschromium-browser
sebagaichromium
, tempatkan kode berikut dalam file shell yang berlaku untuk sistem Anda. Contoh:alias chromium='chromium-browser'
Agar Looker mengetahui alias ini, jalankan perintah ini di command line:
sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium
Setelah Anda menetapkan variabel lingkungan opsional, mulai ulang aplikasi Looker agar variabel dapat diterapkan. Anda mungkin juga perlu memulai ulang sesi terminal yang terbuka, atau me-source file shell, agar terminal membaca konfigurasi baru.
Setelah menginstal Chromium, Anda akan mendapatkan respons yang valid dari menjalankan chromium --version
(jika belum menetapkan variabel lingkungan CHROMIUM_PATH
) atau dari menjalankan $CHROMIUM_PATH --version
(jika telah menetapkan variabel lingkungan CHROMIUM_PATH
).
Variabel lingkungan Chromium opsional
CHROMIUM_PATH
: Jalur ke biner Chromium, defaultnya adalahchromium
.CHROMIUM_PID_DIR
: Jalur ke tempat library dapat menyimpan file PID Chromium, defaultnya adalahchromium_pid_files
di direktori kerja aplikasi Looker.CHROMIUM_PORT_RANGE_START
&CHROMIUM_PORT_RANGE_END
: Aplikasi Chromium memerlukan rentang port untuk berkomunikasi antarproses di mesin 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 menetapkanDISABLE_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 dihapus karena kurangnya koneksi, sehingga menyebabkan waktu tunggu habis atau waktu render yang sangat lama. Menetapkan variabel lingkungan ini ketrue
akan mencegah perender menunggu semua permintaan selesai. Beberapa visualisasi peta dan beberapa visualisasi kustom yang diinstal dari Looker Marketplace mungkin memerlukan akses internet.