Cette page explique comment créer, configurer et gérer des passerelles.
Créer ou modifier une passerelle
Vous pouvez créer ou modifier une passerelle à l'aide de la console Google Cloud ou de gcloud. Une fois que vous avez créé une passerelle, vous ne pouvez pas la transformer en appareil autre qu'une passerelle. Assurez-vous d'avoir créé un registre et une paire de clés d'appareil avant de suivre la procédure décrite dans cette section.
Console
Pour créer une nouvelle passerelle, procédez comme suit :
- Accédez à la page Registres dans Google Cloud Console.
- Cliquez sur l'ID du registre de la passerelle.
- Sur la page Détails du registre, cliquez sur Passerelles, puis sur Ajouter une passerelle pour créer une passerelle.
- Saisissez un ID de passerelle décrivant brièvement la passerelle ou permettant de l'identifier. (Vous ne pourrez plus modifier ce champ.) Pour en savoir plus sur les règles concernant les noms et les tailles de passerelle, consultez la section Caractères et tailles autorisés.
- Pour Communication par passerelle, sélectionnez Autoriser ou Bloquer. Cette option vous permet de bloquer la communication si nécessaire, par exemple lorsqu'une passerelle ou un ou plusieurs appareils qui y sont connectés ne fonctionnent pas correctement. Dans la plupart des cas, il est préférable d'autoriser la communication lors de la création de la passerelle. Lorsqu'une passerelle est bloquée, tous les appareils qui lui sont associés ne peuvent pas non plus communiquer avec Cloud IoT Core.
- Sélectionnez le format de clé publique correspondant à la paire de clés pour cette passerelle. Collez le certificat ou la clé dans le champ Valeur de la clé publique. Vous pouvez également définir une date d'expiration pour la clé.
- Sélectionnez la méthode d'authentification à utiliser pour les appareils associés à la passerelle.
- Utilisez les champs Clé et Valeur pour ajouter des métadonnées de passerelle facultatives, telles qu'un numéro de série. Pour en savoir plus sur les exigences concernant la taille et l'attribution de noms aux paires valeur/clé pour les métadonnées, consultez Caractères et tailles autorisés.
- Sous Stackdriver Logging, sélectionnez un niveau de journalisation des activités pour la passerelle. Le niveau de journalisation de la passerelle remplace celui de son registre.
- Cliquez sur Créer pour créer la passerelle ou sur Mettre à jour pour enregistrer les modifications apportées à une passerelle existante.
Pour modifier une passerelle existante, procédez comme suit :
- Accédez à la page Registres dans Google Cloud Console.
- Cliquez sur l'ID du registre de la passerelle.
- Cliquez sur Détails du registre.
- Cliquez sur Passerelles.
- Cliquez sur l'ID de la passerelle que vous souhaitez modifier.
- Cliquez sur Modifier en haut de la page.
Pour ajouter une clé à une passerelle existante, cliquez sur Ajouter une clé publique sur la page Détails de l'appareil.
gcloud
Pour créer une passerelle, exécutez la commande gcloud iot devices create
. Vous pouvez créer une passerelle avec des identifiants RS256 ou ES256.
Pour créer une passerelle avec des identifiants RS256, exécutez la commande suivante :
gcloud iot devices create --device-type=gateway \ --project=PROJECT_ID \ --region=REGION \ --registry=REGISTRY_ID \ --public-key path=rsa_cert.pem,type=rs256 \ --auth-method={ASSOCIATION_ONLY|AUTH_TOKEN_ONLY|AUTH_TOKEN_AND_ASSOCIATION}
Pour créer une passerelle avec les identifiants ES256, exécutez la commande suivante :
gcloud iot devices create --device-type=gateway \ --project=PROJECT_ID \ --region=REGION \ --registry=REGISTRY_ID \ --public-key path=ec_public.pem,type=es256 \ --auth-method={ASSOCIATION_ONLY|AUTH_TOKEN_ONLY|AUTH_TOKEN_AND_ASSOCIATION}
Pour modifier une passerelle, exécutez la commande gcloud iot devices update
. Vous pouvez modifier différentes propriétés de la passerelle, mais vous ne pouvez pas la définir sur un appareil qui n'est pas une passerelle.
gcloud iot devices update DEVICE_ID \ --project=PROJECT_ID \ --region=REGION \ --registry=REGISTRY_ID \ --auth-method={ASSOCIATION_ONLY|AUTH_TOKEN_ONLY|AUTH_TOKEN_AND_ASSOCIATION}
API
Utilisez les méthodes suivantes pour créer ou modifier une passerelle :
- Méthode
create
de l'appareil pour ajouter des passerelles aux registres - Méthode
patch
de l'appareil pour modifier des passerelles existantes
C#
Go
Java
Node.js
Python
Ruby
Pour savoir comment créer les appareils que vous utiliserez avec la passerelle, consultez Créer ou modifier un appareil.
Configurer la passerelle et obtenir l'état
Avec Cloud IoT Core, vous pouvez contrôler une passerelle en modifiant sa configuration, comme vous le feriez avec n'importe quel autre appareil. Pour savoir comment configurer une passerelle sur le pont MQTT ou HTTP, consultez Configurer des appareils.
Une fois qu'une configuration a été appliquée à une passerelle, celle-ci peut signaler son état à Cloud IoT Core. Vous pouvez comparer l'état de la passerelle et sa configuration la plus récente pour vous assurer qu'elle fonctionne comme prévu.
Associer ou dissocier un appareil
Vous pouvez authentifier les appareils sans passerelle auprès de Cloud IoT Core en les associant à la passerelle. La liaison crée une association entre les appareils et la passerelle que Cloud IoT Core vérifie pour authentifier les appareils.
Console
- Accédez à la page Registres dans Google Cloud Console.
- Cliquez sur l'ID du registre de la passerelle.
- Cliquez sur Passerelles, puis sur l'ID de passerelle.
- Sur la page Détails de la passerelle, cliquez sur Appareils associés.
- Cliquez sur Lier l'appareil.
- Sélectionnez les appareils que vous souhaitez associer à la passerelle, puis cliquez sur Lier.
- Pour annuler la liaison d'un appareil, sélectionnez-le sur la page Détails de la passerelle et cliquez sur Annuler la liaison de l'appareil, puis à nouveau sur Annuler la liaison pour confirmer l'opération.
gcloud
Pour lier un appareil à une passerelle, exécutez la commande gcloud iot devices gateways bind
:
gcloud iot devices gateways bind --gateway=GATEWAY_ID \ --device=DEVICE_ID \ --project=PROJECT_ID \ --device-region=DEVICE_REGION \ --device-registry=DEVICE_REGISTRY \ --gateway-region=GATEWAY_REGION \ --gateway-registry=GATEWAY_REGISTRY
Pour annuler la liaison d'un appareil à une passerelle, exécutez la commande gcloud iot devices gateways unbind
:
gcloud iot devices gateways unbind --gateway=GATEWAY_ID \ --device=DEVICE_ID \ --project=PROJECT_ID \ --device-region=DEVICE_REGION \ --device-registry=DEVICE_REGISTRY \ --gateway-region=GATEWAY_REGION \ --gateway-registry=GATEWAY_REGISTRY
API
Utilisez les méthodes suivantes pour lier un appareil à une passerelle ou annuler sa liaison :
- Méthode
BindDeviceToGateway
du registre pour associer des appareils à des passerelles - Méthode
UnbindDeviceFromGateway
des registres pour dissocier des appareils des passerelles
C#
Go
Java
Node.js
Python
Ruby
Répertorier tous les appareils liés à une passerelle
Console
- Accédez à la page Registres dans Google Cloud Console.
- Cliquez sur l'ID du registre de la passerelle.
- Cliquez sur Passerelles, puis sur l'ID de passerelle.
- Sur la page Détails de la passerelle, cliquez sur Appareils associés.
gcloud
Pour répertorier toutes les associations entre une passerelle et ses appareils, exécutez la commande gcloud iot devices gateways list-bound-devices
:
gcloud iot devices gateways list-bound-devices --gateway=GATEWAY_ID \ --registry=REGISTRY \ --region=REGION \ --project=PROJECT_ID
API
Utilisez la méthode list
des appareils et spécifiez un ID de passerelle pour répertorier tous les appareils associés à la passerelle.
C#
Go
Java
Node.js
Python
Ruby
Répertorier toutes les passerelles d'un registre
Console
- Accédez à la page Registres dans Google Cloud Console.
- Cliquez sur l'ID du registre de la passerelle.
- Sur la page Détails du registre, cliquez sur Passerelles pour afficher la liste de toutes les passerelles de ce registre.
gcloud
Pour répertorier toutes les passerelles d'un registre, exécutez la commande gcloud iot devices list
:
gcloud iot devices list \ --device-type=gateway DEVICE_ID \ --registry=REGISTRY_ID
API
Utilisez la méthode list
de l'appareil pour répertorier toutes les passerelles dans un registre.
C#
Go
Java
Node.js
Python
Ruby
Suppression des appareils associés à une passerelle
Pour supprimer un appareil lié à une passerelle, vous devez d'abord dissocier l'appareil de toutes les passerelles auxquelles il est lié, puis supprimer l'appareil du registre.
Console
Dissociez l'appareil de chaque passerelle à laquelle il est associé.
Sur la page Détails de l'appareil, cliquez sur Supprimer.
Saisissez l'ID de l'appareil pour confirmer votre choix, puis cliquez sur Supprimer.
gcloud
Pour répertorier toutes les passerelles auxquelles un appareil est lié, exécutez la commande gcloud iot devices list
:
gcloud iot devices list DEVICE_ID \ --project=PROJECT_ID \ --registry=REGISTRY_ID \ --region=REGION
Pour annuler la liaison d'un appareil, exécutez la commande gcloud iot devices gateways unbind
:
gcloud iot devices gateways unbind --gateway=GATEWAY_ID \ --device=DEVICE_ID \ --project=PROJECT_ID \ --device-region=DEVICE_REGION \ --device-registry=DEVICE_REGISTRY \ --gateway-region=GATEWAY_REGION \ --gateway-registry=GATEWAY_REGISTRY
Pour supprimer un appareil, exécutez la commande gcloud iot devices delete
:
gcloud iot devices delete DEVICE_ID \ --project=PROJECT_ID \ --registry=REGISTRY_ID \ --region=REGION
API
Après avoir dissocié l'appareil de toutes les passerelles auxquelles il est associé, supprimez-le à l'aide de la méthode delete
de l'appareil.
C#
Go
Java
Node.js
Python
Ruby
Supprimer une passerelle
Pour supprimer une passerelle, vous devez d'abord dissocier ses appareils, puis supprimer la passerelle du registre.
Console
- Dissociez tous les appareils de la passerelle.
- Revenez à la page Détails de la passerelle et cliquez sur Supprimer.
- Saisissez le nom de la passerelle pour confirmer votre choix, puis cliquez sur Supprimer.
gcloud
Pour annuler la liaison d'un appareil, exécutez la commande gcloud iot devices gateways unbind
:
gcloud iot devices gateways unbind --gateway=GATEWAY_ID \ --device=DEVICE_ID \ --project=PROJECT_ID \ --device-region=DEVICE_REGION \ --device-registry=DEVICE_REGISTRY \ --gateway-region=GATEWAY_REGION \ --gateway-registry=GATEWAY_REGISTRY
Pour supprimer une passerelle, exécutez la commande gcloud iot devices delete
:
gcloud iot devices delete GATEWAY_ID
API
Après avoir dissocié tous les appareils de la passerelle, utilisez la méthode delete
de l'appareil pour supprimer la passerelle, en spécifiant l'ID de la passerelle que vous souhaitez supprimer.
C#
Go
Java
Node.js
Python
Ruby
Étapes suivantes
- Utilisez le pont MQTT ou HTTP pour relayer les messages et les données de configuration entre les appareils et Cloud IoT Core.
- Consulter les quotas et les limites de Cloud IoT Core