jaytaylor.kafka

Ansible Kafka

To rola Ansible służąca do instalacji i konfiguracji rozproszonych klastrów kolejek wiadomości pub/sub kafka.

Jak to zdobyć

Dodaj do pliku requirements.yml w swoim playbooku:

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

a następnie uruchom:

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

Lub jeśli chcesz po prostu pobrać tę rolę i zacząć ją używać:

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

Jak to używać

Po zainstalowaniu roli skonfiguruj ją w swoim pliku playbook (np. playbook.yml).

Przykład:

    ---
    - hosts: [all]
      roles:
        - {
          role: "ansible-kafka",
          kafka_hosts: "{{ groups.kafka | list }}",
          kafka_zookeeper_hosts: "{{ zookeeper_hosts | list }}"
          kafka_version: 0.11.0.2,     # Nadpisanie wersji Kafka.
          kafka_scala_serverion: 2.10 # Nadpisanie wersji Scala.
        }

Gdzie kafka_hosts i zookeeper_hosts to zmienne zdefiniowane wcześniej (np. w group_vars/all) i zawierają listę hostów do wykorzystania.

Ważna uwaga

Jeśli korzystasz z tej roli z witryny ansible-galaxy, upewnij się, że używasz "jaytaylor.kafka" jako nazwy roli (zamiast "ansible-kafka").

Zmienne roli

kafka_hosts - lista hostów w klastrze.
kafka_zookeeper_hosts - lista hostów zookeeper dla klastra.
kafka_broker_id - Liczba całkowita identyfikująca unikalnie brokera, domyślnie zostanie dla Ciebie wygenerowana, zarówno przez tę rolę, jak i przez samą kafka w wersjach >= 0.9.
kafka_generate_broker_id - Flaga kontrolująca, czy generować identyfikator brokera, domyślnie ustawiona na yes.
kafka_server_defaults - Domyślne ustawienia serwera Kafka. Ta zmienna zwykle nie powinna być zmieniana.
kafka_producer_defaults - Domyślne ustawienia producenta Kafka. Ta zmienna zwykle nie powinna być zmieniana.
kafka_server - Umożliwia nadpisanie niektórych domyślnych ustawień serwera (z zmiennej kafka_server_defaults). Wartości w tym zbiorze są łączone z zmienną kafka_server_defaults.
kafka_producer - Umożliwia nadpisanie niektórych domyślnych ustawień producenta (z zmiennej kafka_producer_defaults). Wartości w tym zbiorze są łączone z zmienną kafka_producer_defaults.
kafka_healthcheck_address - Jeśli nie jest zdefiniowana, zostanie dynamicznie ustawiona na kafka_server_defaults.host_name lub kafka_server.host_name, jeśli jest zdefiniowana. Domyślnie '127.0.0.1'
kafka_java_version - Wersja Javy do zainstalowania. Domyślnie "openjdk-7-jre-headless"

Uwagi dotyczące wersji

Wersja 2.0.0 nie obsługuje wersji Ansible poniżej 2.2.

Przed wersją 2.0.0 używano zmiennych Ansible server i producer do konfiguracji odpowiednio serwera Kafka i producenta Kafka, ale w 2.0.0 wprowadzono lepsze zakresy zmiennych i lepsze nadpisywanie zmiennych:

Zmienna server została zmieniona na kafka_server, więc jest w "zakresie" roli Kafka. Jest to zbiór, który jest łączony z zbiorem kafka_server_defaults, nadpisując wcześniejsze wartości. Ułatwia to nadpisanie tylko niektórych ustawień, zamiast ponownego pisania całego zbioru zmiennej server.
Zmienna producer została zmieniona na kafka_producer, a teraz działa tak samo jak zmienna kafka_server. Zbiór kafka_producer_defaults zawiera także domyślne wartości dla producenta.

Dodatkowo: