Ansible Playbooks for Confluent Platform のダウンロード

This topic describes how to download Ansible Playbooks for Confluent Platform as the first step in the installation process.

Download Playbooks using Ansible Galaxy

If you are using Ansible 2.11 or higher, download the Ansible Playbooks for Confluent Platform collection using ansible-galaxy as described in this section.

Confluent Platform 7.0 以降、Ansible は Ansible コレクション としてパッケージ化されています。

コントローラーに Ansible Playbooks for Confluent Platform をダウンロードするには、次のコマンドを実行します。このコマンドを実行すると、ロールとプレイブックがデフォルトのコレクションディレクトリにプルされます。

ansible-galaxy collection install \
  git+https://github.com/confluentinc/cp-ansible.git

さらに、次のコマンドで Ansible Playbooks for Confluent Platform のブランチを指定できます。<branch> としては 7.0 以上がサポートされています。

ansible-galaxy collection install \
  git+https://github.com/confluentinc/cp-ansible.git,<branch>

ハッシュのマージの構成

Ansible Playbooks for Confluent Platform では、ハッシュのマージを有効にする必要があります。Ansible 構成ファイル で、以下のように設定を構成します。

[defaults]
hash_behaviour=merge

Ansible 2.9 または 2.10 のホスト用の Ansible Playbooks for Confluent Platform のダウンロード

Ansible 2.9 または 2.10 を使用して Ansible Playbooks for Confluent Platform をダウンロードするには、次の手順を実行します。

  1. Clone the Ansible Playbooks for Confluent Platform repo:

    git clone https://github.com/confluentinc/cp-ansible
    

    重要

    上記のコマンドで作成される cp-ansible ディレクトリには、誰でも書き込み可能な world-writable 権限(777)を指定しないでください。構成ファイル ansible.cfg が world-writable パーミッションのディレクトリにある場合、セキュリティ上のリスクがあるため、Ansible は構成ファイルを読み込みません。

    git clone を使用しない場合は、ソースコード cp-ansible のアクセス許可設定を 755 にします。

  2. Check out the branch. Confluent Platform 7.0.1 does not support installation using Ansible 2.9 or 2.10. As a workaround, checkout an older version branch, such as 6.2.0-post and follow the workflow described in Ansible 2.9 または 2.10 を使用して Confluent Platform をインストールする.

    cd cp-ansible
    git fetch
    git checkout 6.2.0-post
    

    Ansible GitHub リポジトリの master ブランチは開発用のブランチであり、本稼働環境のデプロイには適していません。本稼働環境のデプロイ、アップグレード、またはテストには、専用バージョンのブランチを使用します。