As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Conceitos básicos do Catálogo de pacotes de software
Você pode criar e manter o Catálogo AWS IoT Device Management de Pacotes de Software por meio das Console de gerenciamento da AWS operações de AWS IoT Core API e AWS Command Line Interface (AWS CLI).
**nota**
Habilitar a indexação de AWS IoT frotas é um requisito para usar o Software Package Catalog. Operações básicas, como criar uma versão de pacote de software no Console de gerenciamento da AWS e usar o comando da `CreatePackage` API, falharão sem a indexação de AWS IoT frota ativada.
Para obter mais informações sobre como usar a indexação de AWS IoT frotas com o Software Package Catalog, consulte[Preparação da indexação de frota](preparing-fleet-indexing.md).
**Como usar o console**
Para usar o Console de gerenciamento da AWS, faça login em sua AWS conta e navegue até [AWS IoT Core](https://console.aws.amazon.com/iot/home). No painel de navegação, escolha a opção **Pacotes do software**. Você pode criar e gerenciar pacotes e suas versões nesta seção.
**Uso de operações de API ou CLI**
Você pode usar as operações de AWS IoT Core API para criar e gerenciar recursos do Software Package Catalog. Para obter mais informações, consulte [Referência [AWS SDKs e kits de ferramentas de AWS IoT](https://aws.amazon.com/developer/tools/) API](https://docs.aws.amazon.com/iot/latest/apireference/). Os AWS CLI comandos também gerenciam seu catálogo. Para obter mais informações, consulte a opção [AWS IoT Referência de comandos da CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/index.html).
**Topics**
+ [Criação de um pacote de software e uma versão do pacote](creating-package-and-version.md)
+ [Implantando uma versão do pacote por meio de trabalhos AWS IoT](deploying-package-version.md)
+ [Associando uma versão de pacote a qualquer coisa AWS IoT](associating-package-version.md)
# Criação de um pacote de software e uma versão do pacote
Você pode usar as etapas a seguir para criar um pacote e uma versão inicial por meio do Console de gerenciamento da AWS.
**Para criar um pacote de software**
1. Faça login na sua AWS conta e navegue até o [AWS IoT console](https://console.aws.amazon.com/iot/home).
1. No painel de navegação lateral, selecione **Pacotes do software**.
1. Na página do **AWS IoT pacote de software**, selecione **Criar pacote**. A caixa de diálogo **Habilitar dependências para gerenciamento de pacotes** é exibida.
1. Em **indexação de frota**, selecione **Adicionar pacotes de software e versão do dispositivo**. Isso é necessário para o Catálogo de pacotes de software e fornece indexação de frota e métricas sobre sua frota.
1. [Opcional] Se você quiser que os AWS IoT trabalhos atualizem a sombra nomeada reservada quando os trabalhos forem concluídos com êxito, selecione **Atualizar automaticamente as sombras dos trabalhos**. Se você não quiser que os AWS IoT trabalhos façam essa atualização, deixe essa caixa de seleção desmarcada.
1. [Opcional] Para conceder aos AWS IoT trabalhos o direito de atualizar a sombra nomeada reservada, em **Selecionar função**, escolha **Criar função**. Se você não quiser que os AWS IoT trabalhos façam essa atualização, essa função não é necessária.
1. Crie ou selecione uma função.
1. Se você **não tiver uma função** para essa finalidade: Quando a caixa de diálogo **Criar função** for exibida, insira um **Nome de função** e escolha **Criar**.
1. Se **você tiver uma função** para essa finalidade: em **Selecionar função**, escolha sua função e, em seguida, certifique-se de que a caixa de seleção **Anexar política ao perfil do IAM** esteja marcada.
1. Selecione a opção **Confirmar**. A página **Criar novo pacote** é exibida.
1. Em **Detalhes do pacote**, insira um **Nome do pacote**.
1. Em **Descrição do pacote**, insira as informações para ajudá-lo a identificar e gerenciar esse pacote.
1. [Opcional] Você pode usar tags para ajudar a categorizar e gerenciar esse pacote. Para adicionar tags, expanda **Tags**, escolha **Adicionar** tag e insira um par de valores-chave. É possível inserir até 50 tags. Para obter mais informações, consulte Como [marcar seus AWS IoT recursos](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html).
**Para adicionar uma versão do pacote ao criar um novo pacote**
1. Em **Versão inicial**, insira o **Nome da versão**.
Recomendamos usar o [SemVer formato](https://semver.org/) (por exemplo,`1.0.0.0`) para identificar de forma exclusiva a versão do seu pacote. Você também pode usar uma estratégia de formatação diferente que melhor se adapte ao seu caso de uso. Para obter mais informações, consulte [Ciclo de vida da versão do pacote](preparing-to-use-software-package-catalog.md#package-version-lifecycle).
1. Em **Descrição da versão**, insira as informações que ajudarão você a identificar e gerenciar essa versão do pacote.
**nota**
A caixa de seleção **Versão padrão** está desativada porque as versões do pacote são criadas em um estado `draft`. Você pode nomear a versão padrão após criar a versão do pacote e quando você altera o estado para `published`. Para obter mais informações, consulte [Ciclo de vida da versão do pacote](preparing-to-use-software-package-catalog.md#package-version-lifecycle).
1. [Opcional] Para ajudá-lo a gerenciar essa versão ou comunicar informações aos seus dispositivos, insira um ou mais pares de nome-valor para os **atributos da versão**. Escolha a opção **Adicionar atributo** para cada par nome-valor inserido. Para obter mais informações, consulte [Atributos de versão](preparing-to-use-software-package-catalog.md#version-attributes).
1. [Opcional] Você pode usar tags para ajudar a categorizar e gerenciar esse pacote. Para adicionar tags, expanda **Tags**, escolha **Adicionar** tag e insira um par de valores-chave. É possível inserir até 50 tags. Para obter mais informações, consulte Como [marcar seus AWS IoT recursos](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html).
1. Escolha **Próximo**.
**Associar a lista de materiais de software a uma versão do pacote (opcional)**
1. Na **Etapa 3: Versão SBOMs (opcional)** na janela de **configurações do SBOM**, escolha o formato de arquivo SBOM padrão e o modo de validação usados para validar sua lista de materiais de software antes que ela seja associada à versão do pacote.
1. Na janela **Adicionar arquivo da SBOM**, insira o nome do recurso da Amazon (ARN) representando seu bucket do Amazon S3 com versionamento e o formato de arquivo da SBOM preferido se o tipo padrão não funcionar.
**nota**
Você pode adicionar um único arquivo SBOM ou um único arquivo zip contendo vários SBOMs se tiver mais de uma lista de materiais de software para a versão do seu pacote.
1. Na janela **Arquivo da SBOM adicionado**, você pode visualizar o arquivo SBOM adicionado para a versão do pacote.
1. Escolha **Criar pacote e versão**. A página da versão do pacote é exibida e você pode ver o status de validação do arquivo da SBOM na janela **Arquivo da SBOM adicionado**. O status inicial será `In progress` quando o arquivo da SBOM for validado.
**nota**
Os status de validação do arquivo da SBOM são `Invalid file`, `Not started`, `In progress`, `Validated (SPDX)`, `Validated (CycloneDX)` e os motivos da falha de validação.
# Implantando uma versão do pacote por meio de trabalhos AWS IoT
Você pode usar as etapas a seguir para implantar uma versão do pacote por meio do Console de gerenciamento da AWS.
**Pré-requisitos:**
Antes de começar, faça o seguinte:
+ Registre AWS IoT coisas com AWS IoT Core. Para obter instruções sobre como adicionar seus dispositivos AWS IoT Core, consulte [Criar um objeto](https://docs.aws.amazon.com/iot/latest/developerguide/create-iot-resources.html#create-aws-thing).
+ [Opcional] Crie um grupo de AWS IoT coisas ou grupo dinâmico para atingir os dispositivos nos quais você implantará a versão do pacote. Para obter instruções sobre como criar um grupo de objetos, consulte [Criar um grupo de objetos estático](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html#create-thing-group). Para obter instruções sobre como criar um grupo de objetos dinâmicas, consulte [Criar um grupo de objetos dinâmicas](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html#create-dynamic-thing-group).
+ Crie um pacote de software e uma versão do pacote. Para obter mais informações, consulte [Criação de um pacote de software e uma versão do pacote](creating-package-and-version.md).
+ Criar um documento de trabalho. Para obter mais informações, consulte [Preparação do documento de trabalho e a versão do pacote para implantação](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-jobs-for-service-package-catalog.html#preparing-to-deploy).
**Para implantar um AWS IoT trabalho**
1. No [AWS IoT console](https://console.aws.amazon.com/iot/home), escolha **Pacotes de software**.
1. Escolha o pacote de software que você deseja implantar. A página de **detalhes do pacote de software** é exibida.
1. Escolha a versão do pacote que você deseja implantar, em **Versões**, e escolha **Implantar versão do trabalho**.
1. Se esta for sua primeira vez implantando um trabalho por meio deste portal, uma caixa de diálogo que descreve os requisitos será exibida. Revise as informações e selecione **Confirmar**.
1. Insira um nome para a implantação ou deixe o nome gerado automaticamente no campo **Nome**.
1. [Opcional] No campo **Descrição**, insira uma descrição que identifique a finalidade ou o conteúdo da implantação ou deixe as informações geradas automaticamente.
**Nota:** recomendamos que você não use informações de identificação pessoal nos campos Nome e descrição do trabalho.
1. [Opcional] Adicione qualquer tag para associar a essa tarefa.
1. Escolha **Próximo**.
1. Em **Objetivos da tarefa**, escolha as objetos ou grupos de objetos que devem receber a tarefa.
1. No campo **Arquivo de tarefa**, especifique o arquivo JSON do documento de trabalho.
1. **Integração do Open Jobs com o serviço Catálogo de pacotes**.
1. Selecione os pacotes e as versões especificados em seu documento de trabalho.
**nota**
É necessário escolher os mesmos pacotes e versões de pacotes especificados no documento de trabalho. Você pode incluir mais, mas a tarefa emitirá instruções somente para os pacotes e versões incluídos no documento de trabalho. Para obter mais informações, consulte [Nomeando os pacotes e as versões durante a implantação](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-jobs-for-service-package-catalog.html#naming-package-versions).
1. Escolha **Próximo**.
1. Na página Configuração da tarefa, selecione um dos seguintes tipos de tarefa na caixa de diálogo Configuração da tarefa:
+ **Trabalho de snapshot**: um trabalho de instantâneo é concluído quando termina sua execução nos dispositivos e grupos de destino.
+ **Trabalho contínuo:** um trabalho contínuo se aplica a grupos de objetos e é executado em qualquer dispositivo que você adicione posteriormente a um grupo-alvo especificado.
1. Na caixa de diálogo **Configurações adicionais - opcionais**, revise as seguintes configurações de Trabalho opcionais e faça suas seleções. Para obter mais informações, consulte [Configurações de implantação, agendamento e cancelamento de tarefas ](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-configurations-details.html#job-rollout-abort-scheduling) e [Tempo limite de execução do trabalho e novas configurações](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-configurations-details.html#job-timeout-retry).
+ Configuração de distribuição
+ Configuração de agendamento
+ Configuração de tempo limite de execução de trabalhos
+ Configuração de repetição de execuções de tarefas
+ Configuração de anulação
1. Revise as seleções de tarefas e escolha **Enviar**.
Depois de criar a tarefa, o console gera uma assinatura JSON e a coloca no seu documento de trabalho. Você pode usar o AWS IoT console para ver o status de um trabalho, cancelar ou excluir um trabalho. Para gerenciar trabalhos, acesse o [Hub de trabalhos do console.](https://console.aws.amazon.com/iot/home#/jobhub)
# Associando uma versão de pacote a qualquer coisa AWS IoT
Depois de instalar o software em seu dispositivo, você pode associar uma versão do pacote a uma AWS IoT coisa reservada chamada shadow. Se os AWS IoT trabalhos tiverem sido configurados para atualizar o item chamado shadow reservado após a implantação e conclusão bem-sucedida do trabalho, você não precisará concluir esse procedimento. Para obter mais informações, consulte [Sombra nomeada reservada](preparing-to-use-software-package-catalog.md#reserved-named-shadow).
**Pré-requisitos:**
Antes de começar, faça o seguinte:
+ Crie qualquer AWS IoT coisa, ou coisas, e estabeleça a telemetria por meio de. AWS IoT Core Para obter mais informações, consulte [Introdução ao AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/iot-gs.html).
+ Crie um pacote de software e uma versão do pacote. Para obter mais informações, consulte [Criação de um pacote de software e uma versão do pacote](creating-package-and-version.md).
+ Instale o software da versão do pacote no dispositivo.
**nota**
Associar uma versão do pacote a AWS IoT algo não atualiza nem instala o software no dispositivo físico. A versão do pacote deve ser implantada no dispositivo.
**Para associar uma versão de pacote a qualquer AWS IoT coisa**
1. No painel de navegação do [AWS IoT console](https://console.aws.amazon.com/iot/home), expanda o menu **Todos os dispositivos** e escolho objeto**s**.
1. Identifique o AWS IoT item que você deseja atualizar na lista e escolha o nome do item para exibir sua página de detalhes.
1. Na seção **Detalhes**, escolha **Pacotes e versões**.
1. Escolha **Adicionar ao pacote e à versão**.
1. Em **Escolher um pacote de dispositivo**, escolha o pacote de software desejado.
1. Em **Escolher uma versão**, escolha a versão do software que você deseja.
1. Escolha **Adicionar pacote do dispositivo**.
O pacote e a versão aparecem na lista **Pacotes e versões selecionados**.
1. Repita essas etapas para cada pacote e versão que você quer associar a esse objeto.
1. Ao terminar, escolha **Adicionar detalhes do pacote e da versão**. A página **Detalhes do objeto** é aberta e você pode ver o novo pacote e a nova versão na lista.