Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

고객 호스팅 Looker 인스턴스에서 데이터 내보내기

고객 호스팅 Looker 인스턴스의 관리자는 주로 인프라 관리 오버헤드를 편리성 향상, 기능 가용성 향상, 관리형 안정성으로 바꾸기 위해 Looker 호스팅 환경으로의 이전을 고려할 수 있습니다. Looker에서 호스팅하는 인스턴스를 사용하면 Looker 애플리케이션을 설치, 구성, 유지관리하는 데 필요한 작업이 크게 줄어듭니다. Looker 애플리케이션과 관련된 모든 필수 IT 기능이 자동으로 처리되기 때문입니다.

고객 호스팅 인스턴스를 Looker 호스팅 환경으로 이전하는 데는 다음과 같은 주요 단계가 포함됩니다.

인테이크 및 설정: Looker팀에 티켓을 열고 Looker 온프렘 마이그레이션 설문지를 작성합니다. Looker팀은 설문지 응답을 기반으로 새로운 호스팅 인스턴스를 만듭니다.
암호화: Looker SRE가 GnuPG (GPG) 키 쌍을 생성하고 공개 키를 공유합니다.
내보내기: Looker 인스턴스를 중지하고 데이터 (데이터베이스, 파일 시스템, 고객 관리 키 (CMK))를 내보냅니다.
데이터 전송 및 가져오기: Looker팀이 백업을 Looker 호스팅 인스턴스로 가져와 확인합니다.

이 페이지에서는 3단계: 내보내기에 필요한 작업을 수행하는 방법을 설명합니다.

인스턴스의 파일 시스템 및 데이터베이스 성능과 크기 평가
Looker 파일 시스템에서 전송될 데이터 백업, 암호화, 체크섬 생성
Looker 데이터베이스 스키마에서 전송될 데이터 백업, 암호화, 체크섬 생성
CMK 키 파일 만들기, 암호화, 체크섬 생성
백업 아티팩트 검증
이전을 위해 백업 파일 전달하기

시작하기 전에

이 페이지의 스크립트를 사용하여 인스턴스의 데이터를 백업하려면 Looker 인스턴스, 데이터베이스, 암호화 구성이 이전 요구사항을 충족해야 합니다.

필수 구성

이 페이지에 설명된 스크립트를 실행하려면 다음 Looker 및 데이터베이스 버전이 필요합니다.

Looker 인스턴스에서 지원되는 Looker 출시 버전을 실행해야 합니다.
인스턴스에서 MySQL 버전 8.0.0 이상과 호환되는 데이터베이스를 사용해야 내보낸 데이터베이스 스키마 파일을 Looker에서 사용할 수 있습니다.

AWS KMS를 사용하는 경우 Looker의 암호화 키 변경 문서 페이지에 설명된 단계에 따라 Looker의 AES-256 GCM 암호화로 이전하세요.

데이터 저장 및 문자 표시가 올바르게 이루어지도록 데이터베이스 콜레이션을 utf8mb4 (권장) 또는 utf8로 설정해야 합니다. 다른 콜레이션을 사용하면 특수문자를 저장할 때 데이터가 손상되거나 오류가 발생할 수 있습니다.

마이그레이션을 위해 인스턴스 평가

고객 호스팅 Looker 인스턴스를 Looker 호스팅 Looker (원본) 인스턴스로 이전할 수 있는지 확인하려면 인스턴스의 데이터베이스와 파일 시스템의 크기와 성능을 평가해야 합니다. 이 평가에서는 소스 환경이 백업 생성 프로세스 중에 발생하는 데이터 추출을 처리할 수 있는지도 평가합니다. 이 정보는 Looker팀이 타겟 Looker 호스팅 인스턴스에 충분한 리소스를 할당하는 데 도움이 됩니다.

평가를 수행하려면 Looker 인스턴스의 컴퓨팅 사용량과 파일 시스템 성능을 평가하는 Looker 스크립트가 포함된 GitHub 저장소를 클론해야 합니다. 이 스크립트는 Go Looker SDK를 사용하며 GitHub의 Looker O2C Migration Evaluation 저장소에서 제공됩니다.

다음 섹션에서는 인스턴스를 평가하는 스크립트를 실행하기 위해 완료해야 하는 단계를 설명합니다. 여기에는 다음 작업이 포함됩니다.

스크립트가 포함된 저장소를 클론합니다.
API 사용자 인증 정보를 생성합니다.
명령어를 실행하여 컴퓨팅 사용량을 확인합니다.
명령어를 실행하여 파일 시스템 성능을 확인합니다.

평가 도구 설치

Looker 인스턴스 데이터를 백업할 머신에 다음 도구, 언어, SDK를 설치합니다.

Looker O2C 마이그레이션 평가 저장소 클론

평가 스크립트가 포함된 저장소를 클론하려면 분석 및 백업을 실행할 사용자의 홈 디렉터리에서 다음 명령어를 실행합니다.

git clone https://github.com/looker-open-source/looker-o2c-migration-tool.git

API 사용자 인증 정보 생성

평가 스크립트는 Looker SDK를 사용하여 데이터를 가져오며, 네트워크를 통해 Looker 서버에 요청을 보내는 API 클라이언트 역할을 합니다. 스크립트를 실행하는 관리자 사용자에게는 Looker API 클라이언트 ID와 클라이언트 보안 비밀번호가 있어야 합니다. Looker 관리자 계정의 API 사용자 인증 정보를 생성하려면 다음 단계를 따르세요.

관리 패널에서 사용자 페이지로 이동합니다.
계정에서 수정을 선택합니다.
계정의 세부정보 페이지에서 API3 키 섹션을 찾아 키 수정을 선택합니다.
새 API 키를 선택합니다.
Looker에 클라이언트 ID와 클라이언트 보안 비밀번호가 표시됩니다. 이 값을 복사하여 안전한 위치에 저장합니다.

컴퓨팅 사용량 정보 생성

마이그레이션 평가 스크립트를 사용하여 인스턴스의 컴퓨팅 사용량에 관한 정보를 반환하려면 Looker 애플리케이션의 API 엔드포인트에 직접 네트워크 연결이 있는 머신에서 다음 명령어를 실행하세요.

cd looker-o2c-migration-tool
go run main.go --client-id API_CLIENT_ID --client-secret API_CLIENT_SECRET --looker-instance-address LOOKER_INSTANCE_ADDRESS --output-csv-path OUTPUT_CSV_PATH --ssl=SSL

다음을 바꿉니다.

API_CLIENT_ID: 이전 단계의 클라이언트 ID입니다.
API_CLIENT_SECRET: 이전 단계의 클라이언트 보안 비밀번호입니다.
LOOKER_INSTANCE_ADDRESS: 프로토콜을 포함한 Looker 인스턴스의 주소입니다.
OUTPUT_CSV_PATH: CSV 출력의 경로입니다(예: /content/compute_usage_info.csv).
SSL: 머신과 Looker 인스턴스 간 연결에 SSL 인증서를 사용해야 하는지 여부입니다. 기본값은 true입니다.

이 명령어는 Looker 인스턴스의 사용량 세부정보가 포함된 CSV 파일을 출력합니다.

파일 시스템 성능 정보 생성

이 스크립트는 디스크 쓰기 속도 테스트와 함께 개별 모델 관련 디렉터리의 크기와 파일 수를 보여줍니다. Looker 애플리케이션 설치 문서 페이지에 설명된 대로 Looker가 사용자 이름이 looker인 사용자의 홈 디렉터리에 설치되어 있다고 가정합니다.

마이그레이션 평가 스크립트를 사용하여 인스턴스의 파일 시스템 성능에 관한 정보를 반환하려면 Looker 인스턴스가 호스팅되는 머신에서 다음 명령어를 실행하세요.

cd looker-o2c-migration-tool
go run main.go --file-system-evaluation --output-csv-path OUTPUT_CSV_PATH

다음을 바꿉니다.

OUTPUT_CSV_PATH: CSV 출력의 경로입니다(예: /content/fs_perf_info.csv).

이 명령어는 Looker 인스턴스의 파일 시스템 성능이 포함된 CSV 파일을 출력합니다.

백업을 위해 인스턴스 준비

이 페이지에 설명된 스크립트를 실행하는 데 필요한 패키지와 종속 항목을 설치하여 인스턴스 데이터를 백업할 준비를 합니다. 환경 변수를 설정하여 명령어 작성을 간소화할 수도 있습니다.

종속 항목 설치 및 확인

Looker 인스턴스 데이터를 백업하는 데 필요한 종속 항목을 설치할 때는 Linux 배포판의 표준 패키지 관리자를 사용하세요. 다음 버전은 Debian 12 (Bookworm)에 제공된 패키지에 해당하며 각 필수 패키지의 최소 버전을 나타냅니다.

Looker 인스턴스 데이터를 백업할 머신에 다음 패키지를 설치합니다.

bash 5.2.15
gpg 2.2.40 (GnuPG) - 백업 생성 프로세스에서는 데이터베이스 및 파일 시스템 백업을 Looker 팀과 공유하기 전에 gpg를 사용하여 암호화합니다.
libgcrypt 1.10.2
Gpg-agent 2.2.40 (GnuPG)
GNU tar 1.34
gzip 1.12
md5sum 9.1 (GNU coreutils)
GNU grep 3.11 (PCRE2 10.42 2022-12-11 이상 지원)
GNU sed 4.9
mariadb-client-core (MySQL 8.X에 연결해야 함)

예를 들어 Debian 기반 Linux 시스템에 필요한 패키지를 설치하려면 다음 명령어를 실행합니다.

sudo apt-get update
sudo apt-get install -y \
    bash \
    gnupg \
    libgcrypt20 \
    gnupg-agent \
    tar \
    gzip \
    coreutils \
    grep \
    sed \
    mariadb-client-core

변수 정의하기

다음 명령어는 백업 생성 프로세스 전체에서 사용될 변수를 정의합니다. 추가 명령어를 실행할 터미널에서 구성합니다.

환경 변수: 백업 디렉터리 경로 설정

다음 명령어는 파일이 생성될 백업 디렉터리의 경로를 설정합니다. 디렉터리별 백업 생성 작업을 실행할 터미널에서 다음 명령어를 실행합니다.

BACKUP_DIRECTORY="DIRECTORY_PATH"
BACKUP_DIRECTORY="${BACKUP_DIRECTORY%/}"

다음을 바꿉니다.

DIRECTORY_PATH: 백업 파일이 생성될 경로입니다. 이 디렉터리가 백업을 저장할 수 있을 만큼 충분히 큰지 확인하세요. 경로의 선행 /는 포함하지 않습니다.

환경 변수: 파일 시스템 백업의 소스 경로 설정

파일 시스템 백업의 소스 경로에 대한 변수 정의는 looker가 Looker 애플리케이션을 설치한 사용자의 사용자 이름이고 Looker 애플리케이션 설치 문서 페이지에 설명된 대로 설치가 사용자의 홈 디렉터리에서 이루어졌다고 가정합니다. 다른 디렉터리에 Looker를 설치한 경우 변수를 수정해야 합니다. Looker 파일 시스템 백업을 실행할 터미널에서 이 변수를 설정합니다.

  LOOKER_USER="looker"
  ROOT_LOOKER_FS_DIRECTORY="$(getent passwd "$LOOKER_USER" | cut -d: -f 6)"

환경 변수: 새 Looker 인스턴스 정의

가져올 인스턴스의 이름과 고유 ID를 나타내는 변수를 정의합니다. Looker팀에서 이러한 변수의 값을 제공합니다.

export luid='LOOKER_HOSTED_INSTANCE_ID'
export customer='LOOKER_HOSTED_INSTANCE_NAME'

다음을 바꿉니다.

LOOKER_HOSTED_INSTANCE_ID: 마이그레이션할 Looker 인스턴스의 고유 식별자
LOOKER_HOSTED_INSTANCE_NAME: 마이그레이션할 새 Looker 인스턴스의 이름

환경 변수: 암호화 키

다음 명령어를 실행하면 인스턴스에 공개 GPG 키가 설치됩니다. 인스턴스의 백업 명령어를 실행할 터미널에서 구성합니다 (Looker에서 이 변수의 값을 제공함).

base64_encryption_key="BASE64_ENCRYPTION_KEY"

다음을 바꿉니다.

BASE64_ENCRYPTION_KEY: 백업 스크립트가 백업을 암호화하는 데 사용하는 암호화 키입니다. Looker 팀에서 이 변수의 값을 제공합니다.

공개 암호화 키 생성

다음 명령어는 인스턴스에 공개 pgp 키를 설치합니다. 백업 스크립트는 이 키를 사용하여 백업을 암호화합니다. 인스턴스를 백업하는 명령어를 실행할 터미널에서 구성합니다.

echo -n "${base64_encryption_key}" | base64 -d | gpg --import

인스턴스 데이터 백업

다음 명령어를 실행하여 인스턴스의 파일 시스템과 데이터베이스 스키마의 중요 구성요소를 안전하게 패키징합니다. 이렇게 하면 새 Looker 호스팅 Looker (원래) 인스턴스로 전송하고 복원할 수 있습니다. 스크립트는 md5sum를 사용하여 백업의 무결성을 확인하고 검증하여 백업을 실행합니다. 마지막으로 MD5 파일 형식으로 결과를 내보내기 전에 GnuPG를 사용하여 백업을 암호화합니다.

인스턴스의 파일 시스템 데이터 백업

백업 데이터를 내보내려는 디렉터리에서 환경 변수를 설정한 것과 동일한 터미널에서 다음 명령어를 실행합니다. 마이그레이션할 Looker 호스팅 인스턴스 유형의 탭을 선택합니다.

Looker(원본)

다음 명령어를 실행하여 데이터 검증 또는 워크플로 자동화에 사용되는 맞춤 Git 서버 측 후크가 백업에 포함되어 있는지 확인합니다.

cd "${BACKUP_DIRECTORY}"

function findHookPath() {
rootPath=$1

find \
    ${rootPath}/models{-user-*,}/*/.git/config \
    -maxdepth 0 \
    -type f \
    -xtype f \
  | xargs -I {} grep hooksPath {} \
  | sort \
  | uniq \
  | sed -r -e 's/^.+hooksPath = //g' \
  | xargs -I {} dirname {} \
  | sort \
  | uniq \
  | sed -r -e "s#\.\.\/\.\.\/#${rootPath}/#g"

}

hooksPath=$(findHookPath "${ROOT_LOOKER_FS_DIRECTORY}" | sort | uniq | head -1)

이 명령어를 실행하여 필요한 모든 디렉터리를 나열하고 백업합니다.

time find "${ROOT_LOOKER_FS_DIRECTORY}" \
  -maxdepth 1 \
  -type d \
  \( \
         -name marketplace \
      -o -name bare_models \
      -o -name deploy_keys \
      -o -name models \
      -o -name remote_dependencies \
      -o -name models-self-service \
      -o -name "models-user-*" \
      -o -wholename "${hooksPath}" \
  \) | tar \
  --gzip \
  --create \
  --file="${customer}_looker_fs_backup.tar.gz" \
  --files-from=-

암호화하기 전에 백업의 '지문'을 가져오려면 다음 명령어를 실행합니다.

time md5sum "${customer}_looker_fs_backup.tar.gz" > "${customer}_fs_backup.md5"

다음 명령어를 실행하여 백업을 암호화합니다.

time gpg --encrypt --yes \
  --output "${customer}_looker_fs_backup.tar.gz.enc" \
  --recipient "looker-devops+migration-${luid}@google.com" \
  "${customer}_looker_fs_backup.tar.gz"

암호화 후 다른 '지문'을 가져오려면 다음 명령어를 실행합니다.

time md5sum "${customer}_looker_fs_backup.tar.gz.enc" >> "${customer}_fs_backup.md5"

체크섬은 Looker가 데이터 백업의 무결성을 확인하는 데 도움이 됩니다.

Looker(Google Cloud 핵심 서비스)

다음 명령어를 실행하여 데이터 검증 또는 워크플로 자동화에 사용되는 맞춤 Git 서버 측 후크가 백업에 포함되어 있는지 확인합니다.

cd "${BACKUP_DIRECTORY}"

function findHookPath() {
rootPath=$1

find \
    ${rootPath}/models{-user-*,}/*/.git/config \
    -maxdepth 0 \
    -type f \
    -xtype f \
  | xargs -I {} grep hooksPath {} \
  | sort \
  | uniq \
  | sed -r -e 's/^.+hooksPath = //g' \
  | xargs -I {} dirname {} \
  | sort \
  | uniq \
  | sed -r -e "s#\.\.\/\.\.\/#${rootPath}/#g"

}

hooksPath=$(findHookPath "${ROOT_LOOKER_FS_DIRECTORY}" | sort | uniq | head -1)

이 명령어를 실행하여 필요한 모든 디렉터리를 나열하고 백업합니다.

time find "${ROOT_LOOKER_FS_DIRECTORY}" \
  -maxdepth 1 \
  -type d \
  \( \
         -name marketplace \
      -o -name bare_models \
      -o -name deploy_keys \
      -o -name models \
      -o -name remote_dependencies \
      -o -name models-self-service \
      -o -name "models-user-looker" \
      -o -wholename "${hooksPath}" \
  \) | tar \
  --gzip \
  --create \
  --file="${customer}_looker_fs_backup.tar.gz" \
  --files-from=-

암호화하기 전에 백업의 '지문'을 가져오려면 다음 명령어를 실행합니다.

time md5sum "${customer}_looker_fs_backup.tar.gz" > "${customer}_fs_backup.md5"

다음 명령어를 실행하여 백업을 암호화합니다.

time gpg --encrypt --yes \
  --output "${customer}_looker_fs_backup.tar.gz.enc" \
  --recipient "looker-devops+migration-${luid}@google.com" \
  "${customer}_looker_fs_backup.tar.gz"

암호화 후 다른 '지문'을 가져오려면 다음 명령어를 실행합니다.

time md5sum "${customer}_looker_fs_backup.tar.gz.enc" >> "${customer}_fs_backup.md5"

체크섬은 Looker가 데이터 백업의 무결성을 확인하는 데 도움이 됩니다.

이 스크립트는 마이그레이션의 파일 시스템 부분에 대해 다음 파일을 생성합니다.

${customer}_looker_fs_backup.tar.gz.enc: 암호화되고 압축된 파일 시스템 백업입니다.
${customer}_fs_backup.md5: 확인을 위한 체크섬이 포함된 파일입니다.

인스턴스 데이터베이스 스키마 백업

이러한 명령어는 마이그레이션 도구가 Looker 인스턴스의 내부 데이터베이스에 연결할 수 있도록 하는 임시 구성 파일을 만들어 Looker 인스턴스 데이터베이스 스키마를 백업할 환경을 준비합니다. 이 스크립트는 사용자 이름과 호스트 이름과 같은 민감한 데이터를 명령어에 직접 전달하는 대신 mysqldump 및 mysql와 같은 도구가 읽을 수 있는 구성 파일에 작성합니다.

다음 명령어를 실행하여 임시 구성 파일을 만들고 다양한 설정을 지정합니다.

export database_name="DATABASE_SCHEMA_NAME"
temporary_cnf_file="$(mktemp --tmpdir=. --suffix .cnf)"
echo "[client]
host=DATABASE_HOST
port=DATABASE_PORT
user=DATABASE_USER
password=PASSWORD

[mariadb-dump]
no-sandbox

[mysql]
no-auto-rehash

[mysqldump]
no-tablespaces
loose_set-gtid-purged=OFF
single-transaction
quick
max_allowed_packet=1G
ignore-table=${database_name}.LookerQ_LookerBQ_ACTIVEMQ_ACKS
ignore-table=${database_name}.LookerQ_LookerBQ_ACTIVEMQ_LOCK
ignore-table=${database_name}.LookerQ_LookerBQ_ACTIVEMQ_MSGS

[Server-specific settings - mostly for mysqld/mariadbd processes]
max_allowed_packet = 1024M
" > ${temporary_cnf_file}

다음을 바꿉니다.

DATABASE_HOST: Looker 데이터베이스의 DNS 또는 IP입니다.
DATABASE_PORT: 데이터베이스 포트입니다.
DATABASE_USER: 내보내기를 실행할 데이터베이스 사용자 이름입니다.
PASSWORD: 내보내기를 실행할 사용자의 비밀번호에 대한 일반 텍스트 값입니다. Looker에서는 이 비밀번호를 확인하지 않습니다. 하지만 일반 텍스트 비밀번호 요구사항을 생략하려면 이 변수를 비워 두면 됩니다. 그러면 백업 명령어를 실행할 때 시스템에서 비밀번호를 입력하라는 메시지를 강제로 표시합니다.
DATABASE_SCHEMA_NAME: 데이터베이스 또는 스키마의 이름입니다.

데이터베이스에 연결을 위한 SSL 인증서가 필요한 경우 임시 구성 파일에 다음 경로를 추가합니다.

인증 기관 (CA) 파일의 경로를 설정합니다.

ssl-ca=/etc/mysql/certs/ca.pem

클라이언트 SSL 인증서의 경로를 설정합니다.

ssl-cert=/etc/mysql/certs/client-cert.pem

클라이언트 SSL 비공개 키의 경로를 설정합니다.

ssl-key=/etc/mysql/certs/client-key.pem

MySQL 데이터베이스의 경우 SSL을 요구하고 서버 인증서를 확인합니다.

loose-ssl-mode=VERIFY_CA

MariaDB 데이터베이스의 경우 SSL을 요구하고 서버 인증서를 확인합니다.

loose-ssl-verify-server-cert=ON

다음 명령어를 실행하여 데이터베이스 스키마 백업을 실행하고 암호화하고 확인합니다.

백업을 저장할 디렉터리로 이동합니다.

cd "${BACKUP_DIRECTORY}"

다음 명령어를 실행하여 데이터베이스를 백업합니다.

time mysqldump \
    --defaults-file="${temporary_cnf_file}" \
    "${database_name}" \
  | gzip > "${customer}_looker_db_backup.sql.gz"

암호화하기 전에 백업의 '지문'을 가져오려면 다음 명령어를 실행하세요.

time md5sum "${customer}_looker_db_backup.sql.gz" >> "${customer}_db_backup.md5"

다음 명령어를 실행하여 백업을 암호화합니다.

time gpg --encrypt --yes \
    --output "${customer}_looker_db_backup.sql.gz.enc" \
    --recipient "looker-devops+migration-${luid}@google.com" \
    "${customer}_looker_db_backup.sql.gz"

암호화 후 다른 '지문'을 가져오려면 다음 명령어를 실행합니다.

time md5sum "${customer}_looker_db_backup.sql.gz.enc" >> "${customer}_db_backup.md5"

이 스크립트는 마이그레이션의 데이터베이스 스키마 부분을 위해 다음 파일을 생성합니다.

${customer}_looker_db_backup.sql.gz.enc: 암호화되고 압축된 데이터베이스 스키마 백업입니다.
${customer}_db_backup.md5: 확인을 위한 체크섬이 포함된 파일입니다.

고객 관리 암호화 키 (CMK) 암호화

다음 명령어는 CMK를 검증하고, 형식을 지정하고, 암호화합니다. 이 암호화가 없으면 마이그레이션된 데이터베이스를 새 Looker 환경에서 복호화할 수 없습니다.

주의: 다음 CMK 명령어는 내부 데이터베이스를 호스팅하는 머신이나 Looker 인스턴스를 호스팅하는 머신에서 한 번만 실행해야 합니다.

먼저 현재 CMK로 변수를 설정합니다. CMK는 base64 형식이어야 합니다.

CMK="CUSTOMER_CMK_KEY"

다음을 바꿉니다.

CUSTOMER_CMK_KEY: CMK 값

그런 다음 다음 명령어를 실행하여 CMK 키 파일을 생성하고, 복호화된 CMK의 체크섬을 생성하고, CMK 파일을 암호화하고, 암호화된 CMK의 체크섬을 생성합니다.

echo -n "${CMK}" > "${customer}_looker_cmk_key"

time md5sum "${customer}_looker_cmk_key" >> "${customer}_cmk_key.md5"

time gpg --encrypt --yes \
  --output "${customer}_looker_cmk_key.enc" \
  --recipient "looker-devops+migration-${luid}@google.com" \
  "${customer}_looker_cmk_key"

time md5sum "${customer}_looker_cmk_key.enc" >> "${customer}_cmk_key.md5"

이 스크립트는 마이그레이션의 CMK 부분에 대해 다음 파일을 생성합니다.

${customer}_looker_cmk_key.enc: 암호화된 CMK 파일
${BACKUP_DIRECTORY}/${customer}_cmk_key.md5: 확인을 위한 체크섬이 포함된 파일

마이그레이션 파일 준비

지금까지 실행한 스크립트에서 다음 파일을 생성했습니다.

compute_usage_info.csv: 인스턴스의 컴퓨팅 사용량에 관한 정보가 포함된 CSV 파일
fs_perf_info.csv: 인스턴스의 파일 시스템 성능에 관한 정보가 포함된 CSV 파일
${customer}_looker_fs_backup.tar.gz.enc: 암호화되고 압축된 파일 시스템 백업
${customer}_fs_backup.md5: 확인을 위한 체크섬이 포함된 파일
${customer}_looker_db_backup.sql.gz.enc: 암호화되고 압축된 데이터베이스 스키마 백업
${customer}_db_backup.md5: 확인을 위한 체크섬이 포함된 파일
${customer}_cmk_key.md5: 확인을 위한 체크섬이 포함된 파일
${customer}_looker_cmk_key.enc: 암호화된 CMK 파일

MD5 파일을 ${customer}_backup.md5라는 단일 파일로 결합하려면 백업 디렉터리에서 다음 명령어를 실행합니다.

cat \
    "${customer}_db_backup.md5" \
    "${customer}_fs_backup.md5" \
    "${customer}_cmk_key.md5" \
  | sort | uniq \
  > "${customer}_backup.md5"

백업 아티팩트 검사

백업 파일이 완전하고 안전하며 마이그레이션할 준비가 되었는지 확인하려면 Looker 온프레미스 데이터 검증 도구를 사용하세요. 이 도구는 MD5 체크섬, GPG 암호화 키, 데이터베이스 구조, CMK 유효성 검사를 포함한 포괄적인 유효성 검사를 실행합니다.

유효성 검사 도구 설치

유효성 검사 도구를 실행하려면 머신에 Go와 GnuPG가 설치되어 있어야 합니다.

저장소를 클론하고 도구를 빌드하려면 다음 명령어를 실행합니다.

git clone https://github.com/looker-open-source/customer-scripts.git
cd customer-scripts/onprem-data-verifier
go build -o onprem-verifier main.go

유효성 검사 도구 실행

이 도구는 백업 파일이 포함된 디렉터리에서 작동합니다. 도구를 실행하기 전에 필요한 모든 파일 (암호화된 아티팩트 4개와 암호 해독된 아티팩트 3개)이 ${BACKUP_DIRECTORY}에 있는지 확인합니다.

다음 명령어를 실행하여 아티팩트를 검증합니다.

./onprem-verifier \
  --backupDir "${BACKUP_DIRECTORY}" \
  --customerName "${customer}" \
  --luid "${luid}"

성공하면 도구에서 metadata.json 파일을 생성합니다. 백업 아티팩트를 Looker팀에 전달할 때 이 파일을 포함해야 합니다.

파일 전달하기

백업 및 암호화 프로세스가 끝나면 다음 파일이 있어야 합니다.

${customer}_looker_db_backup.sql.gz.enc
${customer}_looker_fs_backup.tar.gz.enc
${customer}_looker_cmk_key.enc
${customer}_backup.md5
metadata.json
compute_usage_info.csv
fs_perf_info.csv

Looker 호스팅 인스턴스로 가져올 수 있도록 이러한 파일을 Looker 팀에 제공합니다.

고객 호스팅 Looker 인스턴스에서 데이터 내보내기 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

시작하기 전에

필수 구성

마이그레이션을 위해 인스턴스 평가

평가 도구 설치

Looker O2C 마이그레이션 평가 저장소 클론

API 사용자 인증 정보 생성

컴퓨팅 사용량 정보 생성

파일 시스템 성능 정보 생성

백업을 위해 인스턴스 준비

종속 항목 설치 및 확인

변수 정의하기

환경 변수: 백업 디렉터리 경로 설정

환경 변수: 파일 시스템 백업의 소스 경로 설정

환경 변수: 새 Looker 인스턴스 정의

환경 변수: 암호화 키

공개 암호화 키 생성

인스턴스 데이터 백업

인스턴스의 파일 시스템 데이터 백업

Looker(원본)

Looker(Google Cloud 핵심 서비스)

인스턴스 데이터베이스 스키마 백업

고객 관리 암호화 키 (CMK) 암호화

마이그레이션 파일 준비

백업 아티팩트 검사

유효성 검사 도구 설치

유효성 검사 도구 실행

파일 전달하기

고객 호스팅 Looker 인스턴스에서 데이터 내보내기