deployment

使用指定的组件配方、构件和运行时参数创建或更新本地部署。

摘要

$ greengrass-cli deployment create 
    [--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>]"]...
    --recipeDir path/to/component/recipe
    [--remove <component-name>,...]

Arguments

• --artifactDir， -a. 包含您要包含在部署中的构件文件的文件夹的完整路径。artifacts 文件夹必须包含以下目录结构：

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

• --update-config， -c. 部署的配置参数，以 JSON 字符串或 JSON 文件形式提供。JSON 字符串应采用以下格式：

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

  MERGE 和 RESET 区分大小写，并且必须为大写形式。

• --groupId， -g. 部署的目标事物组。

• --merge， -m. 要添加或更新的目标组件的名称和版本。您必须以 格式提供组件信息<component>=<version>。对要指定的每个附加组件使用单独的参数。如果需要，请使用 --runWith 参数为运行组件提供 posixUser 和 posixGroup 信息。

• --runWith。运行组件的 posixUser 和 posixGroup 信息。您必须以 格式提供此信息<component>:posixUser=<user>[:<group>]。例如，HelloWorld:posixUser=ggc_user:ggc_group。对要指定的每个附加选项使用单独的参数。

• --recipeDir， -r. 包含组件配方文件的文件夹的完整路径。

• --remove。要从本地部署中删除的目标组件的名称。要从云部署中删除合并的组件，您必须以以下格式提供目标事物组的组 ID：

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

输出

以下示例显示了运行此命令时生成的输出。

$ 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

摘要

$ greengrass-cli deployment list

Arguments

无

输出

以下示例显示了运行此命令时生成的输出。根据部署的状态，输出将显示以下状态值之一IN_PROGRESS：、 SUCCEEDED或 FAILED。

$ greengrass-cli deployment list

44d89f46-1a29-4044-ad89-5151213dfcbc: SUCCEEDED

摘要

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

Arguments

-i。部署的 ID。

输出

以下示例显示了运行此命令时生成的输出。根据部署的状态，输出将显示以下状态值之一IN_PROGRESS：、 SUCCEEDED或 FAILED。

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

44d89f46-1a29-4044-ad89-5151213dfcbc: FAILED