pvary commented on code in PR #317: URL: https://github.com/apache/flink-kubernetes-operator/pull/317#discussion_r919795038
########## examples/README.md: ########## @@ -0,0 +1,175 @@ +<!-- +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, +software distributed under the License is distributed on an +"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +KIND, either express or implied. See the License for the +specific language governing permissions and limitations +under the License. +--> + +# Flink Kubernetes Operator Examples + +## Overview + +This directory contains few examples for Flink Kubernetes Operator. +These examples should only serve as starting points when familiarizing yourself with the +Flink Kubernetes Operator and users are expected to extend these based on their production needs. + +## Usage + +Please refer to the [Quick Start](https://nightlies.apache.org/flink/flink-kubernetes-operator-docs-main/docs/try-flink-kubernetes-operator/quick-start) +to run the examples. + +## Examples + +### Basic Application Deployment example + +This is a simple deployment defined by a minimal deployment file. +The configuration contains the following: +- Defines the job to run +- Assigns the resources available for the job +- Defines the parallelism used + +To run the job submit the yaml file using kubectl: +```bash +cd examples +kubectl apply -f basic.yaml +``` + +### Basic Session Deployment example + +This example shows how to create a basic Session Cluster and then how to submit specific jobs to this cluster if needed. + +#### Without jobs + +The Flink Deployment could be created without any jobs. +In this case the Flink jobs could be created later by submitting the jobs +separately. + +The Flink Deployment configuration contains the following: +- The name of the Flink Deployment +- The resources available for the Flink Deployment + +The Flink Deployment configuration does __NOT__ contain the following: +- The job to run +- Any job specific configurations + +To create a Flink Deployment with the specific resources without any jobs run the following command: +```bash +cd examples +kubectl apply -f basic-session-deployment-only.yaml +``` + +##### Adding jobs + +For an existing Flink Deployment another configuration could be used to create new jobs. +This configuration should contain the following: +- The Flink Deployment to use +- The job to run +- Any job specific configurations + +If the Flink Deployment is created by `basic-session-deployment-only.yaml` new job could be added +by the following command: +```bash +cd examples +kubectl apply -f basic-session-job-only.yaml +``` + +#### Creating Deployment and Jobs together + +Alternatively the Flink Deployment and the Flink Session Job configurations can be submitted together. + +To try out this run the following command: +```bash +cd examples +kubectl apply -f basic-session-deployment-and-job.yaml +``` + +### SQL runner + +For running Flink SQL scripts check this [example](https://github.com/apache/flink-kubernetes-operator/tree/main/examples/flink-sql-runner-example). Review Comment: Done, and fixed when used absolute link to the `kustomize` example as well -- 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: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
