Tutorial: Introducción a Cloud Canvas - Guía del usuario de Lumberyard

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.

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 unAWS Identity and Access ManagementPara administrar su proyecto Cloud Canvas.

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

  • Agregar sus credenciales administrativas de IAM a Lumberyard.

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

Si lo prefiere, también puede obtener información acerca de cómo inspeccionar sus recursos enAWS, cree usuarios y grupos de IAM para fines administrativos y elimine las implementaciones y recursos de Cloud Canvas deAWS.

Prerequisites

Antes de comenzar este tutorial, debe completar lo siguiente:

Cuando se inscribe enAWS, puede acceder a todas sus capacidades en la nube. Cloud Canvas crea recursos en tuAWSCuenta para que estos servicios estén accesibles a través de Lumberyard. Solo se le cobrará por los servicios que utilice. Si usted es un nuevoAWSPuede 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 , siga los pasos que figuran a continuación para crear una.

Para registrarse en Cuenta de AWS

  1. Abra https://portal.aws.amazon.com/billing/signup.

  2. Siga las instrucciones en línea.

    Parte del procedimiento de inscripción consiste en recibir una llamada telefónica e indicar un código de verificación en el teclado del teléfono.

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.

Después de registrarse en unaAWSPara su cuenta de, necesita un usuario de IAM con los permisos adecuados para administrar un proyecto de Cloud Canvas. IAM le permite administrar el acceso a suAWSaccount.

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 de 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 de su 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, consulteIAM User Guide.

Crear un usuario de IAM 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 su cuenta de

  1. Inicie sesión en la AWS Management Console 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. Marque la casilla situada junto aAWS Management ConsoleAcceso aEn, seleccioneCustom passwordA continuación, escriba una 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 enSiguiente: 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 enSiguiente: Review (Revisar)Para revisar las opciones seleccionadas.

  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 obtener acceso a la herramientaAWSrecursos de su 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 AWS Management Console.

    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. Ha creado un usuario de IAM llamadoCloudCanvasAdminy aCloudCanvasAdministratorsAl que pertenezca 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 administrador, 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).

La funcionalidad Cloud Canvas está habilitada en Lumberyard a través deGemasyGemas en la nube. Las gemas son extensiones que comparten código y activos 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 el proyecto, utilice laProject Configurator.

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

Para habilitar el proyecto CloudGemSamples

  1. Abra Lumberyard Project Configurator, ubicado enlumberyard-version\dev\Bin64BuildPlatform\ProjectConfigurator.exe. Por ejemplo, cuando se usa Visual Studio 2017 como plataforma de compilación, el configurador de proyectos se encuentra enlumberyard-version\dev\Bin64vc141\ProjectConfigurator.exe.

  2. Haga clic en CloudGemSamples.

  3. En la esquina superior derecha del Configurador de proyectos, haga clic enDefinir como predeterminado.

  4. Cierre Project Configurator.

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. Utilice uno de los siguientes métodos para lanzar Lumberyard Editor:

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

    • En el Asistente de configuración de Lumberyard, en elResumen, haga clic enLance el editor.

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

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

    
              OpenCredentials 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 enAgregar 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 deAWSCuenta 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 laCredentials Manager.

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.

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, elijaAWS,Cloud Canvas,Administrador de recursos.

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

    
              Cargue todos los recursos enAWS.
  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 navegadorInicialice el administrador de recursos de Cloud Canvas, revise los campos proporcionados.

    
              Proporcione un nombre de pila del proyectoAWSperfil, yAWSregión
    • Nombre de pila de proyecto— este nombre toma por defecto el nombre del proyecto. Si lo prefiere, puede especificar otro nombre.

    • AWSPerfil de— Este es el perfil que preparó 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.

    • AWSregiónEl valor predeterminado esus-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 (Crear). 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. En el navegadorCrear implementaciónEn el, introduzca un nombre para la implementación (por ejemplo,dev,test, o bienprod).

    
              Escriba un nombre de implementación
  7. Haga clic en Create (Crear). La operación de implementación tarda unos 10 minutos en completarse.

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 AWS Management Console para ver los recursos en AWS Inspeccionar los recursos en AWS
Cree grupos de seguridad para la administración de equipos de Cloud Canvas Cree usuarios y grupos de IAM para administrar equipos de Cloud Canvas
Cree sus propias gemas en la nube Creación de una gema en la nube
Elimine los recursos que ha creado en AWS Elimine las implementaciones y los recursos de Cloud Canvas