Uso de la CLI de contenido dinámico - 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 CLI de contenido dinámico

Cuando habilita la gema Dynamic Content Cloud Gem, los comandos asociadas están disponibles en la interfaz de línea de comando (CLI) lmbr_aws. A continuación, puede utilizar estos comandos para actualizar el contenido dinámico y efectuar operaciones en buckets y archivos de manifiesto.

Los siguientes ejemplos delmbr_awsLos comandos de extensión CLI los habilita la gema Dynamic Content Cloud Gem.

add-file-to-pak de contenido dinámico

Agrega un archivo al .pak archivo especificado.

Además de Argumentos comunes, este comando acepta los siguientes argumentos:

  • --file-name <file_name>

    Entrada de archivo que se agrega.

  • --manifest-path <manifest_path>

    (Opcional) la ruta y el nombre de archivo del manifiesto que se va a usar. Puede especificar una ruta completa o un nombre de archivo que existe en la carpetagame\DynamicContent\Manifests\.

    El valor predeterminado es game\DynamicContent\Manifests\default.json.

  • --pak-file <pak_file>

    Archivo pak al que se añade el archivo.

  • --platform-type <OS_type>

    (Opcional) Sistema operativo de la entrada de archivo que se va a añadir.

add-manifest-content dynamic-content

Añade un archivo al manifiesto de contenido para el proyecto.

Además de Argumentos comunes, este comando acepta los siguientes argumentos:

  • --file-name <filename>

    El nombre del archivo, incluido el directorio local (por ejemplo,staticdata/csv/gameproperties.csv, donde se encuentra el directorio localstaticdata/csv/.

  • --cache-root <cache directory>

    (Opcional) Referencia para el directorio de la caché local (por ejemplo,@assets@). El valor predeterminado es @assets@.

  • --bucket-prefix <prefix>

    El prefijo de bucket en el que almacenar el archivo en el bucket de contenido.

  • --manifest-path <manifest_path>

    (Opcional) la ruta y el nombre de archivo del manifiesto que se va a usar. Puede especificar una ruta completa o un nombre de archivo que existe en la carpetagame\DynamicContent\Manifests\.

    El valor predeterminado es game\DynamicContent\Manifests\default.json.

  • --output-root <default directory path>

    (Opcional) Ruta del directorio predeterminado en el que escribir. El valor predeterminado es @user@.

  • --platform-type <OS_type>

    (Opcional) El tipo de sistema operativo al que pertenece el activo. El valor predeterminado es el sistema operativo actual.

add-pak de contenido dinámico

Añade una nueva entrada de pak al manifiesto.

Además de Argumentos comunes, este comando acepta los siguientes argumentos:

  • --manifest-path <manifest_path>

    (Opcional) la ruta y el nombre de archivo del manifiesto que se va a usar. Puede especificar una ruta completa o un nombre de archivo que existe en la carpetagame\DynamicContent\Manifests\.

    El valor predeterminado es game\DynamicContent\Manifests\default.json.

  • --pak-name <pak_name>

    Nombre del pak (el archivo final será<pak-name>.<OS>.pak).

  • --platform-type <OS_type>

    (Opcional) El tipo de sistema operativo para la.pakfile.

build-new-paks

Crea archivos .pak basados en archivos de manifiesto que se han modificado.

Además de Argumentos comunes, este comando acepta los siguientes argumentos:

  • --all

    (Opcional) Subir todo.pakarchivos con independencia de los resultados de la comprobación de archivos.

  • --manifest-path <manifest_path>

    (Opcional) la ruta y el nombre de archivo del manifiesto que se va a usar. Puede especificar una ruta completa o un nombre de archivo que existe en la carpetagame\DynamicContent\Manifests\.

    El valor predeterminado es game\DynamicContent\Manifests\default.json.

dinamic-content clear-dynamic-content

Vacía el bucket y el contenido de la tabla.

Además de Argumentos comunes, este comando acepta el siguiente argumento:

  • --all-versions

    (Opcional) Elimine todas las versiones del manifiesto y los archivos pak.

  • --noncurrent-versions

    (Opcional) Elimine todas las versiones no actuales del contenido dinámico. Requiere confirmación en la línea de comandos tras el uso de este comando, a menos que--confirm-deleting-noncurrent-versionstambién se utiliza.

  • --confirm-deleting-noncurrent-versions

    (Opcional) Confirme que sabe que este comando eliminará todas las versiones no actuales de los archivos del bucket de contenido y que no podrá revertir ninguna versión anterior después de esta operación. Útil para automatización.

compare-bucket-content

Compara el contenido de manifiesto con el bucket de comprobando los metadatos HEAD.

Además de Argumentos comunes, este comando acepta el siguiente argumento:

  • --manifest-path <manifest_path>

    (Opcional) la ruta y el nombre de archivo del manifiesto que se va a usar. Puede especificar una ruta completa o un nombre de archivo que existe en la carpetagame\DynamicContent\Manifests\.

    El valor predeterminado es game\DynamicContent\Manifests\default.json.

  • --manifest-version-id <manifest version ID>

    (Opcional) Versión del paquete de manifiesto independiente. Puede recuperar los ID de versión disponibles mediante ellist-file-versionscomando.

    El valor predeterminado es la versión más reciente.

dynamic-content create-new-manifest

Crea un manifiesto nuevo.

Además de Argumentos comunes, este comando acepta los siguientes argumentos:

  • --manifest-name <manifest_name>

    Nombre del nuevo manifiesto.

  • --manifest-path <manifest_path>

    (Opcional) la ruta y el nombre de archivo del manifiesto que se va a usar. Puede especificar una ruta completa o un nombre de archivo que existe en la carpetagame\DynamicContent\Manifests\.

    El valor predeterminado es game\DynamicContent\Manifests\default.json.

  • --target-platforms <target_OS> [<target_OS> ...]

    (Opcional) Sistemas operativos de destino para este nuevo manifiesto (el valor predeterminado es todos los sistemas operativos y dispositivos compatibles).

contenido dinámico suprimido-contenido subido

Eliminar un manifiesto o paquete.

Además de Argumentos comunes, este comando acepta los siguientes argumentos:

  • --file-path <file_path>

    El archivo de manifiesto o paquete del depósito.

  • --version-id <version_id>

    (Opcional) ID de versión del archivo.

    El valor predeterminado es la versión más reciente.

  • --confirm-deletion

    (Opcional) Confirma que desea que este comando elimine el contenido especificado. Omita este argumento para obtener una vista previa de lo que se eliminaría.

dynamic-content generate-keys

Genera un nuevo par de claves pública/privada para que lo use el sistema de contenido dinámico.

Además de Argumentos comunes, este comando acepta el siguiente argumento:

  • --key-name <key_name>

    El nombre del archivo de claves que se va a utilizar.

list-bucket-content

Muestra los archivos de manifiesto del bucket de contenido.

Además de Argumentos comunes, este comando acepta el siguiente argumento:

  • --manifest-path <manifest_path>

    (Opcional) la ruta y el nombre de archivo del manifiesto que se va a usar. Puede especificar una ruta completa o un nombre de archivo que existe en la carpetagame\DynamicContent\Manifests\.

    El valor predeterminado es game\DynamicContent\Manifests\default.json.

  • --manifest-version-id <manifest version ID>

    (Opcional) Versión del paquete de manifiesto independiente. Puede recuperar los ID de versión disponibles mediante ellist-file-versionscomando.

    El valor predeterminado es la versión más reciente.

versión-archivo-lista de contenido dinámico

Enumera todas las versiones de un manifiesto o archivo pak que se encuentra en el depósito de contenido. Devuelve la versión más reciente a la más antigua según la fecha de carga.

Además de Argumentos comunes, este comando acepta los siguientes argumentos:

  • --file-name <filename>

    (Opcional) Nombre del manifiesto o archivo pak.

contenido dinámico de la lista de contenido cargado

Enumera todo el contenido cargado.

LaArgumentos comunestambién se puede utilizar con este comando.

configuración de escenario de migración de contenido dinámico

Migre la configuración provisional existente cuando el control de versiones de contenido está habilitado o suspendido. Los datos existentes deben migrarse automáticamente durante la actualización de la implementación, por lo que solo necesitará este comando si la implementación no se actualiza.

Además de Argumentos comunes, este comando acepta los siguientes argumentos:

  • --deployment-name <deployment name>

    (Opcional) Nombre de la implementación para la que se debe migrar la configuración de ensayo.

    El valor predeterminado es la implementación activa actual.

dinámic-content remove-manifest-file

Elimina un archivo del manifiesto de contenido del proyecto.

Además de Argumentos comunes, este comando acepta los siguientes argumentos:

  • --file-name <filename>

    Elimina un archivo del manifiesto de contenido del proyecto. El archivo eliminado coincide con el valor de --file-name que se especifica en el comando add-manifest-file.

  • --manifest-path <manifest_path>

    (Opcional) la ruta y el nombre de archivo del manifiesto que se va a usar. Puede especificar una ruta completa o un nombre de archivo que existe en la carpetagame\DynamicContent\Manifests\.

    El valor predeterminado es game\DynamicContent\Manifests\default.json.

URL de solicitud de contenido dinámico

Solicita una URL para el archivo especificado.

Además de Argumentos comunes, este comando acepta el siguiente argumento:

  • --file-path <file_path>

    El archivo del bucket.

set-staging-status

Establece el estado de fase del archivo especificado.

Además de Argumentos comunes, este comando acepta los siguientes argumentos:

  • --file-path <file_path>

    El archivo del bucket.

  • --version-id <version_id>

    (Opcional) ID de versión del archivo.

    El valor predeterminado es la versión más reciente.

  • --staging-status <PUBLIC|PRIVATE|WINDOW>

    Utilice PUBLIC para hacer público el archivo inmediatamente. Usar WINDOW constart-dateyend-datepara especificar un rango durante el cual el archivo estará disponible públicamente.

  • --start-date <start_date>

    (Opcional) Valor de fecha de inicio para la preparación de ventanas. Utilice NOW o una fecha/hora en formato UTC"Jan 15 2021 14:30".

  • --end-date <end_date>

    (Opcional) Valor de fecha de finalización para la preparación de ventanas. Usar NEVER o una fecha/hora en formato UTC"Jan 31 2021 14:30".

  • --include-children

    (Opcional) Establezca el estado de preparación de todos los paks secundarios.

    El valor predeterminado es falso.

aviso

Existe el riesgo de que se produzca una condición de carrera si se actualiza el estado de preparación de un archivo, mientras que se carga una nueva versión del mismo archivo con un estado de ensayo diferente al mismo tiempo desde otro equipo. El archivo podría acabar con un estado de ensayo inesperado en este caso. Para evitar este problema, especifique el ID de versión al utilizar laset-staging-statuscomando.

Dynamic Content

Mostrar eventos de registro recientes.

Además de Argumentos comunes, este comando acepta los siguientes argumentos:

  • --minutes <minutes>

    (Opcional) El número de minutos de eventos de registro que se mostrarán antes de ahora.

    El valor predeterminado es de 10 minutos.

show-manifest

Muestra todas las entradas del manifiesto de contenido.

Además de Argumentos comunes, este comando acepta los siguientes argumentos:

  • --file-name <filename>

    (Opcional) La entrada de archivo (directorio local + clave) que se va a mostrar.

  • --manifest-path <manifest_path>

    (Opcional) la ruta y el nombre de archivo del manifiesto que se va a usar. Puede especificar una ruta completa o un nombre de archivo que existe en la carpetagame\DynamicContent\Manifests\.

    El valor predeterminado es game\DynamicContent\Manifests\default.json.

  • --manifest-version-id <manifest version ID>

    (Opcional) Versión del paquete de manifiesto independiente. Puede recuperar los ID de versión disponibles mediante ellist-file-versionscomando.

    El valor predeterminado es la versión más reciente.

  • --platform-type <OS_type>

    (Opcional) El tipo de sistema operativo del archivo que se muestra.

  • --section <section>

    (Opcional) Sección que se va a mostrar (PaksorFiles).

show-signature

Muestra la firma que se crea para un archivo especificado.

Además de Argumentos comunes, este comando acepta el siguiente argumento:

  • --file-name <file_name>

    (Opcional) El nombre de archivo para el que se muestra la firma.

control de versiones de suspensión de contenido dinámico

Suspender el control de versiones de contenido dinámico.

Tenga en cuenta que la suspensión del control de versiones no revertirá el bucket de S3 versionado a un estado sin versionar. Los objetos existentes no cambian tras la suspensión, pero el bucket de S3 dejará de acumular nuevas versiones del mismo objeto.

Para reanudar el control de versiones, siga las instrucciones paraHabilitación del versionado de contenido dinámicoen una implementación existente.

Además de Argumentos comunes, este comando acepta los siguientes argumentos:

  • --deployment-name <deployment name>

    (Opcional) Nombre de la implementación para la que se debe suspender el versionado.

    El valor predeterminado es la implementación activa actual.

  • --confirm-versioning-suspension

    (Opcional) Confirma que sabe que este comando suspenderá el versionado de contenido y que necesita volver a habilitar y actualizar la implementación para reanudar el control de versiones. Útil para automatización.

test-signature de contenido dinámico

Prueba si una firma de base64 es válida para la cadena especificada.

Además de Argumentos comunes, este comando acepta los siguientes argumentos:

  • --signature <signature>

    Firma codificada en Base64.

  • --to-sign <string_to_sign>

    La cadena que se va a firmar.

manifiesto de actualización de contenido dinámico

Actualiza el manifiesto con hashes del archivo actual.

Además de Argumentos comunes, este comando acepta el siguiente argumento:

  • --manifest-path <manifest_path>

    (Opcional) la ruta y el nombre de archivo del manifiesto que se va a usar. Puede especificar una ruta completa o un nombre de archivo que existe en la carpetagame\DynamicContent\Manifests\.

    El valor predeterminado es game\DynamicContent\Manifests\default.json.

update-target-platforms dinámica-

Actualiza el sistema operativo de destino de un archivo de manifiesto.

Además de Argumentos comunes, este comando acepta los siguientes argumentos:

  • --manifest-path <manifest_path>

    (Opcional) la ruta y el nombre de archivo del manifiesto que se va a usar. Puede especificar una ruta completa o un nombre de archivo que existe en la carpetagame\DynamicContent\Manifests\.

    El valor predeterminado es game\DynamicContent\Manifests\default.json.

  • --target-platforms <target_OS> [<target_OS> ...]

    (Opcional) Sistemas operativos actualizados para este nuevo manifiesto (el valor predeterminado es todos los sistemas operativos y dispositivos compatibles).

dinámico-upload-manifest-content

Actualiza el manifiesto y carga el contenido del manifiesto cambiado en el bucket de contenido.

Además de Argumentos comunes, este comando acepta los siguientes argumentos:

  • --manifest-path <manifest_path>

    (Opcional) la ruta y el nombre de archivo del manifiesto que se va a usar. Puede especificar una ruta completa o un nombre de archivo que existe en la carpetagame\DynamicContent\Manifests\.

    El valor predeterminado es game\DynamicContent\Manifests\default.json.

  • --deployment-name <deployment name>

    (Opcional) En qué implementación cargar contenido.

    El valor predeterminado es la implementación activa actual.

  • --staging-status <PUBLIC|PRIVATE|WINDOW>

    (opcional) Utilice PUBLIC para hacer que el contenido sea público de forma inmediata. Usar WINDOW constart-dateyend-datepara especificar un rango durante el cual el contenido estará disponible públicamente.

    El valor predeterminado es PRIVADO.

  • --start-date <start_date>

    (Opcional) Valor de fecha de inicio para la preparación de ventanas. Utilice NOW o una fecha/hora en formato UTC"Jan 15 2021 14:30".

  • --end-date <end_date>

    (Opcional) Valor de fecha de finalización para la preparación de ventanas. Usar NEVER o una fecha/hora en formato UTC"Jan 31 2021 14:30".

  • --signing

    (Opcional) Añada firmas de archivos a la tabla de contenido para la verificación del lado del cliente.

    El valor predeterminado no tiene firma.

  • --invalidate-existing-files

    (Opcional) Invalide los archivos existentes con el mismo nombre en la caché perimetral de CloudFront. Solo es efectivo si el contenido dinámico se entrega a través de CloudFront. Para obtener más información sobre el uso de este servicio con contenido dinámico, consulte el tema deUso de Amazon CloudFront.

    El valor predeterminado no tiene invalidación.

  • --replace

    (Opcional) Elimina las versiones anteriores cuando se ha cargado una nueva versión.

  • --all

    (opcional) actualiza todo el contenido del manifiesto independientemente de si parece que ya se han actualizado.