Creación de implementaciones de grupos por lotes

Ejecute el siguiente comando con el fin de obtener el parámetro groupId para cada grupo que desea implementar. Escriba el parámetro groupId en el archivo de entrada de implementación por lotes, de modo que AWS IoT Greengrass pueda identificar cada grupo que se va a implementar.

aws greengrass list-groups
        

La respuesta contiene información acerca de cada grupo de su cuenta de AWS IoT Greengrass:

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

Ejecute el siguiente comando con el fin de obtener el parámetro groupVersionId de cada grupo que desea implementar.

list-group-versions --group-id groupId
        

La respuesta contiene información acerca de todas las versiones de grupo. Anote el valor de la Version del grupo que desee utilizar.

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

En la terminal del equipo o el editor que prefiera, cree un archivo, MyBulkDeploymentInputFile, desde el siguiente ejemplo. Este archivo contiene información acerca de cada grupo de AWS IoT Greengrass que se debe incluir en una implementación por lotes. Aunque este ejemplo define varios grupos, para este tutorial, el archivo puede contener solo uno.

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

Cada registro (o línea) contiene un objeto de grupo. Cada objeto de grupo contiene su correspondiente GroupId y GroupVersionId, y un parámetro DeploymentType. Actualmente, AWS IoT Greengrass solo admite tipos de implementación por lotes de NewDeployment.

Guarde y cierre el archivo. Anote la ubicación del archivo.

Utilice el siguiente comando en el terminal para cargar el archivo de entrada en el bucket de Amazon S3. Sustituya la ruta del archivo por la ubicación y el nombre del archivo. Para obtener información, consulte Cargar un objeto en un bucket.

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

Utilice la siguiente política para crear un rol de ejecución. Este documento de política permite a AWS IoT Greengrass acceder al archivo de entrada de implementación por lotes al crear cada implementación en su nombre.

Para obtener más información acerca de cómo crear un rol de IAM y delegar permisos, consulte Creación de roles de 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": ["*"]

Modifique la relación de confianza para que el rol de ejecución incluya AWS IoT Greengrass. Esto permite a AWS IoT Greengrass utilizar el rol de ejecución y los permisos asociados a él. Para obtener más información, consulte Edición de la relación de confianza para un rol existente.

Le recomendamos que incluya también las claves de contexto de condición global aws:SourceArn y aws:SourceAccount en su política de confianza para ayudar a prevenir el problema de seguridad del suplente confuso. Las claves de contexto de condición restringen el acceso para permitir solo las solicitudes que provienen de la cuenta especificada y del espacio de trabajo de Greengrass. Para obtener más información sobre el problema del suplente confuso, consulte Prevención del suplente confuso entre servicios.

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

Conceda a IAM los permisos PassRole del rol de ejecución al usuario de IAM. Este usuario de IAM es el que se utiliza para iniciar la implementación por lotes. Los permisos PassRole permiten su usuario de IAM transferir el rol de ejecución para AWS IoT Greengrass lo use. Para obtener más información, consulte Concesión de permisos a un usuario para transferir un rol a un servicio de AWS.

Utilice el siguiente ejemplo para actualizar la política de IAM adjunta a su rol de ejecución. Modifique este ejemplo según sea necesario.

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

Utilice el siguiente comando para iniciar la implementación por lotes.

Le recomendamos que incluya un token X-Amzn-Client-Token en cada solicitud StartBulkDeployment. Estas solicitudes son idempotentes en relación con el token y los parámetros de solicitud. Este token puede ser cualquier cadena única que distingue entre mayúsculas y minúsculas de hasta 64 caracteres 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"
          }"
        

El comando debe generar un código de estado correcto de 200, junto con la siguiente respuesta:

{
  "bulkDeploymentId": UUID
}
        

Anote el ID de la implementación por lotes. Se puede utilizar para comprobar el estado de la implementación por lotes.

Use el siguiente comando para comprobar el estado de la implementación por lotes.

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

El comando debe devolver un código de estado de200, además de una carga JSON de información:

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

BulkDeploymentStatus contiene el estado actual de la ejecución por lotes. La ejecución puede tener uno de seis estados diferentes:

La carga JSON también incluye información estadística acerca del progreso de la implementación por lotes. Puede utilizar esta información para determinar la cantidad de grupos que se han procesado y cuántos han obtenido un error. La información estadística incluye los siguientes datos:

En el caso de que se produzca un error de una ejecución de implementación por lotes, esta carga también incluye una sección ErrorDetails que se puede utilizar para la resolución de problemas. Contiene información acerca de la causa del error de ejecución.

Puede comprobar periódicamente el estado de la implementación por lotes para confirmar que está avanzando según lo previsto. Una vez finalizada la implementación, RecordsProcessed debe ser igual que el número de grupos de implementación del archivo de entrada de implementación por lotes. Esto indica que cada registro se ha procesado.