Yunyung commented on code in PR #19994: URL: https://github.com/apache/kafka/pull/19994#discussion_r2156225108
########## docker/examples/README.md: ########## @@ -13,6 +13,27 @@ Kafka server can be started using following ways: - File input - Environment variables +Installation Prepration Review Comment: ```suggestion Installation Preparation ``` ########## docker/examples/README.md: ########## @@ -13,6 +13,27 @@ Kafka server can be started using following ways: - File input - Environment variables +Installation Prepration +------------ + +Note that the `Docker` version **must be >= 20.10.4**. + +The prior Docker versions may cause permission errors when running the Kafka container, as they do not correctly set directory permissions when creating container paths like `/opt/kafka/config`. + +If you are using the prior version, you may encounter the following error during container startup: +```text +===> User +uid=1000(appuser) gid=1000(appuser) groups=1000(appuser) +===> Setting default values of environment variables if not already set. +===> Configuring … +Running in KRaft mode… +/opt/kafka/config/ file not writable +``` + +To avoid this, **please upgrade Docker to 20.10.4 or later**. + +This issue was fixed in Docker [20.10.4 release](https://docs.docker.com/engine/release-notes/20.10/#20104), specifically in Use 0755 permissions when creating missing directories [moby/moby#42017](https://github.com/moby/moby/pull/42017). Review Comment: I prefer leaving the detailed errors in the PR discussion rather than explicitly writing them in the README. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: jira-unsubscr...@kafka.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org
