Publish components to deploy to your core devices - AWS IoT Greengrass
Publicar um componente (GDK CLI)Publicar um componente (comandos do shell)

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

Publish components to deploy to your core devices

Depois de criar ou concluir uma versão de um componente, você pode publicá-la no AWS IoT Greengrass serviço. Em seguida, você pode implantá-lo nos dispositivos principais do Greengrass.

Se você usa a CLI do Greengrass Development Kit (GDK CLI) para desenvolver e criar um componente, você pode usar a CLI do GDK para publicar o componente no. Nuvem AWS Caso contrário, use os comandos shell integrados e o AWS CLI para publicar o componente.

Você também pode usar AWS CloudFormation para criar componentes e outros AWS recursos a partir de modelos. Para obter mais informações, consulte O que é AWS CloudFormation? e AWS::GreengrassV2::ComponentVersionno Guia do AWS CloudFormation usuário.

Publicar um componente (GDK CLI)

Siga as instruções nesta seção para publicar um componente usando a CLI do GDK. A CLI do GDK carrega artefatos de construção em um bucket do S3, atualiza os URIs do artefato na receita e cria o componente a partir da receita. Você especifica o bucket e a região do S3 a serem usados no arquivo de configuração da CLI do GDK.

Se você usar o GDK CLI v1.1.0 ou posterior, poderá especificar --bucket o argumento para especificar o bucket do S3 em que o GDK CLI carrega os artefatos do componente. Se você não especificar esse argumento, a CLI do GDK será carregada no bucket do S3 cujo nome bucket-region-accountId é, onde bucket e region são os valores que você especifica e accountId gdk-config.json é seu ID. Conta da AWS A CLI do GDK cria o bucket se ele não existir.

Importante

As funções principais do dispositivo não permitem acesso aos buckets do S3 por padrão. Se for a primeira vez que você usa esse bucket do S3, você deve adicionar permissões à função para permitir que os dispositivos principais recuperem artefatos de componentes desse bucket do S3. Para ter mais informações, consulte Permitir acesso aos buckets do S3 para artefatos de componentes.

Para publicar um componente do Greengrass (GDK CLI)

  1. Abra a pasta do componente em um prompt de comando ou terminal.

  2. Se você ainda não o fez, crie o componente Greengrass. O comando de construção do componente produz uma receita e artefatos na greengrass-build pasta do componente. Execute o seguinte comando .

    gdk component build

  3. Publique o componente no Nuvem AWS. O comando de publicação do componente carrega os artefatos do componente para o Amazon S3 e atualiza a receita do componente com o URI de cada artefato. Em seguida, ele cria o componente no AWS IoT Greengrass serviço.

    nota

    AWS IoT Greengrass calcula o resumo de cada artefato quando você cria o componente. Isso significa que você não pode modificar os arquivos de artefatos em seu bucket do S3 depois de criar um componente. Se você fizer isso, as implantações que incluam esse componente falharão, porque o resumo do arquivo não corresponde. Se você modificar um arquivo de artefato, deverá criar uma nova versão do componente.

    Se você especificar NEXT_PATCH a versão do componente no arquivo de configuração da CLI do GDK, a CLI do GDK usará a próxima versão do patch que ainda não existe no serviço. AWS IoT Greengrass

    Execute o seguinte comando .

    gdk component publish

    A saída informa a versão do componente que a CLI do GDK criou.

    Depois de publicar o componente, você pode implantar o componente nos dispositivos principais. Para ter mais informações, consulte Implemente AWS IoT Greengrass componentes em dispositivos.

Publicar um componente (comandos do shell)

Use o procedimento a seguir para publicar um componente usando comandos shell e o AWS Command Line Interface (AWS CLI). Ao publicar um componente, você faz o seguinte:

  1. Publique artefatos de componentes em um bucket do S3.

  2. Adicione o URI do Amazon S3 de cada artefato à receita do componente.

  3. Crie uma versão do componente a AWS IoT Greengrass partir da receita do componente.

nota

Cada versão do componente que você carrega deve ser exclusiva. Certifique-se de fazer o upload da versão correta do componente, pois você não poderá editá-la depois de carregá-la.

Você pode seguir estas etapas para publicar um componente do seu computador de desenvolvimento ou do seu dispositivo principal do Greengrass.

Para publicar um componente (comandos shell)

  1. Se o componente usar uma versão que existe no AWS IoT Greengrass serviço, você deverá alterar a versão do componente. Abra a receita em um editor de texto, incremente a versão e salve o arquivo. Escolha uma nova versão que reflita as alterações feitas no componente.

    nota

    AWS IoT Greengrass usa versões semânticas para componentes. As versões semânticas seguem um sistema de numeração principal.secundária.patch. Por exemplo, a versão 1.0.0 representa a primeira versão principal de um componente. Para obter mais informações, consulte a especificação da versão semântica.

  2. Se seu componente tiver artefatos, faça o seguinte:

    1. Publique os artefatos do componente em um bucket do S3 no seu. Conta da AWS

      dica

      Recomendamos que você inclua o nome e a versão do componente no caminho para o artefato no bucket do S3. Esse esquema de nomenclatura pode ajudá-lo a manter os artefatos que as versões anteriores do componente usam, para que você possa continuar oferecendo suporte às versões anteriores do componente.

      Execute o comando a seguir para publicar um arquivo de artefato em um bucket do S3. Substitua DOC-EXAMPLE-BUCKET pelo nome do bucket e substitua artifacts/com.example. HelloWorld/1.0.0/artifact.py com o caminho para o arquivo do artefato.

      aws s3 cp artifacts/com.example.HelloWorld/1.0.0/artifact.py s3://DOC-EXAMPLE-BUCKET/artifacts/com.example.HelloWorld/1.0.0/artifact.py
      Importante

      As funções principais do dispositivo não permitem acesso aos buckets do S3 por padrão. Se for a primeira vez que você usa esse bucket do S3, você deve adicionar permissões à função para permitir que os dispositivos principais recuperem artefatos de componentes desse bucket do S3. Para ter mais informações, consulte Permitir acesso aos buckets do S3 para artefatos de componentes.

    2. Adicione uma lista nomeada Artifacts à receita do componente se ela não estiver presente. A Artifacts lista aparece em cada manifesto, que define os requisitos do componente em cada plataforma que ele suporta (ou os requisitos padrão do componente para todas as plataformas).

    3. Adicione cada artefato à lista de artefatos ou atualize o URI dos artefatos existentes. O URI do Amazon S3 é composto pelo nome do bucket e pelo caminho para o objeto de artefato no bucket. Os URIs do Amazon S3 de seus artefatos devem ser semelhantes ao exemplo a seguir.

      s3://DOC-EXAMPLE-BUCKET/artifacts/com.example.HelloWorld/1.0.0/artifact.py

    Depois de concluir essas etapas, sua receita deve ter uma Artifacts lista semelhante à seguinte.

    JSON
    {
  ...
  "Manifests": [
    {
      "Lifecycle": {
        ...
      },
      "Artifacts": [
        {
          "URI": "s3://DOC-EXAMPLE-BUCKET/artifacts/MyGreengrassComponent/1.0.0/artifact.py",
          "Unarchive": "NONE"
        }
      ]
    }
  ]
}
    nota

    Você pode adicionar a "Unarchive": "ZIP" opção de um artefato ZIP para configurar o software AWS IoT Greengrass Core para descompactar o artefato quando o componente for implantado.

    YAML
    ...
Manifests:
  - Lifecycle:
      ...
    Artifacts:
      - URI: s3://DOC-EXAMPLE-BUCKET/artifacts/MyGreengrassComponent/1.0.0/artifact.py
        Unarchive: NONE
    nota

    Você pode usar a Unarchive: ZIP opção de configurar o software AWS IoT Greengrass Core para descompactar um artefato ZIP quando o componente for implantado. Para obter mais informações sobre como usar artefatos ZIP em um componente, consulte a variável de receita artifacts:decompressedPath.

    Para obter mais informações sobre receitas, consulte AWS IoT Greengrass referência da receita do componente.

  3. Use o AWS IoT Greengrass console para criar um componente a partir do arquivo de receita.

    Execute o comando a seguir para criar o componente a partir de um arquivo de receita. Esse comando cria o componente e o publica como um AWS IoT Greengrass componente privado no seu Conta da AWS. Substitua path/to/recipeFile pelo caminho para o arquivo de receita.

    aws greengrassv2 create-component-version --inline-recipe fileb://path/to/recipeFile

    Copie o arn da resposta para verificar o estado do componente na próxima etapa.

    nota

    AWS IoT Greengrass calcula o resumo de cada artefato quando você cria o componente. Isso significa que você não pode modificar os arquivos de artefatos em seu bucket do S3 depois de criar um componente. Se você fizer isso, as implantações que incluam esse componente falharão, porque o resumo do arquivo não corresponde. Se você modificar um arquivo de artefato, deverá criar uma nova versão do componente.

  4. Cada componente no AWS IoT Greengrass serviço tem um estado. Execute o comando a seguir para confirmar o estado da versão do componente que você publica neste procedimento. Substitua com.example. HelloWorlde 1.0.0 com a versão do componente a ser consultada. arnSubstitua o pelo ARN da etapa anterior.

    aws greengrassv2 describe-component --arn "arn:aws:greengrass:region:account-id:components:com.example.HelloWorld:versions:1.0.0"

    A operação retorna uma resposta que contém os metadados do componente. Os metadados contêm um status objeto que contém o estado do componente e quaisquer erros, se aplicável.

    Quando o estado do componente éDEPLOYABLE, você pode implantar o componente nos dispositivos. Para ter mais informações, consulte Implemente AWS IoT Greengrass componentes em dispositivos.