Resources - 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.

Resources

Open 3D Engine (O3DE), el sucesor de Lumberyard, ya está disponible en Developer Preview. Descargar O3DEo visite elBlog de AWS Game Techpara obtener más información.

Una API de servicio de gema en la nube se implementa basándose en los recursos que se definen en el archivo resource-template.json de gema en la nube. A continuación, puede ver los principales recursos para gema en la nube:

  • ServiceAPI: un recurso personalizado de AWS CloudFormation proporcionadas por Cloud Gem Framework. El controlador de este recurso configura API Gateway para utilizar la gema en la nubeswagger.jsonfile.

  • ServiceLambda: una función de AWS Lambda que implementa la funcionalidad de gema en la nube.

  • ServiceLambdaConfiguration— UnAWS CloudFormationrecurso personalizado proporcionado por Cloud Canvas Resource Manager queconfiguralaServiceLambdarecurso.

Para añadir definiciones para estos recursos a un archivo resource-template.json, escriba el siguiente comando.

lmbr_aws cloud-gem-framework add-service-api-resources --resource-group <gem-name>

Además de la adición de los recursos mencionados, el comando add-service-api-resources hace lo siguiente:

  • Agrega un archivo swagger.json al directorio de AWS de gema en la nube, si no existe ninguno todavía.

  • Agrega los recursos ServiceAPI y ServiceLambda a la propiedad AccessControl de la definición de recurso DependsOn. Esto garantiza que el recurso AccessControl se procese por medio de AWS CloudFormation después de que se hayan procesado los recursos ServiceAPI y ServiceLambda.

Para utilizar los recursos de la API de servicio que añade a un archivo resource-template.json, debe cargar dichos recursos en AWS. Para cargarlos, puedes utilizar ellmbr_aws resource‑group uploadcomando, ellmbr_aws deployment uploado haga clic enCargar recursosen laAdministrador de recursosen Lumberyard Editor.

Recurso Custom::ServiceApi

Cloud Gem Framework proporciona el controlador del recursos Custom::ServiceApi de AWS CloudFormation. Este controlador crea, actualiza y elimina los recursos API REST, de operación, implementación y fase de API Gateway según sea necesario.

Las definiciones de recursos de ServiceApi aceptan los siguientes parámetros:

{ "Resources": { ... "ServiceApi": { "Type": "Custom::ServiceApi", "Properties": { "ServiceToken": { "Ref": "ProjectResourceHandler" }, "ConfigurationBucket": { "Ref": "ConfigurationBucket" }, "ConfigurationKey": { "Ref": "ConfigurationKey" }, "CacheClusterSize": { "Ref": "ServiceApiCacheClusterSize" }, "CacheClusterEnabled": { "Ref": "ServiceApiCacheClusterEnabled" }, "MethodSettings": { ... }, "SwaggerSettings": { "ServiceLambdaArn": { "Fn::GetAtt": [ "ServiceLambda", "Arn" ] } } }, ...
ServiceToken

Identifica la función Lambda que implementa el controlador de recursos personalizado.

ConfigurationBucket

Identifica el bucket que contiene el archivo swagger.json cargado.

ConfigurationKey

Identifica la ubicación en el bucket en el que se carga el archivo swagger.json.

CacheClusterSize

Proporciona API GatewaycacheClusterSizevalor al crear o actualizar la fase API Gateway.

CacheClusterEnabled

Proporciona API GatewaycacheClusterEnabledSi crea o actualiza la fase API Gateway.

MethodSettings

No implementado.

SwaggerSettings

Proporciona valores que inserta en la cargaswagger.jsonantes de que se pase a API Gateway. Por ejemplo, puede utilizar $ServiceLambdaArn$ en el archivo swagger.json para insertar el valor de la propiedad SwaggerSettings ServiceLambdaArn.

La siguiente configuración está predefinida automáticamente:

ResourceGroupName

El nombre del grupo de recursos que se define por el recurso ServiceApi.

DeploymentName

El nombre de la implementación en la que se encuentra el recurso ServiceApi.

RoleArn

El ARN del rol que concede permiso a API Gateway para invocar laServiceLambda(u otros permisos configurados por elCloud Canvas Resource Manager Sistema de seguridad).

Region

La AWSregión de donde reside la API RESTful.

RestApiResourceName

El nombre que se utilizará para el recurso REST API API API Gateway. API Gateway toma este valor de la propiedad http://swagger.io/specification/#infoObject infoObjecttitle de swagger (definida como $RestApiResourceName$ en el archivo swagger.json predeterminado). Este es el nombre de la pila del grupo de recursos con el ID de recursos lógicos ServiceApi adjuntado (normalmente -ServiceApi).