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

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 va a añadir.

  • --manifest-path <manifest_path>

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

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

  • --pak-file <pak_file>

    El 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-file

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 el directorio local esstaticdata/csv/.

  • --cache-root <cache directory>

    (Opcional) La 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 del archivo de manifiesto que se va a usar. Puede especificar una ruta de acceso completa o un nombre de archivo que exista en la carpetagame\DynamicContent\Manifests\.

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

  • --output-root <default directory path>

    (opcional) la 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 del archivo de manifiesto que se va a usar. Puede especificar una ruta de acceso completa o un nombre de archivo que exista en la carpetagame\DynamicContent\Manifests\.

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

  • --pak-name <pak_name>

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

  • --platform-type <OS_type>

    (Opcional) El tipo de sistema operativo para.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 todos.pakindependientemente de los resultados de la comprobación de archivos.

  • --manifest-path <manifest_path>

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

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

clean-content 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 de los archivos de manifiesto y 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 en el depósito de contenido y que no podrá revertir ninguna versión anterior después de esta operación. Útil para la automatización.

compare-bucket-content

Compara el contenido de manifiesto con el bucket mediante la comprobación de metadatos HEAD.

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

  • --manifest-path <manifest_path>

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

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

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

    (Opcional) Versión del pak de manifiesto independiente. Puede recuperar los Id. de versión disponibles utilizando la herramientalist-file-versionscomando.

    La versión predeterminada es la más reciente.

create-content create-new-manifest

Crea un manifiesto nuevo.

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

  • --manifest-name <manifest_name>

    El nombre del nuevo manifiesto.

  • --manifest-path <manifest_path>

    (Opcional) la ruta del archivo de manifiesto que se va a usar. Puede especificar una ruta de acceso completa o un nombre de archivo que exista 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-borrado-contenido cargado

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 en el bucket.

  • --version-id <version_id>

    (Opcional) ID de versión del archivo.

    La versión predeterminada es la 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.

generade-content

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 la clave que se va a usar.

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 del archivo de manifiesto que se va a usar. Puede especificar una ruta de acceso completa o un nombre de archivo que exista en la carpetagame\DynamicContent\Manifests\.

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

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

    (Opcional) Versión del pak de manifiesto independiente. Puede recuperar los Id. de versión disponibles utilizando la herramientalist-file-versionscomando.

    La versión predeterminada es la más reciente.

lista-archivo-versiones dinámico-contenido

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

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

  • --file-name <filename>

    (Opcional) Nombre del archivo de manifiesto o pak.

contenido dinámico-cargado-contenido

Enumera todo el contenido cargado.

LaArgumentos comunestambién se puede utilizar con este comando.

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

Migre la configuración de ensayo existente cuando la versión de contenido está habilitada o suspendida. Los datos existentes se deben migrar 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.

archivo de manifest-file dinámico content

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 del archivo de manifiesto que se va a usar. Puede especificar una ruta de acceso completa o un nombre de archivo que exista 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-dynamic-content 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.

    La versión predeterminada es la más reciente.

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

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

  • --start-date <start_date>

    (Opcional) Valor de fecha de inicio para el almacenamiento provisional en ventana. 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 el almacenamiento provisional en ventana. Utilice NEVER o una fecha/hora en formato UTC"Jan 31 2021 14:30".

  • --include-children

    (Opcional) Establezca el estado de ensayo para todos los paks secundarios.

    El valor predeterminado es falso.

aviso

Existe el riesgo de una condición de carrera si el estado de ensayo de un archivo se actualiza mientras se carga una nueva versión del mismo archivo con un estado provisional diferente al mismo tiempo desde un equipo diferente. El archivo podría terminar con un estado de ensayo inesperado en este caso. Para evitar este problema, especifique el ID de versión al usar la herramienta deset-staging-statuscomando.

registros de presentación de contenido dinámico

Mostrar eventos de registro recientes.

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

  • --minutes <minutes>

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

    El valor predeterminado es 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 del archivo de manifiesto que se va a usar. Puede especificar una ruta de acceso completa o un nombre de archivo que exista en la carpetagame\DynamicContent\Manifests\.

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

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

    (Opcional) Versión del pak de manifiesto independiente. Puede recuperar los Id. de versión disponibles utilizando la herramientalist-file-versionscomando.

    La versión predeterminada es la más reciente.

  • --platform-type <OS_type>

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

  • --section <section>

    (Opcional) La sección para 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.

suspensión de versiones 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 S3 versionado a un estado sin versionar. Los objetos existentes no cambian después de la suspensión, pero el bucket de S3 dejará de acumularse nuevas versiones del mismo objeto.

Para reanudar el control de versiones, siga las instrucciones paraHabilitar el control de versiones 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 control de versiones.

    El valor predeterminado es la implementación activa actual.

  • --confirm-versioning-suspension

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

test-signature

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.

content dynamic-content

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 del archivo de manifiesto que se va a usar. Puede especificar una ruta de acceso completa o un nombre de archivo que exista en la carpetagame\DynamicContent\Manifests\.

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

update-platforms de

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 del archivo de manifiesto que se va a usar. Puede especificar una ruta de acceso completa o un nombre de archivo que exista 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).

upload-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 del archivo de manifiesto que se va a usar. Puede especificar una ruta de acceso completa o un nombre de archivo que exista en la carpetagame\DynamicContent\Manifests\.

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

  • --deployment-name <deployment name>

    (Opcional) A qué implementación se va a cargar contenido.

    El valor predeterminado es la implementación activa actual.

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

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

    El valor predeterminado es PRIVATE.

  • --start-date <start_date>

    (Opcional) Valor de fecha de inicio para el almacenamiento provisional en ventana. 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 el almacenamiento provisional en ventana. Utilice NEVER o una fecha/hora en formato UTC"Jan 31 2021 14:30".

  • --signing

    (Opcional) Agregue firmas de archivo a la tabla de contenido para la verificación del lado del cliente.

    El valor predeterminado es que no hay firma.

  • --invalidate-existing-files

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

    El valor predeterminado es que no hay invalidación.

  • --replace

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

  • --all

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