Apache Flink Kubernetes Operator 指南

Apache Flink Kubernetes Operator 指南

目录结构及介绍

在深入探讨如何安装和运行Apache Flink Kubernetes Operator之前，我们先来看一下项目的根目录结构：

根目录结构

.
├── charts               # Helm图表，用于Kubernetes上的部署。
│   ├── flink-k8s       # 包含Flink Operator的Helm chart。
│   └── templates        # 部署模板文件。
├── cmd                  # 命令入口点。
│   └── manager          # 主要管理命令的位置。
├── config               # 配置文件模板存放位置。
│   └── rbac.yaml        # RBAC权限配置。
├ ├── controller         # 控制器逻辑代码所在目录。
│   └── reconciler       # 调和逻辑，用于处理资源状态。
├── Dockerfile           # Docker构建文件。
├── go.mod               # Go模块定义。
├── go.sum               # Go模块依赖的汇总文件。
├── hack                 # 用于CI/CD流程的一些脚本。
├── LICENSE              # 开源许可证文件。
├── Makefile             # 自动化构建和打包任务。
├── manifests            # 直接应用于集群的YAML模板。
├── pkg                  # 包含自定义类型的包目录。
│   └── resource         # 定义了CRD中的资源类型。
└── third_party          # 外部库或代码片段的存储位置。

• charts: 包含用来在Kubernetes中部署Flink Operator的Helm图表。
• cmd: 包含主程序的命令入口点，如manager.go负责启动Operator。
• config: 包含预定义的配置模板，例如RBAC规则。
• controller: 包括控制器相关的逻辑，处理资源的状态同步。
• manifests: 存储可以直接应用于Kubernetes集群的YAML文件。

启动文件介绍

主要的启动入口位于cmd/manager/main.go。这个Go文件是Operator的核心执行部分，它通过调用Kubernetes客户端来监听和响应flink.apache.org/v1alpha1 API Group下的自定义资源（Custom Resource）的变化。这些变化触发了reconciler内的逻辑去调整集群以反映期望的状态。

为了实际启动Operator，你需要首先构建它的二进制可执行文件，然后可以在你的开发环境中运行它，或者将其打包成容器镜像并在Kubernetes集群中作为DaemonSet或Deployment运行。

配置文件介绍

项目中的config目录包含了几个重要的配置文件模板，其中rbac.yaml是最关键的一个，因为它定义了Operator所需的最小访问权限。该文件包含以下角色和服务账户定义：

RBAC.yaml 内容概览

apiVersion: v1
kind: ServiceAccount
metadata:
  name: flinkoperator-sa
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: flinkoperator-cr
rules:
  - apiGroups: ["flink.apache.org"]
    resources: ["*"]
    verbs: ["*"]
  - apiGroups: [""]
    resources: ["pods", "services", "secrets", "namespaces"]
    verbs: ["get", "list", "watch", "create", "update", "patch", "delete"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: flinkoperator-crb
roleRef:
  kind: ClusterRole
  name: flinkoperator-cr
subjects:
  - kind: ServiceAccount
    name: flinkoperator-sa

此配置允许flinkoperator-sa服务帐户通过其绑定到的ClusterRole来操作Kubernetes对象以及与其他API版本的资源交互，这是运行Operator不可或缺的一部分。

---

以上是对Apache Flink Kubernetes Operator的主要组成部分及其功能的基本概述。希望这能帮助您更好地理解和上手使用该项目。