浏览代码

Updating documentation for read only mode (#247)

Co-authored-by: andormarkus <andormarkus@marc-o-polo.com>
Andor Markus 4 年之前
父节点
当前提交
c91d6aad9f
共有 2 个文件被更改,包括 28 次插入6 次删除
  1. 5 2
      README.md
  2. 23 4
      docker-compose.md

+ 5 - 2
README.md

@@ -39,7 +39,8 @@ docker run -p 8080:8080 \
 	-d provectuslabs/kafka-ui:latest 
 	-d provectuslabs/kafka-ui:latest 
 
 
 ```
 ```
-Then access the web UI at [http://localhost:8080](http://localhost:8080).
+Then access the web UI at [http://localhost:8080](http://localhost:8080).  
+Further configuration with environment variables - [see environment variables](#env_variables)  
  
  
 ### Docker Compose
 ### Docker Compose
 
 
@@ -138,10 +139,11 @@ kafka:
 * `schemaRegistry`: schemaRegistry's address
 * `schemaRegistry`: schemaRegistry's address
 * `schemaNameTemplate`: how keys are saved to schemaRegistry
 * `schemaNameTemplate`: how keys are saved to schemaRegistry
 * `jmxPort`: open jmxPosrts of a broker
 * `jmxPort`: open jmxPosrts of a broker
+* `readOnly`: enable read only mode
 
 
 Configure as many clusters as you need by adding their configs below separated with `-`.
 Configure as many clusters as you need by adding their configs below separated with `-`.
 
 
-## Environment Variables
+## <a name="env_variables"></a> Environment Variables
 
 
 Alternatively, each variable of of the .yml file can be set with an environment variable. 
 Alternatively, each variable of of the .yml file can be set with an environment variable. 
 For example, if you want to use an environment variable to set the `name` parameter, you can write it like this: `KAFKA_CLUSTERS_2_NAME`
 For example, if you want to use an environment variable to set the `name` parameter, you can write it like this: `KAFKA_CLUSTERS_2_NAME`
@@ -154,6 +156,7 @@ For example, if you want to use an environment variable to set the `name` parame
 |`KAFKA_CLUSTERS_0_SCHEMAREGISTRY`   	|SchemaRegistry's address
 |`KAFKA_CLUSTERS_0_SCHEMAREGISTRY`   	|SchemaRegistry's address
 |`KAFKA_CLUSTERS_0_SCHEMANAMETEMPLATE`  |How keys are saved to schemaRegistry
 |`KAFKA_CLUSTERS_0_SCHEMANAMETEMPLATE`  |How keys are saved to schemaRegistry
 |`KAFKA_CLUSTERS_0_JMXPORT`        	|Open jmxPosrts of a broker
 |`KAFKA_CLUSTERS_0_JMXPORT`        	|Open jmxPosrts of a broker
+|`KAFKA_CLUSTERS_0_READONLY`        	|Enable read only mode. Default: false
 
 
  
  
 
 

+ 23 - 4
docker-compose.md

@@ -1,5 +1,7 @@
 # Quick Start with docker-compose
 # Quick Start with docker-compose
 
 
+Envinronment variables documentation - [see usage](README.md#env_variables) 
+
 * Add a new service in docker-compose.yml
 * Add a new service in docker-compose.yml
 
 
 ```yaml
 ```yaml
@@ -9,14 +11,31 @@ services:
     image: provectuslabs/kafka-ui
     image: provectuslabs/kafka-ui
     container_name: kafka-ui
     container_name: kafka-ui
     ports:
     ports:
-      - "9000:8080"
+      - "8080:8080"
     restart: always
     restart: always
     environment:
     environment:
-      -e KAFKA_CLUSTERS_0_NAME=local
-      -e KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS=kafka:9092
-      -e KAFKA_CLUSTERS_0_ZOOKEEPER=localhost:2181
+      - KAFKA_CLUSTERS_0_NAME=local
+      - KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS=kafka:9092
+      - KAFKA_CLUSTERS_0_ZOOKEEPER=localhost:2181
 ```
 ```
+
+* If you prefer Kafka UI in read only mode
    
    
+```yaml
+version: '2'
+services:
+  kafka-ui:
+    image: provectuslabs/kafka-ui
+    container_name: kafka-ui
+    ports:
+      - "8080:8080"
+    restart: always
+    environment:
+      - KAFKA_CLUSTERS_0_NAME=local
+      - KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS=kafka:9092
+      - KAFKA_CLUSTERS_0_ZOOKEEPER=localhost:2181
+      - KAFKA_CLUSTERS_0_READONLY=true
+```
   
   
 * Start Kafka UI process
 * Start Kafka UI process