Pemberitahuan akhir dukungan: Pada 7 Oktober 2026, AWS akan menghentikan dukungan untuk. AWS IoT Greengrass Version 1 Setelah 7 Oktober 2026, Anda tidak akan lagi dapat mengakses sumber daya. AWS IoT Greengrass V1 Untuk informasi lebih lanjut, silakan kunjungi [Migrasi dari AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Opsional: Mengonfigurasi wadah Docker Anda untuk IDT untuk AWS IoT Greengrass
AWS IoT Greengrass menyediakan gambar Docker dan Dockerfile yang membuatnya lebih mudah untuk menjalankan perangkat lunak AWS IoT Greengrass Core dalam wadah Docker. Setelah menyiapkan AWS IoT Greengrass penampung, Anda dapat menjalankan pengujian IDT. Saat ini, hanya x86\_64 Docker arsitektur yang didukung untuk menjalankan IDT untuk AWS IoT Greengrass.
Fitur ini memerlukan IDT v2.3.0 atau yang lebih baru.
Proses pengaturan wadah Docker untuk menjalankan tes IDT bergantung pada apakah Anda menggunakan image Docker atau Dockerfile yang disediakan oleh. AWS IoT Greengrass
+ [Gunakan gambar Docker](#docker-config-setup-docker-image). Gambar Docker memiliki perangkat lunak AWS IoT Greengrass Core dan dependensi yang diinstal.
+ [Menggunakan Dockerfile](#docker-config-setup-dockerfile). Dockerfile berisi kode sumber yang dapat Anda gunakan untuk membangun gambar AWS IoT Greengrass kontainer khusus. Citra dapat dimodifikasi untuk berjalan pada arsitektur platform yang berbeda atau untuk mengurangi ukuran citra.
**catatan**
AWS IoT Greengrass tidak menyediakan gambar Dockerfiles atau Docker untuk perangkat lunak AWS IoT Greengrass inti versi 1.11.1. Untuk menjalankan pengujian IDT pada gambar kontainer kustom Anda sendiri, gambar Anda harus menyertakan dependensi yang ditentukan dalam Dockerfile yang disediakan oleh. AWS IoT Greengrass
Fitur berikut tidak tersedia saat Anda menjalankan AWS IoT Greengrass di wadah Docker:
+ [Konektor](connectors.md) yang berjalan di mode **kontainer Greengrass** ini. Untuk menjalankan konektor dalam kontainer Docker, konektor harus berjalan dengan mode **Tanpa kontainer** ini. Untuk menemukan konektor yang mendukung mode **Tanpa kontainer** ini, lihat [AWS-disediakan konektor Greengrass](connectors-list.md). Beberapa konektor ini memiliki parameter mode isolasi yang harus Anda atur ke **Tanpa kontainer**.
+ [Sumber daya perangkat dan volume lokal](access-local-resources.md). Fungsi Lambda yang ditetapkan pengguna milik Anda yang berjalan dalam kontainer Docker harus mengakses perangkat dan volume pada core secara langsung.
## Konfigurasikan gambar Docker yang disediakan oleh AWS IoT Greengrass
Ikuti langkah-langkah ini untuk mengonfigurasi image AWS IoT Greengrass Docker untuk menjalankan tes IDT.
**Prasyarat**
Sebelum Anda mulai tutorial ini, Anda harus melakukan hal berikut.
+ Anda harus menginstal perangkat lunak dan versi berikut di komputer host Anda berdasarkan versi AWS Command Line Interface (AWS CLI) yang Anda pilih.
------
#### [ AWS CLI version 2 ]
+ [Docker](https://docs.docker.com/install/) versi 18.09 atau yang lebih baru. Versi sebelumnya juga dapat berfungsi, namun kami merekomendasikan 18.09 atau yang lebih baru.
+ AWS CLI versi 2.0.0 atau yang lebih baru.
+ Untuk menginstal AWS CLI versi 2, lihat [Menginstal AWS CLI versi 2](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html).
+ Untuk mengkonfigurasi AWS CLI, lihat [Mengkonfigurasi. AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)
**catatan**
Untuk meningkatkan ke AWS CLI versi 2 yang lebih baru di komputer Windows, Anda harus mengulangi proses [instalasi MSI](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2-windows.html).
------
#### [ AWS CLI version 1 ]
+ [Docker](https://docs.docker.com/install/) versi 18.09 atau yang lebih baru. Versi sebelumnya juga dapat berfungsi, namun kami merekomendasikan 18.09 atau yang lebih baru.
+ [Python](https://www.python.org/downloads/) versi 3.6 atau lebih baru.
+ [pip](https://pip.pypa.io/en/stable/installing) versi 18.1 atau yang lebih baru.
+ AWS CLI versi 1.17.10 atau yang lebih baru
+ Untuk menginstal AWS CLI versi 1, lihat [Menginstal AWS CLI versi 1](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html).
+ Untuk mengkonfigurasi AWS CLI, lihat [Mengkonfigurasi. AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)
+ Untuk meningkatkan ke versi terbaru dari AWS CLI versi 1, jalankan perintah berikut.
```
pip install awscli --upgrade --user
```
**catatan**
Jika Anda menggunakan [instalasi MSI](https://docs.aws.amazon.com/cli/latest/userguide/install-windows.html#msi-on-windows) AWS CLI versi 1 di Windows, perhatikan hal berikut:
Jika instalasi AWS CLI versi 1 gagal menginstal botocore, coba gunakan instalasi [Python](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html#awscli-install-windows-pip) dan pip.
Untuk meningkatkan ke AWS CLI versi 1 yang lebih baru, Anda harus mengulangi proses instalasi MSI.
------
+ Untuk mengakses sumber daya Amazon Elastic Container Registry (Amazon ECR), Anda harus memberikan izin berikut.
+ Amazon ECR mengharuskan pengguna untuk memberikan `ecr:GetAuthorizationToken` izin melalui kebijakan AWS Identity and Access Management (IAM) sebelum mereka dapat mengautentikasi ke registri dan mendorong atau menarik gambar dari repositori Amazon ECR. Untuk informasi lebih lanjut, lihat [Contoh Kebijakan Repositori Amazon ECR](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-policy-examples.html) dan [Mengakses Satu Repositori Amazon ECR](https://docs.aws.amazon.com/AmazonECR/latest/userguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-access-one-bucket) di *Amazon Elastic Container Registry*.
1. Unduh gambar Docker dan konfiguras kontainer. Anda dapat mengunduh citra prebuilt dari [Docker Hub](https://hub.docker.com/r/amazon/aws-iot-greengrass) atau [Amazon Elastic Container Registry](https://docs.aws.amazon.com/AmazonECR/latest/userguide/what-is-ecr.html) (Amazon ECR) dan menjalankannya pada platform Windows, MacOS, dan Linux (x86\_64).
Untuk mengunduh gambar Docker dari Amazon ECR, selesaikan semua langkah di [Langkah 1: Dapatkan AWS IoT Greengrass gambar kontainer dari Amazon ECR](run-gg-in-docker-container.md#docker-pull-image). Kemudian, kembali ke topik ini untuk melanjutkan konfigurasi.
1. Hanya pengguna Linux: Pastikan pengguna yang menjalankan IDT memiliki izin untuk menjalankan perintah Docker. Untuk informasi lebih lanjut, lihat [Mengelola Docker sebagai pengguna non-root](https://docs.docker.com/install/linux/linux-postinstall/#manage-docker-as-a-non-root-user) dalam dokumentasi Docker.
1. Untuk menjalankan AWS IoT Greengrass wadah, gunakan perintah untuk sistem operasi Anda:
------
#### [ Linux ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
-v {{}}:{{}} \
{{}}:{{}}
```
+ Ganti {{}} dengan jalur ke file konfigurasi kernel pada host dan {{}} dengan jalur tempat volume dipasang di wadah.
File konfigurasi kernel pada host biasanya terletak di `/proc/config.gz` atau `/boot/config-{{}}`. Anda dapat berlari `uname -r` untuk menemukan {{}} nilainya.
**Contoh:** Untuk memasang file konfigurasi dari `/boot/config-{{}}`
```
-v /boot/config-4.15.0-74-generic:/boot/config-4.15.0-74-generic \
```
**Contoh:** Untuk memasang file konfigurasi dari `proc/config.gz`
```
-v /proc/config.gz:/proc/config.gz \
```
+ Ganti{{}}: {{}} dalam perintah dengan nama repositori dan tag gambar target.
**Contoh:** Untuk menunjuk ke versi terbaru dari perangkat lunak AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Untuk mendapatkan daftar gambar AWS IoT Greengrass Docker, jalankan perintah berikut.
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
#### [ macOS ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
{{}}:{{}}
```
+ Ganti{{}}: {{}} dalam perintah dengan nama repositori dan tag gambar target.
**Contoh:** Untuk menunjuk ke versi terbaru dari perangkat lunak AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Untuk mendapatkan daftar gambar AWS IoT Greengrass Docker, jalankan perintah berikut:
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
#### [ Windows ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
{{}}:{{}}
```
+ Ganti{{}}: {{}} dalam perintah dengan nama repositori dan tag gambar target.
**Contoh:** Untuk menunjuk ke versi terbaru dari perangkat lunak AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Untuk mendapatkan daftar gambar AWS IoT Greengrass Docker, jalankan perintah berikut:
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
**penting**
Saat menguji dengan IDT, jangan sertakan `--entrypoint /greengrass-entrypoint.sh \` argumen yang digunakan untuk menjalankan image untuk AWS IoT Greengrass penggunaan umum.
1. Langkah selanjutnya: [Konfigurasikan AWS kredensyal dan `device.json` file Anda](set-config.md).
## Konfigurasikan dockerfile yang disediakan oleh AWS IoT Greengrass
Ikuti langkah-langkah ini untuk mengonfigurasi image Docker yang dibangun dari AWS IoT Greengrass Dockerfile untuk menjalankan pengujian IDT.
1. Dari [AWS IoT Greengrass Perangkat lunak Docker](what-is-gg.md#gg-docker-download), mengunduh paket Dockerfile ke komputer host Anda dan mengekstraksi itu.
1. Buka `README.md`. Tiga langkah selanjutnya mengacu pada bagian dalam file ini.
1. Pastikan Anda memenuhi persyaratan di **bagian** Prasyarat.
1. Hanya pengguna Linux: Selesaikan langkah-langkah **Mengaktifkan Symlink dan Perlindungan Hardlink** dan **Mengaktifkan Penerusan Jaringan IPv4** ini.
1. Untuk membuat gambar Docker, selesaikan semua langkah di **Langkah 1. Bangun Gambar AWS IoT Greengrass Docker**. Kemudian, kembali ke topik ini untuk melanjutkan konfigurasi.
1. Untuk menjalankan AWS IoT Greengrass wadah, gunakan perintah untuk sistem operasi Anda:
------
#### [ Linux ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
-v {{}}:{{}} \
{{}}:{{}}
```
+ Ganti {{}} dengan jalur ke file konfigurasi kernel pada host dan {{}} dengan jalur tempat volume dipasang di wadah.
File konfigurasi kernel pada host biasanya terletak di `/proc/config.gz` atau `/boot/config-{{}}`. Anda dapat berlari `uname -r` untuk menemukan {{}} nilainya.
**Contoh:** Untuk memasang file konfigurasi dari `/boot/config-{{}}`
```
-v /boot/config-4.15.0-74-generic:/boot/config-4.15.0-74-generic \
```
**Contoh:** Untuk memasang file konfigurasi dari `proc/config.gz`
```
-v /proc/config.gz:/proc/config.gz \
```
+ Ganti{{}}: {{}} dalam perintah dengan nama repositori dan tag gambar target.
**Contoh:** Untuk menunjuk ke versi terbaru dari perangkat lunak AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Untuk mendapatkan daftar gambar AWS IoT Greengrass Docker, jalankan perintah berikut.
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
#### [ macOS ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
{{}}:{{}}
```
+ Ganti{{}}: {{}} dalam perintah dengan nama repositori dan tag gambar target.
**Contoh:** Untuk menunjuk ke versi terbaru dari perangkat lunak AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Untuk mendapatkan daftar gambar AWS IoT Greengrass Docker, jalankan perintah berikut:
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
#### [ Windows ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
{{}}:{{}}
```
+ Ganti{{}}: {{}} dalam perintah dengan nama repositori dan tag gambar target.
**Contoh:** Untuk menunjuk ke versi terbaru dari perangkat lunak AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Untuk mendapatkan daftar gambar AWS IoT Greengrass Docker, jalankan perintah berikut:
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
**penting**
Saat menguji dengan IDT, jangan sertakan `--entrypoint /greengrass-entrypoint.sh \` argumen yang digunakan untuk menjalankan image untuk AWS IoT Greengrass penggunaan umum.
1. Langkah selanjutnya: [Konfigurasikan AWS kredensyal dan `device.json` file Anda](set-config.md).
## Memecahkan masalah pengaturan kontainer Docker Anda untuk IDT untuk AWS IoT Greengrass
Gunakan informasi berikut untuk membantu memecahkan masalah dengan menjalankan wadah Docker untuk IDT untuk pengujian. AWS IoT Greengrass
### PERINGATAN: Kesalahan saat memuat file konfigurasi:/home/user/. docker/config.json - stat/rumah/pengguna < /. > docker/config.json: izin ditolak
Jika Anda mendapatkan kesalahan ini ketika menjalankan perintah `docker` di Linux, jalankan perintah berikut. Ganti {{}} dalam perintah berikut dengan pengguna yang menjalankan IDT.
```
sudo chown {{}}:{{}} /home/{{}}/.docker -R
sudo chmod g+rwx /home/{{}}/.docker -R
```