Docker アプリケーションマネージャー

• 2.0.x

このコンポーネントは、次のオペレーティングシステムを実行するコアデバイスにインストールできます。

• Linux

• Windows

• Docker Engine 1.9.1 以降が Greengrass コアにインストールされていいること。バージョン 20.10 は、 AWS IoT Greengrass Core ソフトウェアで動作することが検証された最新バージョンです。Docker コンテナを実行するコンポーネントをデプロイする前に、コアデバイスに直接、Docker をインストールしておく必要があります。

• このコンポーネントをデプロイする前に、Docker デーモンがコアデバイス上で起動し、実行されています。

• Docker イメージは、次のいずれかのサポートされているイメージソースに格納されています。

  • Amazon Elastic Container Registry (Amazon ECR) のパブリックイメージリポジトリとプライベートイメージリポジトリ

  • パブリック Docker Hub リポジトリ

  • パブリック Docker の信頼レジストリ

• カスタム Docker コンテナコンポーネントにアーティファクトとして含まれる 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 Hub イメージ: docker:name[:tag|@digest]

  詳細については、「Docker コンテナの実行」を参照してください。

  注記

  イメージのアーティファクトでイメージタグまたはURIイメージダイジェストを指定しない場合、カスタム Docker コンテナコンポーネントをデプロイするときに、Docker アプリケーションマネージャーはそのイメージの利用可能な最新バージョンを取得します。すべてのコアデバイスが同じバージョンのイメージを実行するようにするには、イメージタグまたはイメージダイジェストをアーティファクト に含めることをお勧めしますURI。

• Docker コンテナコンポーネントを実行するシステムユーザーには、ルート権限または管理者権限が必要です。権限がない場合は、ルート権限または管理者権限を持たないユーザーとして実行されるように Docker を設定する必要があります。

  • Linux デバイスでは、ユーザーを docker グループに追加することで、sudo のない docker コマンドを呼び出せます。

  • Windows デバイスでは、ユーザーを docker-users グループ に追加することで、管理者の権限のない docker コマンドを呼び出せます。

  Linux or Unix

  Docker コンテナコンポーネントの実行に使用する ggc_user または非ルートユーザーを docker グループに追加するには、次のコマンドを実行します。

  sudo usermod -aG docker ggc_user

  詳細については、「Docker を非ルートユーザーとして管理する」を参照してください。

  Windows Command Prompt (CMD)

  Docker コンテナコンポーネントの実行に使用する ggc_user またはユーザーを docker-users グループに追加するには、次のコマンドを管理者として実行します。

  net localgroup docker-users ggc_user /add

  Windows PowerShell

  Docker コンテナコンポーネントの実行に使用する ggc_user またはユーザーを docker-users グループに追加するには、次のコマンドを管理者として実行します。

  Add-LocalGroupMember -Group docker-users -Member ggc_user

• ネットワークプロキシ を使用するように AWS IoT Greengrass Core ソフトウェアを設定する場合は、同じプロキシサーバー を使用するように Docker を設定する必要があります。

• Docker イメージが Amazon ECRプライベートレジストリに保存されている場合は、Docker コンテナコンポーネントに依存関係としてトークン交換サービスコンポーネントを含める必要があります。また、Greengrass デバイスロールはecr:GetAuthorizationToken、次のIAMポリシー例に示すようにecr:BatchGetImage、、、および ecr:GetDownloadUrlForLayerアクションを許可する必要があります。

  {
    "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）

• Docker コンテナの実行