Lumberyard
Guía del usuario (Version 1.20)

Tutorial: Introducción a Cloud Canvas

Cloud Canvas conecta Lumberyard con Amazon Web Services (AWS) y utiliza gemas en la nube para habilitar características conectadas en el juego. En este tutorial, se muestra cómo implementar los recursos de un proyecto habilitado para gemas en la nube en AWS y le guiará a través de las siguientes tareas:

  • Registro en una cuenta de AWS.

  • Creación de un usuario de AWS Identity and Access Management (IAM) para administrar su proyecto de Cloud Canvas.

  • Habilitación de las gemas en la nube en su proyecto.

  • Adición de sus credenciales administrativas de IAM a Lumberyard.

  • Carga de recursos en AWS y creación de una implementación.

  • Acceso a Cloud Gem Portal para ver y administrar sus gemas en la nube implementadas.

Si lo prefiere, también puede obtener información acerca de cómo inspeccionar sus recursos en AWS, crear usuarios y grupos de IAM para fines administrativos y eliminar las implementaciones y los recursos de Cloud Canvas de AWS.

Requisitos previos

Antes de comenzar este tutorial, debe completar lo siguiente:

Paso 1: Inscribirse en AWS

Al registrarse en AWS, tiene acceso a todas sus capacidades en la nube. Cloud Canvas crea los recursos en su cuenta de AWS para que estos servicios sean accesibles a través de Lumberyard. Solo se le cobrará por los servicios que utilice. Si es cliente nuevo de AWS, puede comenzar con Cloud Canvas de forma gratuita. Para obtener más información, consulte Capa gratuita de AWS.

Si usted o alguien de su equipo ya tiene una cuenta de AWS, vaya al paso 2.

Si no dispone de una cuenta de AWS, utilice el siguiente procedimiento para crearla.

Para inscribirse en AWS

  1. Abra https://aws.amazon.com/ y elija Create an AWS Account.

  2. Siga las instrucciones en línea.

nota

  • Debe proporcionar un método de pago para crear la cuenta. Aunque estos tutoriales entran en la capa gratuita de AWS, tenga en cuenta que puede incurrir en gastos.

  • Anote el número de la cuenta de AWS porque lo utilizará en el siguiente paso.

Paso 2: Crear un usuario de IAM para administrar el proyecto de Cloud Canvas

Una vez que se haya registrado en una cuenta de AWS, necesita un usuario de IAM con los permisos adecuados para administrar un proyecto de Cloud Canvas. IAM permite administrar el acceso a su cuenta de AWS.

AWS requiere que proporcione credenciales para verificar que dispone de los permisos adecuados para los servicios de AWS a los que accede. Puede escribir estas credenciales en Lumberyard Editor como parte de la configuración del proyecto.

El usuario de IAM que crea pertenecerá a un grupo que tiene permisos de administrador. Esto permite a los usuarios de este grupo crear los recursos de Cloud Canvas y hacer que sean accesibles a través de Lumberyard. Los usuarios administrativos de este grupo tendrán más permisos especiales que los del ámbito de un usuario normal de Cloud Canvas.

En un entorno de equipo, usted, como miembro del grupo de administrador, puede crear usuarios de IAM para cada miembro del equipo. Con IAM, puede establecer permisos específicamente para cada persona de un proyecto. Por ejemplo, puede especificar que solo los diseñadores puedan modificar una base de datos o impedir que los miembros del equipo escriban accidentalmente en los recursos con que los jugadores interactúan.

Para obtener más información sobre IAM y los permisos, consulte Guía del usuario de IAM.

Crear un usuario y un grupo de administrador de IAM

Esta sección le guía a través de las prácticas recomendadas de IAM mediante la creación de un usuario de IAM y un grupo administrativo en la cuenta a la que pertenece el usuario de IAM.

Para crear un usuario y un grupo de IAM en la cuenta de AWS

  1. Inicie sesión en la Consola de administración de AWS y abra la consola de IAM en https://console.aws.amazon.com/iam/.

  2. En el panel de navegación, haga clic en Users (Usuarios).

  3. Haga clic en Add user (Añadir usuario).

  4. En User name (Nombre de usuario), escriba un nombre de usuario como CloudCanvasAdmin. El nombre puede contener letras, dígitos y los siguientes caracteres: signo más (+), signo igual (=), coma (,), punto (.), arroba (@), carácter de subrayado (_) y guion (-). El nombre no distingue entre mayúsculas y minúsculas y debe tener 64 caracteres como máximo.

  5. Active la casilla situada junto a Programmatic access (Acceso mediante programación).

  6. Seleccione la casilla de verificación situada junto a Consola de administración de AWS access (Acceso a Consola de administración de AWS), seleccione Custom password (Contraseña personalizada) y luego escriba la nueva contraseña en el cuadro de texto.

    nota

    Cuando crea un usuario para otra persona, también puede seleccionar Require password reset (Requerir el restablecimiento de la contraseña) para obligar al usuario a crear una nueva contraseña cuando inicie sesión por primera vez.

  7. Haga clic en Next: Permissions (Siguiente: Permisos).

  8. Haga clic en Create group (Crear grupo).

  9. En el cuadro de diálogo Create Group (Crear grupo), escriba un nombre como CloudCanvasAdministrators para el grupo. El nombre puede contener letras, dígitos y los siguientes caracteres: signo más (+), signo igual (=), coma (,), punto (.), arroba (@), carácter de subrayado (_) y guion (-). El nombre no distingue entre mayúsculas y minúsculas y debe tener 128 caracteres como máximo.

  10. En la lista Policy name (Nombre de política), seleccione la casilla de verificación situada junto a AdministratorAccess. Esta política proporciona los permisos necesarios para crear y administrar un proyecto de Cloud Canvas.

    aviso

    La política AdministratorAccess permite casi todos los permisos dentro de la cuenta de AWS y debe asociarse únicamente al administrador de la cuenta. De no hacerlo así, otros miembros del equipo podrían realizar acciones que incurren en gastos no deseados en la cuenta de AWS.

  11. Haga clic en Create group (Crear grupo).

  12. En la lista de grupos, active la casilla de verificación del nuevo grupo si aún no lo está. Haga clic en Refresh (Actualizar) si es necesario para ver el grupo en la lista.

  13. Haga clic en Next: Review (Siguiente: Revisión) para revisar sus elecciones.

  14. Cuando esté listo para continuar, haga clic en Create user (Crear usuario).

    El usuario de IAM se crea junto con dos importantes credenciales: una clave de acceso y una clave de acceso secreta. Más adelante, escribirá estas credenciales en Lumberyard Editor para tener acceso a los recursos de AWS en el proyecto.

  15. Haga clic en Show (Mostrar) para ver la clave de acceso secreta y la contraseña, o haga clic en Download.csv para descargar las credenciales en un archivo .csv. Sus credenciales tendrán el aspecto siguiente:

    • ID de clave de acceso: AKIAIOSFODNN7EXAMPLE

    • Clave de acceso secreta: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

    También puede hacer clic en Send email (Enviar correo electrónico) para recibir instrucciones de inicio de sesión por correo electrónico. A partir de este punto, no podrá ver la clave de acceso secreta desde la Consola de administración de AWS.

    importante

    Mantenga las claves en secreto para proteger su cuenta de AWS y no las envíe nunca por correo electrónico. No las comparta fuera de su organización, aunque reciba una petición que parezca provenir de AWS o Amazon.com. Nadie que represente legítimamente a Amazon le pedirá nunca su clave secreta.

  16. Ya ha creado un usuario de IAM llamado CloudCanvasAdmin y un grupo de administrador CloudCanvasAdministrators al que pertenece el usuario. Para confirmarlo, haga clic en Groups (Grupos) en el panel de navegación. En Group Name (Nombre de grupo), haga clic en CloudCanvasAdministrators. El usuario CloudCanvasAdmin aparecerá en la lista de usuarios del grupo.

nota

En este tutorial, solo se añade un usuario de IAM al grupo de administradores, pero puede añadir más si es necesario.

Si pierde la clave de acceso secreta, debe crear un nuevo conjunto de claves.

Para crear un conjunto de claves

  1. Abra la consola de IAM, en https://console.aws.amazon.com/iam/.

  2. En el panel de navegación izquierdo, haga clic en Users (Usuarios).

  3. En la lista User name (Nombre de usuario), haga clic en el nombre de usuario para el que desea generar nuevas claves de acceso.

  4. En la página Summary (Resumen), haga clic en la pestaña Security credentials (Credenciales de seguridad).

  5. En la sección Access keys (Claves de acceso), haga clic en Create access key (Crear clave de acceso).

Paso 3: Activar una o varias gemas en la nube en su proyecto

La funcionalidad de Cloud Canvas se activa en Lumberyard a través de gemas y gemas en la nube. Las gemas son extensiones que comparten código y recursos entre proyectos de Lumberyard. Las gemas en la nube son gemas que utilizan la capacidad de AWS para proporcionar características conectadas. Para habilitar gemas y gemas en la nube en su proyecto, utilice Project Configurator.

En este tutorial, se utiliza el proyecto CloudGemSamples de Lumberyard, que incluye muchas de las gemas en la nube que se incluyen con Lumberyard.

Para habilitar el proyecto CloudGemSamples

  1. Abra Project Configurator de Lumberyard (lumberyard-version\dev\Tools\LmbrSetup\Win\ProjectConfigurator.exe).

  2. Haga clic en CloudGemSamples.

  3. En la esquina superior derecha de la página de Project Configurator, haga clic en Set as default (Establecer como predeterminado).

  4. Cierre Project Configurator.

Paso 4: Añadir credenciales de administrador a Lumberyard

Para comenzar la administración de un proyecto de Cloud Canvas, hay que agregar las credenciales de usuario de IAM que ha generado anteriormente a un perfil al que Cloud Canvas puede hacer referencia con facilidad. Para ello, puede utilizar Lumberyard Editor o un símbolo de línea de comandos.

Para introducir las credenciales en Lumberyard Editor

  1. Puede utilizar uno de los siguientes métodos para lanzar Lumberyard Editor:

    • En el escritorio, haga doble clic en el icono de Lumberyard Editor.

    • Desde Lumberyard Setup Assistant, en la página Summary (Resumen), haga clic en Launch editor (Lanzar editor).

    • En Visual Studio 2017, vaya al directorio lumberyard-version\dev\Bin64vc141 y haga doble clic en Editor.exe.

    • En Visual Studio 2015, vaya al directorio lumberyard-version\dev\Bin64vc140 y haga doble clic en Editor.exe.

  2. En Lumberyard Editor, elija AWS, Credentials manager (Administrador de credenciales).

    
              Abra Credentials manager (Administrador de credenciales)
  3. En el cuadro de diálogo Credentials Manager (Administrador de credenciales), haga clic en Add profile (Añadir perfil).

    
              Haga clic en Add profile (Añadir perfil)
  4. En el cuadro de diálogo Add profile (Añadir perfil), escriba la siguiente información:

    • En Profile name (Nombre de perfil), escriba el nombre que prefiera (por ejemplo, CloudCanvasAdmin).

    • En AWS access key (Clave de acceso de AWS) y AWS secret key (Clave secreta de AWS), escriba la clave de acceso y la clave secreta.

    
              Introduzca información del perfil de su cuenta de AWS en Lumberyard Editor

    importante

    No comparta estas credenciales con nadie y no las proteja en el control de código fuente. Estas credenciales conceden el control sobre la cuenta de AWS y un usuario malintencionado podría incurrir en cargos.

  5. Haga clic en Guardar.

  6. En Credentials Manager (Administrador de credenciales), haga clic en OK (Aceptar).

    
              Perfil añadido en Credentials Manager (Administrador de credenciales).

Ya ha creado un perfil para administrar un proyecto de Cloud Canvas. El nombre de perfil está ahora asociado a las credenciales y guardado localmente en el equipo en un archivo de credenciales de AWS. Este archivo normalmente se encuentra en su directorio C:\Users\user_name\.aws\. Por comodidad, otras herramientas como AWS Command Line Interface o AWS Toolkit for Visual Studio tienen acceso a estas credenciales.

Paso 5: Cargar recursos en AWS y crear una implementación

Ya está listo para crear en AWS los recursos que se definen en su proyecto.

Se trata de un proceso de dos partes:

  1. Creación de una pila de proyecto en AWS que contiene los recursos que necesitan sus gemas en la nube.

  2. Creación de una implementación. Una implementación es una copia independiente y separada de los recursos de AWS del proyecto para un uso específico (por ejemplo, desarrollo, pruebas o producción).

Para cargar recursos en AWS

  1. En Lumberyard Editor, elija AWS, Cloud Canvas, Resource Manager (Administrador de recursos).

  2. En Resource Manager (Administrador de recursos), haga clic en Upload all resources (Cargar todos los recursos).

    
              Cargue todos los recursos en AWS.
  3. En el cuadro de diálogo Initialize Resource Manager (Inicializar administrador de recursos), haga clic en Yes (Sí).

    
              Initialize Resource Manager (Inicializar administrador de recursos)
  4. En el cuadro de diálogo Initialize Cloud Canvas Resource Manager (Inicializar el administrador de recursos de Cloud Canvas), revise los campos correspondientes.

    
              Proporcione un nombre de pila del proyecto, el perfil de AWS y la región de AWS
    • Project stack name (Nombre de pila de proyecto): este nombre es, de forma predeterminada, el nombre del proyecto. Si lo prefiere, puede especificar otro nombre.

    • AWS profile (Perfil de AWS): es el perfil que ha preparado en el procedimiento anterior. Puede hacer clic en Edit (Editar) para editar este perfil o en Add profile (Añadir perfil) para añadir otro perfil.

    • AWS region (Región de AWS): es, de manera predeterminada us-east-1, que admite todas las gemas en la nube de Lumberyard. No todas las gemas en la nube se admiten en todas las regiones de AWS.

  5. Haga clic en Create. Progress log (Registro de progreso) indica Operation in progress (Operación en curso). La creación de la pila del proyecto en AWS lleva alrededor de 5 a 10 minutos.

    
              Creación de la pila del proyecto en curso
  6. Cuando finalice la operación, aparecerá el cuadro de diálogo Cloud Gem Portal Administrator Account Creation (Creación de la cuenta de administrador de Cloud Gem Portal).

    Copie las credenciales temporales en el portapapeles. Puede hacer clic con el botón derecho del ratón en el cuadro de diálogo y utilizar el menú contextual o pulsar Ctrl+A para seleccionar las credenciales y, a continuación, pulsar Ctrl+C para copiarlas.

    
              Copie las credenciales temporales para Cloud Gem Portal

    importante

    Necesitará estas credenciales posteriormente para utilizar Cloud Gem Portal, que es la interfaz de administración en la web de las gemas en la nube.

  7. Haga clic en OK (Aceptar).

  8. En el cuadro de diálogo Create deployment (Crear implementación), que aparece al mismo tiempo que el cuadro de diálogo Cloud Gem Portal Administrator Account Creation (Creación de la cuenta del administrador de Cloud Gem Portal), escriba un nombre para la implementación (por ejemplo, dev, test o prod).

    
              Escriba un nombre de implementación
  9. Haga clic en Create. La operación de implementación tarda unos 10 minutos en completarse.

Paso 6: Acceder a Cloud Gem Portal

Ahora que ya se han creado sus gemas en la nube, puede administrarlas en Cloud Gem Portal.

Para abrir Cloud Gem Portal

  1. En Lumberyard Editor, elija AWS, Open Cloud Gem Portal (Abrir Cloud Gem Portal).

    
              Abrir Cloud Gem Portal
  2. En el cuadro Sign In to the Cloud Gem Portal (Iniciar sesión en Cloud Gem Portal), escriba el nombre de usuario y la contraseña temporales que anotó previamente.

    
              Escriba las credenciales temporales en Cloud Gem Portal.
  3. Como medida de seguridad, debe reemplazar su contraseña temporal. Escriba una nueva contraseña y haga clic en Save Password (Guardar contraseña).

  4. Después de iniciar sesión, en la página Cloud Gems (Gemas en la nube) aparece la lista de gemas en la nube disponibles en su implementación actual.

    
              La página Cloud Gems (Gemas en la nube) de Cloud Gem Portal
  5. Haga clic en una gema en la nube para ver la página de administración.

Paso 7: Obtener más información

Consulte los siguientes recursos.

Tarea Tema
Obtenga más información acerca de cada una de las gemas en la nube (incluidas gemas en la nube que no están en el proyecto CloudGemSamples) Gemas en la nube
Añada gemas adicionales y gemas en la nube a un proyecto Habilitación de gemas
Utilice Consola de administración de AWS para ver los recursos en AWS Inspeccionar los recursos en AWS
Cree grupos de seguridad para la administración de equipos de Cloud Canvas Creación de usuarios y grupos de IAM para administrar equipos de Cloud Canvas
Administre los usuarios de Cloud Gem Portal Administración de usuarios en Cloud Gem Portal
Cree sus propias gemas en la nube y personalice Cloud Gem Portal Creación de una gema en la nube

Introducción al desarrollo de juegos en Cloud Gem Portal

Elimine los recursos que ha creado en AWS Elimine las implementaciones y los recursos de Cloud Canvas

En esta página: