1. Home
2. Confluent CLI

Confluent Cloud クラスターへの Confluent CLI の接続

以下の手順で、Confluent CLI インスタンスを Confluent Cloud クラスターに接続できます。

Confluent CLI を使用して Confluent Cloud に接続するには、Confluent Cloud で有効な ユーザーアカウント を持っている必要があります。

1. Confluent Cloud のユーザーアカウントで、confluent login コマンドを使用してクラスターにログインします。

   confluent login
   

2. Confluent Cloud 環境 を設定します。

   1. 環境 ID を取得します。

      confluent environment list
      

      出力は以下のようになります。

           Id    |      Name
      +----------+----------------+
        * a-542  | dev
          a-4985 | prod
          a-2345 | jdoe-gcp-env
          a-9012 | jdoe-aws-env
      

   2. ID（<env-id>）を使用して環境を設定します。

      confluent environment use <env-id>
      

      出力は以下のようになります。

      Now using a-4985 as the default (active) environment.
      

3. 使用するクラスターを設定します。

   1. クラスター ID を取得します。

      confluent kafka cluster list
      

      出力は以下のようになります。

            Id      |       Name        | Provider |   Region    | Durability | Status
      +-------------+-------------------+----------+-------------+------------+--------+
          ekg-rr8v7 | dev-aws-oregon    | aws      | us-west-2   | LOW        | UP
          ekg-q2j96 | prod              | gcp      | us-central1 | LOW        | UP
      

   2. ID（<cluster-id>）を使用してクラスターを設定します。これが、コマンドが実行されるクラスターになります。

      confluent kafka cluster use <cluster-id>
      

4. API キーとシークレットを作成し、保存します。これは、トピックに対して生成や消費を行うために必要です。

   Confluent CLI から以下のコマンドを入力します。

   confluent api-key create --resource <resource-id>
   

   出力は以下のようになります。

   Save the API key and secret. The secret is not retrievable later.
   +---------+------------------------------------------------------------------+
   | API Key | LD35EM2YJTCTRQRM                                                 |
   | Secret  | 67JImN+9vk+Hj3eaj2/UcwUlbDNlGGC3KAIOy5JNRVSnweumPBUpW31JWZSBeawz |
   +---------+------------------------------------------------------------------+
   

5. （省略可） confluent api-key store <key> <secret> を使用して API シークレットを追加します。CLI を使用して API キーを作成した場合は、この情報が自動的にローカルに保管されます。一方、UI、API、または別のマシンの CLI を使用して API キーを作成した場合は、まずこの情報を保管しないとシークレットを CLI で使用できません。API キーの作成後にシークレットを取得することができないため、これは必須です。

   confluent api-key store <api-key> <api-secret> --resource <resource-id>
   

6. Confluent CLI コマンドで使用する API キーを設定します。

   confluent api-key use <api-key> --resource <resource-id>
   

これで、指定したクラスターに対して Confluent CLI コマンドを実行できるようになりました。