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) 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 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 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, seperti ecr: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.region.amazonaws.com(VPCtitik akhircom.amazonaws.region.ecr.dkr)

      • api.ecr.region.amazonaws.com(VPCtitik akhircom.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

ecr.region.amazonaws.com

443 Tidak

Diperlukan jika Anda mengunduh gambar Docker dari AmazonECR.

hub.docker.com

registry.hub.docker.com/v1

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 tersebut. Pada halaman detail komponen, cari daftar Dependensi.

2.0.12

Tabel berikut mencantumkan dependensi untuk versi 2.0.12 komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.0.11 komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.0.10 komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.0.9 komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.0.8 komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.0.7 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.1.0 <2.9.0 Lunak
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.

Berkas log lokal

Komponen ini menggunakan file log yang sama dengan komponen inti Greengrass.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Untuk melihat log komponen ini
  • Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti /greengrass/v2 atau C:\greengrass\v2 dengan jalur ke folder AWS IoT Greengrass root.

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

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.

Lihat juga