rmetzger commented on a change in pull request #14346:
URL: https://github.com/apache/flink/pull/14346#discussion_r542234170
##########
File path: docs/deployment/resource-providers/standalone/docker.md
##########
@@ -204,12 +198,44 @@ You can provide the following additional command line
arguments to the cluster e
If the main function of the user job main class accepts arguments, you can
also pass them at the end of the `docker run` command.
-## Customize Flink image
+### Per-Job Cluster Mode
+
+Per-Job Cluster Mode is not supported by Docker.
+
+### Session Mode on Docker
+
+Local deployment in the session mode has already been described in the
[introduction](#starting-a-session-cluster-on-docker) above.
+
+
+{% top %}
+
+## Flink on Docker Reference
+
+### Image tags
+
+The [Flink Docker repository](https://hub.docker.com/_/flink/) is hosted on
Docker Hub and serves images of Flink version 1.2.1 and later.
+The source for these images can be found in the [Apache
flink-docker](https://github.com/apache/flink-docker) repository.
+
+Images for each supported combination of Flink and Scala versions are
available, and
+[tag aliases](https://hub.docker.com/_/flink?tab=tags) are provided for
convenience.
+
+For example, you can use the following aliases:
+
+* `flink:latest` → `flink:<latest-flink>-scala_<latest-scala>`
+* `flink:1.11` → `flink:1.11.<latest-flink-1.11>-scala_2.11`
-When you run the Flink containers, there may be a need to customize them.
-The next chapters describe some how-tos of what you can usually customize.
+<span class="label label-info">Note</span> It is recommended to always use an
explicit version tag of the docker image that specifies both the needed Flink
and Scala
+versions (for example `flink:1.11-scala_2.12`).
+This will avoid some class conflicts that can occur if the Flink and/or Scala
versions used in the application are different
+from the versions provided by the docker image.
+
+<span class="label label-info">Note</span> Prior to Flink 1.5 version, Hadoop
dependencies were always bundled with Flink.
+You can see that certain tags include the version of Hadoop, e.g. (e.g.
`-hadoop28`).
+Beginning with Flink 1.5, image tags that omit the Hadoop version correspond
to Hadoop-free releases of Flink
+that do not include a bundled Hadoop distribution.
-### Configure options
+
+### Passing configuration via environment variables
When you run Flink image, you can also change its configuration options by
setting the environment variable `FLINK_PROPERTIES`:
Review comment:
I'm not sure if that really helps avoiding confusion. I would prefer to
keep it this way.
----------------------------------------------------------------
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.
For queries about this service, please contact Infrastructure at:
[email protected]
