implantação

Crie ou atualize uma implantação local usando receitas de componentes, artefatos e argumentos de tempo de execução especificados.

Resumo

greengrass-cli deployment create 
    --recipeDir path/to/component/recipe
    [--artifactDir path/to/artifact/folder ]
    [--update-config {component-configuration}]
    [--groupId <thing-group>]
    [--merge "<component-name>=<component-version>"]...
    [--runWith "<component-name>:posixUser=<user-name>[:<group-name>]"]...
    [--systemLimits "{component-system-resource-limits}]"]...
    [--remove <component-name>,...]
    [--failure-handling-policy <policy name[ROLLBACK, DO_NOTHING]>]

Arguments (Argumentos)

• --recipeDir,-r. O caminho completo para a pasta que contém os arquivos de receita do componente.

• --artifactDir,-a. O caminho completo para a pasta que contém os arquivos de artefatos que você deseja incluir na sua implantação. A pasta de artefatos deve conter a seguinte estrutura de diretórios:

  /path/to/artifact/folder/<component-name>/<component-version>/<artifacts>

• --update-config,-c. Os argumentos de configuração para a implantação, fornecidos como uma string JSON ou um arquivo JSON. A string JSON deve estar no seguinte formato:

  { \
    "componentName": { \ 
      "MERGE": {"config-key": "config-value"}, \
      "RESET": ["path/to/reset/"] \
    } \
  }

  MERGEe RESET diferenciam maiúsculas de minúsculas e devem estar em maiúsculas.

• --groupId,-g. O grupo-alvo da implantação.

• --merge,-m. O nome e a versão do componente de destino que você deseja adicionar ou atualizar. Você deve fornecer as informações do componente no formato<component>=<version>. Use um argumento separado para cada componente adicional a ser especificado. Se necessário, use o --runWith argumento para fornecer as windowsUser informações posixUserposixGroup, e para executar o componente.

• --runWith. As windowsUser informações posixUserposixGroup, e para executar um componente genérico ou Lambda. Você deve fornecer essas informações no formato<component>:{posixUser|windowsUser}=<user>[:<=posixGroup>]. Por exemplo, você pode especificar HelloWorld:posixUser=ggc_user:ggc_group ouHelloWorld:windowsUser=ggc_user. Use um argumento separado para cada opção adicional a ser especificada.

  Para ter mais informações, consulte Configurar o usuário que executa os componentes.

• --systemLimits. Os limites de recursos do sistema devem ser aplicados aos processos dos componentes Lambda genéricos e não conteinerizados no dispositivo principal. Você pode configurar a quantidade máxima de uso de CPU e RAM que os processos de cada componente podem usar. Especifique um objeto JSON serializado ou um caminho de arquivo para um arquivo JSON. O objeto JSON deve ter o seguinte formato.

  {  \
    "componentName": { \ 
      "cpus": cpuTimeLimit, \
      "memory": memoryLimitInKb \
    } \
  }

  Você pode configurar os seguintes limites de recursos do sistema para cada componente:

  • cpus— A quantidade máxima de tempo de CPU que os processos desse componente podem usar no dispositivo principal. O tempo total da CPU de um dispositivo essencial é equivalente ao número de núcleos da CPU do dispositivo. Por exemplo, em um dispositivo principal com 4 núcleos de CPU, você pode definir esse valor 2 para limitar os processos desse componente a 50% de uso de cada núcleo da CPU. Em um dispositivo com 1 núcleo de CPU, você pode definir esse valor 0.25 para limitar os processos desse componente a 25% de uso da CPU. Se você definir esse valor como um número maior que o número de núcleos de CPU, o software AWS IoT Greengrass Core não limitará o uso da CPU do componente.

  • memory— A quantidade máxima de RAM (em kilobytes) que os processos desse componente podem usar no dispositivo principal.

  Para ter mais informações, consulte Configurar limites de recursos do sistema para componentes.

  Esse recurso está disponível para a versão 2.4.0 e posterior do componente Greengrass nucleus e da CLI do Greengrass em dispositivos principais do Linux. AWS IoT Greengrass atualmente não oferece suporte a esse recurso nos dispositivos principais do Windows.

• --remove. O nome do componente de destino que você deseja remover de uma implantação local. Para remover um componente que foi mesclado de uma implantação na nuvem, você deve fornecer o ID do grupo de itens de destino no seguinte formato:

  Greengrass nucleus v2.4.0 and later

  --remove <component-name> --groupId <group-name>

  Earlier than v2.4.0

  --remove <component-name> --groupId thinggroup/<group-name>

• --failure-handling-policy. Define a ação tomada quando uma implantação falha. Há duas ações que você pode especificar:

  • ROLLBACK –

  • DO_NOTHING –

  Esse recurso está disponível para v2.11.0 e versões posteriores do. Núcleo Greengrass

Saída

O exemplo a seguir mostra a saída produzida quando você executa esse comando.

$ sudo greengrass-cli deployment create \
    --merge MyApp1=1.0.0 \
    --merge MyApp2=1.0.0 --runWith MyApp2:posixUser=ggc_user \
    --remove MyApp3 \
    --recipeDir recipes/ \ 
    --artifactDir artifacts/

Local deployment has been submitted! Deployment Id: 44d89f46-1a29-4044-ad89-5151213dfcbc

Resumo

greengrass-cli deployment cancel
    -i <deployment-id>

Argumentos

-i. O identificador exclusivo da implantação a ser cancelada. O ID de implantação é retornado na saída do create comando.

Saída

• Nenhum

Resumo

greengrass-cli deployment list

Arguments (Argumentos)

Nenhum

Saída

O exemplo a seguir mostra a saída produzida quando você executa esse comando. Dependendo do status da sua implantação, a saída mostra um dos seguintes valores de status:IN_PROGRESS,SUCCEEDED, ouFAILED.

$ sudo greengrass-cli deployment list

44d89f46-1a29-4044-ad89-5151213dfcbc: SUCCEEDED
Created on: 6/27/23 11:05 AM

Resumo

greengrass-cli deployment status -i <deployment-id>

Arguments (Argumentos)

-i. O ID da implantação.

Saída

O exemplo a seguir mostra a saída produzida quando você executa esse comando. Dependendo do status da sua implantação, a saída mostra um dos seguintes valores de status:IN_PROGRESS,SUCCEEDED, ouFAILED.

$ sudo greengrass-cli deployment status -i 44d89f46-1a29-4044-ad89-5151213dfcbc

44d89f46-1a29-4044-ad89-5151213dfcbc: FAILED
Created on: 6/27/23 11:05 AM
Detailed Status: <Detailed deployment status>
Deployment Error Stack: List of error codes
Deployment Error Types: List of error types
Failure Cause: Cause