Atualizar configurações de componentes

As configurações de componentes são objetos JSON que definem os parâmetros de cada componente. A receita de cada componente define sua configuração padrão, que você modifica ao implantar componentes nos dispositivos principais.

Ao criar uma implantação, você pode especificar a atualização de configuração a ser aplicada a cada componente. As atualizações de configuração são operações de patch, o que significa que a atualização modifica a configuração do componente que existe no dispositivo principal. Se o dispositivo principal não tiver o componente, a atualização da configuração modifica e aplica a configuração padrão para essa implantação.

A atualização de configuração define atualizações de redefinição e atualizações de mesclagem. As atualizações de redefinição definem quais valores de configuração devem ser redefinidos para seus padrões ou removidos. As atualizações de mesclagem definem os novos valores de configuração a serem definidos para o componente. Quando você implanta uma atualização de configuração, o software AWS IoT Greengrass Core executa a atualização de redefinição antes da atualização de mesclagem.

Os componentes podem validar as atualizações de configuração que você implanta. O componente se inscreve para receber uma notificação quando uma implantação altera sua configuração e pode rejeitar uma configuração que não suporta. Para ter mais informações, consulte Interaja com a configuração do componente.

Redefinir atualizações

As atualizações de redefinição definem quais valores de configuração devem ser redefinidos para seus valores padrão no dispositivo principal. Se um valor de configuração não tiver um valor padrão, a atualização de redefinição removerá esse valor da configuração do componente. Isso pode ajudá-lo a corrigir um componente que falha como resultado de uma configuração inválida.

Use uma lista de ponteiros JSON para definir quais valores de configuração devem ser redefinidos. Os ponteiros JSON começam com uma barra. / Para identificar um valor em uma configuração de componente aninhado, use barras (/) para separar as chaves de cada nível na configuração. Para obter mais informações, consulte a especificação do ponteiro JSON.

Para redefinir toda a configuração de um componente para seus valores padrão, especifique uma única string vazia como atualização de redefinição.

"reset": [""]

Mesclar atualizações

As atualizações de mesclagem definem os valores de configuração a serem inseridos na configuração do componente no núcleo. A atualização de mesclagem é um objeto JSON que o software AWS IoT Greengrass Core mescla depois de redefinir os valores nos caminhos especificados na atualização de redefinição. Ao usar os AWS SDKs AWS CLI ou, você deve serializar esse objeto JSON como uma string.

Você pode mesclar um par de valores-chave que não existe na configuração padrão do componente. Você também pode mesclar um par de valores-chave que tenha um tipo diferente do valor com a mesma chave. O novo valor substitui o valor antigo. Isso significa que você pode alterar a estrutura do objeto de configuração.

Você pode mesclar valores nulos e sequências de caracteres, listas e objetos vazios.

Use variáveis de receita em atualizações de mesclagem

Esse recurso está disponível para a versão 2.6.0 e posterior do componente núcleo do Greengrass.

Se você definir a opção de ComponentConfiguration configuração de interpolação do núcleo Greengrass comotrue, poderá usar variáveis de receita, além da variável de receita, em atualizações de component_dependency_name:configuration:json_pointer mesclagem. Por exemplo, você pode usar a variável de {iot:thingName} receita em uma atualização de mesclagem para incluir o nome do item do AWS IoT dispositivo principal em um valor de configuração do componente, como uma política de autorização de comunicação entre processos (IPC).

Exemplos

O exemplo a seguir demonstra as atualizações de configuração para um componente do painel que tem a seguinte configuração padrão. Este componente de exemplo exibe informações sobre equipamentos industriais.

{
  "name": null,
  "mode": "REQUEST",
  "network": {
    "useHttps": true,
    "port": {
      "http": 80,
      "https": 443
    },
  },
  "tags": []
}

{
  "name": "Factory 2A",
  "mode": "REQUEST",
  "network": {
    "useHttps": false,
    "port": {
      "http": 8080,
      "https": 443
    }
  },
  "tags": [
    "/boiler/1/temperature",
    "/boiler/1/pressure",
    "/boiler/2/temperature",
    "/boiler/2/pressure"
  ]
}

{
  "name": "Factory 2A",
  "mode": "REQUEST",
  "network": {
    "useHttps": true,
    "port": {
      "http": 8080,
      "https": 443
    }
  },
  "tags": [
    "/boiler/3/temperature",
    "/boiler/3/pressure",
    "/boiler/4/temperature",
    "/boiler/4/pressure",
  ]
}