SCBL002

개요

이 실습에서는 Google Cloud SDK, 명령줄 인터페이스(CLI), Terraform을 사용하여 Spanner 인스턴스와 데이터베이스 생성을 자동화합니다.

목표

이 실습에서는 다음을 수행하는 방법에 대해 알아봅니다.

• gcloud CLI를 사용하여 인스턴스 및 데이터베이스 만들기
• Terraform을 사용하여 Spanner 인프라 자동화

설정 및 요구사항

실습 시작 버튼을 클릭하기 전에

다음 안내를 확인하세요. 실습에는 시간 제한이 있으며 일시중지할 수 없습니다. 실습 시작을 클릭하면 타이머가 시작됩니다. 이 타이머는 Google Cloud 리소스를 사용할 수 있는 시간이 얼마나 남았는지를 표시합니다.

실무형 실습을 통해 시뮬레이션이나 데모 환경이 아닌 실제 클라우드 환경에서 직접 실습 활동을 진행할 수 있습니다. 실습 시간 동안 Google Cloud에 로그인하고 액세스하는 데 사용할 수 있는 새로운 임시 사용자 인증 정보가 제공됩니다.

이 실습을 완료하려면 다음을 준비해야 합니다.

• 표준 인터넷 브라우저 액세스 권한(Chrome 브라우저 권장)

참고: 이 실습을 실행하려면 시크릿 모드 또는 시크릿 브라우저 창을 사용하세요. 개인 계정과 학습자 계정 간의 충돌로 개인 계정에 추가 요금이 발생하는 일을 방지해 줍니다.

• 실습을 완료하기에 충분한 시간. 실습을 시작하고 나면 일시중지할 수 없습니다.

참고: 계정에 추가 요금이 발생하지 않도록 하려면 개인용 Google Cloud 계정이나 프로젝트가 이미 있어도 이 실습에서는 사용하지 마세요.

Google Cloud Shell 활성화하기

Google Cloud Shell은 다양한 개발 도구가 탑재된 가상 머신으로, 5GB의 영구 홈 디렉토리를 제공하며 Google Cloud에서 실행됩니다. Google Cloud Shell을 사용하면 명령줄을 통해 GCP 리소스에 액세스할 수 있습니다.

1. GCP Console의 오른쪽 상단 툴바에서 Cloud Shell 열기 버튼을 클릭합니다.

   

2. ( 계속) Continue을 클릭하십시오.

   

환경을 프로비저닝하고 연결하는 데 약간의 시간이 걸립니다. 연결되면 이미 인증되었으며 프로젝트는 PROJECT_ID 로 설정됩니다. 예를 들면 다음과 같습니다.

gcloud는 Google Cloud Platform의 명령줄 도구입니다. Cloud Shell에 사전 설치되어 있으며 탭 자동 완성을 지원합니다.

다음 명령어로 사용 중인 계정 이름 목록을 표시할 수 있습니다.

gcloud auth list

출력:

Credentialed accounts:
- <myaccount>@<mydomain>.com (active)

출력 예:

Credentialed accounts:
- google1623327_student@qwiklabs.net

다음 명령어로 프로젝트 ID 목록을 표시할 수 있습니다.

gcloud config list project

출력:

[core]
project = <project_ID>

출력 예:

[core]
project = qwiklabs-gcp-44776a13dea667a6

작업 1. gcloud CLI를 사용하여 인스턴스 및 데이터베이스 만들기

1. Google Cloud 콘솔 제목 표시줄에서 Cloud Shell 활성화()를 클릭합니다. 메시지가 표시되면 계속을 클릭합니다.

2. 다음 명령어를 실행하여 프로젝트 ID를 설정합니다.

gcloud config set project {{{project_0.project_id|placeholder_project_id}}}

3. Cloud Shell 프롬프트에서 다음 명령어를 실행하여 test-spanner-instance라는 이름의 Spanner 인스턴스를 만듭니다.

Spanner 구성 및 용량의 파라미터를 확인합니다. 명령어를 승인하라는 메시지가 표시되면 이를 수행합니다.

gcloud spanner instances create test-spanner-instance --config=regional-{{{project_0.default_region|place_holder_text}}} --description="test-spanner-instance" --processing-units=100

4. 명령어는 오래 걸리지 않습니다. 콘솔에서 Spanner 서비스로 이동하여 인스턴스가 만들어졌는지 확인합니다.

아래 명령어를 실행하면 인스턴스를 볼 수 있습니다. 지금 시도해 보세요.

gcloud spanner instances list

5. Pets 데이터베이스를 만들려면 먼저 DDL 코드가 포함된 파일이 필요합니다. 다음 명령어를 입력하여 파일을 만들고 Nano 코드 편집기에서 이 파일을 엽니다.

nano pets-db-schema.sql

6. 다음 코드를 Nano에 붙여넣습니다. Ctrl+X를 입력한 다음 Y를 입력하고, ENTER 키를 눌러 파일을 저장합니다.

CREATE TABLE Owners ( OwnerID STRING(36) NOT NULL, OwnerName STRING(MAX) NOT NULL ) PRIMARY KEY (OwnerID); CREATE TABLE Pets ( PetID STRING(36) NOT NULL, OwnerID STRING(36) NOT NULL, PetType STRING(MAX) NOT NULL, PetName STRING(MAX) NOT NULL, Breed STRING(MAX) NOT NULL, ) PRIMARY KEY (PetID);

7. 이제 스키마 파일이 생겼으므로 다음 명령어를 실행하여 데이터베이스를 만듭니다.

gcloud spanner databases create pets-db --instance=test-spanner-instance --database-dialect=GOOGLE_STANDARD_SQL --ddl-file=./pets-db-schema.sql

8. 소유자와 소유한 모든 강아지를 삽입합니다. Owner와 Pets의 기본 키로는 UUID를 사용합니다. 다음 명령어를 입력하여 소유자의 UUID를 만들고 변수에 저장합니다.

owner_uuid=$(cat /proc/sys/kernel/random/uuid) echo $owner_uuid

9. 소유자 Doug를 삽입합니다.
   참고: --data 파라미터를 사용하여 이름-값 쌍으로 필드를 전달할 수 있습니다.

gcloud spanner rows insert --table=Owners --database=pets-db --instance=test-spanner-instance --data=OwnerID=$owner_uuid,OwnerName=Doug

10. 다음 명령어를 사용해 Doug의 강아지를 모두 삽입합니다.

gcloud spanner rows insert --table=Pets --database=pets-db --instance=test-spanner-instance --data=PetID=$(cat /proc/sys/kernel/random/uuid),OwnerID=$owner_uuid,PetName='Rusty',PetType='Dog',Breed='Poodle' gcloud spanner rows insert --table=Pets --database=pets-db --instance=test-spanner-instance --data=PetID=$(cat /proc/sys/kernel/random/uuid),OwnerID=$owner_uuid,PetName='Duchess',PetType='Dog',Breed='Terrier' gcloud spanner rows insert --table=Pets --database=pets-db --instance=test-spanner-instance --data=PetID=$(cat /proc/sys/kernel/random/uuid),OwnerID=$owner_uuid,PetName='Gretyl',PetType='Dog',Breed='Shepherd' gcloud spanner rows insert --table=Pets --database=pets-db --instance=test-spanner-instance --data=PetID=$(cat /proc/sys/kernel/random/uuid),OwnerID=$owner_uuid,PetName='Gigi',PetType='Dog',Breed='Retriever' gcloud spanner rows insert --table=Pets --database=pets-db --instance=test-spanner-instance --data=PetID=$(cat /proc/sys/kernel/random/uuid),OwnerID=$owner_uuid,PetName='Noir',PetType='Dog',Breed='Schnoodle' gcloud spanner rows insert --table=Pets --database=pets-db --instance=test-spanner-instance --data=PetID=$(cat /proc/sys/kernel/random/uuid),OwnerID=$owner_uuid,PetName='Bree',PetType='Dog',Breed='Mutt'

11. 제대로 작동하는지 확인해 보겠습니다. 다음 쿼리를 실행합니다.

gcloud spanner databases execute-sql pets-db --instance=test-spanner-instance --sql='SELECT o.OwnerName, p.PetName, p.PetType, p.Breed FROM Owners as o JOIN Pets AS p ON o.OwnerID = p.OwnerID'

12. 콘솔로 이동하여 데이터를 확인할 수도 있습니다. 제품 목록에서 Spanner를 선택합니다. 그런 다음 왼쪽 메뉴에서 test-spanner-instance > pets-db(데이터베이스 아래) > Pets(테이블 아래) > 데이터를 선택합니다.

13. 다음 명령어를 사용하여 데이터베이스를 삭제합니다.

gcloud spanner databases delete pets-db --instance=test-spanner-instance

14. 콘솔에서 데이터베이스가 삭제되었는지 확인합니다.

15. 마지막으로, 다음 명령어를 사용해 인스턴스를 삭제합니다.

gcloud spanner instances delete test-spanner-instance --quiet

참고: --quiet 파라미터는 사용자에게 메시지를 표시하지 않고 명령어를 실행합니다. 이전 명령어에 이 명령어를 추가할 수도 있습니다. 이는 자동화된 파이프라인을 작성하면서 사용자에게 질문할 수 없는 경우에 유용합니다.

16. 콘솔에서 인스턴스가 삭제되었는지 확인합니다.

작업 2. Terraform을 사용하여 Spanner 인프라 자동화

1. 다음 명령어를 사용하여 Terraform 파일의 폴더를 만들고 해당 폴더로 변경합니다.

mkdir terraform-spanner cd terraform-spanner

2. Terraform 모듈에는 여러 파일이 필요합니다. 다음 명령어를 실행하여 빈 파일을 만듭니다.

touch main.tf provider.tf terraform.tfvars variables.tf

3. 편집기 열기 버튼을 클릭하여 코드 편집기를 엽니다. 왼쪽의 '탐색기' 창에서 방금 만든 terraform-spanner 폴더를 찾아 펼칩니다. provider.tf 파일을 선택하여 편집기에서 열고 다음 코드를 추가합니다.

terraform { required_providers { google = { source = "hashicorp/google" version = "~> 4.0" } } } provider "google" { project = var.project_id region = var.region }

참고: Terraform 블록의 코드는 Hashicorp의 웹사이트에서 Google 제공자를 다운로드합니다. provider 블록의 코드는 나중에 변수로 설정하게 되는 프로젝트 ID와 리전을 알맞게 사용하도록 제공자를 구성합니다.

4. main.tf 파일을 열고 다음 리소스 블록을 추가합니다. 이 코드는 Spanner 인스턴스를 만듭니다.

resource "google_spanner_instance" "db-instance" { name = "terraform-spanner-instance" config = "regional-${var.region}" display_name = "TF Spanner Instance" processing_units = var.processing_units force_destroy = var.force_destroy }

5. 같은 파일에서 이전 코드 아래에 다음 코드를 추가하여 Pets 데이터베이스를 만듭니다. 테이블을 정의하는 DDL 코드를 확인해 두세요.

resource "google_spanner_database" "test-database" { instance = google_spanner_instance.db-instance.name name = "pets-db" # Can't run destroy unless set to false deletion_protection = var.deletion_protection ddl = [ "CREATE TABLE Owners (OwnerID STRING(36) NOT NULL, OwnerName STRING(MAX) NOT NULL) PRIMARY KEY (OwnerID)", "CREATE TABLE Pets (PetID STRING(36) NOT NULL, OwnerID STRING(36) NOT NULL, PetType STRING(MAX) NOT NULL, PetName STRING(MAX) NOT NULL, Breed STRING(MAX) NOT NULL) PRIMARY KEY (PetID)", ] }

6. variables.tf 파일을 엽니다. 이 파일에서 Terraform 모듈에 사용되는 변수를 선언합니다. 다음 코드를 추가합니다.

variable "deletion_protection" { description = "If set to true, you cannot run terraform destroy if there are databases created." type = bool default = false } variable "force_destroy" { description = "If set to true, running terraform destroy will delete all backups." type = bool default = true } variable "processing_units" { type = number default = 100 } variable "project_id" { description = "The GCP Project ID." type = string } variable "region" { type = string }

7. project_id와 region을 제외한 모든 변수에는 기본값이 있습니다. terraform.tfvars 파일을 사용하여 이러한 변수의 값을 설정합니다. 해당 파일을 열고 다음을 추가합니다.

project_id = "{{{project_0.project_id|placeholder_project_id}}}" region = "{{{project_0.default_region|place_holder_text}}}"

8. 제대로 작동하는지 살펴보겠습니다. 터미널 열기 버튼을 클릭합니다. 편집기에서 새 탭 또는 창을 연 상태라면 먼저 원래 탭으로 전환해야 할 수 있습니다. 명령 프롬프트에서 다음을 입력합니다.

terraform init

9. 이전 명령어에 오류가 없다고 가정하고, 다음을 입력한 다음 출력을 분석합니다. 리소스 2개가 추가된다고 표시됩니다.

terraform plan

10. 마지막으로, 다음 명령어를 입력하여 Spanner 인스턴스와 Pets 데이터베이스를 만듭니다. 메시지가 표시되면 yes를 입력하세요.

terraform apply

11. Terraform 명령어가 완료될 때까지 기다립니다. 콘솔에서 Spanner 서비스로 이동하여 인스턴스와 데이터베이스가 만들어졌는지 확인합니다. 새로고침 버튼이 없기 때문에 인스턴스 목록을 새로고침하려면 다른 제품을 클릭한 다음 Spanner로 돌아와야 할 수 있습니다.

12. 터미널로 돌아가 다음 명령어를 입력하여 Spanner 인스턴스를 삭제합니다.

terraform destroy -auto-approve

수고하셨습니다. Google Cloud SDK, 명령줄 인터페이스(CLI), Terraform을 사용하여 Spanner 인스턴스와 데이터베이스 생성을 자동화했습니다.

실습 종료

실습을 완료하면 실습 종료를 클릭합니다. Qwiklabs에서 사용된 리소스를 자동으로 삭제하고 계정을 지웁니다.

실습 경험을 평가할 수 있습니다. 해당하는 별표 수를 선택하고 의견을 입력한 후 제출을 클릭합니다.

별점의 의미는 다음과 같습니다.

• 별표 1개 = 매우 불만족
• 별표 2개 = 불만족
• 별표 3개 = 중간
• 별표 4개 = 만족
• 별표 5개 = 매우 만족

의견을 제공하고 싶지 않다면 대화상자를 닫으면 됩니다.

의견이나 제안 또는 수정할 사항이 있다면 지원 탭을 사용하세요.

Copyright 2024 Google LLC All rights reserved. Google 및 Google 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표일 수 있습니다.