Publish components to deploy to your core devices - AWS IoT Greengrass
Publicar um componente (GDKCLI)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 o Greengrass Development Kit CLI (GDKCLI) para desenvolver e criar um componente, você pode usar o GDK CLI 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 (GDKCLI)

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

Se você usar a versão GDK CLI v1.1.0 ou posterior, poderá especificar o --bucket argumento para especificar o bucket do S3 em que ele GDK CLI carrega os artefatos do componente. Se você não especificar esse argumento, os GDK CLI uploads para o bucket do S3 cujo nome ébucket-region-accountId, onde bucket e region são os valores que você especifica emgdk-config.json, e accountId é o seu Conta da AWS ID. O GDK CLI 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 obter 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 a de cada artefato. URI 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 GDK CLI configuração, ele GDK CLI usará a próxima versão do patch que ainda não existe no AWS IoT Greengrass serviço.

    Execute o seguinte comando .

    gdk component publish

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

    Depois de publicar o componente, você pode implantar o componente nos dispositivos principais. Para obter 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 Amazon URI 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 amzn-s3-demo-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://amzn-s3-demo-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 obter 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 os URI artefatos existentes. O Amazon S3 URI é composto pelo nome do bucket e pelo caminho para o objeto de artefato no bucket. O Amazon S3 de seus artefatos URIs deve ser semelhante ao exemplo a seguir.

      s3://amzn-s3-demo-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://amzn-s3-demo-bucket/artifacts/MyGreengrassComponent/1.0.0/artifact.py",
          "Unarchive": "NONE"
        }
      ]
    }
  ]
}
    nota

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

    YAML
    ...
Manifests:
  - Lifecycle:
      ...
    Artifacts:
      - URI: s3://amzn-s3-demo-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 ZIP artefato quando o componente for implantado. Para obter mais informações sobre como usar ZIP artefatos em um componente, consulte a variável artefatos: decompressedPath receita.

    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. Substituir path/to/recipeFile com o caminho para o arquivo da 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. Substituir com.example.HelloWorld e 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 obter mais informações, consulte Implemente AWS IoT Greengrass componentes em dispositivos.