Introdução à CLI do Event Streams

Para instalar e configurar a CLI do Event Streams nos planos Lite, Standard e Enterprise, conclua as etapas a seguir:

Etapa 1. Instale a CLI do IBM Cloud

Para obter mais informações sobre como instalar a CLI, consulte Introdução à CLI do IBM Cloud..

Etapa 2. Efetuar login no IBM Cloud

Execute o comando a seguir para efetuar login no IBM Cloud:

ibmcloud login -a cloud.ibm.com

Etapa 3. Criar uma instância do Event Streams

Crie uma instância do Event Streams no IBM Cloud usando os planos Lite, Standard ou Enterprise.

Selecione um dos métodos a seguir:

  • Para criar uma instância por meio do console IBM Cloud, acesse a entrada Event Streams no catálogo.

  • Para criar uma instância por meio da CLI no plano Enterprise, execute o seguinte comando:

    ibmcloud resource service-instance-create <INSTANCE_NAME> messagehub enterprise-3nodes-2tb <REGION>
    

    Como o Enterprise tem seus próprios recursos dedicados para cada cluster, ele requer mais tempo para o fornecimento, então uma nova instância Enterprise pode levar até 3 horas.

  • Para criar uma instância por meio da CLI no plano Standard, execute o seguinte comando:

    ibmcloud resource service-instance-create <INSTANCE_NAME> messagehub standard <REGION>
    

    Provisionar uma nova instância Standard é instantâneo porque os recursos subjacentes já estão configurados.

Etapa 4. Opcional: crie uma chave API de serviço para esta instância

Opcionalmente, é possível criar uma chave API de serviço. Os valores válidos para ROLE_NAME são Gerente, Writer e Leitor. Suas permissões estão descritas em Gerenciando o acesso aos seus recursos do Event Streams.

  • Para criar uma chave de API por meio do console do IBM Cloud, insira as Credenciais de serviço na página da instância e clique em Novas credenciais.

  • Para criar uma chave de API por meio da CLI, execute este comando:

    ibmcloud resource service-key-create <KEY_NAME> <ROLE_NAME> --instance-name <INSTANCE_NAME>
    

Etapa 5. Instale o plug-in da CLI do Event Streams

Execute o comando a seguir:

ibmcloud plugin install event-streams

Etapa 6. Inicializar o plug-in do Event Streams

Antes de poder executar qualquer um dos comandos da CLI do Event Streams, deve-se primeiro inicializar o plug-in. Execute o comando a seguir e, em seguida, selecione sua instância do Event Streams:

ibmcloud es init

Para obter mais informações sobre os comandos Event Streams CLI, consulte referência CLI.