Manajer aplikasi Docker - AWS IoT Greengrass

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Manajer aplikasi Docker

Komponen manajer aplikasi Docker (aws.greengrass.DockerApplicationManager) mengaktifkan AWS IoT Greengrass untuk mengunduh gambar Docker dari registri gambar publik. Hal ini juga memungkinkan AWS IoT Greengrass untuk mengelola kredensial untuk men-download gambar dari repositori privat di Amazon Elastic Container Registry (Amazon ECR).

Ketika Anda mengembangkan komponen kustom yang menjalankan kontainer Docker, sertakan manajer aplikasi Docker sebagai dependensi untuk men-download gambar Docker yang ditetapkan sebagai artefak dalam komponen Anda. Untuk informasi selengkapnya, lihat Jalankan kontainer Docker.

Versi

Komponen ini memiliki versi berikut:

  • 2.0.x

Tipe

Inikomponen generik (aws.greengrass.generic). YangInti Greengrassmenjalankan skrip siklus hidup komponen.

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

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

  • Linux

  • Windows

Persyaratan

Komponen ini memiliki persyaratan sebagai berikut:

  • Mesin Docker1.9.1 atau yang lebih baru yang terpasang pada perangkat inti Greengrass. Versi 20.10 adalah versi terkini yang disahkan untuk bekerja denganAWS IoT GreengrassPerangkat inti. Anda harus menginstal Docker langsung pada perangkat inti sebelum Anda men-deploy 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 kedockergrup untuk menelepondockerperintah tanpasudo.

    • Pada perangkat Windows, Anda dapat menambahkan pengguna kedocker-usersgrup untuk menelepondockerperintah tanpa hak adminstrator.

    Linux or Unix

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

    sudo usermod -aG docker ggc_user

    Untuk informasi selengkapnya, lihatMengelola Docker sebagai pengguna non-root.

    Windows Command Prompt (CMD)

    Untuk menambahkanggc_user, atau pengguna yang Anda gunakan untuk menjalankan komponen kontainer Docker, kedocker-usersgrup, 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, kedocker-usersgrup, jalankan perintah berikut sebagai administrator.

    Add-LocalGroupMember -Group docker-users -Member ggc_user
  • Jika AndakonfigurasiAWS IoT GreengrassPerangkat lunak inti untuk menggunakan proxy jaringan, Anda harusmengkonfigurasi 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" } ] }

Titik akhir dan port

Komponen ini harus dapat melakukan permintaan keluar ke titik akhir dan port berikut, selain titik akhir dan port yang diperlukan untuk operasi dasar. Untuk informasi selengkapnya, lihat Izinkan lalu lintas perangkat melalui proxy atau firewall.

Titik Akhir Port Diperlukan Deskripsi

ecr.region.amazonaws.com

443 Tidak

Diperlukan jika Anda mengunduh gambar Docker dari Amazon ECR.

hub.docker.com

registry.hub.docker.com/v1

443 Tidak

Diperlukan jika Anda mengunduh gambar Docker dari Docker Hub.

Dependensi

Saat Anda men-deploy komponen, AWS IoT Greengrass juga men-deploy versi dependensinya yang kompatibel. Ini berarti bahwa Anda harus memenuhi persyaratan untuk komponen dan semua dependensinya untuk berhasil men-deploy komponen. Bagian ini berisi daftar dependensi untuk versi yang dirilis dari komponen ini dan kendala versi semantik yang menentukan versi komponen untuk setiap dependensi. Anda juga dapat melihat dependensi untuk setiap versi komponen di konsol AWS IoT Greengrass tersebut. Pada halaman detail komponen, cari daftar Dependensi.

2.0.6

Tabel berikut mencantumkan dependensi untuk versi 2.0.6 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.8.0 Lunak
2.0.5

Tabel berikut mencantumkan dependensi untuk versi 2.0.5 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.7.0 Lunak
2.0.4

Tabel berikut mencantumkan dependensi untuk versi 2.0.4 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.6.0 Lunak
2.0.3

Tabel berikut mencantumkan dependensi untuk versi 2.0.3 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.5.0 Lunak
2.0.2

Tabel berikut mencantumkan dependensi untuk versi 2.0.2 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.4.0 Lunak
2.0.1

Tabel berikut mencantumkan dependensi untuk versi 2.0.1 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.3.0 Lunak
2.0.0

Tabel berikut mencantumkan dependensi untuk versi 2.0.0 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.2.0 Lunak

Untuk informasi selengkapnya tentang dependensi komponen, lihat referensi resep komponen.

Konfigurasi

Komponen ini tidak memiliki parameter konfigurasi apapun.

File log lokal

Komponen ini menggunakan file log berikut.

Linux
/greengrass/v2/logs/aws.greengrass.DockerApplicationManager.log
Windows
C:\greengrass\v2\logs\aws.greengrass.DockerApplicationManager.log

Untuk melihat log komponen ini

  • Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti/greengrass/v2atauC:\greengrass\v2dengan jalur keAWS IoT Greengrassfolder akar.

    Linux
    sudo tail -f /greengrass/v2/logs/aws.greengrass.DockerApplicationManager.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.greengrass.DockerApplicationManager.log -Tail 10 -Wait

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.

Versi

Perubahan

2.0.6

Versi yang diperbarui untuk rilis inti Greengrass versi 2.7.0.

2.0.5

Versi yang diperbarui untuk rilis inti Greengrass versi 2.6.0.

2.0.4

Versi yang diperbarui untuk rilis inti Greengrass versi 2.5.0.

2.0.3

Versi yang diperbarui untuk rilis inti Greengrass versi 2.4.0.

2.0.2

Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0.

2.0.1

Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0.

2.0.0

Versi awal.

Lihat juga