렐름 만들기

이 페이지에서는 Game Servers 렐름을 만들고 나열하고 설명하는 방법을 설명합니다. 렐름은 플레이어 집단을 위한 게임 지연 시간 요구사항에 기초하여 게임 서버 클러스터를 사용자 정의로 그룹화한 것입니다.

시작하기 전에

시작하기 전에 Game Servers 개요의 주요 개념을 숙지하는 것이 좋습니다. 또한 다음 작업을 수행했는지 확인합니다.

  • Game Services API가 사용 설정되어 있는지 확인합니다.
  • Game Services API 사용 설정
  • Cloud SDK가 설치된 셸을 선택하거나 API 클라이언트를 사용하세요.
  • Cloud Shell

    Cloud Shell을 시작하려면 다음 단계를 수행하세요.

    1. Google Cloud Console로 이동합니다.

      Google Cloud Console

    2. Console의 오른쪽 상단에서 Cloud Shell 활성화 버튼을 클릭합니다.

    Console 하단의 프레임에서 Cloud Shell 세션이 열립니다. 이 셸을 사용하여 gcloud 명령어를 실행합니다.

    로컬 셸

    gcloud를 설치하려면 gcloud 명령줄 도구가 포함된 Cloud SDK를 설치합니다.

    gcloud 명령줄 도구에 원하는 기본 프로젝트를 설정했는지 확인합니다. 그렇지 않으면 나중에 각 명령어에 명시적으로 --project 플래그를 지정해야 합니다.

    gcloud config list project
    

    사용할 수 없는 경우 다음 명령어를 실행하여 기본 프로젝트를 설정하고 project-id를 원하는 프로젝트 ID로 바꾸세요.

    gcloud config set project project-id
    

    다음 명령어를 실행하여 Google Cloud SDK의 버전을 확인합니다. Game Servers에는 306.0.0 이상의 SDK 버전이 필요합니다.

    gcloud version
    

    설치를 업데이트하려면 다음 명령어를 실행합니다.

    gcloud components update
    

    클라이언트 라이브러리

    Google Cloud Game Servers는 클라이언트 라이브러리를 사용하여 프로그래매틱 방식으로 제어할 수 있습니다. 라이브러리 사용 및 인증에 대한 안내는 클라이언트 라이브러리 개요를 참조하세요.

렐름 만들기

렐름은 전역 또는 리전일 수 있습니다. 렐름 클러스터로 등록된 클러스터가 북미와 남미 또는 유럽과 아시아 등 다양한 지리적 위치에 걸쳐 있는 리전의 경우 전역 렐름이 유용한 옵션입니다. 클러스터가 유럽 서부처럼 같은 리전에 있을 때는 리전 렐름이 적합합니다. 리전 간 네트워크 중단 시 전역 렐름에서 일부 리전의 클러스터를 관리하지 못할 수도 있습니다. 리전 간 네트워크 장애에 대비하기 위해 연결된 게임 서버 클러스터와 최대한 가까운 리전의 리전 렐름을 만들어야 합니다.

예를 들어 europe-west1, europe-west2, europe-west3 리전에 클러스터를 만들어 유럽 서부의 사용자에게 서비스를 제공하는 경우 이러한 리전 중 하나에 리전 렐름을 만들 수도 있습니다. 이 구성은 네트워크 중단으로 인해 다른 리전에서 리전이 도달할 수 없는 경우 렐름이 계속 클러스터를 관리할 수 있게 해줍니다.

렐름을 어디에서 만들지 확신이 없으면 해당 렐름을 전역 렐름으로 만들 수 있습니다. 요구사항이 변경되면 관리가 필요한 클러스터와 더 가까운 리전에서 새 렐름을 만들 수 있습니다. 그런 다음 먼저 전역 렐름에서 클러스터를 삭제 및 등록 취소한 후에 새로운 리전 렐름에서 등록하는 방식으로 기존 클러스터를 새 리전 렐름으로 이동할 수 있습니다.

gcloud 명령어

gcloud 명령줄 도구를 사용하여 렐름을 만들 수 있습니다. 전역 렐름을 만들려면 다음 명령어를 실행하고 자리표시자 값(예: realmID)을 적절한 값으로 바꿉니다.

gcloud game servers realms create realmID --time-zone tz

리전 렐름을 만들려면 다음 명령어를 실행하고 자리표시자 값(예: realmID)을 적절한 값으로 바꿉니다.

gcloud game servers realms create realmID --time-zone tz --location=region

변수 자리표시자는 다음 설명에 해당합니다.

  • realmID는 이 렐름에 지정할 수 있는 고유 식별자입니다.
  • tz는 이 렐름의 시간대입니다. 확장 정책 같은 시간 기반 이벤트를 예약하는 경우 이 시간대를 적용합니다.
  • region은 렐름의 리전입니다. 장애 도메인을 제어하려면 리전을 지정하세요. 전역 렐름을 만들고 이 옵션을 생략하는 것을 추천합니다.

Go


import (
	"context"
	"fmt"
	"io"

	gaming "cloud.google.com/go/gaming/apiv1"
	gamingpb "google.golang.org/genproto/googleapis/cloud/gaming/v1"
)

// createRealm creates a game server realm.
func createRealm(w io.Writer, projectID, location, realmID string) error {
	// projectID := "my-project"
	// location := "global"
	// realmID := "myrealm"
	ctx := context.Background()
	client, err := gaming.NewRealmsClient(ctx)
	if err != nil {
		return fmt.Errorf("NewRealmsClient: %v", err)
	}
	defer client.Close()

	req := &gamingpb.CreateRealmRequest{
		Parent:  fmt.Sprintf("projects/%s/locations/%s", projectID, location),
		RealmId: realmID,
		Realm: &gamingpb.Realm{
			TimeZone:    "US/Pacific",
			Description: "My Game Server Realm",
		},
	}

	op, err := client.CreateRealm(ctx, req)
	if err != nil {
		return fmt.Errorf("CreateRealm: %v", err)
	}
	resp, err := op.Wait(ctx)
	if err != nil {
		return fmt.Errorf("Wait: %v", err)
	}

	fmt.Fprintf(w, "Realm created: %v", resp.Name)
	return nil
}

Node.js

const {RealmsServiceClient} = require('@google-cloud/game-servers');

const client = new RealmsServiceClient();

async function createRealm() {
  /**
   * TODO(developer): Uncomment these variables before running the sample.
   */
  // const projectId = 'Your Google Cloud Project ID';
  // const location = 'A Compute Engine region, e.g. "us-central1"';
  // const realmId = 'A unique identifier for the realm';
  const request = {
    parent: `projects/${projectId}/locations/${location}`,
    realmId: realmId,
    realm: {
      // Must use a supported time zone name.
      // See https://cloud.google.com/dataprep/docs/html/Supported-Time-Zone-Values_66194188
      timeZone: 'US/Pacific',
      description: 'My Game Server realm',
    },
  };

  const [operation] = await client.createRealm(request);
  const results = await operation.promise();
  const [realm] = results;

  console.log('Realm created:');

  console.log(`\tRealm name: ${realm.name}`);
  console.log(`\tRealm description: ${realm.description}`);
  console.log(`\tRealm time zone: ${realm.timeZone}`);
}

createRealm();

Python

def create_realm(project_id, location, realm_id):
    """Creates a realm."""

    client = gaming.RealmsServiceClient()

    request = realms.CreateRealmRequest(
        parent=f"projects/{project_id}/locations/{location}",
        realm_id=realm_id,
        realm=realms.Realm(
            description="My Realm",
            time_zone="US/Pacific",
        ),
    )

    operation = client.create_realm(request)
    print(f"Create realm operation: {operation.operation.name}")
    operation.result(timeout=120)

렐름 나열

gcloud 명령어

gcloud 명령줄 도구를 사용하여 전역 또는 리전 렐름을 나열할 수 있습니다.

전역 렐름과 리전 렐름을 모두 나열하려면 다음 명령어를 실행합니다.

gcloud game servers realms list

특정 위치의 렐름을 나열하려면 다음 명령어를 실행하고 regionglobal 또는 Google Cloud 리전으로 바꿉니다.

gcloud game servers realms list --location=region

Go


import (
	"context"
	"fmt"
	"io"

	gaming "cloud.google.com/go/gaming/apiv1"
	"google.golang.org/api/iterator"
	gamingpb "google.golang.org/genproto/googleapis/cloud/gaming/v1"
)

// listRealms lists the realms in a location.
func listRealms(w io.Writer, projectID, location string) error {
	// projectID := "my-project"
	// location := "global"
	ctx := context.Background()
	client, err := gaming.NewRealmsClient(ctx)
	if err != nil {
		return fmt.Errorf("NewRealmsClient: %v", err)
	}
	defer client.Close()

	req := &gamingpb.ListRealmsRequest{
		Parent: fmt.Sprintf("projects/%s/locations/%s", projectID, location),
	}

	it := client.ListRealms(ctx, req)
	for {
		resp, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			return fmt.Errorf("Next: %v", err)
		}

		fmt.Fprintf(w, "Realm listed: %v\n", resp.Name)
	}

	return nil
}

Node.js

const {RealmsServiceClient} = require('@google-cloud/game-servers');

const client = new RealmsServiceClient();

async function listRealms() {
  /**
   * TODO(developer): Uncomment these variables before running the sample.
   */
  // const projectId = 'Your Google Cloud Project ID';
  // const location = 'A Compute Engine region, e.g. "us-central1"';
  const request = {
    parent: `projects/${projectId}/locations/${location}`,
  };

  const [results] = await client.listRealms(request);
  for (const realm of results) {
    console.log(`Realm name: ${realm.name}`);
    console.log(`Realm description: ${realm.description}`);
    console.log(`Realm time zone: ${realm.timeZone}`);

    const createTime = realm.createTime;
    const createDate = new Date(createTime.seconds * 1000);
    console.log(`Realm created on: ${createDate.toLocaleDateString()}\n`);
  }
}

listRealms();

Python



def list_realms(project_id, location):
    """Lists the existing realms."""

    client = gaming.RealmsServiceClient()

    response = client.list_realms(
        parent=f"projects/{project_id}/locations/{location}"
    )

    for realm in response.realms:
        print(f"Name: {realm.name}")

    return response.realms

렐름 설명

gcloud 명령어

gcloud 명령줄 도구를 사용하여 생성 시간 또는 시간대 등 렐름에 대한 세부정보를 가져올 수 있습니다.

전역 렐름을 설명하려면 다음 명령어를 실행하고 realmID를 이전에 만든 렐름의 식별자로 바꿉니다.

gcloud game servers realms describe realmID

전역이 아닌 렐름을 하나 이상 만든 경우 특정 리전의 렐름에 대한 세부정보를 기술할 수 있습니다. 리전의 렐름을 설명하려면 realmID를 이전에 만든 렐름의 식별자로, region을 렐름이 위치한 리전으로 바꿉니다.

gcloud game servers realms describe realmID --location=region

Go


import (
	"context"
	"fmt"
	"io"

	gaming "cloud.google.com/go/gaming/apiv1"
	gamingpb "google.golang.org/genproto/googleapis/cloud/gaming/v1"
)

// getRealm retrieves info on a realm.
func getRealm(w io.Writer, projectID, location, realmID string) error {
	// projectID := "my-project"
	// location := "global"
	// realmID := "myrealm"
	ctx := context.Background()
	client, err := gaming.NewRealmsClient(ctx)
	if err != nil {
		return fmt.Errorf("NewRealmsClient: %v", err)
	}
	defer client.Close()

	req := &gamingpb.GetRealmRequest{
		Name: fmt.Sprintf("projects/%s/locations/%s/realms/%s", projectID, location, realmID),
	}

	resp, err := client.GetRealm(ctx, req)
	if err != nil {
		return fmt.Errorf("GetRealm: %v", err)
	}

	fmt.Fprintf(w, "Realm retrieved: %v", resp.Name)
	return nil
}

Node.js

const {RealmsServiceClient} = require('@google-cloud/game-servers');

const client = new RealmsServiceClient();

async function getRealm() {
  /**
   * TODO(developer): Uncomment these variables before running the sample.
   */
  // const projectId = 'Your Google Cloud Project ID';
  // const location = 'A Compute Engine region, e.g. "us-central1"';
  // const realmId = 'Unique identifier of the realm';
  const request = {
    // Realm name is the full resource name including project ID and location
    name: client.realmPath(projectId, location, realmId),
  };

  const [realm] = await client.getRealm(request);
  console.log(`Realm name: ${realm.name}`);
  console.log(`Realm description: ${realm.description}`);
  console.log(`Realm time zone: ${realm.timeZone}`);

  const createTime = realm.createTime;
  const createDate = new Date(createTime.seconds * 1000);

  console.log(`Realm created on: ${createDate.toLocaleDateString()}`);
}

getRealm();

Python

def get_realm(project_id, location, realm_id):
    """Gets a realm."""

    client = gaming.RealmsServiceClient()

    request = realms.GetRealmRequest(
        name=f"projects/{project_id}/locations/{location}/realms/{realm_id}",
    )

    response = client.get_realm(request)
    print(f"Get realm response:\n{response}")
    return response

다음 단계