Creación de una compilación con archivos en Amazon S3 - Amazon GameLift Servers

Creación de una compilación con archivos en Amazon S3

Puede almacenar sus archivos de compilación en Amazon S3 y cargarlos en Amazon GameLift Servers desde allí. Al crear la compilación, debe especificar la ubicación del bucket de S3 y Amazon GameLift Servers recuperará los archivos de compilación directamente desde Amazon S3.

Para crear un recurso de compilación, realice el siguiente procedimiento:

  1. Almacene los archivos de compilación en Amazon S.. Cree un archivo .zip que contenga los archivos de compilación empaquetados y cárguelos en un bucket de S3 en su Cuenta de AWS. Tome nota de la etiqueta del bucket y el nombre de archivo, pues los necesitará para crear una compilación de Amazon GameLift Servers.

  2. Otorgue acceso a Amazon GameLift Servers a los archivos de compilación. Para crear un rol de IAM;, siga las instrucciones en Acceso a un archivo de compilación de un juego en Amazon S3. En cuanto haya creado el rol, tome nota del nombre de recurso de Amazon (ARN) del nuevo rol, ya que lo necesitará para crear una compilación.

  3. Cree una compilación. Utilice la consola de Amazon GameLift Servers o la AWS CLI para crear un nuevo registro de compilación. Debe tener el permiso PassRole, tal y como se describe en Ejemplo de permisos de IAM para Amazon GameLift Servers.

Console

  1. En la consola de Amazon GameLift Servers, en el panel de navegación, elija Alojamiento, Compilaciones.

  2. En la página Compilaciones, seleccione Crear compilación.

  3. En la página Crear compilación, en Configuración de compilación, realice el siguiente procedimiento:

    1. En Nombre, especifique un nombre de script.

    2. En Versión, escriba una versión. Como puede actualizar el contenido de una compilación, los datos de la versión pueden ayudarle a realizar un seguimiento de las actualizaciones.

    3. Para Sistema operativo (SO), elija el sistema operativo de la compilación del servidor de juegos. El valor no podrá actualizarse más tarde.

    4. En Compilación del servidor de juegos, especifique el URI de S3 del objeto de compilación que cargó en Amazon S3 y elija la versión del objeto. Si no recuerda el URI y la versión del objeto de Amazon S3, elija Explorar S3 y busque el objeto de compilación.

    5. Para el rol de IAM, elija el rol creado que permite a Amazon GameLift Servers acceder a su bucket de S3 y al objeto de compilación.

  4. En Etiquetas, añada etiquetas a la compilación introduciendo los pares Clave y Valor (opcional).

  5. Seleccione Crear.

Amazon GameLift Servers asigna un ID a la nueva compilación y carga el archivo .zip designado. Puede ver la nueva compilación, incluido su estado, en la página Compilaciones

AWS CLI

Utilice el comando create-build para definir la nueva compilación y cargar los archivos de compilación del servidor.

  1. Abra una ventana de línea de comandos y cambie a un directorio en el que pueda usar la AWS CLI.

  2. Escriba el siguiente comando 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: es un nombre descriptivo para la nueva compilación.

    • server-sdk-version: la versión del SDK del servidor de Amazon GameLift Servers utilizado para integrar el servidor de juegos con Amazon GameLift Servers. Si no proporciona un valor, Amazon GameLift Servers utiliza el valor por defecto 4.0.2.

    • operating-system: el entorno de tiempo de ejecución de la compilación del servidor de juegos. Debe especificar un valor para el sistema operativo. El valor no podrá actualizarse más tarde.

    • build-version: los detalles de la versión de los archivos de compilación. Esa información puede resultar útil porque cada nueva versión del servidor de juegos requiere un nuevo recurso de compilación.

    • storage-location

      • Bucket: nombre del bucket de S3 que contiene la compilación. Por ejemplo, “my_build_files”.

      • Key: nombre del archivo .zip que contiene los archivos de compilación. Por ejemplo, “my_game_build_7.0.1, 7.0.2”.

      • RoleARN: el ARN asignado al rol de IAM creado. Por ejemplo, “arn:aws:iam::111122223333:role/GameLiftAccess”. Para ver una política de ejemplo, consulte Acceso a un archivo de compilación de un juego en Amazon S3.

    • region: cree la compilación en la región de AWS en la que tiene previsto implementar las flotas. Si va a implementar el juego en varias regiones, cree una compilación en cada región.

      nota

      Le recomendamos que compruebe la región predeterminada actual mediante el comando configure get. Utilice el comando configure set para cambiar la región predeterminada.

    Ejemplo

    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

  3. Para ver la nueva compilación, utilice el comando describe-build.