Créer des déploiements en bloc pour des groupes

Exécutez la commande suivante pour obtenir l'groupId de chaque groupe que vous souhaitez déployer. Vous entrez l'groupId dans votre fichier d'entrée de déploiement en bloc de telle sorte que AWS IoT Greengrass puisse identifier chaque groupe à déployer.

aws greengrass list-groups
        

La réponse contient des informations sur chaque groupe de votre compte AWS IoT Greengrass :

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

Exécutez la commande suivante pour obtenir l'groupVersionId de chaque groupe que vous souhaitez déployer.

list-group-versions --group-id groupId
        

La réponse contient des informations sur toutes les versions du groupe. Prenez en compte les informations deVersionpour la version de groupe que vous souhaitez utiliser.

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

Dans le terminal de votre ordinateur ou l'éditeur de votre choix, créez un fichier,MyBulkDeploymentInputFile, à partir de l'exemple suivant. Ce fichier contient des informations sur chaque groupe AWS IoT Greengrass à inclure dans un déploiement en bloc. Bien que cet exemple définisse plusieurs groupes, pour ce didacticiel, votre fichier peut en contenir un seul.

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

Chaque enregistrement (ou ligne) contient un objet de groupe. Chaque objet de groupe contient son GroupId et GroupVersionId correspondants et un DeploymentType. Actuellement, AWS IoT Greengrass prend uniquement en charge les types de déploiement en bloc NewDeployment.

Enregistrez et fermez votre fichier. Prenez note de l'emplacement du fichier.

Utilisez la commande suivante dans votre terminal pour charger votre fichier d'entrée dans votre compartiment Amazon S3. Remplacez le chemin de fichier par l'emplacement et le nom de votre fichier. Pour de plus amples informations, veuillez consulter Ajouter un objet à un compartiment.

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

Utilisez la stratégie suivante pour créer un rôle d'exécution. Ce document de stratégie permet à AWS IoT Greengrass d'accéder à votre fichier d'entrée de déploiement en bloc lorsqu'il crée chaque déploiement en votre nom.

Pour de plus amples informations sur la création d'un rôle IAM et la délégation des autorisations, veuillez consulter Création de rôles IAM.

 {
    "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": ["*"]

Modifiez la relation d'approbation pour votre rôle d'exécution pour inclure AWS IoT Greengrass. Cela permet à AWS IoT Greengrass d'utiliser votre rôle d'exécution et les autorisations attachées à celui-ci. Pour de plus amples informations, veuillez consulter Modification de la relation d'approbation pour un rôle existant.

Nous vous recommandons également d'inclureaws:SourceArnetaws:SourceAccountClés de contexte de condition globale dans votre stratégie d'approbation pour empêcherdéputé confusproblème de sécurité. Les clés contextuelles de condition limitent l'accès afin d'autoriser uniquement les demandes provenant du compte spécifié et de l'espace de travail Greengrass. Pour plus d'informations sur le problème du député confus, veuillez consulterPrévention du problème de l'adjoint confus entre services.

{
  "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:*"
        }
      }
    }
  ]
}

Donnez IAMPassRoleautorisations de votre rôle d'exécution à votre utilisateur IAM. Cet utilisateur IAM est celui utilisé pour initier le déploiement en bloc.PassRoleLes autorisations permettent à votre utilisateur IAM de transmettre votre rôle d'exécution àAWS IoT Greengrasspour une utilisation. Pour plus d'informations, consultez la section Octroi d'autorisations à un utilisateur pour transférer un rôle à un service AWS.

Utilisez l'exemple suivant pour mettre à jour la stratégie IAM attachée à votre rôle d'exécution. Modifiez cet exemple, si nécessaire.

 {
    "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"
                }
            }
        }
    ]
}
        

Pour démarrer le déploiement en bloc, utilisez la commande suivante :

Nous vous recommandons d'inclure un jeton X-Amzn-Client-Token dans chaque demande StartBulkDeployment. Ces demandes sont idempotentes en ce qui concerne le jeton et les paramètres de demande. Ce jeton peut être n'importe quel caractère unique, sensible à la casse et peut contenir un maximum de 64 caractères 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"
          }"
        

La commande doit entraîner la réussite de code de statut 200, ainsi que la réponse suivante :

{
  "bulkDeploymentId": UUID
}
        

Prenez note de l'ID de déploiement en bloc. Il peut être utilisé pour vérifier le statut de votre déploiement en bloc.

Utilisez la commande suivante pour vérifier le statut de votre déploiement en bloc.

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

La commande doit retourner un code de statut réussi 200 en plus d'une charge utile JSON d'informations :

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

BulkDeploymentStatus contient le statut actuel de l'exécution en bloc. L'exécution peut avoir l'un des six statuts suivants :

La charge utile JSON inclut également des données statistiques sur la progression du déploiement en bloc. Vous pouvez utiliser ces informations pour déterminer combien de groupes ont été traités et combien ont échoué. Les informations statistiques incluent :

Dans le cas d'un échec de l'exécution du déploiement en bloc, cette charge utile inclut également une section ErrorDetails qui peut être utilisée pour le dépannage. Elle contient des informations sur la cause de l'échec de l'exécution.

Vous pouvez vérifier régulièrement le statut du déploiement en bloc pour confirmer qu'il progresse comme prévu. Une fois que le déploiement est terminé, RecordsProcessed doit être égal au nombre de groupes de déploiement dans votre fichier d'entrée de déploiement en bloc. Cela indique que chaque enregistrement a été traité.