Looker에는 이미지 기반 형식(HTML 및 PNG 또는 PDF 파일)으로 데이터를 전송 또는 다운로드하고 용지 크기 및 테이블 확장과 같은 기능을 사용하려면 Chromium이라는 렌더링 소프트웨어가 필요합니다. 이 페이지에서는 고객이 호스팅하는 Looker 인스턴스에 렌더링 소프트웨어를 설치하는 방법을 설명합니다.
Chromium 렌더링은 페이지에서 요청한 모든 리소스가 완료될 때까지 기다린 후 Looker에 렌더링된 콘텐츠를 생성하라는 메시지를 '완료됨' 신호로 전송합니다. 이러한 리소스 요청 수와 빈도로 인해 일부 네트워크에서 요청을 악의적으로 신고하여 삭제할 수 있으며 이로 인해 렌더링된 작업이 지연됩니다.
Chromium 프로젝트는 Google Chrome의 독점적이지 않은 부분을 공유하기 위해 Google이 시작한 오픈소스 프로젝트입니다.
시작하기 전에
Chromium을 설치하기 전에 다음 주제에 관해 자세히 알아보세요.
Chromium 설치 요구사항 및 기본 요건
이 페이지에서는 배포 유형과 관계없는 Chromium 설치 안내 예시를 제공합니다. Chromium을 다운로드한 후 이 페이지의 나머지 설치 안내를 따르실 수도 있습니다.
Looker 인스턴스에서 Chromium을 실행하려면 Chromium 97, Chromium 109 또는 Chromium 114가 필요합니다. Chromium이 Looker 인스턴스를 호스팅하는 머신의 실행 가능한 경로에 설치되어야 합니다. Looker 애플리케이션은 chromium 명령어를 사용하거나 CHROMIUM_PATH [환경 변수(#optional_chromium_environment_variables)로 설정된 맞춤 경로를 사용하여 Chromium에 액세스해야 합니다.
클러스터링된 Looker 설치 시 Chromium을 설치하는 경우 각 노드의 Chromium 버전이 완전히 동일해야 합니다. 다른 빌드 번호와 같은 사소한 차이도 Looker의 렌더링 기능에 지장을 줄 수 있습니다.
특정 배포판에 Chromium을 설치할 때 알아야 할 사항
Looker는 Ubuntu (LTS 출시), Debian 9 이상, RedHat Enterprise Linux (RHEL) 7 이상, CentOS 7 이상, Amazon Linux를 비롯한 모든 주요 엔터프라이즈 Linux 배포판의 출시 버전을 지원합니다.
Ubuntu 설치의 경우 Chromium 웹브라우저를 설치한 다음 Looker 애플리케이션이 설치를 찾을 수 있도록 별칭을 설정해야 합니다.
Debian 설치의 경우 Chromium에는 Debian 9 (stretch) 이상이 필요합니다. Looker 인스턴스가 Debian 설치와 함께 Docker를 사용하는 경우 procps를 설치하고 루트로 실행되고 있지 않은지 확인합니다.
글꼴 패키지 설치
Chromium을 시작하려면 시스템에 Microsoft OpenType 글꼴 (OTF) 패키지가 설치되어 있어야 합니다. OTF 패키지는 .otf 파일 확장자를 사용합니다. 이 Google Fonts의 OTF 패키지와 같은 OTF 패키지를 다운로드할 수 있습니다.
데이터에 영어 외의 문자가 포함되어 있으면 Google Noto 글꼴 패키지 (크기가 몇 GB임)도 설치해야 합니다.
이러한 패키지를 설치한 후 다음 명령어를 실행합니다.
cd $HOME
rm -rf /tmp/fonts
Chromium 설치
Chromium을 설치하려면 시스템에 해당하는 설치 명령어를 실행합니다. 예를 들면 다음과 같습니다.
apt-get update && apt-get install -y chromium-browserchromium-browser의 별칭을chromium로 지정하거나CHROMIUM_PATH환경 변수를 내보내야 합니다.chromium-browser를chromium로 별칭으로 지정하려면 시스템에 적용되는 셸 파일에 다음을 배치합니다. 예를 들면 다음과 같습니다.alias chromium='chromium-browser'이 별칭을 Looker에 알리려면 명령줄에서 다음 명령어를 실행합니다.
sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium선택적 환경 변수를 설정한 후 Looker 애플리케이션을 다시 시작하여 적용합니다. 열려 있는 터미널 세션을 다시 시작하거나 셸 파일을 소싱하여 터미널이 새 구성을 읽도록 해야 할 수도 있습니다.
Chromium을 설치한 후 CHROMIUM_PATH 환경 변수를 설정하지 않은 경우 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_START및CHROMIUM_PORT_RANGE_END: Chromium 애플리케이션에서 로컬 머신의 프로세스 간에 통신하려면 포트 범위가 필요합니다. 기본 범위는 40000~40500이지만, 두 환경 변수를 모두 설정하여 이 기본값을 재정의할 수 있습니다. 사용되지 않은 포트는 범위에서 무작위로 선택되며 단일 렌더링 기간에만 사용됩니다.DISABLE_EXTERNAL_RENDER_ACCESS: 외부 또는 차단된 인터넷 액세스가 없는 고객이 호스팅하는 Looker 인스턴스 또는 서버의 관리자는DISABLE_EXTERNAL_RENDER_ACCESS=true을 설정해야 합니다. 일반적으로 Chromium 렌더러는 페이지에서 요청한 모든 리소스가 완료되기를 기다린 후 렌더러가 '완료' 신호를 보내 Looker에게 콘텐츠를 생성하라는 메시지를 표시합니다. 이러한 요청 중 일부는 연결 부족으로 인해 중단되거나 시간 초과 또는 렌더링 시간이 매우 길어질 수 있습니다. 이 환경 변수를true로 설정하면 렌더러가 모든 요청이 완료될 때까지 기다릴 수 없습니다. Looker Marketplace에서 설치된 일부 지도 시각화 및 커스텀 시각화에는 인터넷 액세스가 필요할 수 있습니다.