기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 관리형 호스팅을 위한 Amazon GameLift Servers 빌드 리소스 생성
빌드를 생성하고 파일을 업로드할 때 몇 가지 옵션이 있습니다.
+ [파일 디렉터리에서 빌드 생성](gamelift-build-cli-uploading-upload-build.md). 이 방법은 가장 간단하며 일반적으로 사용되는 선택 사항입니다.
+ [Amazon Simple Storage Service(S3)의 파일을 사용하여 빌드 생성](gamelift-build-cli-uploading-create-build.md). 이 선택 사항을 사용하면 Amazon S3에서 빌드 버전을 관리할 수 있습니다.
두 방법을 모두 사용하면 Amazon GameLift Servers가 고유의 빌드 ID 및 기타 메타데이터를 사용하여 새 빌드 리소스를 생성합니다. 빌드는 **초기화됨** 상태에서 시작됩니다. Amazon GameLift Servers가 게임 서버 파일을 획득한 후 빌드는 **준비 완료** 상태로 이동합니다.
빌드가 준비되면 새 Amazon GameLift Servers 플릿에 배포할 수 있습니다. 자세한 내용은 [Amazon GameLift Servers 관리형 EC2 플릿 생성](fleets-creating.md) 섹션을 참조하세요. Amazon GameLift Servers는 새 플릿을 설정할 때 빌드 파일을 각 플릿 인스턴스에 다운로드하고 빌드 파일을 설치합니다.
# 파일 디렉터리에서 빌드 생성
로컬 디렉터리를 포함하여 모든 위치에 저장된 게임 빌드를 생성하려면 [https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html) AWS CLI 명령을 사용합니다. 이 명령은 Amazon GameLift Servers에 새 빌드 레코드를 생성하고 지정한 위치에서 파일을 업로드합니다.
**업로드 요청을 보냅니다.** 명령줄 창에 다음 **upload-build** 명령 및 파라미터를 입력합니다.
```
aws gamelift upload-build \
--name user-defined name of build \
--operating-system supported OS \
--server-sdk-version server SDK for Amazon GameLift Servers version \
--build-root build path \
--build-version user-defined build number \
--region region name
```
+ **operating-system** - 게임 서버 빌드의 런타임 환경. OS 값을 지정해야 합니다. 나중에 업데이트할 수 없습니다.
+ **server-sdk-version** - 게임 서버가 통합되는 Amazon GameLift Servers 서버 SDK 버전입니다. 값을 입력하지 않으면 Amazon GameLift Servers에서 기본값 `4.0.2`를 사용합니다. 서버 SDK 버전을 잘못 지정하면 Amazon GameLift Servers 서비스에 대한 연결을 설정하도록 `InitSdk`를 호출할 때 게임 서버 빌드가 실패할 수 있습니다.
+ **build-root** - 빌드 파일의 디렉터리 경로입니다.
+ **name** - 새 빌드를 설명하는 이름입니다.
+ **build-version** - 빌드 파일의 버전 세부 정보입니다.
+ **region** - 빌드를 생성하려는 AWS 리전입니다. 플릿을 배포하려고 계획하는 리전에서 빌드를 생성합니다. 여러 리전에서 게임을 배포하는 경우 각 리전에서 빌드를 생성합니다.
**참고**
[https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html)을 사용하여 현재 기본 리전을 확인합니다. 기본 리전을 변경하려면 [https://docs.aws.amazon.com/cli/latest/reference/configure/set.html](https://docs.aws.amazon.com/cli/latest/reference/configure/set.html) 명령을 사용합니다.
*예시*
```
aws gamelift upload-build \
--operating-system AMAZON_LINUX_2023 \
--server-sdk-version "5.0.0" \
--build-root "~/mygame" \
--name "My Game Nightly Build" \
--build-version "build 255" \
--region us-west-2
```
```
aws gamelift upload-build \
--operating-system WINDOWS_2022 \
--server-sdk-version "5.0.0" \
--build-root "C:\mygame" \
--name "My Game Nightly Build" \
--build-version "build 255" \
--region us-west-2
```
업로드 요청에 대한 응답으로 Amazon GameLift Servers는 업로드 진행 상황을 제공합니다. 업로드에 성공하면 Amazon GameLift Servers는 새 빌드 레코드 ID를 반환합니다. 업로드 시간은 게임 파일의 크기와 연결 속도에 따라 달라집니다.
# Amazon S3 내 파일을 사용하여 빌드 생성
Amazon S3에 빌드 파일을 저장하고 여기에서 Amazon GameLift Servers에 업로드할 수 있습니다. 빌드를 생성할 때 S3 버킷 위치를 지정하고 Amazon S3에서 직접 빌드 파일을 Amazon GameLift Servers 검색합니다.
**빌드 리소스를 생성하려면**
1. **빌드 파일을 Amazon S3에 저장합니다.** 패키지 빌드 파일이 포함된 .zip 파일을 생성하여의 S3 버킷에 업로드합니다 AWS 계정. Amazon GameLift Servers 빌드를 생성할 때 버킷 레이블과 파일 이름을 기록해 둡니다.
1. **빌드 파일에 대한 액세스 권한을 Amazon GameLift Servers에 부여합니다.** [Amazon S3의 게임 빌드 파일에 액세스](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-access-storage-loc)의 지침에 따라 IAM 역할을 생성합니다. 역할을 생성한 후에 빌드를 생성할 때 필요하므로 새 역할의 Amazon 리소스 이름(ARN)을 기록해 둡니다.
1. **빌드를 생성합니다.** Amazon GameLift Servers 콘솔 또는를 사용하여 새 빌드 레코드를 AWS CLI 생성합니다. [Amazon GameLift Servers의 IAM 권한 예제](gamelift-iam-policy-examples.md)에 설명된 대로 `PassRole` 권한이 있어야 합니다.
------
#### [ Console ]
1. [Amazon GameLift Servers 콘솔](https://console.aws.amazon.com/gamelift/)의 탐색 창에서 **호스팅**, **빌드**를 선택합니다.
1. **빌드** 페이지에서 **빌드 생성**을 선택합니다.
1. **빌드 생성** 페이지의 **빌드 설정**에서 다음을 수행하세요.
1. **이름**에 스크립트 이름을 입력합니다.
1. **버전**에 버전을 입력합니다. 빌드의 콘텐츠를 업데이트할 수 있으므로 버전 데이터를 통해 업데이트를 추적할 수 있습니다.
1. **운영 체제(OS)**에 게임 서버 빌드의 OS를 선택합니다. 나중에는 이 값을 업데이트할 수 없습니다.
1. **게임 서버 빌드**에는 Amazon S3에 업로드한 빌드 객체의 **S3 URI**를 입력하고 **객체 버전**을 선택합니다. Amazon S3 URI와 객체 버전이 기억나지 않는 경우, **S3 찾아보기**를 선택하고 빌드 객체를 검색합니다.
1. **IAM 역할**에는 Amazon GameLift Servers에서 S3 버킷 및 빌드 객체에 액세스할 수 있도록 생성한 역할을 선택합니다.
1. (선택 사항) **태그**에서 **키** 및 **값** 쌍을 입력하여 빌드에 태그를 추가합니다.
1. **생성(Create)**을 선택합니다.
Amazon GameLift Servers는 새 빌드에 ID를 할당하고 지정된 .zip 파일을 업로드합니다. **빌드** 페이지에서 상태를 포함한 새 빌드를 볼 수 있습니다.
------
#### [ AWS CLI ]
새로운 빌드를 정의하고 서버 빌드 파일을 업로드하려면 [https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-build.html) 명령을 사용합니다.
1. 명령줄 창을 열고 AWS CLI를 사용할 수 있는 디렉터리로 전환합니다.
1. 다음 **create-build** 명령을 입력합니다.
```
aws gamelift create-build \
--name user-defined name of build \
--server-sdk-version server SDK for Amazon GameLift Servers version \
--operating-system supported OS \
--build-version user-defined build number \
--storage-location "Bucket"=S3 bucket label,"Key"=Build .zip file name,"RoleArn"=Access role ARN} \
--region region name
```
+ **name** - 새 빌드를 설명하는 이름입니다.
+ **server-sdk-version** - 게임 서버를 Amazon GameLift Servers와 통합하는 데 사용되는 Amazon GameLift Servers의 서버 SDK 버전입니다. 값을 입력하지 않으면 Amazon GameLift Servers에서 기본값 `4.0.2`를 사용합니다.
+ **operating-system** - 게임 서버 빌드의 런타임 환경. OS 값을 지정해야 합니다. 나중에 업데이트할 수 없습니다.
+ **build-version** - 빌드 파일의 버전 세부 정보입니다. 게임 서버의 새 버전이 나올 때마다 새 빌드 리소스가 필요하기 때문에 이 정보가 유용할 수 있습니다.
+ **storage-location**
+ **Bucket** - 빌드가 포함되어 있는 S3 버킷의 이름입니다. 예: “my\$1build\$1files”.
+ **Key** - 빌드 파일을 포함하는 .zip 파일의 이름입니다. 예: “my\$1game\$1build\$17.0.1, 7.0.2”.
+ **RoleARN** - 생성한 IAM 역할에 할당된 ARN입니다. 예: “arn:aws:iam::111122223333:role/GameLiftAccess”. 정책 예제는 [Amazon S3의 게임 빌드 파일에 액세스](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-access-storage-loc)을 참조하세요.
+ **region** - 플릿을 배포하려는 AWS 리전에서 빌드를 생성합니다. 여러 리전에서 게임을 배포하는 경우 각 리전에서 빌드를 생성합니다.
**참고**
[https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html) 명령을 사용하여 현재 기본 리전을 확인하는 것이 좋습니다[https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html). 기본 리전을 변경하려면 [https://docs.aws.amazon.com/cli/latest/reference/configure/set.html](https://docs.aws.amazon.com/cli/latest/reference/configure/set.html) 명령을 사용합니다.
*예제*
```
aws gamelift create-build \
--operating-system WINDOWS_2022 \
--storage-location "Bucket"="my_game_build_files","Key"="mygame_build_101.zip","RoleArn"="arn:aws:iam::111122223333:role/gamelift" \
--name "My Game Nightly Build" \
--build-version "build 101" \
--region us-west-2
```
1. 새 빌드를 보려면 [https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-build.html) 명령을 사용합니다.
------