碼頭應用程序管理器

• 2.0.x

此元件可安裝在執行下列作業系統的核心裝置上：

• Linux

• Windows

• 碼頭引擎 1.9.1 或更高版本安裝在 Greengrass 核心設備上。版本 20.10 是經過驗證可與AWS IoT Greengrass核心軟件配合使用的最新版本。在部署執行 Docker 容器的元件之前，您必須直接在核心裝置上安裝 Docker。

• 在您部署此元件之前，Docker 精靈會在核心裝置上啟動並執行。

• Docker 圖像存儲在以下支持的圖像源之一中：

  • Amazon Elastic Container Registry (Amazon ECR) 中的公共和私有映像存儲庫

  • 公共碼頭集線器存儲庫

  • 公共碼頭信任的註冊表

• Docker 映像檔包含在您的自訂 Docker 容器元件中作為成品。使用下列 URI 格式來指定您的泊塢視窗映像檔：

  • 私人 Amazon ECR 圖片：docker:account-id.dkr.ecr.region.amazonaws.com/repository/image[:tag|@digest]

  • 公共 Amazon ECR 圖片：docker:public.ecr.aws/repository/image[:tag|@digest]

  • 公共碼頭集線器映像：docker:name[:tag|@digest]

  如需詳細資訊，請參閱 運行碼頭容器。

  注意

  如果您未在映像的成品 URI 中指定映像標籤或映像摘要，則當您部署自訂 Docker 容器元件時，Docker 應用程式管理員會提取該映像的最新可用版本。若要確保所有核心裝置都執行相同版本的映像，建議您在成品 URI 中加入映像標記或影像摘要。

• 執行 Docker 容器元件的系統使用者必須具有根或管理員權限，或者您必須將 Docker 設定為以非 root 使用者或非管理員使用者身分執行。

  • 在 Linux 裝置上，您可以將使用者新增至docker群組，以便在不使用的情況下呼叫docker指令sudo。

  • 在 Windows 裝置上，您可以將使用者新增至docker-users群組，以便在沒有系統管理員權限的情況下呼叫docker命令。

  Linux or Unix

  若要將ggc_user您用來執行 Docker 容器元件的非 root 使用者新增至docker群組，請執行下列命令。

  sudo usermod -aG docker ggc_user

  如需詳細資訊，請參閱以非 root 使用者身分管理 Docker。

  Windows Command Prompt (CMD)

  若要將ggc_user或您用來執行 Docker 容器元件的使用者新增至docker-users群組，請以系統管理員身分執行下列命令。

  net localgroup docker-users ggc_user /add

  Windows PowerShell

  若要將ggc_user或您用來執行 Docker 容器元件的使用者新增至docker-users群組，請以系統管理員身分執行下列命令。

  Add-LocalGroupMember -Group docker-users -Member ggc_user

• 如果您將 AWS IoT GreengrassCore 軟體設定為使用網路 Proxy，則必須將 Docker 設定為使用相同的 Proxy 伺服器。

• 如果您的 Docker 映像檔儲存在 Amazon ECR 私有登錄中，則必須將權杖交換服務元件作為 Docker 容器元件的相依性包含在 Docker 容器元件中。此外，Greengrass 裝置角色必須允許ecr:GetAuthorizationToken、和ecr:GetDownloadUrlForLayer動作ecr:BatchGetImage，如下列範例 IAM 政策所示。

  {
    "Version": "2012-10-17",
    "Statement": [
      {
        "Action": [
          "ecr:GetAuthorizationToken",
          "ecr:BatchGetImage",
          "ecr:GetDownloadUrlForLayer"
        ],
        "Resource": [
          "*"
        ],
        "Effect": "Allow"
      }
    ]
  }

• docker 應用程序管理器組件支持在 VPC 中運行。若要在 VPC 中部署此元件，需要下列項目。

  • docker 應用程序管理器組件必須具有下載圖像的連接性。例如，如果您使用 ECR，則必須具有與下列端點的連線能力。

    • *.dkr.ecr.region.amazonaws.com(VPC 端端點com.amazonaws.region.ecr.dkr)

    • api.ecr.region.amazonaws.com(VPC 端端點com.amazonaws.region.ecr.api)

• 運行碼頭容器