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.