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á.

Preparação de tarefas AWS IoT

O Catálogo de pacotes de software AWS IoT Device Management amplia as AWS IoT tarefas por meio de parâmetros de substituição e integração com indexação de AWS IoT frotas, grupos de objetos dinâmicas e o nome da sombra nomeada reservada AWS IoT do objeto.

Parâmetros de substituição para tarefas AWS IoT

Você pode usar parâmetros de substituição como um espaço reservado em seu documento de trabalho AWS IoT. Quando o serviço de tarefa encontra um parâmetro de substituição, ele aponta a tarefa para um atributo de versão de software nomeado para o valor do parâmetro. Você pode usar esse processo para criar um único documento de trabalho e passar os metadados para a tarefa por meio de atributos de uso geral. Por exemplo, você pode passar por um URL do Amazon Simple Storage Service (Amazon S3), um pacote de software do nome do recurso da Amazon (ARN) ou uma assinatura no documento de trabalho por meio dos atributos da versão do pacote.

Os parâmetros de substituição devem ser formatados no documento de trabalho da seguinte forma:

No exemplo a seguir, há um pacote de software chamado samplePackage, e ele tem uma versão de pacote chamada 2.1.5 que tem os seguintes atributos:

Para s3URL, o parâmetro do documento de trabalho é escrito da seguinte forma:

{
"samplePackage": "${aws:iot:package:samplePackage1:version:2.1.5:attributes:s3URL}"
}

Para signature, o parâmetro do documento de trabalho é escrito da seguinte forma:

{
"samplePackage": "${aws:iot:package:samplePackage1:version:2.1.5:attributes:signature}"
}

O documento de trabalho completo está escrito da seguinte forma:

{
  ...
  "Steps": {
    "uninstall": ["samplePackage"],
    "download": [ 
      { 
        "samplePackage": "${aws:iot:package:samplePackage1:version:2.1.5:attributes:s3URL}"
      },
    ],
    "signature": [
      "samplePackage" : "${aws:iot:package:samplePackage1:version:2.1.5:attributes:signature}"
    ]
  }
}

Depois que a substituição é feita, o seguinte documento de trabalho é implantado nos dispositivos:

{
  ...
  "Steps": {
    "uninstall": ["samplePackage"],
    "download": [ 
      { 
        "samplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile"
      },
    ],
    "signature": [
      "samplePackage" : "aaaaabbbbbcccccdddddeeeeefffffggggghhhhhiiiiijjjj"
    ]
  }
}

Parâmetros de substituição (visualização antes e depois)

Os parâmetros de substituição simplificam a criação de um documento de trabalho usando vários sinalizadores, como $default para a versão padrão do pacote. Isso elimina a necessidade de inserir manualmente metadados específicos da versão do pacote para cada implantação de trabalho, pois esses sinalizadores são preenchidos de modo automático com os metadados referenciados na versão específica do pacote. Para obter mais informações sobre os atributos da versão do pacote, como $default para a versão padrão do pacote, consulte Preparação do documento de trabalho e versão do pacote para implantação.

No AWS Management Console, ative o botão Visualizar substituição na janela do Editor do arquivo de instruções de implantação durante a implantação de um trabalho para uma versão do pacote para visualizar o documento do trabalho com e sem os parâmetros de substituição.

Usando o parâmetro “antes da substituição” nas APIs DescribeJob e GetJobDocument, você pode visualizar a resposta da API antes e depois da remoção dos parâmetros de substituição. Consulte os exemplos a seguir com as APIs DescribeJob e GetJobDocument:

Para obter mais informações sobre AWS IoT Tarefas, criar documentos de trabalho e implantar tarefas, consulte Tarefas.

Preparação do documento de trabalho e versão do pacote para implantação

Quando uma versão do pacote é criada, ela está em um estado draft para indicar que está sendo preparada para implantação. Para preparar a versão do pacote para implantação, crie um documento de trabalho, salve-o em um local em que a tarefa possa ser acessada (como o Amazon S3) e confirme se a versão do pacote tem os valores de atributos que você deseja que o documento de trabalho use. (Nota: você pode atualizar os atributos de uma versão do pacote apenas enquanto ela estiver no estado draft.)

Ao criar um AWS IoT Job ou um modelo de Job para uma implantação de pacote único, você tem as seguintes opções para personalizar seu documento de trabalho:

Arquivo de instruções de implantação (recipe)

Atributos de versão do Artifact

Versão do pacote

Quando você estiver satisfeito com a versão do pacote, publique-a por meio da página de detalhes do pacote de software no console de AWS IoT ou emitindo a operação de API UpdatePackageVersion. Em seguida, você pode referenciar a versão do pacote ao criar o trabalho por meio do console AWS IoT ou emitindo a operação da API CreateJob.

Nomeação dos pacotes e das versões durante a implantação

Para implantar uma versão do pacote de software em um dispositivo, confirme se o pacote de software e a versão do pacote referenciados no documento do trabalho correspondem ao pacote de software e à versão do pacote declarados no parâmetro destinationPackageVersions na operação da API CreateJob. Se não corresponderem, você receberá uma mensagem de erro solicitando que as duas referências correspondam. Para obter mais informações sobre mensagens de erro do Catálogo de pacotes de software, consulte Mensagens de erro de solução de problemas geral.

Além dos pacotes de software e das versões de pacotes referenciados no documento de trabalho, você pode incluir pacotes de software e versões de pacotes adicionais no parâmetro destinationPackageVersions na operação da API CreateJob não referenciados no documento de trabalho. Inclua as informações de instalação necessárias no documento de trabalho para que os dispositivos instalem adequadamente as versões adicionais do pacote de software. Para obter mais informações sobre a operação CreateJob API consulte CreateJob.

Segmentação de tarefas por meio de grupos de objetos dinâmicas AWS IoT

O Catálogo de pacotes de software trabalha com indexação de frota, AWS IoTtarefas e grupos de objetos AWS IoT dinâmicas para filtrar e direcionar dispositivos na frota para selecionar qual versão do pacote implantar nos dispositivos. Você pode executar uma consulta de indexação de frota com base nas informações atuais do pacote do seu dispositivo e direcionar essas objetos para uma tarefa AWS IoT. Você também pode lançar atualizações de software, mas somente para dispositivos de destino qualificados. Por exemplo, você pode especificar que deseja implantar uma configuração somente nos dispositivos que atualmente executam o iot-device-client 1.5.09. Para obter mais informações, consulte a opção Criar um grupo de objetos dinâmicas.

Versões reservadas nomeadas de sombra e pacote

Se configurado, a opção Tarefas AWS IoT pode atualizar uma sombra nomeada reservada do objeto ($package) quando a tarefa for concluída com êxito. Se você fizer isso, não precisará associar manualmente uma versão do pacote a uma sombra nomeada reservado do objeto.

Você pode optar por associar ou atualizar manualmente uma versão do pacote à sombra nomeada reservada do objeto nas seguintes situações:

Você pode adicionar ou atualizar uma versão de pacote para uma sombra nomeada reservada do objeto ($package) por meio do console ou da operação da API UpdateThingShadow. Para obter mais informações, consulte Associação de uma versão de pacote a uma AWS IoT objeto.

Como desinstalar um pacote de software e sua versão do pacote

$null é um espaço reservado que solicita que o serviço Tarefas AWS IoT remova o pacote de software e a versão do pacote existentes da sombra nomeada reservada do dispositivo $package. Para obter mais informações, consulte Sombra nomeada reservada.

Para usar esse atributo, substitua o nome da versão no final do nome do recurso da Amazon (ARN) de destinationPackageVersion com $null. Depois disso, você deve instruir seu serviço a remover o software do dispositivo.

O ARN autorizado usa o seguinte formato:

arn:aws:iot:<regionCode>:111122223333:package/<packageName>/version/$null

Por exemplo,

$ aws iot create-job \
    ... \
    --destinationPackageVersions ["arn:aws:iot:us-east-1:111122223333:package/samplePackage/version/$null"]