이 페이지에서는 Game Servers 배포를 생성, 나열, 설명, 업데이트하는 방법을 설명합니다. 배포는 일부 또는 모든 렐름에 배포할 수 있는 하나 이상의 소프트웨어 버전을 관리합니다. 배포를 만들고 구성을 추가한 후 출시하는 방법의 엔드 투 엔드 예시를 보려면 클러스터 확장 동작 구성을 참조하세요.
시작하기 전에
시작하기 전에 Game Servers 개요의 주요 개념을 숙지하는 것이 좋습니다. 또한 다음 태스크를 수행했는지 확인합니다.
- Game Services API가 사용 설정되어 있는지 확인합니다. Game Services API 사용 설정
- gcloud CLI가 설치된 셸을 선택하거나 API 클라이언트를 사용합니다.
Google Cloud Console로 이동.
Console의 오른쪽 상단에서 Cloud Shell 활성화 버튼을 클릭합니다.
- 서비스 계정 만들기.
- 비공개 키를 JSON 파일로 다운로드합니다.
-
GOOGLE_APPLICATION_CREDENTIALS
환경 변수를 사용자 인증 정보가 포함된 JSON 파일의 경로로 설정합니다. 이 변수는 현재 셸 세션에만 적용되므로 새 세션을 열면 변수를 다시 설정합니다.
Cloud Shell
Cloud Shell을 시작하려면 다음 단계를 수행하세요.
Console 하단의 프레임에서 Cloud Shell 세션이 열립니다.
이 셸을 사용하여 gcloud
명령어를 실행합니다.
로컬 셸
gcloud CLI 설치
Google Cloud CLI에 원하는 기본 프로젝트를 설정했는지 확인합니다. 그렇지 않으면 나중에 명령어마다 --project
플래그를 명시적으로 지정해야 합니다.
gcloud config list project
사용할 수 없는 경우 다음 명령어를 실행하여 기본 프로젝트를 설정하고 PROJECT_ID
를 원하는 프로젝트 ID로 바꾸세요.
gcloud config set project PROJECT_ID
다음 명령어를 실행하여 Google Cloud CLI 버전을 확인합니다.
Game Servers에는 gcloud CLI 버전 306.0.0
이상이 필요합니다.
gcloud version
설치를 업데이트하려면 다음 명령어를 실행합니다.
gcloud components update
curl / PowerShell
curl
또는 Windows PowerShell에서 REST API를 사용하려면 다음을 수행합니다.
클라이언트 라이브러리
클라이언트 라이브러리를 사용하여 Google Cloud Game Servers를 프로그래매틱 방식으로 제어할 수 있습니다. 라이브러리 사용 및 인증에 대한 안내는 클라이언트 라이브러리 개요를 참조하세요.
배포 만들기
Console
Google Cloud Console에서 게임 서버 배포 페이지로 이동합니다.
배포 만들기를 클릭합니다.
이름 상자에 이 배포의 고유 식별자를 입력합니다.
(선택사항) 설명 상자에 이 배포에 대한 설명을 입력합니다.
만들기를 클릭합니다.
gcloud
Google Cloud CLI를 사용하여 배포를 만들 수 있습니다.
배포를 만들려면 다음 명령어를 실행하고 deploymentID를 적절한 값으로 바꿉니다.
gcloud game servers deployments create deploymentID
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: IAM 설정에 나열된 Google Cloud 프로젝트 ID입니다.
- DEPLOYMENT_ID: 배포의 사용자 정의 식별자입니다.
JSON 요청 본문:
{ "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID", }
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
배포 나열
Console
Google Cloud Console에서 게임 서버 배포 페이지로 이동합니다.
필터 상자를 사용하여 여러 속성별로 배포 목록을 필터링할 수 있습니다.
gcloud
Google Cloud CLI를 사용하여 배포를 나열할 수 있습니다.
배포를 나열하려면 다음 명령어를 실행합니다.
gcloud game servers deployments list
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: IAM 설정에 나열된 Google Cloud 프로젝트 ID입니다.
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "gameServerDeployments": [ { "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/my-deployment-1", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "etag": "RI8hTm3ZaMNZ3qRVeKVcxcN3W26_oR559JYofnFi69A" }, { "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/my-deployment-2", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "etag": "az38kwIY4X3WdP2SA0fkTGib9hwVj7iXLFXAtIzMLpc" } ] }
배포 설명
Console
Google Cloud Console에서 게임 서버 배포 페이지로 이동합니다.
필터 상자를 사용하여 여러 속성별로 배포 목록을 필터링할 수 있습니다.
마지막 테이블 열에서 줄임표 more_vert를 클릭하고 구성 나열을 선택합니다. 이 페이지에서 배포의 활성 및 비활성 구성을 볼 수 있습니다.
배포를 위한 새 구성을 만들려면 구성 만들기를 클릭합니다. 출시를 업데이트하려면 출시 관리를 클릭합니다.
gcloud
Google Cloud CLI를 사용하여 만든 시간 또는 업데이트 시간과 같은 배포에 대한 세부정보를 가져올 수 있습니다.
배포를 설명하려면 다음 명령어를 실행하고 deploymentID를 이전에 만든 배포의 식별자로 바꿉니다.
gcloud game servers deployments describe deploymentID
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: IAM 설정에 나열된 Google Cloud 프로젝트 ID입니다.
- DEPLOYMENT_ID: 배포의 사용자 정의 식별자입니다.
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "etag": "RI8hTm3ZaMNZ3qRVeKVcxcN3W26_oR559JYofnFi69A" }
배포 업데이트
gcloud
배포 필드를 업데이트하려면 기존 배포의 deploymentID를 바꾼 후 gcloud game servers
deployments update
명령어를 실행합니다. 다음 명령어는 배포의 설명 필드를 업데이트합니다.
gcloud game servers deployments update deploymentID --description="My updated description"
다른 배포 필드의 플래그를 찾으려면 gcloud
참조를 확인하세요.
REST
다음 샘플은 description
필드를 업데이트합니다. 다른 필드를 업데이트하려면 필드 이름을 ?updateMask=
쿼리 매개변수에 추가하고 JSON 본문을 요청합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: IAM 설정에 나열된 Google Cloud 프로젝트 ID입니다.
- DEPLOYMENT_ID: 배포의 사용자 정의 식별자입니다.
JSON 요청 본문:
{ "description": "My updated description" }
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata", "createTime": CREATE_TIME, "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID", "verb": "update", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
다음 단계
- 구성을 만드는 방법 알아보기
- 출시를 만들거나 업데이트하는 방법 알아보기
- 배포 삭제 방법 알아보기