Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Cree un recurso de Amazon GameLift Servers compilación para el alojamiento gestionado
Al crear una compilación y cargar sus archivos, tiene dos opciones:
+ [Creación de una compilación a partir de un directorio de archivos](gamelift-build-cli-uploading-upload-build.md). Esta es la opción más sencilla y la que se utiliza habitualmente.
+ [Cree una compilación con archivos en Amazon Simple Storage Service (Amazon S3)](gamelift-build-cli-uploading-create-build.md). Con esta opción, puede administrar sus versiones de compilación en Amazon S3.
Con ambos métodos, Amazon GameLift Servers crea un nuevo recurso de compilación con un ID de compilación único y otros metadatos. La compilación comienza con el estado **Inicializado**. Cuando Amazon GameLift Servers adquiere los archivos del servidor de juegos, la compilación pasa al estado **Listo**.
Cuando la compilación esté lista, podrá implementarla en una nueva flota de Amazon GameLift Servers. Para obtener más información, consulte [Cree una EC2 flota Amazon GameLift Servers gestionada](fleets-creating.md). Cuando Amazon GameLift Servers configure la nueva flota, descargará los archivos de compilación en cada instancia de la flota e instalará los archivos de compilación.
# Creación de una compilación a partir de un directorio de archivos
Para crear una compilación de juego almacenada en cualquier ubicación, incluido un directorio local, usa el [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 comando. Este comando crea un registro de compilación nuevo en Amazon GameLift Servers y carga archivos desde la ubicación que especifique.
**Envíe una solicitud de carga.** En una ventana de línea de comandos, especifique el comando **upload-build** y los parámetros siguientes.
```
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**: 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.
+ **server-sdk-version**: la versión del SDK del servidor de Amazon GameLift Servers con la que se ha integrado el servidor de juegos. Si no proporciona un valor, Amazon GameLift Servers utiliza el valor por defecto `4.0.2`. Si especifica una versión incorrecta del SDK del servidor, es posible que la compilación del servidor de juegos falle al llamar a `InitSdk` para establecer una conexión con el servicio Amazon GameLift Servers.
+ **build-root**: es la ruta del directorio de los archivos de compilación.
+ **name**: es un nombre descriptivo para la nueva compilación.
+ **build-version**: los detalles de la versión de los archivos de compilación.
+ **region**— La AWS región en la que quieres crear tu construcción. Cree la compilación en la región 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**
Vea su región predeterminada actual mediante el comando [https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html). Utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/configure/set.html](https://docs.aws.amazon.com/cli/latest/reference/configure/set.html) para cambiar la región predeterminada.
*Ejemplos*
```
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
```
Como respuesta a su solicitud de carga, Amazon GameLift Servers proporciona el progreso de la carga. Si la carga se realiza correctamente, Amazon GameLift Servers devuelve el nuevo ID de registro de compilación. El tiempo de carga depende del tamaño de los archivos del juego y de la velocidad de conexión.
# 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 depósito de S3 y Amazon GameLift Servers recuperar los archivos de compilación directamente de 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árguelo en un bucket de S3 que tenga. Cuenta de AWS Toma nota de la etiqueta del depósito y del nombre del archivo, ya que los necesitarás para crear una Amazon GameLift Servers compilación.
1. **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](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-access-storage-loc). 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.
1. **Cree una compilación.** Usa la Amazon GameLift Servers consola o el 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](gamelift-iam-policy-examples.md).
------
#### [ Console ]
1. En la [consola de Amazon GameLift Servers](https://console.aws.amazon.com/gamelift/), en el panel de navegación, elija **Alojamiento**, **Compilaciones**.
1. En la página **Compilaciones**, seleccione **Crear compilación**.
1. 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.
1. 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.
1. Para **Sistema operativo (SO)**, elija el sistema operativo de la compilación del servidor de juegos. El valor no podrá actualizarse más tarde.
1. 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.
1. 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.
1. En **Etiquetas**, añada etiquetas a la compilación introduciendo los pares **Clave** y **Valor** (opcional).
1. 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 [https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-build.html) 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.
1. 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\$1build\$1files”.
+ **Key**: nombre del archivo .zip que contiene los archivos de compilación. Por ejemplo, “my\$1game\$1build\$17.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](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-access-storage-loc).
+ **region**— Crea la construcción en la región en la que planeas desplegar las flotas. AWS 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 [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). Utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/configure/set.html](https://docs.aws.amazon.com/cli/latest/reference/configure/set.html) 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
```
1. Para ver la nueva compilación, utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-build.html).
------