Création d'un appareil virtuel avec Amazon EC2

Dans ce didacticiel, vous allez créer une instance Amazon EC2 qui servira d'appareil virtuel dans le cloud.

Pour terminer ce didacticiel, vous avez besoin d'un Compte AWS. Si vous n'en avez pas, effectuez les étapes décrites dans la section Configurez votre Compte AWS avant de continuer.

Configurer une instance Amazon EC2

Les étapes suivantes vous montrent comment créer une instance Amazon EC2 qui fera office de périphérique virtuel à la place d'un appareil physique.

Si c'est la première fois que vous créez une instance Amazon EC2, vous trouverez peut-être les instructions de la section Commencer avec les instances Amazon EC2Linux plus utiles.

Pour lancer une instance

1. Ouvrez la console Amazon EC2 à l’adresse https://console.aws.amazon.com/ec2/.

2. Dans le menu de la console sur la gauche, développez la section Instances et choisissez Instances. Dans le tableau de bord Instances, choisissez Lancer les instances sur la droite pour afficher une liste des configurations de base.

3. Dans la section Nom et balises, entrez le nom de l'instance et ajoutez éventuellement des balises.

4. Dans la section Images d'applications et de systèmes d'exploitation (Amazon Machine Image), choisissez un modèle d'AMI pour votre instance, tel que l'AMI Amazon Linux 2 (HVM). Notez que cette AMI est indiquée comme « Éligible à l'offre gratuite ».

5. Dans la section Type d'instance, vous pouvez sélectionner la configuration matérielle de votre instance. Sélectionnez le type t2.micro qui est sélectionné par défaut. Notez que ce type d'instance est éligible pour l'offre gratuite.

6. Dans la section Key pair (Paire de clés [login]), choisissez un nom de paire de clés dans la liste déroulante ou choisissez Create a new key pair (Créer une paire de clés) pour en créer une. Lorsque vous créez une nouvelle paire de clés, assurez-vous de télécharger le fichier de clé privée et de l'enregistrer dans un endroit sûr, car c'est votre seule chance de le télécharger et de l'enregistrer. Vous devez fournir le nom de votre paire de clés quand vous lancez une instance, ainsi que la clé privée correspondante chaque fois que vous vous connectez à l'instance.

   Avertissement

   Ne choisissez pas l'option Continuer sans paire de clés. Si vous lancez votre instance sans une paire de clés, vous ne pourrez pas vous y connecter.

7. Dans les sections Paramètres réseau et Configuration du stockage, vous pouvez conserver les paramètres par défaut. Une fois que vous êtes prêt, choisissez Lancer les instances.

8. Une page de confirmation indique que l'instance est en cours de lancement. Sélectionnez View Instances pour fermer la page de confirmation et revenir à la console.

9. Sur l'écran Instances, vous pouvez afficher le statut du lancement. Il suffit de peu de temps pour lancer une instance. Lorsque vous lancez une instance, son état initial est pending. Une fois que l’instance a démarré, son état devient running et elle reçoit un nom DNS public. (Si la colonne DNS public (IPv4) est masquée, sélectionnez l'icône Afficher / Masquer les colonnes (icône en forme d'engrenage) dans le coin supérieur droit de la page, puis sélectionnez DNS public (IPv4).)

10. Cela peut prendre quelques minutes avant que l'instance soit prête pour que vous puissiez vous y connecter. Vérifiez que votre instance a réussi ses contrôles de statut ; vous pouvez voir cette information dans la colonne Status Checks.

    Une fois que le statut de votre nouvelle instance a été vérifié, passez à la procédure suivante et connectez-vous à celle-ci.

Pour vous connecter à votre instance

Vous pouvez vous connecter à une instance à l'aide du client basé sur un navigateur en sélectionnant l'instance dans la console Amazon EC2 et en choisissant de vous connecter à l'aide d'Amazon EC2 Instance Connect. Instance Connect gère les autorisations et fournit une connexion réussie.

1. Ouvrez la console Amazon EC2 à l’adresse https://console.aws.amazon.com/ec2/.

2. Dans le menu de gauche, choisissez Instances.

3. Sélectionnez l’instance, puis choisissez Connect (Connexion).

4. Choisissez Amazon EC2 Instance Connect, Connect.

Vous devriez maintenant avoir une fenêtre Amazon EC2 Instance Connect connectée à votre nouvelle instance Amazon EC2.

Installez Git, Node.js et configurez le AWS CLI

Dans cette section, vous allez installer Git et Node.js sur votre instance Linux.

Pour installer Git

1. Dans votre fenêtre Amazon EC2 Instance Connect, mettez à jour votre instance à l'aide de la commande suivante.

   sudo yum update -y

2. Dans votre fenêtre Amazon EC2 Instance Connect, installez Git à l’aide de la commande suivante.

   sudo yum install git -y

3. Pour vérifier si Git a été installé et si la version actuelle de Git est installée, exécutez la commande suivante :

   git --version

Pour installer Node.js

1. Dans votre fenêtre Amazon EC2 Instance Connect, installez le gestionnaire de versions de nœud (nvm) à l'aide de la commande suivante.

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.34.0/install.sh | bash

   Nous allons utiliser nvm pour installer Node.js, car il peut installer plusieurs versions de Node.js et vous permettre de passer de l'une à l'autre.

2. Dans votre fenêtre Amazon EC2 Instance Connect, activez nvm à l'aide de cette commande.

   . ~/.nvm/nvm.sh

3. Dans votre fenêtre Amazon EC2 Instance Connect, utilisez nvm pour installer la dernière version de Node.js à l'aide de cette commande.

   nvm install 16

   Note

   Cela installe la dernière version LTS de Node.js.

   L'installation de Node.js installe également le gestionnaire de package de nœud (npm), ce qui vous permet d'installer des modules supplémentaires si besoin.

4. Dans votre fenêtre Amazon EC2 Instance Connect, vérifiez que Node.js est installé et s'exécute correctement à l'aide de cette commande.

   node -e "console.log('Running Node.js ' + process.version)"

   Ce didacticiel nécessite Nœud v10.0 ou une version ultérieure. Pour plus d'informations, consultez Tutoriel : Configuration de Node.js sur une instance Amazon EC2.

Pour configurer AWS CLI

Votre instance Amazon EC2 est préchargée avec le AWS CLI. Cependant, vous devez compléter votre AWS CLI profil. Pour plus d’informations sur la configuration de votre CLI, consultez Configuration du AWS CLI.

1. L'exemple suivant montre des exemples de valeurs. Remplacez les par vos propres valeurs. Vous pouvez trouver ces valeurs dans votre AWS console, dans les informations de votre compte sous Identifiants de sécurité.

   Dans votre fenêtre Amazon EC2 Instance Connect, saisissez cette commande :

   aws configure

   Entrez ensuite les valeurs de votre compte en suivant les instructions affichées.

   AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
   AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
   Default region name [None]: us-west-2
   Default output format [None]: json

2. Vous pouvez tester votre AWS CLI configuration à l'aide de cette commande :

   aws iot describe-endpoint --endpoint-type iot:Data-ATS

   Si vous êtes correctement AWS CLI configuré, la commande doit renvoyer une adresse de point de terminaison provenant de votre Compte AWS.

Créez AWS IoT des ressources pour votre appareil virtuel

Cette section décrit comment utiliser le AWS CLI pour créer l'objet objet et ses fichiers de certificat directement sur le périphérique virtuel. Cela se fait directement sur l'appareil afin d'éviter les complications potentielles qui pourraient découler de leur copie à partir d'un autre ordinateur. Dans cette section, vous allez créer les ressources suivantes pour votre appareil virtuel :

• Un objet dans lequel représenter votre appareil virtuel AWS IoT.

• Un certificat pour authentifier votre appareil virtuel.

• Document de politique autorisant votre appareil virtuel à se connecter aux messages AWS IoT, à les publier, à les recevoir et à s'y abonner.

Pour créer un AWS IoT objet dans votre instance Linux

Les appareils connectés AWS IoT sont représentés par des objets dans le AWS IoT registre. Un objet représente un appareil spécifique ou une entité logique. Dans ce cas, votre objet représentera votre appareil virtuel, cette instance Amazon EC2.

1. Dans votre fenêtre Amazon EC2 Instance Connect, exécutez la commande suivante pour créer votre objet.

   aws iot create-thing --thing-name "MyIotThing"

2. La réponse JSON devrait ressembler à ceci :

   {
       "thingArn": "arn:aws:iot:your-region:your-aws-account:thing/MyIotThing", 
       "thingName": "MyIotThing",
       "thingId": "6cf922a8-d8ea-4136-f3401EXAMPLE"
   }

Pour créer et joindre AWS IoT des clés et des certificats dans votre instance Linux

La commande create-keys-and-certificate crée des certificats clients signés par l'autorité de certification Amazon Root. Ce certificat est utilisé pour authentifier l'identité de votre appareil virtuel.

1. Dans votre fenêtre Amazon EC2 Instance Connect, créez un répertoire pour stocker vos fichiers de certificat et de clé.

   mkdir ~/certs

2. Dans votre fenêtre Amazon EC2 Instance Connect, téléchargez une copie du certificat de l'autorité de certification Amazon (CA) à l'aide de cette commande.

   curl -o ~/certs/Amazon-root-CA-1.pem \
       https://www.amazontrust.com/repository/AmazonRootCA1.pem 

3. Dans votre fenêtre Amazon EC2 Instance Connect, exécutez la commande suivante pour créer vos fichiers de clé privée, de clé publique et de certificat X.509. Cette commande enregistre et active également le certificat avec AWS IoT.

   aws iot create-keys-and-certificate \
       --set-as-active \
       --certificate-pem-outfile "~/certs/device.pem.crt" \
       --public-key-outfile "~/certs/public.pem.key" \
       --private-key-outfile "~/certs/private.pem.key"

   La réponse se présente comme suit. Enregistrez le certificateArn afin de pouvoir l'utiliser dans les commandes suivantes. Vous en aurez besoin pour joindre votre certificat à votre objet et pour associer la politique au certificat ultérieurement.

   {
       "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/9894ba17925e663f1d29c23af4582b8e3b7619c31f3fbd93adcb51ae54b83dc2",
       "certificateId": "9894ba17925e663f1d29c23af4582b8e3b7619c31f3fbd93adcb51ae54b83dc2",
       "certificatePem": "
   -----BEGIN CERTIFICATE-----
   MIICiTCCEXAMPLE6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
   VVMxCzAJBgNVBAgEXAMPLEAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
   b24xFDASBgNVBAsTC0lBTSEXAMPLE2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
   BgkqhkiG9w0BCQEWEG5vb25lQGFtYEXAMPLEb20wHhcNMTEwNDI1MjA0NTIxWhcN
   MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCEXAMPLEJBgNVBAgTAldBMRAwDgYD
   VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDAEXAMPLEsTC0lBTSBDb25z
   b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEXAMPLE25lQGFt
   YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+aEXAMPLE
   EXAMPLEfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T
   rDHudUZEXAMPLELG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE
   Ibb3OhjZnzcvQAEXAMPLEWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4
   nUhVVxYUntneD9+h8Mg9qEXAMPLEyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
   FFBjvSfpJIlJ00zbhNYS5f6GuoEDEXAMPLEBHjJnyp378OD8uTs7fLvjx79LjSTb
   NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=
   -----END CERTIFICATE-----\n",
       "keyPair": {
           "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkEXAMPLEQEFAAOCAQ8AMIIBCgKCAQEAEXAMPLE1nnyJwKSMHw4h\nMMEXAMPLEuuN/dMAS3fyce8DW/4+EXAMPLEyjmoF/YVF/gHr99VEEXAMPLE5VF13\n59VK7cEXAMPLE67GK+y+jikqXOgHh/xJTwo+sGpWEXAMPLEDz18xOd2ka4tCzuWEXAMPLEahJbYkCPUBSU8opVkR7qkEXAMPLE1DR6sx2HocliOOLtu6Fkw91swQWEXAMPLE\GB3ZPrNh0PzQYvjUStZeccyNCx2EXAMPLEvp9mQOUXP6plfgxwKRX2fEXAMPLEDa\nhJLXkX3rHU2xbxJSq7D+XEXAMPLEcw+LyFhI5mgFRl88eGdsAEXAMPLElnI9EesG\nFQIDAQAB\n-----END PUBLIC KEY-----\n",
           "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nkey omitted for security reasons\n-----END RSA PRIVATE KEY-----\n"
       }
   }

4. Dans votre fenêtre Amazon EC2 Instance Connect, attachez votre objet au certificat que vous venez de créer en utilisant la commande suivante et le CertificateArn dans la réponse de la commande précédente.

   aws iot attach-thing-principal \
       --thing-name "MyIotThing" \
       --principal "certificateArn"

   En cas de succès, cette commande n'affiche aucune sortie.

Pour créer et attacher une politique

1. Dans votre fenêtre Amazon EC2 Instance Connect, créez le fichier de politique en copiant et en collant ce document de politique dans un fichier nommé ~/policy.json.

   Si vous n'en avez pas, vous pouvez ouvrir nano à l'aide de cette commande.

   nano ~/policy.json

   Collez-y le document de politique pour policy.json. Faites ctrl-x pour quitter l'éditeur nano et enregistrer le fichier.

   Contenu du document de politique pour policy.json.

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "iot:Publish",
                   "iot:Subscribe",
                   "iot:Receive",
                   "iot:Connect"
               ],
               "Resource": [
                   "*"
               ]
           }
       ]
   }

2. Dans votre fenêtre Amazon EC2 Instance Connect, créez votre politique à l’aide de la commande suivante.

   aws iot create-policy \
       --policy-name "MyIotThingPolicy" \
       --policy-document "file://~/policy.json"

   Sortie :

   {
       "policyName": "MyIotThingPolicy",
       "policyArn": "arn:aws:iot:your-region:your-aws-account:policy/MyIotThingPolicy",
       "policyDocument": "{
           \"Version\": \"2012-10-17\",
           \"Statement\": [
               {
                   \"Effect\": \"Allow\",
                   \"Action\": [
                       \"iot:Publish\",
                       \"iot:Receive\",
                       \"iot:Subscribe\",
                       \"iot:Connect\"
                   ],
                   \"Resource\": [
                       \"*\"
                   ]
               }
           ]
       }",
       "policyVersionId": "1"
   }

3. Dans votre fenêtre Amazon EC2 Instance Connect, attachez la politique au certificat de votre appareil virtuel à l’aide de la commande suivante.

   aws iot attach-policy \
       --policy-name "MyIotThingPolicy" \
       --target "certificateArn"

   En cas de succès, cette commande n'affiche aucune sortie.

Installez le SDK du AWS IoT périphérique pour JavaScript

Dans cette section, vous allez installer le SDK du AWS IoT périphérique JavaScript, qui contient le code avec lequel les applications peuvent communiquer, AWS IoT ainsi que des exemples de programmes. Pour plus d'informations, consultez le SDK du AWS IoT périphérique pour le JavaScript GitHub référentiel.

Pour installer le SDK du AWS IoT périphérique JavaScript sur votre instance Linux

1. Dans votre fenêtre Amazon EC2 Instance Connect, clonez le SDK du AWS IoT périphérique pour le JavaScript référentiel dans le aws-iot-device-sdk-js-v2 répertoire de votre répertoire personnel à l'aide de cette commande.

   cd ~
   git clone https://github.com/aws/aws-iot-device-sdk-js-v2.git

2. Accédez au répertoire aws-iot-device-sdk-js-v2 que vous avez créé à l'étape précédente.

   cd aws-iot-device-sdk-js-v2

3. Utilisez npm pour installer le kit SDK.

   npm install

Exécuter les exemples d'applications

Les commandes des sections suivantes supposent que vos fichiers de clé et de certificat sont stockés sur votre appareil virtuel comme indiqué dans ce tableau.

Noms des fichiers de certificat
Fichier	Chemin d'accès du fichier
Clé privée	~/certs/private.pem.key
Certificat de l'appareil	~/certs/device.pem.crt
Certificat racine de l'autorité de certification	~/certs/Amazon-root-CA-1.pem

Dans cette section, vous allez installer et exécuter l'pub-sub.jsexemple d'application qui se trouve dans le aws-iot-device-sdk-js-v2/samples/node répertoire du SDK du AWS IoT périphérique pour JavaScript. Cette application montre comment un appareil, votre instance Amazon EC2, utilise la bibliothèque MQTT pour publier des messages MQTT et s'y abonner. L'exemple d'application pub-sub.js s'abonne à une rubrique, topic_1, publie 10 messages sur cette rubrique et affiche les messages au fur et à mesure qu'ils sont reçus de l’agent de messages.

Pour installer et exécuter l'exemple d'application

1. Dans votre fenêtre Amazon EC2 Instance Connect, accédez au aws-iot-device-sdk-js-v2/samples/node/pub_sub répertoire créé par le SDK et installez l'exemple d'application à l'aide de ces commandes.

   cd ~/aws-iot-device-sdk-js-v2/samples/node/pub_sub
   npm install

2. Dans votre fenêtre Amazon EC2 Instance Connect, accédez à your-iot-endpointpartir de à l'aide AWS IoT de cette commande.

   aws iot describe-endpoint --endpoint-type iot:Data-ATS

3. Dans votre fenêtre Amazon EC2 Instance Connect, insérez your-iot-endpointcomme indiqué et exécutez cette commande.

   node dist/index.js --topic topic_1 --ca_file ~/certs/Amazon-root-CA-1.pem --cert ~/certs/device.pem.crt --key ~/certs/private.pem.key --endpoint your-iot-endpoint

Exemple d'application :

1. Se connecte AWS IoT Core à votre compte.

2. S'abonne à la rubrique du message, topic_1, et affiche les messages qu'il reçoit à cette rubrique.

3. Publie 10 messages dans la rubrique topic_1.

4. Affiche une sortie similaire à celle-ci :

   Publish received. topic:"topic_1" dup:false qos:1 retain:false
   {"message":"Hello world!","sequence":1}
   Publish received. topic:"topic_1" dup:false qos:1 retain:false
   {"message":"Hello world!","sequence":2}
   Publish received. topic:"topic_1" dup:false qos:1 retain:false
   {"message":"Hello world!","sequence":3}
   Publish received. topic:"topic_1" dup:false qos:1 retain:false
   {"message":"Hello world!","sequence":4}
   Publish received. topic:"topic_1" dup:false qos:1 retain:false
   {"message":"Hello world!","sequence":5}
   Publish received. topic:"topic_1" dup:false qos:1 retain:false
   {"message":"Hello world!","sequence":6}
   Publish received. topic:"topic_1" dup:false qos:1 retain:false
   {"message":"Hello world!","sequence":7}
   Publish received. topic:"topic_1" dup:false qos:1 retain:false
   {"message":"Hello world!","sequence":8}
   Publish received. topic:"topic_1" dup:false qos:1 retain:false
   {"message":"Hello world!","sequence":9}
   Publish received. topic:"topic_1" dup:false qos:1 retain:false
   {"message":"Hello world!","sequence":10}

Si vous rencontrez des difficultés en exécutant l'exemple d'application, veuillez consulter Dépannage des problèmes avec l'exemple d'application.

Vous pouvez également ajouter le paramètre --verbosity debug sur la ligne de commande afin que l'exemple d'application affiche des messages détaillés sur ce qu'elle fait. Ces informations peuvent vous fournir l'aide dont vous avez besoin pour corriger le problème.

Afficher les messages de l'exemple d'application dans la AWS IoT console

Vous pouvez voir les messages de l'application d'exemple lorsqu'ils passent par l’agent de messages en utilisant le client de test MQTT dans la AWS IoT console.

Pour afficher les messages MQTT publiés par l'exemple d'application

1. Consultez Afficher les messages MQTT avec le client AWS IoT MQTT. Cela vous permet d'apprendre à utiliser le client de test MQTT dans la AWS IoT console pour afficher les messages MQTT lorsqu'ils transitent par l’agent de messages.

2. Ouvrez le client de test MQTT dans la AWS IoT console.

3. Dans S'abonner à une rubrique, S'abonner à la rubrique, topic_1.

4. Dans votre fenêtre Amazon EC2 Instance Connect, réexécutez l'exemple d'application et regardez les messages du client de test MQTT dans la AWS IoT console.

   cd ~/aws-iot-device-sdk-js-v2/samples/node/pub_sub
   node dist/index.js --topic topic_1 --ca_file ~/certs/Amazon-root-CA-1.pem --cert ~/certs/device.pem.crt --key ~/certs/private.pem.key --endpoint your-iot-endpoint

Pour plus d'informations sur le MQTT et sur la manière dont le protocole est pris AWS IoT Core en charge, consultez MQTT.