Google Cloud 프로젝트와 Cloud Shell 준비

Google Cloud 리소스는 프로젝트 안에 만들어지고, 사용량은 연결된 결제 계정으로 청구된다. 서버 명령을 실행하기 전에 프로젝트 ID와 결제 상태를 확인한다. 필요한 작업은 모두 브라우저의 Google Cloud Console과 Cloud Shell에서 진행할 수 있다.

시작 전에

Google 계정과 지원되는 결제 수단이 필요하다. 2026년 8월 기준 무료 체험 대상인 신규 고객은 결제 수단으로 본인을 확인하면 90일 동안 쓸 수 있는 $300 크레딧을 받는다. 무료 체험이 끝나도 자동으로 과금되지 않는다. 크레딧을 소진하거나 90일이 지나면 리소스가 멈추고, 계속 쓰려면 직접 유료 계정으로 업그레이드해야 한다. 이 단계에서는 Minecraft VM을 만들기 전에 결제 계정 연결과 예산 알림 설정까지 마친다.

이 단계의 예산은 일반 알림 예산이다. 정한 금액에 도달해도 Compute Engine VM이나 Storage 사용을 자동으로 멈추지 않는다.

프로젝트 만들기

실행: Google Cloud Console에서

Google Cloud Console에 로그인한다.
상단의 프로젝트 선택 메뉴를 누른다.
새 프로젝트를 누른다.
프로젝트 이름을 알아보기 쉽게 입력한다.
화면에 생성된 프로젝트 ID를 확인하고 만들기를 누른다.
생성이 끝나면 상단 프로젝트 선택 메뉴에서 새 프로젝트를 선택한다.

프로젝트 이름은 나중에 바꿀 수 있지만 프로젝트 ID는 Google Cloud API와 Terraform이 계속 사용한다. 이후 명령에는 이름 대신 ID를 넣는다. 예시는 minecraft-guide-123456처럼 소문자, 숫자와 하이픈으로 된 값이다.

조직 계정에서는 프로젝트를 직접 만들 권한이 없을 수 있다. 새 프로젝트 버튼이 없거나 생성이 거부되면 조직 관리자에게 프로젝트 생성과 결제 연결을 요청한다.

결제 계정 연결

Minecraft VM, 디스크와 외부 IP를 만들려면 프로젝트에 활성 결제 계정이 연결돼 있어야 한다.

실행: Console 왼쪽 메뉴에서

결제를 연다.
결제 계정이 없다면 안내에 따라 셀프서비스 결제 계정을 만든다.
내 프로젝트에서 앞에서 만든 프로젝트를 찾는다.
프로젝트 행의 메뉴에서 결제 변경을 누른다.
사용할 결제 계정을 선택하고 연결한다.

새 프로젝트를 만들 때 결제 계정을 이미 선택했다면 다시 연결하지 않는다. Google Cloud 결제 연결 문서에서 프로젝트와 결제 계정에 필요한 권한을 확인할 수 있다.

예산 알림 만들기

예산 알림은 사용량이 예상 금액에 가까워졌을 때 이메일을 보낸다. VM과 Storage는 별도의 중지 조치를 할 때까지 계속 실행된다.

실행: 결제 화면에서

결제에서 연결한 결제 계정을 연다.
비용 관리의 예산 및 알림을 선택한다.
예산 만들기를 누른다.
범위를 이 Minecraft 프로젝트 하나로 제한한다.
감당할 수 있는 월 금액을 입력한다.
기본 임계값 알림과 받을 이메일 주소를 확인하고 저장한다.

예산 금액은 서버 가격을 뜻하지 않는다. 서버를 계속 켜 두는 실수를 알아차릴 수 있는 금액으로 정한다. Google Cloud는 예산과 알림 설정 절차를 별도로 제공한다.

Cloud Shell 열기

Cloud Shell은 브라우저에서 실행되는 Linux 터미널이다. gcloud, curl, nano 같은 도구를 준비해 주고 Console에서 선택한 프로젝트를 현재 프로젝트로 전달한다.

실행: Google Cloud Console에서

Console 오른쪽 위의 Cloud Shell 활성화 아이콘을 누른다.
화면 아래에 터미널이 열릴 때까지 기다린다.
처음 권한 요청이 나오면 내용을 읽고 승인을 누른다.

프롬프트 끝에 $가 보이면 다음 명령을 입력한다.

gcloud config get-value project

출력은 앞에서 적어 둔 프로젝트 ID와 같아야 한다. 다르면 Console 상단에서 프로젝트를 다시 선택하고 Cloud Shell 탭을 새로 연다.

Cloud Shell의 $HOME에는 기본 모드에서 5GB 영구 저장 공간이 제공된다. 임시 모드를 선택하면 세션이 끝날 때 작업 파일이 사라지므로 여기서는 사용하지 않는다. 120일 동안 Cloud Shell을 한 번도 열지 않으면 이 저장 공간 전체가 삭제된다는 점도 기억해 둔다. 서버 운영을 오래 쉬었다 돌아올 계획이라면 terraform.tfvars 같은 작업 파일을 로컬 PC에도 복사해 둔다.

Terraform 준비

Cloud Shell 이미지에 Terraform이 있을 수도 있고 없을 수도 있다. 2026년 6월 Cloud Shell 릴리스 노트에는 기본 CLI 제거가 기록돼 있으므로 먼저 존재 여부를 검사한다.

확인: Cloud Shell에서

아래 다섯 줄은 하나의 검사 명령이다. 통째로 복사해 붙여 넣고 Enter를 누르면, Terraform이 있을 때는 버전을, 없을 때는 Terraform installation required를 출력한다.

if command -v terraform >/dev/null 2>&1; then
  terraform version
else
  echo "Terraform installation required"
fi

Terraform v1.8 이상이고 2.0 미만이면 설치를 건너뛴다. 없거나 더 오래된 버전이면 공개 설치 스크립트를 내려받는다.

조건부 실행: Cloud Shell에 Terraform이 없거나 1.8 미만일 때

curl --fail --location \
  https://juntiger-assets.pages.dev/minecraft-terraform-bootstrap.sh \
  --output minecraft-terraform-bootstrap.sh

bash minecraft-terraform-bootstrap.sh
export PATH="$HOME/.local/bin:$PATH"
terraform version

설치 스크립트는 Cloud Shell의 Linux x86_64 환경만 받는다. 이 연재의 검증에 사용한 Terraform 1.15.8 압축 파일을 HashiCorp에서 내려받고, 설치 스크립트에 고정한 SHA-256과 비교한 뒤 $HOME/.local/bin에 설치한다. macOS나 WSL에서 이 스크립트를 실행하지 않는다.

export PATH=... 줄은 지금 열린 세션에 설치 경로를 알려 준다. 스크립트가 $HOME/.profile에도 같은 줄을 추가해 두므로, 다음에 새 Cloud Shell 탭을 열면 따로 실행하지 않아도 terraform 명령을 바로 찾는다.

정상 출력은 Terraform v1.15.8처럼 시작한다.

로컬 터미널을 쓸 때

Cloud Shell 대신 내 컴퓨터에서 진행하려면 HashiCorp Terraform 설치 문서와 Google Cloud CLI 설치 문서를 따른다. macOS Terminal, Linux와 WSL에서도 같은 Bash 명령을 사용할 수 있다.

로컬에서는 브라우저 로그인이 Cloud Shell에 자동으로 전달되지 않는다. 03편에서 gcloud init, CLI 로그인과 Application Default Credentials를 따로 준비한다.

완료 확인

Cloud Shell에서 다음 세 명령을 실행한다.

gcloud config get-value project
gcloud auth list --filter="status:ACTIVE"
terraform version

프로젝트가 다르거나 Terraform 명령을 찾지 못하면 여기서 멈춘다. 세 명령의 성공은 Terraform 인증과 원격 state 준비의 선수 조건이다.