Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pengaturan untuk Perangkat dan Armada di SageMaker Edge Manager
Armada adalah kumpulan perangkat yang dikelompokkan secara logis yang dapat Anda gunakan untuk mengumpulkan dan menganalisis data. Anda dapat menggunakan SageMaker Edge Manager untuk mengoperasikan model pembelajaran mesin pada armada kamera pintar, speaker pintar, robot, dan perangkat tepi lainnya.
Buat armada dan daftarkan perangkat Anda secara terprogram dengan AWS SDK untuk Python (Boto3) atau melalui konsol SageMaker AI.
**Topics**
+ [Buat Armada](edge-device-fleet-create.md)
+ [Daftarkan Perangkat](edge-device-fleet-register.md)
+ [Periksa Status](edge-device-fleet-check-status.md)
# Buat Armada
[Anda dapat membuat armada secara terprogram dengan AWS SDK untuk Python (Boto3) atau melalui konsol SageMaker https://console.aws.amazon.com AI/sagemaker.](https://console.aws.amazon.com/sagemaker/)
## Buat Armada (Boto3)
Gunakan `CreateDeviceFleet` API untuk membuat armada. Tentukan nama untuk armada, ARN AWS IoT Peran Anda untuk `RoleArn` bidang, serta URI Amazon S3 tempat perangkat menyimpan data sampel.
Anda dapat secara opsional menyertakan deskripsi armada, tag, dan ID AWS KMS Kunci.
```
import boto3
# Create SageMaker client so you can interact and manage SageMaker resources
sagemaker_client = boto3.client("sagemaker", region_name="aws-region")
sagemaker_client.create_device_fleet(
DeviceFleetName="sample-fleet-name",
RoleArn="arn:aws:iam::999999999:role/rolename", # IoT Role ARN
Description="fleet description",
OutputConfig={
S3OutputLocation="s3://bucket/",
KMSKeyId: "1234abcd-12ab-34cd-56ef-1234567890ab",
},
Tags=[
{
"Key": "string",
"Value" : "string"
}
],
)
```
Alias AWS IoT Peran dibuat untuk Anda saat Anda membuat armada perangkat. Alias AWS IoT peran menyediakan mekanisme untuk perangkat yang terhubung untuk mengautentikasi AWS IoT menggunakan sertifikat X.509 dan kemudian mendapatkan AWS kredensil berumur pendek dari peran IAM yang terkait dengan alias peran. AWS IoT
Gunakan `DescribeDeviceFleet` untuk mendapatkan nama alias peran dan ARN.
```
# Print Amazon Resource Name (ARN) and alias that has access
# to AWS Internet of Things (IoT).
sagemaker_client.describe_device_fleet(DeviceFleetName=device_fleet_name)['IotRoleAlias']
```
Gunakan `DescribeDeviceFleet` API untuk mendapatkan deskripsi armada yang Anda buat.
```
sagemaker_client.describe_device_fleet(
DeviceFleetName="sample-fleet-name"
)
```
Secara default, ia mengembalikan nama armada, armada perangkat ARN, Amazon S3 bucket URI, peran IAM, alias peran yang dibuat, stempel waktu saat armada dibuat AWS IoT, dan stempel waktu kapan armada terakhir dimodifikasi.
```
{ "DeviceFleetName": "sample-fleet-name",
"DeviceFleetArn": "arn:aws:sagemaker:us-west-2:9999999999:device-fleet/sample-fleet-name",
"IAMRole": "arn:aws:iam::999999999:role/rolename",
"Description": "this is a sample fleet",
"IoTRoleAlias": "arn:aws:iot:us-west-2:9999999999:rolealias/SagemakerEdge-sample-fleet-name"
"OutputConfig": {
"S3OutputLocation": "s3://bucket/folder",
"KMSKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
},
"CreationTime": "1600977370",
"LastModifiedTime": "1600977370"}
```
## Buat Armada (Konsol)
Anda dapat membuat pekerjaan pengemasan Edge Manager menggunakan konsol Amazon SageMaker AI di [https://console.aws.amazon.com/sagemaker](https://console.aws.amazon.com/sagemaker/).
1. Di konsol SageMaker AI, pilih **Edge Manager** lalu pilih **armada perangkat Edge**.
1. Pilih **Buat armada perangkat**.
![\[Lokasi armada perangkat Buat di konsol.\]](http://docs.aws.amazon.com/id_id/sagemaker/latest/dg/images/smith/create-device-button-edited.png)
1. Masukkan nama untuk armada perangkat di bidang **Nama armada perangkat**. Pilih **Berikutnya**.
![\[Lokasi tombol Berikutnya di bagian Properti armada perangkat di konsol.\]](http://docs.aws.amazon.com/id_id/sagemaker/latest/dg/images/smith/create-device-fleet-filled.png)
1. Pada halaman **konfigurasi Output**, tentukan URI bucket Amazon S3 tempat Anda ingin menyimpan data sampel dari armada perangkat. Anda dapat secara opsional menambahkan kunci enkripsi juga dengan memilih AWS KMS kunci yang ada dari daftar dropdown atau dengan memasukkan ARN kunci. Pilih **Kirim**.
![\[Contoh halaman konfigurasi Output di konsol.\]](http://docs.aws.amazon.com/id_id/sagemaker/latest/dg/images/smith/create-device-fleet-output-filled.png)
1. Pilih nama armada perangkat Anda untuk diarahkan ke detail armada perangkat. Halaman ini menampilkan nama armada perangkat, ARN, deskripsi (jika Anda memberikannya), tanggal armada dibuat, terakhir kali armada diubah, URI bucket Amazon S3, ID kunci (jika disediakan) AWS KMS , alias (jika disediakan) AWS IoT , dan peran IAM. Jika Anda menambahkan tag, tag akan muncul di bagian **Tag armada perangkat**.
# Daftarkan Perangkat
**penting**
Pendaftaran perangkat diperlukan untuk menggunakan bagian mana pun dari SageMaker Edge Manager.
[Anda dapat membuat armada secara terprogram dengan AWS SDK untuk Python (Boto3) atau melalui konsol SageMaker AI di /sagemaker. https://console.aws.amazon.com](https://console.aws.amazon.com/sagemaker/)
## Daftarkan Perangkat (Boto3)
Untuk mendaftarkan perangkat Anda, pertama-tama buat dan daftarkan objek AWS IoT benda dan konfigurasikan peran IAM. SageMaker Edge Manager memanfaatkan AWS IoT Core layanan untuk memfasilitasi koneksi antara perangkat edge dan cloud. Anda dapat memanfaatkan AWS IoT fungsionalitas yang ada setelah mengatur perangkat agar berfungsi dengan Edge Manager.
Untuk menghubungkan perangkat Anda ke AWS IoT Anda perlu membuat objek AWS IoT benda, membuat dan mendaftarkan sertifikat klien dengan AWS IoT, dan membuat dan mengkonfigurasi peran IAM untuk perangkat Anda.
Lihat [Panduan Memulai](https://docs.aws.amazon.com/sagemaker/latest/dg/edge-manager-getting-started.html) untuk contoh mendalam atau [layanan Jelajahi AWS IoT Core dalam](https://docs.aws.amazon.com/iot/latest/developerguide/iot-gs-first-thing.html) tutorial langsung.
Gunakan `RegisterDevices` API untuk mendaftarkan perangkat Anda. Berikan nama armada yang Anda inginkan perangkat menjadi bagiannya, serta nama untuk perangkat tersebut. Anda secara opsional dapat menambahkan deskripsi ke perangkat, tag, dan nama AWS IoT benda yang terkait dengan perangkat.
```
sagemaker_client.register_devices(
DeviceFleetName="sample-fleet-name",
Devices=[
{
"DeviceName": "sample-device-1",
"IotThingName": "sample-thing-name-1",
"Description": "Device #1"
}
],
Tags=[
{
"Key": "string",
"Value" : "string"
}
],
)
```
## Daftarkan Perangkat (Konsol)
Anda dapat mendaftarkan perangkat Anda menggunakan konsol SageMaker AI di [https://console.aws.amazon.com/sagemaker](https://console.aws.amazon.com/sagemaker/).
1. Di konsol SageMaker AI, pilih **Edge Inference** lalu pilih **perangkat Edge**.
1. Pilih **Daftarkan perangkat**.
![\[Lokasi Daftarkan perangkat di bagian Perangkat Tepi konsol.\]](http://docs.aws.amazon.com/id_id/sagemaker/latest/dg/images/smith/register-device-button.png)
1. Di bagian **Properti perangkat**, masukkan nama armada yang dimiliki perangkat di bawah bidang **Nama armada perangkat**. Pilih **Berikutnya**.
![\[Bagian Properti perangkat di konsol.\]](http://docs.aws.amazon.com/id_id/sagemaker/latest/dg/images/smith/register-devices-empty.png)
1. Di bagian **Sumber perangkat**, tambahkan perangkat Anda satu per satu. Anda harus menyertakan **Nama Perangkat** untuk setiap perangkat di armada Anda. Anda secara opsional dapat memberikan deskripsi (di bidang **Deskripsi**) dan nama objek Internet of Things (IoT) (di bidang nama **IoT**). Pilih **Kirim** setelah Anda menambahkan semua perangkat Anda.
![\[Bagian Sumber perangkat di konsol.\]](http://docs.aws.amazon.com/id_id/sagemaker/latest/dg/images/smith/register-devices-device-source.png)
Halaman **Perangkat** menampilkan nama perangkat yang telah Anda tambahkan, armada yang dimilikinya, kapan terdaftar, detak jantung terakhir, dan deskripsi dan AWS IoT nama, jika Anda memberikannya.
Pilih perangkat untuk melihat detail perangkat, termasuk nama perangkat, armada, ARN, deskripsi, nama IoT Thing, saat perangkat terdaftar, dan detak jantung terakhir.
# Periksa Status
Periksa apakah perangkat atau armada Anda terhubung dan mengambil sampel data. Melakukan pemeriksaan berkala, secara manual atau otomatis, memungkinkan Anda untuk memeriksa apakah perangkat atau armada Anda berfungsi dengan baik.
Gunakan konsol Amazon S3 di [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)untuk secara interaktif memilih armada untuk pemeriksaan status. Anda juga dapat menggunakan AWS SDK untuk Python (Boto3). Berikut ini menjelaskan berbeda APIs dari Boto3 yang dapat Anda gunakan untuk memeriksa status perangkat atau armada Anda. Gunakan API yang paling sesuai dengan kasus penggunaan Anda.
+ **Periksa perangkat individual.**
Untuk memeriksa status perangkat individual, gunakan `DescribeDevice` API. Daftar yang berisi satu atau beberapa model disediakan jika model telah diterapkan ke perangkat.
```
sagemaker_client.describe_device(
DeviceName="sample-device-1",
DeviceFleetName="sample-fleet-name"
)
```
Menjalankan `DescribeDevice` pengembalian:
```
{ "DeviceName": "sample-device".
"Description": "this is a sample device",
"DeviceFleetName": "sample-device-fleet",
"IoTThingName": "SampleThing",
"RegistrationTime": 1600977370,
"LatestHeartbeat": 1600977370,
"Models":[
{
"ModelName": "sample-model",
"ModelVersion": "1.1",
"LatestSampleTime": 1600977370,
"LatestInference": 1600977370
}
]
}
```
+ **Periksa armada perangkat.**
Untuk memeriksa status armada, gunakan `GetDeviceFleetReport` API. Berikan nama armada perangkat untuk mendapatkan ringkasan armada.
```
sagemaker_client.get_device_fleet_report(
DeviceFleetName="sample-fleet-name"
)
```
+ **Periksa detak jantung.**
Setiap perangkat dalam armada secara berkala menghasilkan sinyal, atau “detak jantung”. Detak jantung dapat digunakan untuk memeriksa apakah perangkat berkomunikasi dengan Edge Manager. Jika stempel waktu detak jantung terakhir tidak diperbarui, perangkat mungkin gagal.
Periksa detak jantung terakhir dengan dibuat oleh perangkat dengan `DescribeDevice` API. Tentukan nama perangkat dan armada tempat perangkat tepi berada.
```
sagemaker_client.describe_device(
DeviceName="sample-device-1",
DeviceFleetName="sample-fleet-name"
)
```