ゲームサーバーソフトウェアでコンテナイメージを準備する - Amazon GameLift
作業ディレクトリを作成するイメージの構築イメージをプッシュする

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ゲームサーバーソフトウェアでコンテナイメージを準備する

このドキュメントは、パブリックプレビューリリースの機能を対象としています。このドキュメントは変更される可能性があります。

コンテナは、Amazon GameLift コンテナフリートの最も基本的な要素です。コンテナには、ゲームサーバーと SDKs、ソフトウェア、ディレクトリ、ファイルなどの依存関係が含まれます。

コンテナフリートで機能するには、ゲームサーバーが Linux で実行され、サーバー SDK 5.x と統合されている必要があります。

作業ディレクトリをセットアップする

作業ディレクトリは、コンテナイメージの構築に必要なすべてのファイルを配置し、Amazon GameLift による実行方法を定義する場所です。

コンテナ作業ディレクトリを設定するには

  1. Amazon GameLift コンテナイメージを操作するディレクトリを作成します。

    例:

    [~/]$ mkdir -p work/glc/gamebuild && cd work && find .
.
./glc
./glc/gamebuild

  2. Amazon GameLift Agent のクローンを作成します。

    例:

    [~/work]$ git clone https://github.com/aws/amazon-gamelift-agent.git 
Cloning into 'amazon-gamelift-agent'...

  3. Maven GameLiftAgent を使用して を構築します。

    例:

    [~/work]$ cd amazon-gamelift-agent 


    [~/work/amazon-gamelift-agent]$ mvn clean compile assembly:single && \
mv target ../glc && cd .. && find glc

  4. サーバー SDK 5.x と統合され、構築され、.ZIPファイルにパッケージ化されたゲームサーバーを追加します。

  5. .ZIP ファイルを にコピーします~/work/glc/gamebuild/。

SDK 5.x ゲームサーバーをお持ちでない場合は、サンプルSimpleServerゲームをダウンロードして使用して、コンテナフリートの使用を試すことができます。

[~/work]$ curl -o glc/gamebuild/SimpleServer.zip \ 
'https://ws-assets-prod-iad-r-iad-ed304a55c2ca1aee.s3.us-east-1.amazonaws.com/086bb355-4fdc-4e63-8ca7-af7cfc45d4f2/AmazonGameLiftSampleServerBinary.zip' && 
% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
Dload  Upload   Total   Spent    Left  Speed
100 5140k  100 5140k    0     0  12.3M      0 --:--:-- --:--:-- --:--:-- 12.3M
glc
glc/target
glc/target/GameLiftAgent-1.0.jar
glc/gamebuild
glc/gamebuild/SimpleServer.zip

コンテナイメージを構築する

Dockerfile は、コンテナを構築するための環境、ソフトウェア、および手順を指定します。

Dockerfile を作成するには

  1. glc サブディレクトリに移動します。

    [~/work]$ cd glc && find 

.
./target
./target/GameLiftAgent-1.0.jar
./gamebuild

  2. 新しい Dockerfile を作成して開きます。

    例:

    [~/work/glc]$ nano Dockerfile

  3. 次のいずれかのテンプレートからコピーし、コンテンツを Dockerfile に貼り付けます。

このテンプレートには、コンテナが Amazon GameLift フリートで使用できるようにするために必要な最小限の手順が含まれています。ゲームサーバーに必要なコンテンツを変更します。

# Base image
# ----------
  # Add the base image that you want to use over here,
  # Make sure to use an image with the same architecture as the
  # Instance type you are planning to use on your fleets.
  # We require JDK to be installed in the base image, so that
  # it can be used to run the &AGS; Agent
FROM public.ecr.aws/amazoncorretto/amazoncorretto:17-amd64
  #
# Game build directory
# --------------------
  # Add your game build to gamebuild directory and add the zip file name in the 'GAME_BUILD_ZIP' env variable below.
  # The game build provided over here needs to be integrated with gamelift server sdk.
  # This template assumes that the game build is in a zip format.
ENV GAME_BUILD_ZIP="<ADD_GAME_BUILD_ZIP_FILE_NAME>" \
  #
# Default directory
# -----------------
  # Default directory, the value provided here should be where the game executable exists.
  # Provide this same value as your launch path in RuntimeConfiguration when creating a fleet.
  # Ref: https://docs.aws.amazon.com/gamelift/latest/apireference/API_ServerProcess.html
GAME_EXECUTABLE="<ADD NAME OF EXECUTABLE WITHIN THE GAME BUILD>" \
HOME_DIR="/local/game" \
  #
  # Registered compute in anywhere fleet (not used in container fleets)
  # -------------------------------------------------------------------
  # Add the name for the registered compute in an anywhere fleet.
  # This environment variable is required only for anywhere fleets, but not for container fleets.
  # If it is set for container fleets, it will be overridden by Gamelift.
  GAMELIFT_COMPUTE_NAME="<ADD_COMPUTE_NAME>" \
  #
# Default Gamelift Agent jar
# --------------------------
GAMELIFT_AGENT_EXEC="GameLiftAgent-1.0.jar" \
  #
  # This env variable defines the name of the S3 bucket that stores the GameLift Agent logs.
  # This S3 bucket should exist in the customer AWS account.
  # In order to allow GameLift agent to upload logs to this s3 bucket, customers would need to
  # include s3:PutObject permission in the IAM role provided as instanceRoleArn during CreateFleet operation.
GAMELIFT_AGENT_LOGS_BUCKET_NAME="<ADD NAME OF GAMELIFT AGENT LOGS S3 BUCKET>" \
  #
# -----------
  # This env variable defines the name of the S3 bucket that stores the game session logs.
  # This S3 bucket should exist in the customer AWS account.
  # In order to allow GameLift agent to upload logs to this s3 bucket, customers would need to
  # include s3:PutObject permission in the IAM role provided as instanceRoleArn during CreateFleet operation.
# -----------
GAME_SESSION_LOGS_BUCKET_NAME="<ADD NAME OF GAME SESSION LOGS S3 BUCKET>" \
#
# -----------
GAMELIFT_AGENT_LOGS_PATH="/local/game/agentlogs/" \
  #
# NOT USED in container fleets - USED in Anywhere fleets
# ----------------------------------------------------------
  # Specifiy the type of compute resource used to host the game servers.
  # This env variable is required only for anywhere fleets, but not for container fleets.
  # If it is set for container fleets, it will be overridden by Gamelift.
#
# -----------
COMPUTE_TYPE="ANYWHERE" \
  #
  # Specify the credential to be used for creating the client.
  # This env variable is required only for anywhere fleets, but not for container fleets.
  # If it is set for container fleets, it will be overridden by Gamelift.
#
# -----------
CREDENTIAL_PROVIDER="environment-variable"

USER root

    # intall dependencies as necessary
    RUN yum install -y sudo \
                        unzip \
                        git \
                        shadow-utils \
                        iputils \
                        tar \
                        gcc \
                        make \
                        openssl-devel \
                        zlib-devel \
                        vim \
                        net-tools \
                        nc \
                        procps
    
    # Set up the ground for 'gamescale' user
    RUN groupadd -r gamescale -g 500 && \
      useradd -u 500 -r -g gamescale -m -s /sbin/nologin -c "Gamescale user" gamescale && \
      echo "gamescale ALL=(ALL) NOPASSWD: ALL" | (EDITOR="tee -a" visudo) && \
      mkdir -p $HOME_DIR && \
      mkdir $HOME_DIR/mono && \
      chown -R gamescale:gamescale $HOME_DIR
    
    WORKDIR $HOME_DIR
    
    # extract game build as necessary
    COPY ./gamebuild/$GAME_BUILD_ZIP .
    RUN unzip ./$GAME_BUILD_ZIP -d ./
    
    # copy Gamelift Agent jar
    COPY ./gameliftAgent/$GAMELIFT_AGENT_EXEC ./
    
    # Add permissions to game build and gamelift agent jar
    RUN chmod +x ./$GAME_EXECUTABLE
    RUN chmod +x ./$GAMELIFT_AGENT_EXEC
    
    # Check if java is installed on the image, if not then the Agent will not be able to run
    RUN java --version
    
    USER gamescale
    
    ENV PATH="$PATH:$HOME_DIR/bin:$JAVA_HOME"
    
    # Change directory to bin
    WORKDIR $HOME_DIR
    
    # check path before starting the container
    RUN echo $PATH
    
    # Create logs directory for GameLift Agent & server processes
    RUN mkdir logs
    RUN mkdir agentlogs
    
    # Start the GameLift Agent
    ENTRYPOINT sleep 90 && java -jar $GAMELIFT_AGENT_EXEC -ip "192.168.1.1" -gslb "$GAME_SESSION_LOGS_BUCKET_NAME" -galb "$GAMELIFT_AGENT_LOGS_BUCKET_NAME" -galp "$GAMELIFT_AGENT_LOGS_PATH" -glc environment-variable
  
# Base image
# ----------
  # Add the base image that you want to use over here,
  # Make sure to use an image with the same architecture as the
  # Instance type you are planning to use on your fleets.
  # We require JDK to be installed in the base image, so that
  # it can be used to run the &AGS; Agent
FROM public.ecr.aws/amazoncorretto/amazoncorretto:17-amd64
  #
# Game build directory
# --------------------
  # Add your game build to gamebuild directory and add the zip file name in the 'GAME_BUILD_ZIP' env variable below.
  # The game build provided over here needs to be integrated with gamelift server sdk.
  # This template assumes that the game build is in a zip format.
ENV GAME_BUILD_ZIP="SimpleServer.zip" \
  #
# Default directory
# -----------------
  # Default directory, the value provided here should be where the game executable exists.
  # Provide this same value as your launch path in RuntimeConfiguration when creating a fleet.
  # Ref: https://docs.aws.amazon.com/gamelift/latest/apireference/API_ServerProcess.html
GAME_EXECUTABLE="GameLiftSampleServer" \
HOME_DIR="/local/game" \
  #
  # Registered compute in anywhere fleet (not used in container fleets)
  # -------------------------------------------------------------------
  # Add the name for the registered compute in an anywhere fleet.
  # This environment variable is required only for anywhere fleets, but not for container fleets.
  # If it is set for container fleets, it will be overridden by Gamelift.
  GAMELIFT_COMPUTE_NAME="<ADD_COMPUTE_NAME>" \
  #
# Default Gamelift Agent jar
# --------------------------
GAMELIFT_AGENT_EXEC="GameLiftAgent-1.0.jar" \
  #
  # This env variable defines the name of the S3 bucket that stores the GameLift Agent logs.
  # This S3 bucket should exist in the customer AWS account.
  # In order to allow GameLift agent to upload logs to this s3 bucket, customers would need to
  # include s3:PutObject permission in the IAM role provided as instanceRoleArn during CreateFleet operation.
GAMELIFT_AGENT_LOGS_BUCKET_NAME="<ADD NAME OF GAMELIFT AGENT LOGS S3 BUCKET>" \
  #
# -----------
  # This env variable defines the name of the S3 bucket that stores the game session logs.
  # This S3 bucket should exist in the customer AWS account.
  # In order to allow GameLift agent to upload logs to this s3 bucket, customers would need to
  # include s3:PutObject permission in the IAM role provided as instanceRoleArn during CreateFleet operation.
# -----------
GAME_SESSION_LOGS_BUCKET_NAME="<ADD NAME OF GAME SESSION LOGS S3 BUCKET>" \
#
# -----------
GAMELIFT_AGENT_LOGS_PATH="/local/game/agentlogs/" \
  #
# NOT USED in container fleets - USED in Anywhere fleets
# ----------------------------------------------------------
  # Specifiy the type of compute resource used to host the game servers.
  # This env variable is required only for anywhere fleets, but not for container fleets.
  # If it is set for container fleets, it will be overridden by Gamelift.
#
# -----------
COMPUTE_TYPE="ANYWHERE" \
  #
  # Specify the credential to be used for creating the client.
  # This env variable is required only for anywhere fleets, but not for container fleets.
  # If it is set for container fleets, it will be overridden by Gamelift.
#
# -----------
CREDENTIAL_PROVIDER="environment-variable"

USER root

    # intall dependencies as necessary
    RUN yum install -y sudo \
                        unzip \
                        git \
                        shadow-utils \
                        iputils \
                        tar \
                        gcc \
                        make \
                        openssl-devel \
                        zlib-devel \
                        vim \
                        net-tools \
                        nc \
                        procps
    
    # Set up the ground for 'gamescale' user
    RUN groupadd -r gamescale -g 500 && \
      useradd -u 500 -r -g gamescale -m -s /sbin/nologin -c "Gamescale user" gamescale && \
      echo "gamescale ALL=(ALL) NOPASSWD: ALL" | (EDITOR="tee -a" visudo) && \
      mkdir -p $HOME_DIR && \
      mkdir $HOME_DIR/mono && \
      chown -R gamescale:gamescale $HOME_DIR
    
    WORKDIR $HOME_DIR
    
    # extract game build as necessary
    COPY ./gamebuild/$GAME_BUILD_ZIP .
    RUN unzip ./$GAME_BUILD_ZIP -d ./
    
    # copy Gamelift Agent jar
    COPY ./target/$GAMELIFT_AGENT_EXEC ./
    
    # Add permissions to game build and gamelift agent jar
    RUN chmod +x ./$GAME_EXECUTABLE
    RUN chmod +x ./$GAMELIFT_AGENT_EXEC
    
    # Check if java is installed on the image, if not then the Agent will not be able to run
    RUN java --version
    
    USER gamescale
    
    ENV PATH "$PATH:$HOME_DIR/bin:$JAVA_HOME"
    
    # Change directory to bin
    WORKDIR $HOME_DIR
    
    # check path before starting the container
    RUN echo $PATH
    
    # Create logs directory for GameLift Agent & server processes
    RUN mkdir logs
    RUN mkdir agentlogs
    
    # Start the GameLift Agent
    ENTRYPOINT sleep 90 && java -jar $GAMELIFT_AGENT_EXEC -ip "192.168.1.1" -gslb "$GAME_SESSION_LOGS_BUCKET_NAME" -galb "$GAMELIFT_AGENT_LOGS_BUCKET_NAME" -galp "$GAMELIFT_AGENT_LOGS_PATH" -glc environment-variable
注記

注： Dockerfile の一部の環境変数は、 で上書きできますContainerDefinition。

コンテナイメージを構築するには

  1. コンテナイメージを構築します。

    独自の SDK 5.x サーバーを使用している場合

    任意のローカルリポジトリ名を指定できます。

    [~/work/glc]$ docker build -t <local repository name>:<optional tag> .
    SimpleServer サンプルを使用している場合
    [~/work/glc]$ docker build -t simple-server:version-1 .
Successfully built 0123456789012
Successfully tagged simple-server:version-1
    注記

    次の例では、 simpler-server を初期REPOSITORY値として使用し、 をTAG値version-1として使用します。

  2. イメージのリストを表示し、 REPOSITORY と のIMAGE ID値を書き留めます。これらは、以下の手順で必要になります。

    [~/work/glc]$ docker images
REPOSITORY       TAG          IMAGE ID        CREATED           SIZE
simple-server    version-1    0123456789012    14 minutes ago    1.24GB

コンテナイメージを Amazon ECR にプッシュする

コンテナイメージを Amazon ECR のプライベートリポジトリにアップロードします。コンテナグループ定義を作成するときは、Amazon がコンテナイメージのスナップショット GameLift を作成し、コンテナフリートをデプロイするときに使用できるように、このリポジトリの場所を参照します。

注記

Amazon ECR プライベートリポジトリがまだない場合は、1 つの を作成します。

Amazon ECR 認証情報を取得するには

  • コンテナイメージを Amazon ECR にプッシュする前に、認証情報を AWS 一時的な形式で取得し、Docker に提供する必要があります。Docker がログインできるように、Amazon ECR 認証情報を取得します。

    [~/work/glc]$ aws ecr get-login-password --region us-west-2 | docker login --username AWS --password-stdin aws_account_id.dkr.ecr.us-west-2.amazonaws.com
WARNING! Your password will be stored unencrypted in 
/home/user-name/.docker/config.json.
Configure a credential helper to remove this warning.
See https://docs.docker.com/engine/reference/commandline/login/#credentials-store

Login Succeeded
コンテナイメージを Amazon ECR にプッシュするには

  1. 使用する Amazon ECR プライベートリポジトリの URI をコピーします。

  2. Amazon ECR タグをコンテナイメージに適用します。

    [~/work/glc]$ docker tag <IMAGE ID from above> <Amazon ECR private repository URI>:<optional tag>

  3. コンテナイメージを Amazon ECR にプッシュする

    [~/work/glc]$ docker image push  <Amazon ECR private repository URI>