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.
# Introducción al Catálogo de paquetes de software
Puede crear y mantener el catálogo de paquetes de AWS IoT Device Management software mediante Consola de administración de AWS las operaciones de AWS IoT Core API y AWS Command Line Interface (AWS CLI).
**nota**
Habilitar AWS IoT la indexación de la flota es un requisito para utilizar Software Package Catalog. Las operaciones básicas, como la creación de una versión de un paquete de software en el comando API Consola de administración de AWS y el uso del comando `CreatePackage` API, fallarán si no está habilitada la indexación de la AWS IoT flota.
Para obtener más información sobre el uso de la indexación de AWS IoT flotas con Software Package Catalog, consulte[Preparación para la indexación de flotas](preparing-fleet-indexing.md).
**Uso de la consola**
Para utilizarla Consola de administración de AWS, inicie sesión en su AWS cuenta y navegue hasta [AWS IoT Core](https://console.aws.amazon.com/iot/home). En el panel de navegación, seleccione **Paquetes de software**. A continuación, puede crear y gestionar los paquetes y sus versiones desde esta sección.
**Uso de operaciones de API o CLI**
Puede usar las operaciones de la AWS IoT Core API para crear y administrar las funciones del Catálogo de Paquetes de Software. Para obtener más información, consulte la [referencia [AWS SDKs y los kits de herramientas](https://aws.amazon.com/developer/tools/) de las AWS IoT API](https://docs.aws.amazon.com/iot/latest/apireference/). Los AWS CLI comandos también administran su catálogo. Para obtener más información, consulte la [Referencia de comandos de CLI AWS IoT](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/index.html).
**Topics**
+ [Crear un paquete de software y una versión del paquete](creating-package-and-version.md)
+ [Implementación de una versión de paquete mediante trabajos AWS IoT](deploying-package-version.md)
+ [Asociar una versión de paquete a cualquier cosa AWS IoT](associating-package-version.md)
# Crear un paquete de software y una versión del paquete
Puede seguir los siguientes pasos para crear un paquete y una versión inicial mediante la Consola de administración de AWS.
**Para crear un paquete de software**
1. Inicie sesión en su AWS cuenta y vaya a la [AWS IoT consola](https://console.aws.amazon.com/iot/home).
1. En el panel de navegación, seleccione **Paquetes de software**.
1. En la página **del paquete de software AWS IoT **, elija **Crear paquete**. Aparece el cuadro de diálogo **Habilitar dependencias para la administración de paquetes**.
1. En **Indexación de flotas**, seleccione **Agregar paquetes y versiones de software del dispositivo**. Esto es obligatorio para el catálogo de paquetes de software y proporciona indexación de la flota y métricas sobre su flota.
1. [Opcional] Si desea que los AWS IoT trabajos actualicen la sombra con el nombre reservado cuando los trabajos se completen correctamente, seleccione **Actualizar automáticamente las sombras de los trabajos**. Si no desea que los AWS IoT trabajos realicen esta actualización, deje esta casilla de verificación sin seleccionar.
1. [Opcional] Para conceder a los AWS IoT trabajos los derechos de actualización de la sombra reservada denominada, en **Seleccionar función**, seleccione **Crear** función. Si no quieres que AWS IoT Jobs realice esta actualización, este rol no es obligatorio.
1. Crear o seleccionar un rol.
1. Si **no tiene un rol** para este propósito: cuando aparezca el cuadro de diálogo **Crear rol**, introduzca el **nombre del rol** y, a continuación, elija **Crear**.
1. Si **tiene un rol para este propósito: en **Seleccionar rol, elija su rol** y, a continuación, asegúrese de que** la casilla **asociar política al rol de IAM** esté seleccionada.
1. Elija **Confirmar**. Aparece la página **Crear nuevo paquete**.
1. En **Detalles del paquete**, introduzca un **nombre de paquete**.
1. En la **Descripción del paquete**, introduzca información que le ayude a identificar y gestionar este paquete.
1. [Opcional] Puede utilizar etiquetas como ayuda para clasificar y administrar este paquete. Para añadir etiquetas, expanda **Etiquetas**, seleccione **Añadir etiqueta** e introduzca un par clave-valor. Puede añadir hasta 50 etiquetas. Para obtener más información, consulte [Etiquetar AWS IoT los recursos](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html).
**Para añadir una versión de paquete al crear un paquete nuevo**
1. En **Versión inicial**, introduzca un **Nombre de la versión**.
Recomendamos utilizar el [SemVer formato](https://semver.org/) (por ejemplo,`1.0.0.0`) para identificar de forma exclusiva la versión del paquete. También puede utilizar una estrategia de formato diferente que se adapte mejor a su caso de uso. Para obtener más información, consulte [Ciclo de vida de la versión de paquete](preparing-to-use-software-package-catalog.md#package-version-lifecycle).
1. En la **Descripción del paquete**, introduzca información que le ayude a identificar y gestionar esta versión del paquete.
**nota**
La casilla de verificación **Versión predeterminada** está desactivada porque las versiones de los paquetes se crean en un estado `draft`. Puede asignar un nombre a la versión predeterminada después de crear la versión del paquete y al cambiar el estado a `published`. Para obtener más información, consulte [Ciclo de vida de la versión de paquete](preparing-to-use-software-package-catalog.md#package-version-lifecycle).
1. [Opcional] Para ayudarle a gestionar esta versión o para comunicar información a sus dispositivos, introduzca uno o más pares nombre-valor para los **atributos de Versión**. Seleccione **Añadir atributo** para cada par de nombre-valor que introduzca. Para obtener más información, consulte [Atributos de la versión](preparing-to-use-software-package-catalog.md#version-attributes).
1. [Opcional] Puede utilizar etiquetas como ayuda para clasificar y administrar este paquete. Para añadir etiquetas, expanda **Etiquetas**, seleccione **Añadir etiqueta** e introduzca un par clave-valor. Puede añadir hasta 50 etiquetas. Para obtener más información, consulte [Etiquetar AWS IoT los recursos](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html).
1. Elija **Siguiente**.
**Asociación de la lista de materiales de software con una versión de paquete (opcional)**
1. En el **paso 3: Versión SBOMs (opcional)** de la ventana de **configuraciones de la SBOM**, elija el formato de archivo de la SBOM y el modo de validación predeterminados que se utilizan para validar la lista de materiales del software antes de asociarla a la versión del paquete.
1. En la ventana **Agregar archivo SBOM**, introduzca el nombre de recurso de Amazon (ARN) que representa su bucket de Amazon S3 con control de versiones y el formato de archivo SBOM preferido si el tipo predeterminado no funciona.
**nota**
Puede añadir un único archivo SBOM o un único archivo zip que contenga varios SBOMs si tiene más de una lista de materiales de software para la versión del paquete.
1. En la ventana del archivo **Archivo SBOM agregado**, puede ver el archivo SBOM que ha agregado para la versión del paquete.
1. Seleccione **Crear paquete y versión**. Aparece la página de la versión del paquete donde puede ver el estado de validación del archivo SBOM en la ventana **Archivo SBOM agregado**. El estado inicial será `In progress` cuando el archivo SBOM se someta a validación.
**nota**
Los estados de validación del archivo SBOM son `Invalid file`, `Not started`, `In progress`, `Validated (SPDX)`, `Validated (CycloneDX)` y los motivos del error de validación.
# Implementación de una versión de paquete mediante trabajos AWS IoT
Puede utilizar los siguientes pasos para desplegar una versión del paquete a través de la Consola de administración de AWS.
**Requisitos previos**:
Antes de comenzar, haga lo siguiente:
+ Registra AWS IoT cosas con AWS IoT Core. Para obtener instrucciones sobre cómo añadir tus dispositivos AWS IoT Core, consulta [Crear un objeto objeto](https://docs.aws.amazon.com/iot/latest/developerguide/create-iot-resources.html#create-aws-thing).
+ [Opcional] Cree un grupo de AWS IoT cosas o un grupo de cosas dinámico para dirigirse a los dispositivos en los que va a implementar la versión del paquete. Para obtener instrucciones sobre cómo crear un grupo de cosas, consulte [Crear un grupo de cosas estático](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html#create-thing-group). Para obtener instrucciones sobre cómo crear un grupo de cosas dinámico, consulte [Crear un grupo de cosas dinámico](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html#create-dynamic-thing-group).
+ Cree un paquete de software y una versión del paquete. Para obtener más información, consulte [Crear un paquete de software y una versión del paquete](creating-package-and-version.md).
+ Creación de un documento de trabajo Para más información, consulte [Preparar el documento de trabajo y la versión del paquete para su implementación](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-jobs-for-service-package-catalog.html#preparing-to-deploy).
**Para implementar un AWS IoT trabajo**
1. En la [consola de AWS IoT](https://console.aws.amazon.com/iot/home), elija **Paquetes de software**.
1. Elija el paquete de software que desee implementar. Aparecerá la **página de detalles del paquete de software**.
1. Elija la versión del paquete que desea implementar, en **Versiones**, y elija **Implementar la versión del trabajo**.
1. Si es la primera vez que implementa un trabajo a través de este portal, aparecerá un cuadro de diálogo en el que se describen los requisitos. Revise la información y seleccione **Reconocer**.
1. Introduzca un nombre para la implementación o deje el nombre generado automáticamente en el campo **Nombre**.
1. [Opcional] En el campo **Descripción**, introduzca una descripción que identifique el propósito o el contenido de la implementación, o deje la información generada automáticamente.
**Nota:** Le recomendamos que no utilice información personal identificable en los campos Nombre del puesto y Descripción.
1. [Opcional] Añada las etiquetas que desee asociar a este trabajo.
1. Elija **Siguiente**.
1. En **Objetivos del trabajo**, elija las cosas o grupos de cosas que deben recibir el trabajo.
1. En el campo **Archivo de trabajo**, especifique el archivo JSON del documento de trabajo.
1. Integración de **Open Jobs con el servicio Catálogo de paquetes**.
1. Seleccione los paquetes y las versiones que se especifican en su documento de trabajo.
**nota**
Debe elegir los mismos paquetes y versiones de paquetes que se especifican en el documento de trabajo. Puede incluir más, pero el trabajo solo emitirá instrucciones para los paquetes y las versiones incluidos en el documento de trabajo. Para obtener más información, consulte [Asignar un nombre a los paquetes y las versiones al implementarlos](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-jobs-for-service-package-catalog.html#naming-package-versions).
1. Elija **Siguiente**.
1. En la página Configuración del trabajo, seleccione uno de los siguientes tipos de trabajo en el cuadro de diálogo Configuración del trabajo:
+ **Trabajo de instantánea**: un trabajo de instantánea está completo cuando termina de ejecutarse en los dispositivos y grupos de destino.
+ **Trabajo continuo**: un trabajo continuo se aplica a grupos de objetos y se ejecuta en cualquier dispositivo que luego se añada a un grupo de destino específico.
1. En el cuadro de diálogo **Configuraciones adicionales (opcional)**, revise las siguientes configuraciones de trabajo opcionales y seleccione las opciones correspondientes: Para obtener más información, consulte Configuraciones de [despliegue, programación y cancelación de trabajos y Configuraciones](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-configurations-details.html#job-rollout-abort-scheduling) de [tiempo de espera y reintento de ejecución de trabajos](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-configurations-details.html#job-timeout-retry).
+ Configuración de despliegue
+ Configuración de programación
+ Configuración del tiempo de espera de ejecuciones de trabajo
+ Configuración de reintento de ejecución de trabajos
+ Configuración de anulación
1. Revise las selecciones de trabajos y, a continuación, elija **Enviar**.
Después de crear el trabajo, la consola genera una firma JSON y la coloca en su documento del trabajo. Puede usar la AWS IoT consola para ver el estado de un trabajo o cancelar o eliminar un trabajo. Para gestionar los trabajos, vaya al [Centro de trabajos de la consola](https://console.aws.amazon.com/iot/home#/jobhub).
# Asociar una versión de paquete a cualquier cosa AWS IoT
Después de instalar el software en el dispositivo, puedes asociar una versión de paquete a una AWS IoT cosa reservada llamada shadow. Si se ha configurado AWS IoT jobs para actualizar el objeto reservado denominado shadow después de que el trabajo se haya desplegado y finalizado correctamente, no es necesario que complete este procedimiento. Para obtener más información, consulte [Sombra con nombre reservado](preparing-to-use-software-package-catalog.md#reserved-named-shadow).
**Requisitos previos**:
Antes de comenzar, haga lo siguiente:
+ Cree una o AWS IoT varias cosas y establezca la telemetría mediante ella. AWS IoT Core Para obtener más información, consulte [Cómo empezar](https://docs.aws.amazon.com/iot/latest/developerguide/iot-gs.html) con. AWS IoT Core
+ Cree un paquete de software y una versión del paquete. Para obtener más información, consulte [Crear un paquete de software y una versión del paquete](creating-package-and-version.md).
+ Instale el software de la versión empaquetada en el dispositivo.
**nota**
Al asociar una versión de paquete a AWS IoT algo, no se actualiza ni instala el software en el dispositivo físico. La versión del paquete debe implementarse en el dispositivo.
**Para asociar una versión de paquete a algo AWS IoT**
1. En el panel de navegación de la [consola de AWS IoT](https://console.aws.amazon.com/iot/home), expanda el menú **Todos los dispositivos** y seleccione **Cosas**.
1. Identifique AWS IoT el elemento que desea actualizar en la lista y elija el nombre del elemento para mostrar su página de detalles.
1. En la sección **Detalles**, seleccione **Paquetes y versiones**.
1. Seleccione **Añadir al paquete y a la versión**.
1. En **Elegir un paquete de dispositivos**, elija el paquete de software que desee.
1. En **Elija una versión**, elija la versión de software que desee.
1. Seleccione **Añadir paquete de dispositivo**.
El paquete y la versión aparecen en la lista de **paquetes y versiones seleccionados**.
1. Repita estos pasos para cada paquete y versión que desee asociar a esta cosa.
1. Cuando haya terminado, elija **Agregar detalles del paquete y la versión**. Se abre la página de **detalles de la cosa** y podrá ver el nuevo paquete y la nueva versión en la lista.