將 AWS IoT Greengrass V2 核心裝置設定為非根裝置

從 完成下列步驟使用自動資源佈建安裝 AWS IoT Greengrass 核心軟體：設定您的裝置環境、提供登入資料，以及下載 AWS IoT Greengrass 核心軟體。

建立安裝目錄，並確保您的使用者擁有該目錄。

mkdir -p $HOME/greengrass/v2

在沒有 的情況下執行安裝程式sudo。將 --component-default-user設定為您目前的使用者。

java -Droot="$HOME/greengrass/v2" -Dlog.store=FILE \
  -jar ./GreengrassInstaller/lib/Greengrass.jar \
  --aws-region region \
  --thing-name MyGreengrassCore \
  --thing-group-name MyGreengrassCoreGroup \
  --thing-policy-name GreengrassV2IoTThingPolicy \
  --tes-role-name GreengrassV2TokenExchangeRole \
  --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias \
  --component-default-user $USER \
  --provision true

請勿使用 ，--setup-system-service true因為您沒有建立系統服務的根存取權。

如果 AWS IoT Greengrass 核心軟體目前正在執行，請停止它。

kill $(cat $HOME/greengrass/v2/alts/loader.pid)

建立系統化使用者服務目錄。

mkdir -p $HOME/.config/systemd/user

$HOME/.config/systemd/user/greengrass.service 使用下列內容在 建立服務檔案。

[Unit]
Description=Greengrass Core

[Service]
Type=simple
PIDFile=%h/greengrass/v2/alts/loader.pid
RemainAfterExit=no
Restart=on-failure
RestartSec=10
ExecStart=/bin/sh %h/greengrass/v2/alts/current/distro/bin/loader
Environment="JAVA_HOME=/path/to/java"

[Install]
WantedBy=default.target

在系統化使用者單位檔案中， %h 是一種指標，可解析為執行服務之使用者的主目錄。

將 /path/to/java 取代為 Java 安裝的路徑。

啟用並啟動服務。

systemctl --user daemon-reload
systemctl --user enable greengrass.service
systemctl --user start greengrass.service

從 完成下列步驟使用自動資源佈建安裝 AWS IoT Greengrass 核心軟體：設定您的裝置環境、提供登入資料，以及下載 AWS IoT Greengrass 核心軟體。

建立將執行 AWS IoT Greengrass Core 軟體和所有元件的非根使用者。

sudo useradd --create-home gg_non_root

以非根使用者身分登入並執行安裝程式。--component-default-user 設定為相同的使用者。請勿使用 sudo，也不設定系統服務。

java -Droot="/home/gg_non_root/greengrass/v2" -Dlog.store=FILE \
  -jar ./GreengrassInstaller/lib/Greengrass.jar \
  --aws-region region \
  --thing-name MyGreengrassCore \
  --thing-group-name MyGreengrassCoreGroup \
  --thing-policy-name GreengrassV2IoTThingPolicy \
  --tes-role-name GreengrassV2TokenExchangeRole \
  --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias \
  --component-default-user gg_non_root \
  --provision true \
  --setup-system-service false

做為根目錄，使用/etc/systemd/system/greengrass.service下列內容在 建立系統服務檔案。

[Unit]
Description=Greengrass Core
After=network.target

[Service]
Type=simple
User=gg_non_root
PIDFile=/home/gg_non_root/greengrass/v2/alts/loader.pid
RemainAfterExit=no
Restart=on-failure
RestartSec=10
ExecStart=/bin/sh -c "exec /home/gg_non_root/greengrass/v2/alts/current/distro/bin/loader >> /home/gg_non_root/greengrass/v2/logs/loader.log 2>&1"
KillMode=mixed
NoNewPrivileges=true
ProtectSystem=strict
ReadWritePaths=/home/gg_non_root/greengrass /tmp

[Install]
WantedBy=multi-user.target

停止執行中 AWS IoT Greengrass 的核心執行個體，然後啟用並啟動系統服務。

sudo systemctl daemon-reload
sudo systemctl enable greengrass.service
sudo systemctl start greengrass.service

從 完成下列步驟使用自動資源佈建安裝 AWS IoT Greengrass 核心軟體：設定您的裝置環境、提供登入資料，以及下載 AWS IoT Greengrass 核心軟體。

建立將執行 AWS IoT Greengrass Core 軟體的非根使用者。

sudo useradd --create-home gg_non_root

將非根使用者新增至 sudoers，以便以元件使用者身分執行命令。在 建立檔案/etc/sudoers.d/gg_non_root。

gg_non_root ALL=(ggc_user:ggc_group) NOPASSWD: SETENV: /bin/sh, /bin/bash

如果您使用 將元件設定為以其他使用者身分執行posixUser，請為每個使用者新增 sudoers 項目。例如：

gg_non_root ALL=(ggc_user:ggc_group) NOPASSWD: SETENV: /bin/sh, /bin/bash
gg_non_root ALL=(another_user:another_group) NOPASSWD: SETENV: /bin/sh, /bin/bash

以非根使用者身分登入並執行安裝程式。請勿使用 sudo，也不設定系統服務。

java -Droot="/home/gg_non_root/greengrass/v2" -Dlog.store=FILE \
  -jar ./GreengrassInstaller/lib/Greengrass.jar \
  --aws-region region \
  --thing-name MyGreengrassCore \
  --thing-group-name MyGreengrassCoreGroup \
  --thing-policy-name GreengrassV2IoTThingPolicy \
  --tes-role-name GreengrassV2TokenExchangeRole \
  --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias \
  --component-default-user ggc_user:ggc_group \
  --provision true \
  --setup-system-service false

做為根目錄，使用/etc/systemd/system/greengrass.service下列內容在 建立系統服務檔案。

[Unit]
Description=Greengrass Core
After=network.target

[Service]
Type=simple
User=gg_non_root
PIDFile=/home/gg_non_root/greengrass/v2/alts/loader.pid
RemainAfterExit=no
Restart=on-failure
RestartSec=10
ExecStart=/bin/sh -c "exec /home/gg_non_root/greengrass/v2/alts/current/distro/bin/loader >> /home/gg_non_root/greengrass/v2/logs/loader.log 2>&1"
KillMode=mixed
AmbientCapabilities=CAP_CHOWN CAP_DAC_OVERRIDE CAP_DAC_READ_SEARCH CAP_FOWNER CAP_SETUID CAP_SETGID CAP_SYS_RESOURCE CAP_AUDIT_WRITE
CapabilityBoundingSet=CAP_CHOWN CAP_DAC_OVERRIDE CAP_DAC_READ_SEARCH CAP_FOWNER CAP_SETUID CAP_SETGID CAP_SYS_RESOURCE CAP_AUDIT_WRITE
ProtectSystem=strict
ReadWritePaths=/home/gg_non_root/greengrass /tmp

[Install]
WantedBy=multi-user.target

如需所需功能的資訊，請參閱 所需的 Linux 功能 AWS IoT Greengrass V2。

停止執行中 AWS IoT Greengrass 的核心執行個體，然後啟用並啟動系統服務。

sudo systemctl daemon-reload
sudo systemctl enable greengrass.service
sudo systemctl start greengrass.service

從 完成下列步驟使用自動資源佈建安裝 AWS IoT Greengrass 核心軟體：設定您的裝置環境、提供登入資料，以及下載 AWS IoT Greengrass 核心軟體。

在您下載 AWS IoT Greengrass Core 軟體的目錄中GreengrassInstaller/bin/greengrass.service.template，修改 的服務範本檔案。在執行安裝程式之前，將下列幾行新增至 [Service]區段：

CapabilityBoundingSet=CAP_CHOWN CAP_DAC_OVERRIDE CAP_DAC_READ_SEARCH CAP_FOWNER CAP_SETUID CAP_SETGID CAP_SYS_RESOURCE CAP_AUDIT_WRITE
ProtectSystem=strict
ReadWritePaths=/greengrass /tmp

使用 執行安裝程式--setup-system-service true。

sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
  -jar ./GreengrassInstaller/lib/Greengrass.jar \
  --aws-region region \
  --thing-name MyGreengrassCore \
  --thing-group-name MyGreengrassCoreGroup \
  --thing-policy-name GreengrassV2IoTThingPolicy \
  --tes-role-name GreengrassV2TokenExchangeRole \
  --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias \
  --component-default-user ggc_user:ggc_group \
  --provision true \
  --setup-system-service true