Initiation à l'interface de ligne de commande Event Streams
Pour installer et configurer l'interface de ligne de commande Event Streams sur les plans Lite, Standard et Enterprise, procédez comme suit :
Étape 1. Installez l'interface de ligne de commande IBM Cloud
Pour plus d'informations sur l'installation de l'interface de ligne de commande, voir Initiation à l'interface de ligne de commande IBM Cloud.
Étape 2. Connectez-vous à IBM Cloud
Exécutez la commande suivante pour vous connecter à IBM Cloud :
ibmcloud login -a cloud.ibm.com
Étape 3. Créer une instance Event Streams
Créer une instance Event Streams sur IBM Cloud avec les plans Lite, Standard ou Enterprise.
Sélectionnez l'une des méthodes suivantes :
-
Pour créer une instance à partir de la console IBM Cloud, accédez à l'entrée Event Streams dans le catalogue.
-
Pour créer une instance à partir de l'interface de ligne de commande sur le plan Enterprise, exécutez la commande suivante :
ibmcloud resource service-instance-create <INSTANCE_NAME> messagehub enterprise-3nodes-2tb <REGION>Puisque le plan Enterprise possède ses propres ressources dédiées pour chaque cluster, la mise à disposition est plus longue ; elle peut durer jusqu'à 3 heures pour une nouvelle instance Enterprise.
-
Pour créer une instance à partir de l'interface de ligne de commande sur le plan Standard, exécutez la commande suivante :
ibmcloud resource service-instance-create <INSTANCE_NAME> messagehub standard <REGION>La mise à disposition d'une nouvelle instance Standard est instantanée car les ressources sous-jacentes sont déjà mises en place.
Étape 4. Facultatif : créer une clé d'API de service pour cette instance
Vous pouvez éventuellement créer une clé d'API de service. Les valeurs valides pour ROLE_NAME sont Manager, Writer et Reader. Leurs droits sont décrits dans Gestion de l'accès à vos ressources Event Streams.
-
Pour créer une clé d'API depuis la console IBM Cloud, entrez les données d'identification pour le service depuis la page d'instance et cliquez sur la commande relative aux nouvelles données d'identification.
-
Pour créer une clé d'API depuis l'interface de ligne de commande, exécutez cette commande :
ibmcloud resource service-key-create <KEY_NAME> <ROLE_NAME> --instance-name <INSTANCE_NAME>
Étape 5. Installation du plug-in de la CLI Event Streams
Exécutez la commande suivante :
ibmcloud plugin install event-streams
Étape 6. Initialisation du plug-in Event Streams
Avant de pouvoir exécuter l'une des commandes de l'interface de ligne de commande Event Streams, vous devez d'abord initialiser le plug-in. Exécutez la commande suivante puis sélectionnez votre instance Event Streams :
ibmcloud es init
Pour plus d'informations sur les commandes de l'interface de ligne de commande Event Streams, voir Référence de l'interface de ligne de commande.