Añadir una versión del paquete a Distributor - AWS Systems Manager
Añadir una versión del paquete (consola)Añadir una versión del paquete (AWS CLI)

Añadir una versión del paquete a Distributor

Para agregar una versión del paquete, cree un paquete y, a continuación, utilice Distributor para agregar una versión del paquete mediante la incorporación de una entrada en el documento AWS Systems Manager SSM que ya existe para las versiones anteriores. Distributor es una capacidad de AWS Systems Manager. Para ahorrar tiempo, actualice el manifiesto de una versión anterior del paquete, cambie el valor de la entrada version en el manifiesto (por ejemplo, de Test_1.0 a Test_2.0) y guárdelo como el manifiesto de la nueva versión. El flujo de trabajo simple Añadir versión en la Distributor consola actualiza el archivo de manifiesto por usted.

Una nueva versión del paquete puede:

  • Sustituya al menos uno de los archivos instalables asociados a la versión actual.

  • Añada nuevos archivos instalables para admitir plataformas adicionales.

  • Elimine archivos para cesar la compatibilidad con plataformas específicas.

Una versión más reciente puede utilizar el mismo bucket de Amazon Simple Storage Service (Amazon S3), pero debe tener una URL con otro nombre de archivo mostrado al final. Puede utilizar la consola de Systems Manager o la AWS Command Line Interface (AWS CLI) para agregar la nueva versión. Cargar un archivo instalable con el nombre exacto de un archivo instalable existente en el bucket de Amazon S3 sobrescribe el archivo existente. No se copian archivos instalables de la versión anterior a la nueva versión; debe cargar archivos instalables de la versión anterior para que formen parte de una nueva versión. Una vez que Distributor haya terminado de crear su nueva versión del paquete, puede eliminar o reutilizar el bucket de Amazon S3, ya que Distributor copia su software en un bucket de Systems Manager interno como parte del proceso de control de versiones.

nota

Cada paquete está limitado a un máximo de 25 versiones. Puede eliminar las versiones que ya no sean necesarias.

Añadir una versión del paquete (consola)

Antes de realizar estos pasos, siga las instrucciones de Crear un paquete para crear un nuevo paquete de la versión. A continuación, utilice la consola de Systems Manager para agregar una nueva versión del paquete a Distributor.

Añadir una versión del paquete (simple)

Para añadir una versión del paquete mediante el flujo de trabajo Simple, prepare archivos instalables actualizados o añade archivos instalables para admitir más plataformas y arquitecturas. A continuación, utiliceDistributor para cargar archivos instalables nuevos y actualizados y añada una versión del paquete. El flujo de trabajo simplificado Añadir versión en la Distributor consola actualiza el archivo de manifiesto y documento de SSM asociados por usted.

Para añadir una versión del paquete (simple)

  1. Abra la consola de AWS Systems Manager en https://console.aws.amazon.com/systems-manager/.

  2. En el panel de navegación, elija Distributor.

  3. En la página de inicio de Distributor, elija el paquete en el que desee añadir otra versión.

  4. En la página Añadir versión, seleccione simple.

  5. En Version Name (Nombre de la versión), escriba un nombre de versión. El nombre de la versión para la nueva versión debe ser diferente de los nombres de versiones anteriores. Los nombres de las versiones pueden tener un máximo de 512 caracteres y no pueden contener caracteres especiales.

  6. Para nombre de bucket de S3, elija un bucket de S3 existente de la lista. Este puede ser el mismo bucket que utilizó para almacenar archivos instalables para versiones anteriores, pero los nombres de los archivos instalables deben ser diferentes para evitar sobrescribir los archivos instalables existentes en el bucket.

  7. En S3 key prefix (Prefijo de clave de S3), escriba la subcarpeta del bucket donde se almacenan sus recursos instalables.

  8. En Upload software (Cargar software), diríjase a los archivos de software instalable que desea adjuntar a la nueva versión. Los archivos instalables de versiones existentes no se copian automáticamente a una nueva versión; debe cargar cualquier archivo instalable de versiones anteriores del paquete si desea que alguno de los mismos archivos instalables forme parte de la nueva versión. Puede cargar más de un archivo de software en una única acción.

  9. Para la plataforma de destino, verifique que la plataforma del sistema operativo de destino que se muestra para cada archivo instalable sea correcta. Si el sistema operativo que se muestra no es correcto, seleccione el sistema operativo correcto en la lista desplegable.

    En el flujo de trabajo simple, ya que carga cada archivo una sola vez, se requieren pasos adicionales para dirigirse a un único archivo en varios sistemas operativos. Por ejemplo, si carga un archivo de software instalable denominado Logtool_v1.1.1.rpm, debe cambiar algunos valores predeterminados en el flujo de trabajo simple para dirigir Distributor al mismo software en los sistemas operativos Amazon Linux y Ubuntu. Puede elegir una de las opciones siguientes para evitar esta limitación.

    • Utilice el flujo de trabajo avanzado en su lugar, comprima cada archivo instalable en un archivo .zip antes de comenzar, y cree manualmente el manifiesto para que un archivo instalable pueda ser dirigido a varias plataformas o versiones del sistema operativo. Para obtener más información, consulte Añadir una versión del paquete (avanzado).

    • Edite manualmente el archivo de manifiesto en el flujo de trabajo simple para que su archivo .zip esté dirigido a múltiples plataformas o versiones del sistema operativo. Para obtener más información acerca de cómo hacerlo, consulte el final del paso 4 en Paso 2: crear el manifiesto del paquete JSON.

  10. En Platform version (Versión de la plataforma), verifique que la versión de la plataforma del sistema operativo que se muestra sea _any, una versión de lanzamiento principal seguida de una comodín (7.*) o la versión exacta de lanzamiento del sistema operativo a la que desea que se aplique su software. Para obtener más información sobre cómo especificar una versión de la plataforma, consulte el paso 4 en Paso 2: crear el manifiesto del paquete JSON.

  11. Para Arquitectura, elija la arquitectura de procesador correcta para cada archivo instalable de la lista desplegable. Para obtener más información acerca de las arquitecturas compatibles, consulte Plataformas de paquetes y arquitecturas admitidas.

  12. (Opcional) Expanda los scripts y revise los scripts de instalación y desinstalación que Distributor genera para su software instalable.

  13. Para añadir más archivos de software instalable a la nueva versión, seleccione Añadir software. De no ser así, vaya al siguiente paso.

  14. (Opcional) Expanda el manifiesto, y revise el manifiesto del paquete JSON que Distributor genera para su software instalable. Si cambió cualquier información sobre su software instalable desde que comenzó este procedimiento, como la versión de plataforma o la plataforma de destino, elija Generar manifiesto para mostrar el manifiesto actualizado del paquete.

    Puede editar el manifiesto manualmente si desea dirigirlo a un software instalable en más de un sistema operativo, como se describe en el paso 9. Para obtener más información sobre cómo editar el manifiesto, consulte Paso 2: crear el manifiesto del paquete JSON.

  15. Cuando haya terminado de añadir software y revisar la plataforma de destino, la versión y los datos de arquitectura, seleccione Añadir versión.

  16. Espere Distributor para terminar la carga de su software y crear la nueva versión del paquete. Distributor muestra el estado de carga para cada archivo instalable. En función del número y el tamaño de los paquetes que se agreguen, esto puede tardar unos minutos. Distributor automáticamente le redirige a la página de detalles del paquete,pero puede elegir abrir esta página por sí mismo después de que el software se hayan cargado. La página Detalles del paquete no muestra toda la información sobre el paquete hasta que Distributor termina de crear la nueva versión del paquete. Para detener la versión del paquete de carga y creación, elija Detener carga.

  17. Si Distributor no puede cargar cualquiera de los archivos de instalación de software, muestra un mensaje de Upload failed (Carga fallida). Para volver a intentar la carga, elija Reintentar carga. Para obtener más información sobre cómo solucionar errores de creación de versión del paquete, consulte Solución de problemas de AWS Systems ManagerDistributor.

  18. Cuando Distributor haya terminado de crear la nueva versión del paquete, en la página de Detalles del paquete, en la pestaña Versiones, vea la nueva versión en la lista de versiones de paquete disponibles. Establezca una versión predeterminada del paquete; para ello, elija una versión y, a continuación, elija Set default version (Establecer versión predeterminada).

    Si no establece una versión predeterminada, la versión del paquete más reciente es la versión predeterminada.

Añadir una versión del paquete (avanzado)

Para añadir una versión del paquete, cree un paquete, y después use Distributor para añadir una versión del paquete incorporando una entrada en el documento SSM que ya existe para las versiones anteriores. Para ahorrar tiempo, actualice el manifiesto de una versión anterior del paquete, cambie el valor de la entrada version en el manifiesto (por ejemplo, de Test_1.0 a Test_2.0) y guárdelo como el manifiesto de la nueva versión. Debe tener un manifiesto actualizada para añadir una nueva versión del paquete utilizando el flujo de trabajo avanzado.

Para añadir una versión del paquete (avanzado)

  1. Abra la consola de AWS Systems Manager en https://console.aws.amazon.com/systems-manager/.

  2. En el panel de navegación, elija Distributor.

  3. En la página de Distributor inicio, elija el paquete a la que desea añadir otra versión y, a continuación, elija Añadir versión.

  4. En Version name (Nombre de versión), escriba el valor exacto que se encuentra en la entrada version en su archivo de manifiesto.

  5. Para nombre de bucket de S3, elija un bucket de S3 existente de la lista. Este puede ser el mismo bucket que utilizó para almacenar archivos instalables para versiones anteriores, pero los nombres de los archivos instalables deben ser diferentes para evitar sobrescribir los archivos instalables existentes en el bucket.

  6. En S3 key prefix (Prefijo de clave de S3), escriba la subcarpeta del bucket donde se almacenan sus recursos instalables.

  7. En Manifest (Manifiesto), elija Extract from package (Extraer del paquete) para utilizar un manifiesto que cargó al bucket de S3 con sus archivos .zip.

    (Opcional) Si no cargó el manifiesto JSON revisado al bucket de Amazon S3 donde guardó los archivos .zip, elija New manifest (Nuevo manifiesto). Puede crear o pegar todo el manifiesto en el campo de edición de JSON. Para obtener más información sobre cómo crear el manifiesto JSON, consulte Paso 2: crear el manifiesto del paquete JSON.

  8. Cuando haya terminado con el manifiesto, seleccione Agregar versión del paquete.

  9. En la página Details (Detalles) del paquete, en la pestaña Versions (Versiones), vea la nueva versión en la lista de versiones de paquete disponibles. Establezca una versión predeterminada del paquete; para ello, elija una versión y, a continuación, elija Set default version (Establecer versión predeterminada).

    Si no establece una versión predeterminada, la versión del paquete más reciente es la versión predeterminada.

Añadir una versión del paquete (AWS CLI)

Puede utilizar la AWS CLI para añadir una nueva versión del paquete a Distributor. Antes de ejecutar estos comandos, debe crear una nueva versión del paquete y cargarlo en S3, tal y como se describe al principio de este tema.

Para añadir una versión del paquete (AWS CLI)

  1. Ejecute el siguiente comando para editar el documento de AWS Systems Manager con una entrada para una nueva versión del paquete. Sustituya document-name por el nombre de su documento. Sustituya amzn-s3-demo-bucket con la URL del manifiesto JSON que copió en Paso 3: cargar el paquete y el manifiesto en un bucket de Amazon S3. S3-bucket-URL-of-package es la URL del bucket de Amazon S3 donde se almacena el paquete completo. Sustituya version-name-from-updated-manifest por el valor de version en el manifiesto. Establezca el parámetro --document-version en $LATEST para que el documento asociado a esta versión del paquete sea la versión más reciente del documento.

    aws ssm update-document \
    --name "document-name" \
    --content "S3-bucket-URL-to-manifest-file" \
    --attachments Key="SourceUrl",Values="amzn-s3-demo-bucket" \
    --version-name version-name-from-updated-manifest \
    --document-version $LATEST

    A continuación, se muestra un ejemplo.

    aws ssm update-document \
    --name ExamplePackage \
    --content "https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage/manifest.json" \
    --attachments Key="SourceUrl",Values="https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage" \
    --version-name 1.1.1 \
    --document-version $LATEST

  2. Ejecute el siguiente comando para verificar que el paquete se ha actualizado y muestra el manifiesto de paquete. Sustituya package-name por el nombre de su paquete y, si lo desea, document-version por el número de versión del documento (no coincide con la versión del paquete) que actualizó. Si esta versión del paquete está asociada a la versión más reciente del documento, puede especificar $LATEST para el valor del parámetro --document-version opcional.

    aws ssm get-document \
    --name "package-name" \
    --document-version "document-version"

Para obtener más información acerca de otras opciones que puede utilizar con el comando update-document, consulte update-document en la sección sobre AWS Systems Manager de la Referencia de comandos de la AWS CLI.