Buat deployment massal untuk grup

Jalankan perintah berikut untuk mendapatkan groupId untuk setiap grup yang ingin Anda gunakan. Anda memasukkan groupId ke file input deployment massal Anda sehingga AWS IoT Greengrass dapat mengidentifikasi setiap usaha untuk di-deploy.

aws greengrass list-groups
        

Respons berisi informasi tentang setiap grup di akun AWS IoT Greengrass Anda:

{
  "Groups": [
    {
      "Name": "string",
      "Id": "string",
      "Arn": "string",
      "LastUpdatedTimestamp": "string",
      "CreationTimestamp": "string",
      "LatestVersion": "string",
      "LatestVersionArn": "string"
    }
  ],
  "NextToken": "string"
}          
        

Jalankan perintah berikut untuk mendapatkan groupVersionId dari setiap grup yang ingin Anda men-deploy.

list-group-versions --group-id groupId
        

Respons berisi informasi tentang semua versi dalam grup. Buat catatan tentang Version nilai untuk versi grup yang ingin Anda gunakan.

{
  "Versions": [
    {
      "Arn": "string",
      "Id": "string",
      "Version": "string",
      "CreationTimestamp": "string"
    }
  ],
  "NextToken": "string"
}
        

Di terminal komputer Anda atau editor pilihan, buat file,MyBulkDeploymentInputFile, dari contoh berikut. File ini berisi informasi tentang masing-masing AWS IoT Greengrass grup untuk dimasukkan dalam deployment massal. Meskipun contoh ini mendefinisikan beberapa grup, untuk tutorial ini, file Anda dapat berisi hanya satu.

{"GroupId":"groupId1", "GroupVersionId":"groupVersionId1", "DeploymentType":"NewDeployment"}
{"GroupId":"groupId2", "GroupVersionId":"groupVersionId2", "DeploymentType":"NewDeployment"}
{"GroupId":"groupId3", "GroupVersionId":"groupVersionId3", "DeploymentType":"NewDeployment"}
...
        

Setiap catatan (atau baris) berisi objek grup. Setiap objek grup berisi yang sesuai GroupId dan GroupVersionId dan sebuah DeploymentType. Saat ini, AWS IoT Greengrass mendukung NewDeployment jenis deployment massal saja.

Simpan dan tutup file Anda. Buat catatan tentang lokasi file.

Gunakan perintah berikut di terminal Anda untuk mengunggah file input Anda ke bucket Amazon S3 Anda. Ganti path file dengan lokasi dan nama file Anda. Untuk informasi, lihat Menambahkan objek ke bucket.

aws s3 cp path/MyBulkDeploymentInputFile s3://my-bucket/

Gunakan kebijakan berikut untuk membuat peran eksekusi. Dokumen kebijakan ini mengizinkan AWS IoT Greengrass untuk mengakses file input deployment massal Anda ketika membuat setiap deployment atas nama Anda.

Untuk informasi lebih lanjut tentang membuat IAM role dan mendelegasikan izin, lihat Membuat IAM role.

 {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": "greengrass:CreateDeployment",
            "Resource": [
                "arn:aws:greengrass:region:accountId:/greengrass/groups/groupId1",
                "arn:aws:greengrass:region:accountId:/greengrass/groups/groupId2",
                "arn:aws:greengrass:region:accountId:/greengrass/groups/groupId3",
                ...
            ]
        }
    ]
}
        

"Resource": ["*"]

Modifikasi hubungan kepercayaan untuk peran eksekusi Anda untuk menyertakan AWS IoT Greengrass. Ini mengizinkan AWS IoT Greengrass untuk menggunakan peran eksekusi Anda dan izin yang melekat padanya. Untuk informasi, lihat Mengedit hubungan kepercayaan untuk peran yang ada.

Kami merekomendasikan Anda juga memasukkanaws:SourceArndanaws:SourceAccountkunci konteks kondisi global dalam kebijakan kepercayaan Anda untuk membantu mencegahdeputi bingungmasalah keamanan. Kunci konteks kondisi membatasi akses untuk mengizinkan hanya permintaan yang berasal dari akun tertentu dan ruang kerja Greengrass. Untuk informasi lebih lanjut tentang masalah deputi yang membingungkan, lihatCross-service bingung wakil pencegahan.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "",
      "Effect": "Allow",
      "Principal": {
        "Service": "greengrass.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "account-id"
        },
        "ArnLike": {
          "aws:SourceArn": "arn:aws:greengrass:region:account-id:*"
        }
      }
    }
  ]
}

Berikan IAM PassRole izin untuk peran eksekusi ke pengguna IAM Anda. Pengguna IAM ini adalah salah satu yang digunakan untuk memulai deployment massal. PassRole mengizinkan pengguna IAM Anda untuk meneruskan peran eksekusi Anda ke AWS IoT Greengrass untuk digunakan. Untuk informasi lebih lanjut, lihat Memberikan izin pengguna untuk meneruskan peran ke AWS layanan.

Gunakan contoh berikut untuk memperbarui kebijakan IAM yang dilampirkan pada peran eksekusi yang dilampirkan pada peran eksekusi Anda. Memodifikasi contoh ini, jika perlu.

 {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Stmt1508193814000",
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ],
            "Resource": [
                "arn:aws:iam::account-id:user/executionRoleArn"
            ]
            "Condition": {
                "StringEquals": {
                    "iam:PassedToService": "greengrass.amazonaws.com"
                }
            }
        }
    ]
}
        

Gunakan perintah berikut untuk memulai deployment massal.

Kami merekomendasikan Anda menyertakan X-Amzn-Client-Token token di setiap StartBulkDeployment permintaan. Permintaan ini idempoten sehubungan dengan token dan parameter permintaan. Token ini dapat berupa string yang unik dan sensitif hingga 64 karakter ASCII.

aws greengrass start-bulk-deployment --cli-input-json "{
          "InputFileUri":"URI of file in S3 bucket", 
          "ExecutionRoleArn":"ARN of execution role",
          "AmznClientToken":"your Amazon client token"
          }"
        

Perintah harus menghasilkan kode status sukses 200, bersama dengan respon berikut:

{
  "bulkDeploymentId": UUID
}
        

Membuat catatan ID deployment massal. Hal ini dapat digunakan untuk memeriksa status deployment massal Anda.

Gunakan perintah berikut untuk memeriksa status deployment massal Anda.

aws greengrass get-bulk-deployment-status --bulk-deployment-id 1234567

Perintah tersebut seharusnya mengembalikan kode status sukses dari 200 selain muatan JSON informasi:

 {
  "BulkDeploymentStatus": Running,
  "Statistics": {
     "RecordsProcessed": integer,
     "InvalidInputRecords": integer,
     "RetryAttempts": integer
  },
  "CreatedAt": "string",
  "ErrorMessage": "string",
  "ErrorDetails": [
    {
      "DetailedErrorCode": "string",
      "DetailedErrorMessage": "string"
    }
  ]
}
        

BulkDeploymentStatus Berisi status eksekusi massal saat ini. Eksekusi dapat memiliki satu dari enam status yang berbeda:

Muatan JSON juga mencakup informasi statistik tentang kemajuan deployment massal. Anda dapat menggunakan informasi ini untuk menentukan berapa banyak grup telah diproses dan berapa banyak telah gagal. Informasi statistik meliputi:

Dalam kasus kegagalan eksekusi deployment massal, muatan ini juga mencakup ErrorDetails bagian yang dapat digunakan untuk pemecahan masalah. Ini berisi informasi tentang penyebab kegagalan eksekusi.

Anda dapat secara berkala memeriksa status deployment massal untuk mengkonfirmasi bahwa kemajuan seperti yang diharapkan. Setelah deployment selesai, RecordsProcessed harus sama dengan jumlah grup deployment dalam file input deployment massal Anda. Hal ini menunjukkan bahwa setiap catatan telah diproses.