Control Center のプロパティファイル

Control Center プロパティファイルの複数の例が、ご使用の CONFLUENT_HOME ディレクトリの etc/confluent-control-center ディレクトリにあります。これらのファイルには重要な構成オプションが含まれています。その一部はデフォルトに設定されているか、コメントアウトされています。使用可能な構成オプションの一部はプロパティファイルに存在していません。たとえば、 アクセス制御 オプションの大部分はデフォルトでは存在せず、手動で追加する必要があります。ご使用の環境の要件に応じて、「Control Center 構成リファレンス」で説明されている追加の構成オプションがあり、プロパティファイル内に追加して構成できます。デフォルト設定は通常、使用可能なプロパティファイルテンプレートごとに異なります。

注釈

パラメーターはキー/値ペアの形式で提供されます。# で始まっている行は無視されます。オプションのコメントを解除するには、前にあるハッシュ # を削除します。

Control Center 構成ファイルの例

次の表は、Confluent Control Center で用意されているサンプルのプロパティファイルのリストです。$CONFLUENT_HOME/etc/confluent-control-center ディレクトリにあります。

ファイル名 説明 注意事項
control-center.properties 一部の基本設定を含むプロパティファイルのサンプルです。 なし
control-center-dev.properties 本稼働環境以外で使用するプロパティファイルのサンプルです。開発者ライセンス による単一のブローカーを含みます。 Debian/Ubuntu 以外の環境で、start コマンドで使用されるデフォルトプロパティファイルです。
control-center-production.properties 本稼働環境に適した設定のプロパティファイルのサンプルです。 本稼働環境の設定では、さらにプロパティを設定する必要があります。たとえば、データディレクトリを /tmp 以外の値に、またホスト名を localhost 以外の値に設定し、セキュリティ機能を構成する必要があります。Debian/Ubuntu 環境で、start コマンドで使用されるデフォルトプロパティファイルです。
control-center-minimal.properties ローカル環境用に最適化されたプロパティファイルのサンプルです。 このプロパティファイルは、デモ用にローカルで実行している Control Center で使用できます。start コマンドで明示的に渡す必要があります。

Control Center プロパティファイルを渡す

Control Center のデフォルトでは $CONFLUENT_HOME/etc/confluent-control-center ディレクトリにあるプロパティファイルが認識され、CLI コマンドによって再起動されるときに自動的に読み込まれます。以下の場合を除き、Control Center を起動するときにプロパティファイル名を明示的に渡す必要はありません。

  • プロパティファイルがカスタマイズ名を持っている場合。テストのためにプロパティファイルの名前を変更できます。
  • プロパティファイルがデフォルトのディレクトリにない場合。この場合、Control Center にはプロパティファイルの完全なパスが必要です。
  • .minimal プロパティファイルは常に start コマンドを使用して明示的に渡す必要がある場合。
  • control-center-start スクリプトを使用する場合は、常にプロパティファイルを渡す必要がある場合。

Control Center の再起動

Control Center を停止および再起動するには以下の手順に従います。プロパティファイルを渡す必要がある例と渡す必要がない例を以下に示します。

注釈

ご使用の環境向けに構成されている 1 つ以上の適切な Control Center プロパティファイルに変更を加えます。対象のプロパティファイルには control-center.propertiescontrol-center-dev.propertiescontrol-center-production.propertiescontrol-center-minimal.properties があります。プロパティファイルは /path-to-confluent/etc/confluent-control-center/ にあります。

例 1: 標準の本稼働環境

Control Center を再起動し、デフォルトのプロパティファイルを入力して構成を有効にする例です。

./bin/control-center-stop
./bin/control-center-start ../etc/confluent-control-center/control-center.properties

例 2: カスタマイズされたプロパティファイルの名前および場所

bin 起動スクリプトを使用して Control Center を起動し、カスタマイズされたプロパティファイル名と場所を入力する例です。

./control-center-stop
./control-center-start /Users/myUserName/confluent/configs/c3.properties-rbac

この例では、/bin がカレントディレクトリであることを前提としています。

例 3: ローカル開発環境

ローカル CLI を使用してローカル(開発)環境内で Control Center を起動する例です。この例では、$CONFLUENT_HOME が構成されていることを前提としています。プロパティファイル名を渡す必要はありません。Control Center が control-center-dev.properties を自動で渡します(Ubuntu/Debian 以外)。

重要

confluent local は、本稼働環境では使用しないでください。

confluent local services stop
confluent local services start

プロパティファイルの抜粋例

このセクションでは、開発環境と本稼働環境の Control Center プロパティファイルにおけるいくつかの基本的な違いを説明します。

本稼働環境プロパティ(control-center-production.properties)ファイルの抜粋例:

 1############################# Server Basics #############################
 2
 3# A comma-separated list of Apache Kafka cluster host names (required)
 4# NOTE: should not be localhost
 5#bootstrap.servers=kafka1:9092
 6...
 7
 8############################# Control Center Settings ###################
 9
10...
11# Directory for Control Center to store data
12# NOTE: this should be changed to point to a reliable directory
13confluent.controlcenter.data.dir=/var/lib/confluent/control-center
14...

開発プロパティ(control-center-dev.properties)ファイルの抜粋例:

 1############################# Server Basics #############################
 2
 3# A comma-separated list of Apache Kafka cluster host names (required)
 4bootstrap.servers=localhost:9092
 5...
 6
 7############################# Control Center Settings ###################
 8
 9...
10# Directory for Control Center to store data
11# NOTE: this should be changed to point to a reliable directory
12confluent.controlcenter.data.dir=/tmp/confluent/control-center
13...
14
15.. note:  The ``.dev`` file is pre-configured with
16          ``localhost`` where applicable.  The data directory points to
17          a ``/tmp`` directory.