Manajer aplikasi Docker

• 2.0.x

Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut:

• Linux

• Windows

• Docker Engine 1.9.1 atau yang lebih baru diinstal pada perangkat inti Greengrass. Versi 20.10 adalah versi terbaru yang diverifikasi untuk bekerja dengan perangkat lunak AWS IoT Greengrass Core. Anda harus menginstal Docker langsung pada perangkat inti sebelum Anda menyebarkan komponen yang menjalankan kontainer Docker.

• Daemon Docker dimulai dan berjalan pada perangkat inti sebelum Anda men-deploy komponen ini.

• Docker gambar disimpan di salah satu sumber gambar yang didukung berikut:

  • Repositori gambar publik dan privat di Amazon Elastic Container Registry (Amazon ECR)

  • Repositori Hub Docker publik

  • Registri Terpercaya Docker publik

• Gambar Docker disertakan sebagai artefak dalam komponen kontainer Docker kustom Anda. Gunakan format URI berikut untuk menentukan gambar Docker Anda:

  • Gambar Amazon ECR privat: docker:account-id.dkr.ecr.region.amazonaws.com/repository/image[:tag|@digest]

  • Citra Amazon ECR publik: docker:public.ecr.aws/repository/image[:tag|@digest]

  • Gambar Hub Docker publik: docker:name[:tag|@digest]

  Untuk informasi selengkapnya, lihat Jalankan kontainer Docker.

  catatan

  Jika Anda tidak menentukan tanda gambar atau digest gambar di URI artefak untuk gambar, maka manajer aplikasi Docker akan menarik versi terbaru yang tersedia dari gambar tersebut ketika Anda menggunakan komponen kontainer Docker kustom Anda. Untuk memastikan bahwa semua perangkat inti menjalankan versi gambar yang sama, sebaiknya sertakan tag gambar atau diges gambar di URI artefak.

• Pengguna sistem yang menjalankan komponen kontainer Docker harus memiliki izin root atau administrator, atau Anda harus mengonfigurasi Docker untuk menjalankannya sebagai pengguna non-root atau non-admistrator.

  • Pada perangkat Linux, Anda dapat menambahkan pengguna ke docker grup untuk memanggil docker perintah tanpasudo.

  • Pada perangkat Windows, Anda dapat menambahkan pengguna ke docker-users grup untuk memanggil docker perintah tanpa hak istimewa adminstrator.

  Linux or Unix

  Untuk menambahkanggc_user, atau pengguna non-root yang Anda gunakan untuk menjalankan komponen kontainer Docker, ke docker grup, jalankan perintah berikut.

  sudo usermod -aG docker ggc_user

  Untuk informasi selengkapnya, lihat Mengelola Docker sebagai pengguna non-root.

  Windows Command Prompt (CMD)

  Untuk menambahkanggc_user, atau pengguna yang Anda gunakan untuk menjalankan komponen kontainer Docker, ke docker-users grup, jalankan perintah berikut sebagai administrator.

  net localgroup docker-users ggc_user /add

  Windows PowerShell

  Untuk menambahkanggc_user, atau pengguna yang Anda gunakan untuk menjalankan komponen kontainer Docker, ke docker-users grup, jalankan perintah berikut sebagai administrator.

  Add-LocalGroupMember -Group docker-users -Member ggc_user

• Jika Anda mengkonfigurasi perangkat lunak AWS IoT Greengrass Core untuk menggunakan proxy jaringan, Anda harus mengkonfigurasi Docker untuk menggunakan server proxy yang sama.

• Jika gambar Docker Anda disimpan dalam registri privat Amazon ECR, maka Anda harus menyertakan komponen layanan pertukaran token sebagai dependensi dalam komponen kontainer Docker. Juga, peran perangkat Greengrass harus mengizinkan tindakan ecr:GetAuthorizationToken, ecr:BatchGetImage, dan ecr:GetDownloadUrlForLayer, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut.

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

• Komponen manajer aplikasi docker didukung untuk berjalan di VPC. Untuk menerapkan komponen ini di VPC, berikut ini diperlukan.

  • Komponen manajer aplikasi docker harus memiliki konektivitas untuk mengunduh gambar. Misalnya, jika Anda menggunakan ECR, Anda harus memiliki konektivitas ke titik akhir berikut.

    • *.dkr.ecr.region.amazonaws.com(Titik akhir VPC) com.amazonaws.region.ecr.dkr

    • api.ecr.region.amazonaws.com(Titik akhir VPC) com.amazonaws.region.ecr.api

• Jalankan kontainer Docker