jaytaylor.kafka

Ansible Kafka

これは、kafkaの分散型パブリッシュ/サブスクライブメッセージングキュークラスターをインストールおよび構成するためのAnsibleロールです。

取得方法

プレイブックのrequirements.ymlに次のように追加します：

- src: https://github.com/jaytaylor/ansible-kafka

その後、以下のコマンドを実行します：

ansible-galaxy install -r requirements.yml --ignore-errors

または、このロールを単独で取得して使い始めたい場合は、次のようにします：

cd my-playbook-folder/roles
git clone https://github.com/jaytaylor/ansible-kafka.git
cd -

使用方法

ロールがインストールされたら、プレイブックファイル（例：playbook.yml）から設定します。

例：

    ---
    - hosts: [all]
      roles:
        - {
          role: "ansible-kafka",
          kafka_hosts: "{{ groups.kafka | list }}",
          kafka_zookeeper_hosts: "{{ zookeeper_hosts | list }}"
          kafka_version: 0.11.0.2,     # Kafkaのバージョンを上書きします。
          kafka_scala_version: 2.10    # Scalaのバージョンを上書きします。
        }

ここで、kafka_hostsとzookeeper_hostsはどちらも定義済みの変数（例：group_vars/allなど）で、使用するホストのリストを含みます。

重要な注意

このロールをansible-galaxyのウェブサイトから使用する場合、ロール名として「jaytaylor.kafka」を使用することを確認してください（「ansible-kafka」ではなく）。

ロール変数

kafka_hosts - クラスター内のホストのリスト。
kafka_zookeeper_hosts - クラスターのためのZooKeeperホストのリスト。
kafka_broker_id - ブローカーを一意に識別する整数。デフォルトではこのロールまたはKafka自体が生成します（バージョン>= 0.9）。
kafka_generate_broker_id - ブローカーIDを生成するかどうかを制御するフラグ。デフォルトは「はい」です。
kafka_server_defaults - デフォルトのKafkaサーバー設定。通常はこの変数を変更するべきではありません。
kafka_producer_defaults - デフォルトのKafkaプロデューサー設定。通常はこの変数を変更するべきではありません。
kafka_server - 特定のデフォルトサーバー設定を上書きすることを許可します（kafka_server_defaults変数から）。このハッシュ内の値は、kafka_server_defaults変数と組み合わされます。
kafka_producer - 特定のデフォルトプロデューサー設定を上書きすることを許可します（kafka_producer_defaults変数から）。このハッシュ内の値は、kafka_server_defaults変数と組み合わされます。
kafka_healthcheck_address - 定義されていない場合、これは動的にkafka_server_defaults.host_nameまたは定義されている場合はkafka_server.host_nameに設定されます。デフォルトは「127.0.0.1」です。
kafka_java_version - インストールするJavaのバージョン。デフォルトは「openjdk-7-jre-headless」です。

バージョンノート

バージョン2.0.0は、Ansibleバージョン2.2未満をサポートしていません。

バージョン2.0.0以前は、serverとproducerのAnsible変数を使用してそれぞれKafkaサーバーとKafkaプロデューサーを構成しましたが、2.0.0ではより良い変数のスコープと上書きが導入されました：

server変数はkafka_serverに変更され、Kafkaロールの「スコープ」内にあります。このハッシュは、kafka_server_defaultsハッシュと組み合わされ、前の定義された値を上書きします。これにより、全体のserver変数ハッシュを再記述することなく、特定の設定だけを上書きするのが容易になります。
producer変数はkafka_producerになり、現在はkafka_server変数と同じように動作します。また、kafka_producer_defaultsハッシュにはプロデューサーのデフォルト値が含まれています。

また：