Uso de la Cloud Canvas Línea de comandos - 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.

Uso de la Cloud Canvas Línea de comandos

Cloud Canvas proporciona el \dev\lmbr_aws.cmd herramienta de línea de comandos para trabajar con AWS Los recursos de. La herramienta invoca el código de Python que se encuentra en el \dev\Tools\lmbr_aws del directorio.

Notas

Syntax

lmbr_aws {command} {command-arguments}

{command} es uno de los comandos de la sección de resumen de comandos que sigue a. {command-arguments} son los argumentos aceptados con el comando. Los argumentos comunes a la mayoría de los comandos se enumeran en la Argumentos comunes sección. Argumentos de un comando único se enumeran en la sección de detalles del comando.

Configuration

La herramienta obtiene su valor predeterminado AWS configuración desde el mismo ~/.aws/credentials y ~/.aws/config archivos como AWS herramientas de línea de comandos (para obtener información, consulte Configuración de la AWS Command Line Interface). El lmbr_aws herramienta no requiere que el AWS línea de comandos de la interfaz de.

Entorno Variables

Al igual que con la AWS herramientas de línea de comandos, el valor predeterminado AWS la configuración puede ser se anula mediante las siguientes variables de entorno.

  • AWS_ACCESS_KEY_ID La clave de acceso para su AWS cuenta.

  • AWS_SECRET_ACCESS_KEY La clave secreta para su AWS cuenta.

  • AWS_DEFAULT_REGION La región predeterminada que se va a utilizar; por ejemplo, us-east-2.

  • AWS_PROFILE La credencial predeterminada y el perfil de configuración para usar, si lo hay.

Configuración Argumentos

Los siguientes argumentos se pueden utilizar para anular el AWS configuración desde todos otras fuentes:

  • --assume-role{role-name} o bien -R {role-name} – Especifica la IAM del rol de que se va a asumir para realizar las acciones solicitadas. El de las credenciales en la ~/.aws/credentials el archivo debe ser capaz para asumir el rol especificado.

  • --aws-access-key {access-key} – El AWS clave de acceso que se utiliza.

  • --aws-secret-key {secret-key} – El AWS clave secreta que se utiliza.

  • --profile {profile-name} o bien -P {profile-name} – El AWS del perfil de herramienta de línea de comandos que se utiliza.

Argumentos comunes

La mayoría de los lmbr_aws los comandos aceptan los siguientes argumentos, además a sus propios argumentos individuales:

  • --aws-directory {aws} – Identifica el {game}\AWS para utilizar. El valor predeterminado es el valor de la sys_game_folder propiedad desde {root}\bootstrap.cfg con AWS se ha añadido.

  • --game-directory {directory} – Ubicación del directorio del proyecto de juego. El valor predeterminado es {root}\{game} donde {game} está determinado por el sys_game_folder en el campo {root}\bootstrap.cfg del archivo.

  • --help o bien -h – Mostrar ayuda para el del comando.

  • --no-prompt – Suprime las llamadas que solicitan entrada desde el ventana del símbolo del sistema.

  • --region-override {AWS_region} – Especificar un valor no predeterminado AWS región que utilizar en tu local-project-settings.json del archivo.

    --root-directory {root} – Identifica el lumberyard_installation\dev del directorio. El valor predeterminado es el directorio de trabajo actual.

  • --user-directory {user} – Ubicación del directorio de caché del usuario. El valor predeterminado es {root}\Cache\{game}\AWS donde {game} está determinado por el sys_game_folder en el campo {root}\bootstrap.cfg del archivo.

  • --verbose – Muestra la salida adicional al ejecutar de los comandos de la.

Commands

A continuación se muestran los lmbr_aws de los comandos de la.

El lmbr_aws cloud-gem Los comandos de la crean, habilitan y deshabilitan la nube Las gemas de.

gém-nube crear

Cree una gema en la nube. Este comando es nuevo en Lumberyard 1.11.

Además del Argumentos comunes, el cloud-gem create El comando acepta lo siguiente argumentos:

  • --directory {path}

    Opcional. El directorio donde se crea la gema. El valor predeterminado es \dev\Gems\{name}\v{N}, donde {name} es el nombre que se especificado por el --gem opción y {N} es la parte principal de la gema número de versión especificado por el --version opción.

  • --enable

    Opcional. Habilitar la gema para el proyecto actual cuando la gema sea creado. De forma predeterminada, la gema no está habilitada cuando es creado.

  • --gem {name}

    Se requiere. El nombre de la gema para crear.

  • --initial-content {initial-content-type}

    Opcional. Inicialización de la gema en la nube AWS con el contenido especificado por {initial-content-type}.

    A continuación se muestran los valores posibles para {initial-content-type}.

    nota

    Antes de poder utilizar la api opciones de contenido, haz uno de los siguientes:

    • En Lumberyard Setup Assistant, elige Compilar el juego código

    • Desde una ventana del símbolo del sistema en la \dev\Tools\LmbrSetup\Win , escriba el siguiente comando:

      lmbr capabilities enable compilegame
    • api-lambda

      Definición de un grupo de recursos con Amazon API Gateway y AWS Lambda Los recursos de función de que se ajustan a los requisitos de Cloud Gem Framework Patrón de API de servicio. Puede añadir AWS recursos según sea necesario.

    • api-lambda-bucket

      Definición de un grupo de recursos con API Gateway y Lambda función Recursos de que se ajustan al servicio de Cloud Gem Framework Patrón de API. También crea un Amazon S3 recurso de bucket de.

    • api-lambda-dynamodb

      Definición de un grupo de recursos con API Gateway y Lambda función Recursos de que se ajustan al servicio de Cloud Gem Framework Patrón de API. También crea un Amazon DynamoDB tabla del recurso de.

    • bucket

      Defina un grupo de recursos que tenga un Amazon S3 cubo del recurso de.

    • lambda

      Defina un grupo de recursos que tenga un Lambda función del recurso de.

    • no-resources

      Defina un grupo de recursos que no tenga recursos (excepto Controlacceso, que es obligatorio). Este es el valor predeterminado.

    • resource-manager-plugin

      Defina un complemento del administrador de recursos.

  • --no-cpp-code

    Opcional. Defina una gema que no contenga código C++ y que no crear como un .dll del archivo. La gema puede contener de grupos de recursos y/o complementos del administrador de recursos.

  • --version {version}

    Opcional. Establezca la versión de la gema en el número especificado por {version}. El el valor predeterminado es 1.0.0. El número de versión debe estar en el campo formato {number}.{number}.{number}.

gém-nube desactivar

Deshabilite una gema en la nube que esté en el proyecto actual. Este comando es nuevo en Lumberyard 1.11.

Además del Argumentos comunes, el cloud-gem disable El comando acepta lo siguiente argumentos:

  • --gem {name}

    Se requiere. El nombre de la gema para deshabilitar.

gém-nube activar

Habilite una gema en la nube que esté en el proyecto actual. Este comando es nuevo en Lumberyard 1.11.

Además del Argumentos comunes, el cloud-gem enable El comando acepta lo siguiente argumentos:

  • --gem {name}

    Se requiere. El nombre de la gema para habilitar.

camisetas-de-nube-gem importar-tts-zip

Importación de paquetes de voz generados desde el servicio Cloud Gem Text-to-Speech en un proyecto. Este comando es nuevo en Lumberyard 1.11.

Además del Argumentos comunes, el cloud-gem-tts import-tts-zip El comando acepta lo siguiente argumentos:

  • --download-path {zip-path}

    Se requiere. La ruta absoluta a un .zip archivo que se descargó de Text-to-Speech Cloud Gem Portal.

  • --import-as-wav

    Opcional. Convierte archivos de audio en .wav archivo cuando se extraen.

Para obtener más información sobre la descarga e importación de archivos de voz, consulte Gema en la nube de conversión de texto a voz [EMPTY].

El lmbr_aws deployment administración de comandos Cloud Canvas Las implementaciones de.

nota

En Lumberyard 1.16 y versiones posteriores, el deployment comandos instale, modifique o elimine gemas en serie en lugar de en paralelo. Este evita los problemas que pueden producirse en AWS cuando varios grupos de recursos son creado, actualizado o eliminado al mismo tiempo.

Este comportamiento predeterminado se puede anular con el botón --parallel , como en los siguientes ejemplos:

lmbr_aws deployment create --deployment deployment_name --parallel lmbr_aws deployment update --parallel lmbr_aws deployment delete --deployment deployment_name --parallel
aviso

Porque aumenta en gran medida el riesgo de errores al modificar su la implementación, el uso de la --parallel no se recomienda.

implementación crear

Cree una copia completa e independiente de todos los recursos necesarios para el Proyecto de Lumberyard.

Además del Argumentos comunes, el deployment create El comando acepta lo siguiente argumentos:

  • --deployment {deployment-name} o bien -d {deployment-name}

    Se requiere. El nombre de la implementación para crear.

  • --confirm-aws-usage o bien -C

    Opcional. Confirma que sabe que el deployment create el comando creará AWS recursos para los que y que pueden realizar acciones que pueden afectar permisos en tu AWS cuenta. Especificar este argumento para deshabilitar el mensaje de confirmación relacionado.

implementación por defecto

Establezca o muestre las implementaciones predeterminadas de usuario y proyecto.

Además del Argumentos comunes, el deployment default El comando acepta lo siguiente argumentos:

  • --set {deployment}

    Opcional. Establece el valor predeterminado en el nombre de implementación proporcionado.

  • --clear

    Opcional. Borra los valores predeterminados.

  • --show

    Opcional. Muestra los valores predeterminados.

  • --project

    Opcional. Se aplica --set y --clear de el proyecto predeterminado en lugar del usuario predeterminado. Ignorado para --show.

    Solo uno de los --setde --clear, y --show Los argumentos de están permitidos.

    Si --set o bien --clear se especifica, este El comando actualiza el {root}\user\AWS\user-settings.json del archivo. Si --project se proporciona, el {root}\{game}\AWS\project-settings.json El archivo se ha actualizado.

implementación eliminar

Elimine una copia completa e independiente de todos los recursos necesarios para el Lumberyard del proyecto.

Además del Argumentos comunes, el deployment delete El comando acepta lo siguiente argumentos:

  • --deployment {deployment-name} o bien -d {deployment-name}

    Se requiere. El nombre de la implementación para eliminar.

  • --confirm-resource-deletion

    Opcional. Confirma que el comando eliminará permanentemente Los recursos de para la implementación especificada. Si este argumento no es especificado, se emite un mensaje de confirmación.

nota

AWS CloudFormation imposible borrar las pilas que definen Amazon S3 Los buckets de que contienen datos. Para permitir que se eliminen las pilas de proyecto, la project-template.json el archivo especifica un DeletionPolicy de Retain para del bucket de configuración de. Esto causa AWS CloudFormation para no eliminar el bucket cuando la pila del proyecto se elimina. Una vez eliminada la pila del proyecto, el comando elimina todos los objetos del bucket de configuración y A continuación, elimina el bucket.

implementación lista

Enumere todas las implementaciones en el proyecto local.

Ejemplo de salida:

Name Status Reason Timestamp Id ----------------- --------------- ---------------------------------------------------------------------------- ----------------- -------------------------------------------------------------------------------------------------------------------------- AnotherDeployment CREATE_PENDING Resource is defined in the local project template but does not exist in AWS. Development CREATE_COMPLETE 03/04/16 18:43:11 arn:aws:cloudformation:us-east-2:<ACCOUNTID>:stack/foo-hw-Development-ZDLXUB7FKR94/8e6492f0-e248-11e5-8e7e-50d5ca6e60ae User Default Deployment: (none) Project Default Deployment: Development Release Deployment: (none)

implementación lista-recursos

Enumere todos los recursos asociados con el proyecto.

Además del Argumentos comunes, el deployment list-resources El comando acepta lo siguiente argumentos:

  • --deployment {deployment-name} o bien -d {deployment-name}

    Opcional. El nombre de la implementación para mostrar los recursos de. En caso contrario especificado, enumera todos los recursos del proyecto.

implementación proteger

Marca una implementación como protegida y emite una advertencia cuando un usuario (para ejemplo, un desarrollador de juegos, programador o probador) intenta conectar un del cliente de juego de desarrollo para recursos en directo. Para obtener más información, consulte Uso de implementaciones protegidas .

Además del Argumentos comunes, el deployment protect El comando acepta lo siguiente argumentos:

  • --set {deployment-name}

    Opcional. Especifica que la implementación está protegida.

  • --clear {deployment-name}

    Opcional. Especifica que la implementación no está protegida.

  • --show

    Opcional. Muestra una lista de las implementaciones que están actualmente protegido por.

    nota

    Para mostrar el estado protegido de las implementaciones, también puede use la función implementación lista o bien mapeos lista del comando.

implementación liberación

Establece, muestra o elimina la implementación de la versión.

Además del Argumentos comunes, el deployment release El comando acepta lo siguiente argumentos:

  • --set {deployment-name}

    Se requiere. El nombre de la implementación que se va a establecer como la versión.

  • --clear

    Elimina la designación de despliegue de la versión actual implementación de.

  • --show

    Muestra la implementación que está configurada actualmente como el despliegue implementación de.

implementación etiquetas

Administra las etiquetas de una implementación. Las etiquetas de implementación especifican el grupo de recursos anula para una implementación.

Además del Argumentos comunes, el deployment tags El comando acepta lo siguiente argumentos:

  • --add {tag} [{tag} ...]

    Opcional. Especifica las etiquetas que se van a añadir a una implementación. Las etiquetas son guardados en el lumberyard_version\dev\project_name\AWS\local-project-settings.json del archivo.

  • --clear

    Opcional. Borra todas las etiquetas de una implementación.

  • --delete {tag} [{tag} ...]

    Opcional. Especifica las etiquetas que se van a eliminar de una implementación.

  • --deployment {deployment-name} o bien -d {deployment-name}

    Opcional. El nombre de la implementación.

  • --list

    Opcional. Enumera todas las etiquetas de una implementación.

implementación actualización-acceso

Establece, muestra o elimina la implementación de la versión.

Además del Argumentos comunes, el deployment update-access El comando acepta lo siguiente argumentos:

  • --confirm-aws-usage o bien -C

    Opcional. Confirma que sabe que este comando crea AWS recursos por los que se le puede cobrar y que puede realizar Las acciones de que pueden afectar a los permisos de su AWS cuenta. Especificar este argumento para deshabilitar el mensaje de confirmación relacionado.

  • --confirm-resource-deletion

    Opcional. Si la operación eliminará los recursos de forma permanente, confirma su confirmación y aprobación. Si este argumento no es especificado, se le pedirá que confirme la finalización de la operación. Especifique este argumento para deshabilitar la confirmación relacionada selección dinámica.

  • --confirm-security-change

    Opcional. Confirma que sabe que este comando puede hacer que Los cambios relacionados con la seguridad de. Especifique este argumento para deshabilitar la mensaje de confirmación relacionado con.

  • --deployment {deployment-name} o bien -d {deployment-name}

    Opcional. El nombre de la implementación cuya pila de acceso es actualizado. Si se omite, la implementación predeterminada se actualiza. Utilice * para actualice todas las implementaciones.

implementación actualización, carga de implementación, recursos de carga de implementación

Actualiza una implementación. deployment upload o bien deployment upload-resources se puede utilizar en lugar de deployment update.

Además del Argumentos comunes, el deployment update El comando acepta lo siguiente argumentos:

  • --confirm-aws-usage o bien -C

    Opcional. Confirma que sabe que este comando crea AWS recursos por los que se le puede cobrar y que puede realizar Las acciones de que pueden afectar a los permisos de su AWS cuenta. Especificar este argumento para deshabilitar el mensaje de confirmación relacionado.

  • --confirm-resource-deletion

    Opcional. Si la operación eliminará los recursos de forma permanente, confirma su confirmación y aprobación. Si este argumento no es especificado, se le pedirá que confirme la finalización de la operación. Especifique este argumento para deshabilitar la confirmación relacionada selección dinámica.

  • --confirm-security-change

    Opcional. Confirma que sabe que este comando puede hacer que Los cambios relacionados con la seguridad de. Especifique este argumento para deshabilitar la mensaje de confirmación relacionado con.

  • --deployment {deployment-name} o bien -d {deployment-name}

    Opcional. El nombre de la implementación para actualizar. Si se omite, el botón La implementación predeterminada de se actualiza.

El lmbr_aws function los comandos gestionan carpetas, CloudWatch registros, y código para Lambda funciones.

función crear-carpeta

Recrea la carpeta de función predeterminada para un Lambda función del recurso de.

Además del Argumentos comunes, el function create-folder El comando acepta lo siguiente argumentos:

  • --function {function-name} o bien -f {function-name}

    Se requiere. El nombre lógico de un Lambda Recurso de función de.

  • --resource-group {resource-group-name} o bien -r {resource-group-name}

    Se requiere. El nombre de un grupo de recursos.

  • --force

    Opcional. Omite las comprobaciones de la existencia del recurso y el tipo de del recurso de. Se utiliza al crear carpetas para funciones que aún no creado.

función obtener-registro

Recupera datos de un CloudWatch Logs archivo de registro.

Además del Argumentos comunes, el function get-log El comando acepta lo siguiente argumentos:

  • --deployment {deployment-name} o bien -d {deployment-name}

    Opcional. El nombre de una implementación. Si se especifica este argumento, el --resource-group también debe especificarse el argumento. Si se omite este argumento, la función debe existir en la de la pila de proyecto de.

  • --function {function-name} o bien -f {function-name}

    Se requiere. El nombre lógico de un Lambda Recurso de función de.

  • --resource-group {resource-group-name} o bien -r {resource-group-name}

    Opcional. El nombre de un grupo de recursos. Si se especifica, el campo --deployment el argumento también debe ser especificado.

  • --log-stream-name {log-stream-name} o bien -l {log-stream-name}

    Opcional. El nombre del flujo de registro o el nombre del flujo de registro parcial. Si omitido, se muestra el flujo de registros más reciente.

función cargar-código

Actualizaciones Lambda para una implementación o proyecto de.

Además del Argumentos comunes, el function upload-code El comando acepta lo siguiente argumentos:

  • --deployment {deployment-name} o bien -d {deployment-name}

    Opcional. El nombre de una implementación para actualizar. Si no es así, ni el argumento --project se especifica el argumento , el La implementación predeterminada de se actualiza. Si el --project se especifica el argumento , el --deployment el argumento es ha ignorado.

  • --function {function-name}

    Opcional. El nombre del Lambda función para actualizar. En caso contrario especificado, todos Lambda las funciones del grupo de recursos son actualizado.

  • --keep

    Opcional. Mantenga la generada .zip archivo en lugar de eliminarla después de cargarla.

  • --project

    Opcional. Actualiza el proyecto. Anula el --deployment del argumento.

  • --resource-group {resource-group-name} o bien -r {resource-group-name}

    Opcional. El nombre de un grupo de recursos que tiene la función para actualizar.

El lmbr_aws login-provider comandos añadir, eliminar y actualizar de inicio de sesión en redes sociales en Amazon Cognito Configuración del grupo de identidades de.

nombre-inicio-proveedor-añadir

Añadir un proveedor de inicio de sesión de jugador a la Amazon Cognito Configuración del grupo de identidades de. Los proveedores de inicio de sesión permiten a los jugadores de su juego iniciar sesión utilizando sus redes sociales como Facebook o el uso de su identidad de Amazon. Para más información información, consulte Control del acceso a Recursos.

Además del Argumentos comunes, el login-provider add El comando acepta lo siguiente argumentos:

  • --provider {provider-name}

    Se requiere. El nombre del proveedor. El nombre debe ser amazonde google o bien facebook, o, si está utilizando un OpenID genérico proveedor, un nombre que elija.

  • --app-id {application-id}

    Se requiere. El ID de aplicación de su proveedor de inicio de sesión (esto es normalmente diferente de su ID de cliente).

  • --client-id {client-id}

    Se requiere. El ID de cliente de aplicación único para el inicio de sesión proveedor.

  • --client-secret {client-secret}

    Se requiere. La clave secreta que se va a utilizar con el proveedor de inicio de sesión.

  • --redirect-uri {redirect-uri}

    Se requiere. El URI de redireccionamiento para utilizarlo con su proveedor de inicio de sesión.

  • --provider-uri {provider-uri}

    Opcional. El URI de un proveedor de conexión de ID abierto genérico. Esto es solo se utiliza para proveedores de OpenID genéricos.

  • --provider-port {provider-port}

    Opcional. El puerto en el que su proveedor escucha para su API. Esto es solo se utiliza para proveedores de OpenID genéricos.

  • --provider-path {provider-path}

    Opcional. La parte de la ruta del URI del proveedor. Esto es solo utilizado para proveedores de OpenID genéricos.

    Este comando guarda su configuración en un player-access/auth-settings.json objeto en el bucket de configuración del proyecto para que el PlayerAccessTokenExchange Lambda la función puede acceder es.

    nota

    Debes ejecutar project upload después de ejecutar este de modo que el comando PlayerAccessIdentityPool La configuración de se actualiza para reflejar el cambio.

usuario-proveedor eliminar

Eliminar un proveedor de inicio de sesión de jugador de la Amazon Cognito grupo de identidades Configuración de.

Además del Argumentos comunes, el login-provider remove El comando acepta lo siguiente argumento:

  • --provider {provider-name}

    Se requiere. El nombre del proveedor.

    El login-provider remove el comando guarda el configuración en un /player-access/auth-settings.json objeto en el bucket de configuración del proyecto para que el PlayerAccessTokenExchange Lambda la función puede acceder es.

    nota

    Debes ejecutar lmbr_aws project upload después de ejecutando este comando para que el PlayerAccessIdentityPool La configuración de se actualiza para reflejar el cambio.

inicio de sesión-actualización del proveedor

Actualizar un proveedor de inicio de sesión de jugador en la Amazon Cognito Configuración del grupo de identidades de. Los proveedores de inicio de sesión permiten a los jugadores de su juego iniciar sesión utilizando sus redes sociales como Facebook o mediante su identidad de Amazon. Para más información información, consulte Control del acceso a Recursos.

Además del Argumentos comunes, el login-provider update El comando acepta lo siguiente argumentos:

  • --provider {provider-name}

    Se requiere. El nombre del proveedor actualizado. El nombre debe ser amazonde google o bien facebook, o, si está utilizando un OpenID genérico proveedor, el nombre que eligió cuando el proveedor fue ha añadido.

  • --app-id {application-id}

    Opcional. El ID de aplicación de su proveedor de inicio de sesión (esto es normalmente diferente de su ID de cliente).

  • --client-id {client-id}

    Opcional. El ID de cliente de aplicación único para el inicio de sesión proveedor.

  • --client-secret {client-secret}

    Opcional. La clave secreta que se va a utilizar con el proveedor de inicio de sesión.

  • --redirect-uri {redirect-uri}

    Opcional. El URI de redireccionamiento para utilizarlo con su proveedor de inicio de sesión.

  • --provider-uri {provider-uri}

    Opcional. El URI de un proveedor de conexión de ID abierto genérico. Este El argumento solo se utiliza para proveedores de OpenID genéricos.

  • --provider-port {provider-port}

    Opcional. El puerto en el que el proveedor escucha la API del proveedor. Este argumento se utiliza solo para proveedores de OpenID genéricos.

  • --provider-path {provider-path}

    Opcional. La parte de la ruta del URI del proveedor. Este argumento es se utiliza solo para proveedores de OpenID genéricos.

    El login-provider update el comando guarda su configuración en un /player-access/auth-settings.json objeto en el bucket de configuración del proyecto para que el PlayerAccessTokenExchange Lambda la función puede acceder es.

    nota

    Debes ejecutar lmbr_aws project upload después de ejecutando este comando para que el PlayerAccessIdentityPool La configuración de se actualiza para reflejar el cambio.

El lmbr_aws mappings Los comandos de gestionan los mapeos de lógicos a nombres de recursos físicos en un Cloud Canvas implementación de.

mapeos lista

Muestre los mapeos lógicos a nombres de recursos físicos.

Ejemplo de salida:

Name Type Id --------------------------------------- --------------------------- ---------------------------------------------------------------- HelloWorld.SayHello AWS::Lambda::Function foo-hw-Development-ZDLXUB7FKR94-HelloWo-SayHello-1FADMFNE5M1CO PlayerAccessIdentityPool Custom::CognitoIdentityPool us-east-2:108f6d6a-f929-4212-9947-a03269b9582e PlayerLoginIdentityPool Custom::CognitoIdentityPool us-east-2:3020e175-0ddd-4860-8dad-1db57162cbb2 PlayerAccessTokenExchange AWS::Lambda::Function foo-hw-PlayerAccessTokenExchange-1BG6JJ94IZAUV account_id Configuration <ACCOUNTID> region Configuration us-east-2

mapeos actualizar

Actualizar el nombre fácil de recordar a mapeos de ID de recurso físico para el actual implementación predeterminada o la implementación de lanzamiento.

Además del Argumentos comunes, el mappings update El comando acepta lo siguiente argumentos:

  • --release

    Opcional. Hace que los mapeos de despliegue se actualicen. Por defecto, solo los mapeos utilizados al lanzar el juego desde dentro de la El editor de se actualiza.

    El comando se ve en la recurso-plantilla.json archivo para Metadata.CloudCanvas.PlayerAccess propiedades en Definiciones de recursos de. Entonces consulta AWS CloudFormation para los nombres físicos de esos recursos en la implementación predeterminada actual. Si el --release se especifica el argumento , la liberación La implementación de se consulta.

  • --deployment {deployment-name} o bien -d {deployment-name}

    Opcional. Exporta archivos de mapeo de cliente y servidor para el de implementación especificada en el \dev\project_name\Config directorio en el formato {deployment_name}.player.awsLogicalMappings.json y {deployment_name}.server.awsLogicalMappings.json. El {deployment-name} El argumento es obligatorio y distingue entre mayúsculas y minúsculas.

    Cuando ejecuta un lanzador de juegos como el de dev\Bin64vcNNN\CloudGemSamplesLauncher.exe, puedes utilizar el -cc_override_resource_map {mappings-name} argumento para elegir el mapeo. Para obtener más información, consulte Selección de una implementación con un PC Launcher.

El lmbr_aws parameter Los comandos de la administran parámetros para Cloud Canvas y grupos de recursos.

parámetro claro

Borra la configuración de parámetros especificada para su proyecto. El proyecto debe inicializarse (debe haberse creado una pila de proyecto) antes de poder borre los parámetros.

Además del Argumentos comunes, el parameter clear El comando acepta lo siguiente argumentos:

  • --deployment {deployment-name} o bien -d {deployment-name}

    Opcional. Borra el valor del parámetro para la implementación especificada. {deployment-name} puede ser *, en el que case el valor del parámetro utilizado para todas las implementaciones que no se borra el valor. Si se omite, el valor del parámetro es eliminado para todas las implementaciones, incluido *.

  • --resource-group {resource-group-name} o bien -r {resource-group-name}

    Opcional. Borra el valor del parámetro para el especificado grupo-de-recursos. {resource-group-name} puede ser *, en cuyo caso el valor del parámetro utilizado para todos los grupos de recursos que no anulan el valor se borra. Si se omite, el parámetro se borra el valor para todos los grupos de recursos, incluido *.

  • --parameter {parameter-name} o bien -p {parameter-name}

    Se requiere. El parámetro para borrar.

parámetro lista

Enumera los parámetros configurados actualmente para su proyecto. El proyecto debe inicializarse (debe haberse creado una pila de proyecto) antes de poder los parámetros de la lista.

Además del Argumentos comunes, el parameter list El comando acepta lo siguiente argumentos:

  • --deployment {deployment-name} o bien -d {deployment-name}

    Se requiere. Limita la lista a la implementación especificada. {deployment-name} puede ser *, en el que Los parámetros de caso que se aplican a todas las implementaciones se muestran en la lista.

  • --resource-group {resource-group-name} o bien -r {resource-group-name}

    Se requiere. Limita la lista al grupo de recursos especificado. {resource-group-name} puede ser *, en qué parámetros de caso que se aplican a todos los grupos de recursos son de la lista.

  • --parameter {parameter-name} o bien -p {parameter-name}

    Opcional. Limita la lista al parámetro especificado.

parámetro establecer

Establece la configuración de parámetros para su proyecto. El proyecto debe ser (debe haberse creado una pila de proyecto) antes de poder establecer Los parámetros de.

Además del Argumentos comunes, el parameter set El comando acepta lo siguiente argumentos:

  • --deployment {deployment-name} o bien -d {deployment-name}

    Se requiere. Establece el valor del parámetro para la implementación especificada. {deployment-name} puede ser *, en el que caso el valor del parámetro se utiliza para todas las implementaciones que no anular el valor.

  • --resource-group {resource-group-name} o bien -r {resource-group-name}

    Se requiere. Establece el valor del parámetro para el recurso especificado del grupo de. {resource-group-name} puede ser *, en qué caso el valor del parámetro se utiliza para todos los grupos de recursos que no anule el valor.

  • --parameter {parameter-name} o bien -p {parameter-name}

    Se requiere. Especifica el parámetro cuyo valor se establecerá en.

  • --value {parameter-value} o bien -v {parameter-value}

    Se requiere. Especifica el valor para establecer.

El lmbr_aws profile Los comandos de la administran la AWS los perfiles que utilizar para Cloud Canvas.

añadir perfil

Añadir un AWS del perfil en el AWS Configuración de la herramienta de línea de comandos de.

Además del Argumentos comunes, el profile add El comando acepta los siguientes argumentos:

  • --aws-access-key{accesskey}

    Se requiere. La clave de acceso de AWS asociada con el añadido del perfil.

  • --aws-secret-key{secretkey}

    Se requiere. La clave secreta de AWS asociada con la clave del perfil.

  • --profile {profile-name} o bien -P {profile-name}

    Se requiere. El nombre del perfil de AWS para añadir.

  • --make-default

    Opcional. Convierta el nuevo perfil en el perfil predeterminado.

perfil por defecto

Establecer, borrar o mostrar el valor predeterminado AWS del perfil. El profile default El comando modifica el DefaultProfile sección de usuario-configuración.json del archivo. A partir de Lumberyard 1.15, el Cloud Canvas herramienta de limpieza utiliza esta configuración para determinar el AWS para utilizar.

Además del Argumentos comunes, el profile default El comando acepta lo siguiente argumentos:

  • --set {profile-name}

    Opcional. Establezca el perfil predeterminado para la implementación actual en la información proporcionada AWS nombre de perfil.

  • --clear

    Opcional. Borre el perfil predeterminado.

  • --show

    Opcional. Mostrar el perfil predeterminado.

perfil lista

Enumerar el AWS que se han configurado.

perfil eliminar

Eliminar un AWS del perfil de la AWS Configuración de línea de comandos de.

Además del Argumentos comunes, el profile remove El comando acepta lo siguiente argumento:

  • --profile {profile-name} o bien -P {profile-name}

    Se requiere. El nombre del AWS para eliminar.

perfil cambiar nombre

Cambiar el nombre de un AWS del perfil en el AWS herramienta de línea de comandos Configuración de.

Además del Argumentos comunes, el profile rename El comando acepta lo siguiente argumentos:

  • --old {old-profile-name}

    Se requiere. El nombre del perfil de AWS para cambiar.

  • --new {new-profile-name}

    Se requiere. El nuevo nombre del perfil de AWS.

perfil actualizar

Actualizar un AWS del perfil.

Además del Argumentos comunes, el profile update El comando acepta lo siguiente argumentos:

  • --aws-access-key{accesskey}

    Opcional. La clave de acceso de AWS asociada al perfil actualizado. El valor predeterminado es no cambiar la clave de acceso de AWS asociada a la del perfil.

  • --aws-secret-key{secretkey}

    Opcional. La clave secreta de AWS asociada con el perfil actualizado. El valor predeterminado es no cambiar la clave secreta de AWS asociada a la del perfil.

  • --profile {profilename} o bien -P {profile-name}

    Se requiere. El nombre del perfil de AWS para actualizar.

nota

Para convertir un perfil existente en el perfil predeterminado, utiliza la opción perfil por defecto --set {profile-name} del comando.

El lmbr_aws project administración de comandos Cloud Canvas proyectos en Lumberyard.

proyecto crear

Inicializar Cloud Canvas administración de recursos para un Lumberyard del proyecto. Esto incluye creación de un conjunto de valores predeterminados Definiciones de recursos en el dev\game\AWS y un directorio AWS CloudFormation que contiene los recursos que el Cloud Canvas El administrador de recursos de utiliza para administrar los recursos del juego.

Además del Argumentos comunes, el project create El comando acepta lo siguiente argumentos:

  • --stack {stack-name}

    Opcional. El nombre utilizado para el proyecto AWS CloudFormation Pila de. El valor predeterminado es el nombre del {game} del directorio.

  • --confirm-aws-usage o bien -C

    Opcional. Confirma que sabe que este comando creará AWS los recursos por los que se le puede cobrar y que puede realizar Las acciones de que pueden afectar a los permisos de su AWS cuenta. Especificar este argumento para deshabilitar el mensaje de confirmación relacionado.

  • --files-only

    Opcional. Escribe los datos de configuración predeterminados en el {game}\AWS y sale de. El directorio debe estar vacío o no debe existen.

  • --region {region}

    Se requiere. El AWS región en la que la pila del proyecto será creado.

    nota

    El region argumento solo se puede utilizar con el project create y resource-importer list-importable-resources de los comandos de la. Para realizar la operación manualmente anular el AWS región en otra lmbr_aws comandos, utilice la función --region-override del argumento.

Cómo project create Funciona

El project create El comando realiza lo siguiente las tareas:

  1. Crea el archivo del proyecto AWS CloudFormation stack con una plantilla de arranque que define solo el Bucket de configuración del recurso de.

  2. Carga el proyecto-plantilla.json y el archivo el contenido comprimido del subdirectorio-código-proyecto a la Bucket de configuración.

  3. Utiliza el cargado project-template.json para realizar una AWS CloudFormation operación de actualización de pila de. El project-code.zip archivo se utiliza para crear el Lambda de la función definida por el project-template.json del archivo.

nota
  • Si el {root}\{game}\AWS el directorio está vacío o no existe, project create crea el directorio si es necesario y copia el contenido del dev\Tools\lmbr_aws\AWSResourceManager\default-project-content al directorio.

  • project create produce un error si una pila con el el nombre especificado ya existe en el configurado AWS cuenta y región. En este caso, puedes utilizar el botón --stack argumento para especificar un para la pila del proyecto.

  • project create genera un error si el dev\{game}\AWS\local-project-settings.json el archivo tiene un archivo no vacío ProjectStackId propiedad. En un principio, el ProjectStackId la propiedad no es presente en el local-project-settings.json del archivo. Después de crear la pila del proyecto en el paso 1, el ProjectStackId la propiedad está escrita en el archivo y es el AWS CloudFormation ID de pila de.

  • Si el proceso de actualización de pila en el paso 2 falla en el primer puedes volver a intentarlo utilizando la project upload del comando.

crear-plantilla-extensión-proyecto

Crea una plantilla de extensión para agregar un proyecto, implementación o de acceso a la implementación que complementan los recursos de project-template.json, deployment-template.json, o bien deployment-access-template.json de los archivos.

Además del Argumentos comunes, el project create-extension-template el comando acepta el los siguientes argumentos:

  • --project

    Opcional. Crea un project-template-extensions.json archivo en el directorio del proyecto.

  • --deployment

    Opcional. Crea un deployment-template-extensions.json archivo en el directorio del proyecto.

  • --deployment-access

    Opcional. Crea un deployment-access-template-extensions.json en el directorio del proyecto.

proyecto eliminar

Eliminar el AWS CloudFormation que contiene los recursos del proyecto. Usted debe elimine todas las implementaciones del proyecto antes de eliminar la pila del proyecto. Después de eliminar la pila del proyecto, debe crear una nueva pila del proyecto antes de que puedes utilizar AWS CloudFormation del administrador de recursos de su proyecto.

Además del Argumentos comunes, el project delete El comando acepta lo siguiente argumento:

  • --confirm-resource-deletion

    Opcional. Confirma su reconocimiento y aprobación de que el La operación eliminará los recursos de forma permanente. Si este argumento no es se le pedirá que confirme que ha completado el operación. Especifique este argumento para deshabilitar la confirmación relacionada selección dinámica.

    AWS CloudFormation imposible borrar las pilas que definen Amazon S3 de buckets que contienen de los datos. Para permitir que se eliminen las pilas de proyecto, la project-template.json el archivo especifica un DeletionPolicy de Retain para del bucket de configuración de. Esto causa AWS CloudFormation para no eliminar el bucket cuando se elimina la pila del proyecto. Después de que la pila del proyecto se haya eliminado, el comando elimina todos los objetos de la configuración y, a continuación, elimina el bucket.

nota

Antes de utilizar la project delete comando, asegúrese de que el valor predeterminado AWS Las credenciales especificadas por el ~/.aws/credentials en el archivo local son las mismas que las credenciales que se especifican en el Cloud Canvas Gestor de credenciales. Si las credenciales no son el mismo, es posible que el proyecto no se elimine correctamente. Puedes utilizar la función Herramienta de limpieza de Cloud Canvas para eliminar los recursos huérfanos después de una eliminación de pila de proyecto fallida.

proyecto recursos-de-lista

Enumere todos los recursos asociados con el proyecto.

actualización del proyecto, carga de proyecto

Actualizar el proyecto AWS CloudFormation Pila de. project upload se puede utilizar en lugar de project update.

Además del Argumentos comunes, el project update El comando acepta lo siguiente argumentos:

  • --confirm-aws-usage o bien -C

    Opcional. Confirma que sabe que este comando creará AWS los recursos por los que se le puede cobrar y que puede realizar que pueden afectar al permiso en su AWS cuenta. Especificar este argumento para deshabilitar el mensaje de confirmación relacionado.

  • --confirm-resource-deletion

    Opcional. Si la operación eliminará los recursos de forma permanente, confirma su confirmación y aprobación. Si este argumento no es especificado, se le pedirá que confirme la finalización de la operación. Especifique este argumento para deshabilitar la confirmación relacionada selección dinámica.

Cómo project update funciona

El comando de actualización del proyecto realiza las siguientes tareas:

  1. Carga el proyecto-plantilla.json y el archivo el contenido comprimido del subdirectorio-código-proyecto a la Bucket de configuración.

  2. Utiliza el cargado project-template.json para realizar una AWS CloudFormation operación de actualización de pila de. El project-code.zip archivo se utiliza para crear el Lambda de la función definida por el project-template.json del archivo.

nota

El project update El comando falla si el comando dev\{game}\AWS\local-project-settings.json el archivo no existe o no tiene un archivo válido ProjectStackId propiedad.

proyecto actualización-versión-marco

Actualiza la versión del marco de la gema en la nube para un proyecto.

Además del Argumentos comunes, el project update-code El comando acepta lo siguiente argumentos:

  • --confirm-aws-usage o bien -C

    Opcional. Confirma que sabe que el deployment create el comando creará AWS recursos para los que y que pueden realizar acciones que pueden afectar permisos en tu AWS cuenta. Especificar este argumento para deshabilitar el mensaje de confirmación relacionado.

  • --confirm-resource-deletion

    Opcional. Confirma que el comando eliminará permanentemente los recursos que pertenecen a la implementación especificada. Si esto no se ha especificado el argumento , se emite un mensaje de confirmación.

  • --confirm-security-change

    Opcional. Confirma que sabe que este comando puede hacer que Los cambios relacionados con la seguridad de. Especifique este argumento para deshabilitar la mensaje de confirmación relacionado con.

Para obtener más información, consulte Aplicación Actualizaciones del marco de un proyecto.

El lmbr_aws resource-group los comandos administran los grupos de recursos en su Cloud Canvas del proyecto.

añadir-grupo-de-recursos

nota

La funcionalidad de este comando ha cambiado en Lumberyard 1.11. Este el comando está obsoleto a favor del habilitar grupo de recursos y gém-nube crear de los comandos de la. A partir de Lumberyard 1.11, los grupos de recursos locales del proyecto están obsoletos en favor de las gemas en la nube. Como las gemas en la nube son reutilizables, recomendamos que se utilizan en lugar de los grupos de recursos locales.

A partir de Lumberyard 1.11, el resource-group add El comando tiene el comando siguiente comportamiento:

  • Si el grupo de recursos especificado en la --resource-group el parámetro existe pero está deshabilitado, el grupo de recursos está habilitado. Este es el equivalente del lmbr_aws resource-group enable del comando.

  • Si el grupo de recursos no existe, el campo lmbr_aws cloud-gem create se llama al comando para crear un nuevo grupo de recursos en una gema en la nube. El nombre de la gema en la nube lo especifica el --resource-group {resource-group-name} Parámetro.

    • De forma predeterminada, la nueva gema no tiene recursos. Esto corresponde a la cloud-gem create del comando --initial-content no-resources opción.

    • Si el --include-example-resources opción es especificado, el equivalente de la cloud-gem create del comando --initial-content api-lambda-dynamodb La opción se denomina.

Además del Argumentos comunes, el resource-group add El comando acepta lo siguiente argumentos:

  • --resource-group {resource-group-name} o bien -r {resource-group-name}

    Se requiere. El nombre de un grupo de recursos existente para habilitar. En caso negativo existe un grupo de recursos con el nombre especificado, especifica el nombre de la gema en la nube y el grupo de recursos que se va a crear.

  • --gem {gem-path}

    Opcional. Busca la definición del grupo de recursos en Gems\group\AWS o bien gem-path\AWS.

  • --include-example-resources

    Opcional. El equivalente de la --initial-content api-lambda-dynamodb de la opción gém-nube crear del comando.

deshabilitar grupo de recursos

Deshabilite un grupo de recursos para depurar. Este comando es nuevo en Lumberyard 1.11.

Además del Argumentos comunes, el resource-group disable El comando acepta lo siguiente argumento:

  • --resource-group {resource-group-name} o bien -r {resource-group-name}

    Se requiere. El nombre del grupo de recursos para deshabilitar.

De forma predeterminada, cuando una gema en la nube está habilitada para un proyecto, todos sus recursos Los grupos de están habilitados. La deshabilitación de un grupo de recursos tiene lo siguiente consecuencias:

  • Cuando se crea una implementación, los recursos que deshabilita las definiciones de grupo de recursos no se crean en AWS.

  • Cuando se actualiza una implementación, los recursos definidos por el grupo de recursos deshabilitado se elimina.

  • El grupo de recursos se agrega a una lista de grupos de recursos deshabilitados en el proyecto local-project-settings.json del archivo.

nota

Antes de Lumberyard 1.11, el local-project-settings.json del archivo se guarda una lista de activado Los grupos de recursos de. Por predeterminado, todos los grupos de recursos de una gema en la nube están habilitados cuando la nube La gema está habilitada. Por lo tanto, enumerar solo los grupos de recursos deshabilitados facilita su identificación.

Normalmente es mejor deshabilitar la gema en la nube que proporciona un recurso que para deshabilitar el propio grupo de recursos. Por lo tanto, recomendamos que utilizas el resource-group disable solo comando para depurar o probar. Para volver a habilitar un grupo de recursos, puede utilizar la lmbr_aws resource-group enable del comando.

habilitar grupo de recursos

Habilite un grupo de recursos. Este comando es nuevo en Lumberyard 1.11.

Además del Argumentos comunes, el resource-group disable El comando acepta lo siguiente argumento:

  • --resource-group {resource-group-name} o bien -r {resource-group-name}

    Se requiere. El nombre del grupo de recursos para habilitar.

lista de grupos de recursos

Enumerar todos los grupos de recursos encontrados en la plantilla de implementación local y en la implementación seleccionada en AWS.

Además del Argumentos comunes, el resource-group list El comando acepta lo siguiente argumento:

  • --deployment {deployment-name} o bien -d {deployment-name}

    Opcional. El nombre de la implementación para enumerar los grupos de recursos para. Si no se proporciona, la implementación predeterminada se utiliza.

Ejemplo de salida:

Name Status Reason Timestamp Id -------------- --------------- ------------------------------------------------------------------------------- ----------------- -------------------------------------------------------------------------------------------------------------------------------------------------- AnotherResourceGroup CREATE_PENDING Resource is defined in the local deployment template but does not exist in AWS. HelloWorld CREATE_COMPLETE 03/04/16 18:42:57 arn:aws:cloudformation:us-east-2:<ACCOUNTID>:stack/foo-hw-Development-ZDLXUB7FKR94-HelloWorld-WSGZ15EUWX52/9b909d20-e238-11e5-a98d-50fae987c09a

recursos-de-lista-de-grupo-de-recursos

Enumere todos los recursos asociados con el proyecto.

Además del Argumentos comunes, el resource-group list-resources El comando acepta lo siguiente argumentos:

  • --deployment {deployment-name} o bien -d {deployment-name}

    Opcional. El nombre de la implementación para mostrar los recursos de. En caso contrario especificado, enumera todos los recursos del proyecto.

  • --resource-group {resource-group-name} o bien -r {resource-group-name}

    Opcional. El nombre del grupo de recursos para enumerar los recursos de. Si especificado, deployment también debe especificarse. En caso contrario especificado, todos los recursos de implementación o de proyecto aparecen en la lista.

grupo-de-recursos eliminar

nota

La funcionalidad de este comando ha cambiado en Lumberyard 1.11. Este el comando está obsoleto a favor del gém-nube desactivar y deshabilitar grupo de recursos de los comandos de la.

A partir de Lumberyard 1.11, el resource-group remove El comando tiene el comando siguiente comportamiento:

  • Si el grupo de recursos especificado en la --resource-group El parámetro se proporciona mediante una nube , deshabilita la gema en la nube. Este es el equivalente del lmbr_aws cloud-gem disable del comando.

  • Si el grupo de recursos no lo proporciona una gema en la nube, deshabilita la del grupo de recursos de. Este es el equivalente del lmbr_aws resource-group disable del comando.

Además del Argumentos comunes, el resource-group remove El comando acepta lo siguiente argumento:

  • --resource-group {resource-group-name} o bien -r {resource-group-name}

    Se requiere. El nombre del grupo de recursos o gema en la nube que se va a desactivado.

recursos-recursos-cargar-grupo-de-recursos (cargar, actualizar)

Actualizar el de un grupo de recursos AWS CloudFormation en una implementación de. resource-group upload o bien resource-group update se puede utilizar en lugar de resource-group upload-resources.

Además del Argumentos comunes, el resource-group upload El comando acepta lo siguiente argumentos:

  • --confirm-aws-usage o bien -C

    Opcional. Confirma que sabe que este comando creará AWS los recursos por los que se le puede cobrar y que puede realizar Las acciones de que pueden afectar a los permisos de su AWS cuenta. Especificar este argumento para deshabilitar el mensaje de confirmación relacionado.

  • --confirm-resource-deletion

    Opcional. Si la operación eliminará los recursos de forma permanente, confirma su confirmación y aprobación. Especifique este argumento en desactive el mensaje de confirmación relacionado.

  • --confirm-security-change

    Opcional. Confirma que sabe que este comando puede hacer que Los cambios relacionados con la seguridad de. Especifique este argumento para deshabilitar la mensaje de confirmación relacionado con.

  • --deployment {deployment-name} o bien -d {deployment-name}

    Opcional. El nombre de la implementación para actualizar. Si no se especifica, la implementación predeterminada se actualiza.

  • --resource-group {resource-group-name}, o bien -r {resource-group-name}

    Se requiere. El nombre del grupo de recursos para actualizar. En caso contrario especificado, todos los grupos de recursos de la implementación se actualizan.

El lmbr_aws resource-importer lista de comandos e importar AWS las definiciones de recursos a su Cloud Canvas del proyecto.

recurso-importador-importación-recurso

Importe un recurso a un grupo de recursos.

Además del Argumentos comunes, el resource-importer import-resource el comando acepta el los siguientes argumentos:

  • --type {dynamodb|s3|lambda|sns|sqs}

    Opcional. El tipo de la AWS recurso para importar. Elegir entre dynamodbde s3, lambdade sns o bien sqs.

  • --arn ARN

    Se requiere. El ARN de la AWS recurso para importar.

  • --resource-name {resource-name}

    Se requiere. El nombre del recurso para importar.

  • --resource-group {resource-group-name} o bien -r {resource-group-name}

    Se requiere. El nombre del grupo de recursos para importar.

  • --download

    Opcional. Si se especifica, descarga el contenido del Amazon S3 del bucket de.

recurso-importador-de-recursos-importables-de-lista

Enumerar todos los recursos admitidos actualmente existentes en AWS.

Además del Argumentos comunes, el resource-importer list-importable-resources el comando acepta los siguientes argumentos:

  • --type {dynamodb|s3|lambda|sns|sqs}

    Se requiere. El tipo de la AWS recurso para enumerar. Elegir entre dynamodbde s3, lambdade sns o bien sqs.

  • --region {region}

    Opcional. El AWS región de los recursos. El valor predeterminado es la región de la pila del proyecto, si existe.

    nota

    El region argumento solo se puede utilizar con el resource-importer list-importable-resources y project create de los comandos de la. Para anular manualmente el AWS región en otra lmbr_aws comandos, usar el --region-override del argumento.