[GitHub] GJL commented on a change in pull request #6562: [Backport 1.6][FLINK-10001][docs] Update Docker and Kubernetes documentation

[GitBox <gi...@apache.org>]

GJL commented on a change in pull request #6562: [Backport 1.6][FLINK-10001][docs] Update Docker and Kubernetes documentation
URL: https://github.com/apache/flink/pull/6562#discussion_r210597356
 
 

 ##########
 File path: docs/ops/deployment/kubernetes.md
 ##########
 @@ -23,51 +23,78 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-[Kubernetes](https://kubernetes.io) is a container orchestration system.
+This page describes how to deploy a Flink job and session cluster on [Kubernetes](https://kubernetes.io).
 
 * This will be replaced by the TOC
 {:toc}
 
-## Simple Kubernetes Flink Cluster
+## Setup Kubernetes
 
-A basic Flink cluster deployment in Kubernetes has three components:
+Please follow [Kubernetes' setup guide](https://kubernetes.io/docs/setup/) in order to deploy a Kubernetes cluster.
+If you want to run Kubernetes locally, we recommend using [MiniKube](https://kubernetes.io/docs/setup/minikube/).
 
-* a Deployment for a single Jobmanager
-* a Deployment for a pool of Taskmanagers
-* a Service exposing the Jobmanager's RPC and UI ports
+<div class="alert alert-info">
 
 Review comment:
   I'd use 
   ```
   <div class="alert alert-info" markdown="span">
     <strong>Note:</strong> If using MiniKube please make sure to execute `minikube ssh 'sudo ip link set docker0
     promisc on'` before deploying a Flink cluster. Otherwise Flink components are not able to self reference
     themselves through a Kubernetes service. 
   </div>
   ```
   to make sure that the formatting is always consistent.
   \`...\` compiles to `<code class="highlighter-rouge">...</code>` in our current setup.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services