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
) memungkinkan AWS IoT Greengrass untuk mengunduh gambar Docker dari pendaftar gambar publik dan pendaftar pribadi yang dihosting di Amazon Elastic Container Registry (Amazon). ECR Ini juga memungkinkan AWS IoT Greengrass untuk mengelola kredensyal secara otomatis untuk mengunduh gambar dengan aman dari repositori pribadi di 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
Komponen ini adalah komponen generik (aws.greengrass.generic
). Inti Greengrass menjalankan 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:
-
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 pribadi 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 URI format berikut untuk menentukan gambar Docker Anda:
-
ECRGambar Amazon pribadi:
docker:
account-id
.dkr.ecr.region
.amazonaws.com/repository
/image
[:tag|@digest
] -
ECRGambar Amazon 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 tag gambar atau intisari gambar dalam artefak URI untuk gambar, maka manajer aplikasi Docker menarik versi terbaru yang tersedia dari gambar tersebut saat Anda menerapkan komponen kontainer Docker kustom Anda. Untuk memastikan bahwa semua perangkat inti Anda menjalankan versi gambar yang sama, kami sarankan Anda menyertakan tag gambar atau intisari gambar dalam artefakURI.
-
-
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 memanggildocker
perintah tanpasudo
. -
Pada perangkat Windows, Anda dapat menambahkan pengguna ke
docker-users
grup untuk memanggildocker
perintah tanpa hak istimewa adminstrator.
-
-
Jika Anda mengkonfigurasi perangkat lunak AWS IoT Greengrass Core untuk menggunakan proxy jaringan, Anda harus mengkonfigurasi Docker untuk menggunakan server proxy yang sama
. -
Jika image Docker Anda disimpan dalam registri ECR pribadi Amazon, maka Anda harus menyertakan komponen layanan pertukaran token sebagai dependensi dalam komponen kontainer Docker. Selain itu, peran perangkat Greengrass harus mengizinkan,,
ecr:GetDownloadUrlForLayer
dan tindakanecr:BatchGetImage
, sepertiecr:GetAuthorizationToken
yang ditunjukkan dalam kebijakan contoh berikut. IAM{ "Version": "2012-10-17", "Statement": [ { "Action": [ "ecr:GetAuthorizationToken", "ecr:BatchGetImage", "ecr:GetDownloadUrlForLayer" ], "Resource": [ "*" ], "Effect": "Allow" } ] }
-
Komponen manajer aplikasi docker didukung untuk berjalan di file. VPC Untuk menerapkan komponen ini di aVPC, berikut ini diperlukan.
-
Komponen manajer aplikasi docker harus memiliki konektivitas untuk mengunduh gambar. Misalnya, jika Anda menggunakanECR, Anda harus memiliki konektivitas ke titik akhir berikut.
-
*.dkr.ecr.
(VPCtitik akhirregion
.amazonaws.com.rproxy.goskope.comcom.amazonaws.
)region
.ecr.dkr -
api.ecr.
(VPCtitik akhirregion
.amazonaws.com.rproxy.goskope.comcom.amazonaws.
)region
.ecr.api
-
-
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 | Wajib | Deskripsi |
---|---|---|---|
|
443 | Tidak |
Diperlukan jika Anda mengunduh gambar Docker dari AmazonECR. |
|
443 | Tidak |
Diperlukan jika Anda mengunduh gambar Docker dari Docker Hub. |
Dependensi
Saat Anda menerapkan komponen, gunakan AWS IoT Greengrass juga 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
Untuk informasi selengkapnya tentang dependensi komponen, lihat referensi resep komponen.
Konfigurasi
Komponen ini tidak memiliki parameter konfigurasi apapun.
Berkas log lokal
Komponen ini menggunakan file log yang sama dengan komponen inti Greengrass.
Untuk melihat log komponen ini
-
Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti
atau/greengrass/v2
C:\greengrass\v2
dengan jalur ke folder AWS IoT Greengrass root.
Changelog
Tabel berikut menjelaskan perubahan dalam setiap versi komponen.
Versi |
Perubahan |
---|---|
2.0.12 |
Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. |
2.0.11 |
Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. |
2.0.10 |
Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. |
2.0.9 |
Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. |
2.0.8 |
Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. |
2.0.7 |
Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. |
2.0.6 |
Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. |
2.0.5 |
Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. |
2.0.4 |
Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. |
2.0.3 |
Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. |
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. |