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 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

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

  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 Looker mengetahui alias ini, jalankan perintah ini di command line:

    sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium
    
  3. 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 adalah chromium.

  • CHROMIUM_PID_DIR: Jalur ke tempat library dapat menyimpan file PID Chromium, defaultnya adalah chromium_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 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 dihapus karena kurangnya koneksi, sehingga menyebabkan waktu tunggu habis atau waktu render yang sangat lama. Menetapkan 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.