使用kubebuilder造operator1

最新推荐文章于 2025-08-26 12:33:01 发布
原创 最新推荐文章于 2025-08-26 12:33:01 发布 · 209 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#docker #k8s #operator #kubebuilder

本文档记录了一次使用Kubebuilder创建并部署Operator的过程。首先检查了Go、Docker和kubectl的版本要求，然后在指定目录初始化项目，并创建了一个名为Guestbook的API和Controller。通过`make install`和`make run`安装并运行Operator，接着创建了CR实例并在本地K8s集群部署。文章探讨了项目如何连接到K8s集群、Operator的部署位置、权限管理和控制逻辑编写等问题，同时提示了部署Operator需要的权限以及使用VPN的建议。

学习📝记录：项目来源kubebuilder官网，别的不多说，学啥你不得先把官网来一遍吗
1、版本先check下
官网上的Prerequisites, 这一步必不可少~~
go version v1.15+ (kubebuilder v3.0).
go version v1.16+ (kubebuilder v3.1+).
docker version 17.03+.
kubectl version v1.11.3+.
Access to a Kubernetes v1.11.3+ cluster.

go version
docker version
kubectl version

2、先造个空项目感受下

# 先进到对应的目录
-> % cd ~/go/src && mkdir guestbook && cd guestbook
# 初始化项目
-> % kubebuilder init --domain my.domain --repo my.domain/guestbook
# 创建API 著名的GVK；api和controller都有很多玩法~ 后面慢慢来
kubebuilder create api --group webapp --version v1 --kind Guestbook
# 安装CRD & 运行operator
make install && make run 
# 新建CR实例
kubectl apply -f config/samples/
# 本地k8s部署operator，就不push了, deploy这里需要大量的权限，注意去官网上看RBAC说明
# 还是那句话，花点钱吧，VPN不香吗。实在是不想花钱，就阿里云吧
make docker-build docker-push IMG=zhangting9391/guestbook:v1
make deploy IMG=zhangting9391/guestbook:v1
# 完事了就卸载吧
make uninstall
make undeploy

效果是出来了，但是还是满脸问号？？？

  • 项目是怎么发现我的k8s集群的
  • operator怎么指定安装在哪里
  • 权限管理是怎么做的，安装operator需要哪些权限
  • 控制逻辑要怎么写
  • 怎么watch我自己的资源
  • 资源应该怎样来定义
  • operator是怎样部署到k8s集群里面的
    本来想一次写完，可是发现贴图太大了，编辑的时候不爽，另起一篇吧~
    在这里插入图片描述

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

moonlight9391
关注
18、使用Kubebuilder创建和部署Kubernetes Operator
s8t9u0v1w的博客
10-04 42
本文详细介绍了如何使用Kubebuilder创建和部署Kubernetes Operator，涵盖构建和部署自定义资源（CRD）、本地运行Manager、定制资源结构体、实现Reconcile逻辑、添加RBAC权限、镜像构建与集群部署等核心步骤。同时深入讲解了如何为自定义资源创建多版本（如v1alpha1到v1beta1），实现版本间无损转换，配置Conversion Webhook，并通过cert-manager管理证书。配合make命令和kustomize工具，完整呈现Operator开发到上线的全流程
12、使用Kubebuilder和Operator SDK开发Kubernetes Operator
desk3的博客
08-03 51
本文介绍了如何使用Kubebuilder和Operator SDK开发自定义的Kubernetes Operator，涵盖环境搭建、业务逻辑实现、验证流程以及两者对比和最佳实践，帮助开发者快速掌握Operator开发核心技能。
Kubebuilder与Operator开发
gitblog_00857的博客
08-26 389
Kubebuilder与Operator开发 【免费下载链接】kubebuilder Kubebuilder - SDK for building Kubernetes APIs using CRDs 项目地址: https://...
操作符Operator（1）
yzy2736的博客
11-21 602
1、操作符 和 操作数 操作符： 运算符，参与运算的符号 不一定只有一个符号 操作数： 参与运算的数据 也称之为“元” 操作符出现的位置不同，可能会有不同的含义。 例如“-”，这个符号出现在数字5前面，该数字读作负5、若该数字出现在5和3的中间，则读作5减3。 2、表达式 表达式 = 操作符 + 操作数 每个表达式都由一个运算结果，该结果叫做返回值，返回值类型叫做返回类型。 相加运算符(+) 相加运算符用于对两个操作数进行相加运算，如果操作为数字符串，则改运算符将两个操作数连接成一个字符串。 表达式为：x
Kubernetes Operator开发
niwoxiangyu的博客
04-19 2347
因此Crontroller 是个面向期望的编程模型,我们声明的这个期望对象，就是API Object(K8s Runtime Object)- config/crd 目录下是我们crd的描述文件,我们需要把自定义资源(CRD)的描述信息注册给k8s时需要的。- api/v1 目录下主要存放是我们API Object, 就是我们的Resource对象相关信息。部署 Controller为了确保我们的CRD描述是最新的. 我们重新安装下。
kubernetes-operator开发教程（基于kubebuilder脚手架）
ss810540895的博客
11-03 1817
Operator是什么？Kubernetes Operator是一个自定义控制器，用于通过自动化操作来管理复杂应用或服务。实现原理是什么？Kubernetes Operator的实现原理基于自定义控制器（Controller）和自定义资源定义（CRD）。
Kubernetes operator（七） kubebuilder 的安装及简单使用 篇
a1369760658的博客
02-04 2878
本文是 Kubernetes operator学习 系列第七篇，对 目前编写Operator的常用脚手架 kubebuilder 进行学习，主要涉及 kubebuilder 的安装及简单使用
每期一个小窍门: 使用kubebuilder 生成operator脚手架 并操作控制自定义CRD副本数 （下）
李昊轩的博客
08-03 659
然后这边 kubectl get pod 可以看到如我们所愿 有5个启动的pod 对应了上方的部署文件。通过拿到的运行期状态 来跟部署文件的期望状态对比 然后进行不同业务响应就ok了。写好这个文件后 直接通过自带的make命令 install 到k8s中。有了这个dacar类型之后 我们徒手制作一个这个类型的部署文件。由于这个是demo 我们就不把operator部署到集群侧了。在这个文件中定义 dacar 这个crd的spec。我们发现可以查看到这个crd了。apply 这个文件后。
Operator实战1：使用kubebuilder开发一个部署web服务的Operator
吴就业
06-03 1218
虽然API上并没有对如何设计资源的状态做任何约定，包括kubernetes在1.19版本之前提供的内置资源，它们的状态也并不都遵循约定，但状态的设计建议还是遵循官方新提出的约定，可参考这篇《kubernetes设计与实现-API设计约定-condition设计约定：https://renhongcai.gitbook.io/kubernetes/di-shi-liu-zhang-api-she-ji-yue-ding/1.2-api_convention_condition》。
kubebuilder开发operator
ltgsoldier1的博客
12-09 754
安装kubebuilder前 需要有kubernetes环境和golang环境。官网：https://go.kubebuilder.io/安装kubebuilder。
使用Kubebuilder编写operator 简单流程
qq_43490312的博客
08-26 799
+ 暂不涉及相关概念的解释以及源码 + 如何使用kubebuilder创建一个operator项目 + 如何使用kind构建本地测试k8s环境 + 如何使用kubebuilder部署一个operator
2022-03-15 使用kubebuilder命令创建operator工程
悟世之路
03-15 1279
摘要: 记录使用kubebuilder命令创建operator空工程的基本命令 步骤: 一. 进入go安装的src目录 需要根据个人机器情况进入go安装目录的src目录 我的目录是 cd /usr/local/go/src 二. 创建工程名字的文件夹, 例如hello [root@node-201 github]# cd /usr/local/go/src/ [root@node-201 src]# pwd /usr/local/go/src [root@node-2..
kubebuilder实现k8s operator模式
linclaus的博客
08-06 1942
背景 在Kubernetes中，希望通过CRD的方式定义业务资源，并通过Watch这些CR Object来做出相应的业务操作，也就是K8S Operator的实现，但是从零开始实现K8S Operator，是一件非常繁杂和困难的事情，好在当前社区提供了丰富的Operator实现框架，最热门的当属kubebuilder。 本文将参考官方文档在Ubuntu18.04进行实践 Installation 1.kubebuilder安装 os=$(go env GOOS) arch=$(go env GOARCH
kubebuilder创建operator
不爱学习的小妞博客
07-05 932
文章目录前言一、环境准备二、kubebuilder demo1.创建一个project2.初始化项目3.在宿主机上安装kubectl4.安装CRD并部署controller5.创建CR 前言 一、环境准备 1.go环境 go环境搭建可以参考笔者之前的笔记macOS搭建go环境及VSCode安装使用教程 sunxi@sunxideMacBook-Pro vagrant-provisioning % go version go version go1.16.5 darwin/amd64 2.kubebui
万物皆可operator之二，kubebuilder工具实现demo开发
sixinchao_1的博客
09-28 974
本文将介绍使用上一文中搭建的kubebuilder环境开发一个operator demo。 demo功能介绍： 新建一个crd，只有一个字段 image，当我们的controller watch到有对应的crd资源创建后，使用该image创建对应的deployment，进而拉起对应的pod。 1、选择一个目录，创建Unit目录后，去执行下边的命令 mkdir Unit cd Unit go mod init Unit 会生成go.mod文件 2、然后执行，domain可自己定义。 kubebuilder
Operator学习笔记
胜天半子
08-25 1642
一、什么是Operator Operator是CoreOS(一种操作系统，用于大量基于云计算的虚拟服务器)推出的，旨在简化复杂有状态应用管理。 Operator是一个感知应用状态的控制器，通过扩展k8s API来自动创建、管理和配置应用实例。Operator基于CRD（Custom Resource Definition）扩展资源对象，并通过控制器来保证应用处于预期状态。 Operator可用于： 通过k8s API观察集群的当前状态 分析当前状态与期望状态的差别 调用k8s API消除这些差别 二、为
基于kubebuilder开发operator流程
最新发布
09-01
<think> 我们正在回答用户关于“基于kubebuilder开发operator的详细流程”的问题。根据提供的引用资料，我们可以整理出开发流程。注意引用[2]提到步骤2和5是核心业务逻辑，其余可通过脚手架工具自动生成。 引用[1]和[2]都提到kubebuilder是一个热门的Operator开发框架，能够简化开发工作。引用[4]和[5]提供了具体的操作步骤。 因此，我们可以将流程分为以下几个主要步骤： 1. 环境准备：安装必要的工具，包括kubebuilder。 2. 初始化项目：使用kubebuilder初始化项目结构。 3. 创建API（CRD）：定义自定义资源（CRD）的Group、Version、Kind以及生成相关的代码和配置文件。 4. 实现业务逻辑：主要是Reconcile函数，即控制器逻辑。 5. 生成CRD清单：使用make命令生成CRD的yaml文件。 6. 部署和运行：将Operator部署到Kubernetes集群。 下面详细描述每个步骤： ### 步骤1：环境准备 根据引用[4]和引用[5]，需要安装kubebuilder。以Linux系统为例： - 下载kubebuilder二进制文件： ```bash wget https://github.com/kubernetes-sigs/kubebuilder/releases/latest/download/kubebuilder_linux_amd64 mv kubebuilder_linux_amd64 kubebuilder chmod +x kubebuilder mv kubebuilder /usr/local/bin/ ``` - 验证安装：`kubebuilder version` 此外，还需要安装kustomize（kubebuilder会用到）以及配置好Go环境（因为kubebuilder项目使用Go语言开发）。 ### 步骤2：初始化项目 创建一个目录作为项目根目录，然后初始化Go模块和kubebuilder项目。 ```bash mkdir demo-operator cd demo-operator go mod init demo-operator # 初始化Go模块 kubebuilder init --domain my.domain # 初始化项目，指定域名（例如my.domain） ``` 注意：引用[5]中提到，对于不同的操作系统架构，命令可能略有不同，但一般使用`--domain`参数即可。 ### 步骤3：创建API（CRD） 使用kubebuilder创建自定义资源定义（CRD）和控制器骨架。 ```bash kubebuilder create api --group webapp --version v1 --kind DemoOperator ``` 执行此命令后，会询问是否创建资源（Resource）和控制器（Controller），回答`y`（是）即可。 这将在项目中生成以下内容： - `api/v1/`目录：包含CRD的Go类型定义（在`demooperator_types.go`中） - `controllers/`目录：包含控制器的代码（在`demooperator_controller.go`中） 此时，我们需要编辑`api/v1/demooperator_types.go`文件，定义DemoOperator资源的结构（Spec）和状态（Status）。 ### 步骤4：实现业务逻辑（核心） 在生成的控制器文件`controllers/demooperator_controller.go`中，找到`Reconcile`方法。该方法就是Operator的核心逻辑，当创建、更新或删除自定义资源对象时，Reconcile函数会被调用。我们需要在此函数中编写业务逻辑。 例如，我们可能需要根据自定义资源对象的状态，创建、更新或删除其他Kubernetes资源（如Deployment、Service等）。 ### 步骤5：生成CRD清单 使用kubebuilder提供的make命令生成CRD的yaml文件： ```bash make manifests ``` 该命令会在`config/crd/bases/`目录下生成CRD的yaml文件。 ### 步骤6：部署和运行Operator 有两种方式运行Operator： 1. 本地运行（用于调试）： ```bash make install # 安装CRD到集群 make run # 本地运行Operator（需要配置kubeconfig） ``` 2. 部署到集群： - 构建Operator的镜像并推送到镜像仓库。 - 使用`make deploy`命令部署（该命令会使用`config/`目录下的部署清单，需要预先配置好镜像地址）。 部署完成后，就可以创建自定义资源对象（CR）来触发Operator的业务逻辑了。 注意：引用[3]提供了kubebuilder官方文档和阿里云原生技术公开课的链接，可以作为进一步学习的资料。 总结流程：准备环境 -> 初始化项目 -> 创建API（定义CRD）-> 实现控制器逻辑（Reconcile）-> 生成清单 -> 部署运行。 §§相关问题§§ 1. kubebuilder创建API时指定的Group、Version、Kind分别代表什么？ 2. 在Reconcile函数中如何监听自定义资源的变化？ 3. 如何测试和调试基于kubebuilder开发的Operator？ </think> 以下是基于kubebuilder开发Kubernetes Operator的详细流程，结合引用资料整理而成： ### 一、环境准备 1. **安装kubebuilder**（引用[4][5]） Linux系统： ```bash wget https://github.com/kubernetes-sigs/kubebuilder/releases/latest/download/kubebuilder_linux_amd64 mv kubebuilder_linux_amd64 kubebuilder chmod +x kubebuilder sudo mv kubebuilder /usr/local/bin/ ``` 其他系统需下载对应版本并配置环境变量 验证安装：`kubebuilder version` 2. **依赖工具** - Go 1.16+ - Kubernetes集群（Minikube或Kind） - kustomize（kubebuilder内置） --- ### 二、项目初始化（引用[5]） ```bash # 创建项目目录 mkdir demo-operator cd demo-operator # 初始化Go模块 go mod init demo-operator # 初始化kubebuilder项目（指定域名） kubebuilder init --domain my.domain ``` --- ### 三、创建API（CRD定义） 1. **生成CRD骨架**（引用[2][5]） ```bash kubebuilder create api \ --group webapp \ # API组名（如：apps.k8s.io） --version v1 \ # API版本 --kind DemoOperator # 自定义资源类型 ``` 提示时选择 `y` 创建Resource和Controller 2. **定义CRD结构** 编辑文件 `api/v1/demooperator_types.go`： ```go type DemoOperatorSpec struct { Replicas int32 `json:"replicas"` Image string `json:"image"` } type DemoOperatorStatus struct { AvailableReplicas int32 `json:"availableReplicas"` } ``` --- ### 四、实现业务逻辑（核心步骤） 1. **修改控制器**（引用[2]） 编辑 `controllers/demooperator_controller.go`： ```go func (r *DemoOperatorReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error) { // 1. 获取自定义资源实例 demo := &webappv1.DemoOperator{} if err := r.Get(ctx, req.NamespacedName, demo); err != nil { return ctrl.Result{}, client.IgnoreNotFound(err) } // 2. 业务逻辑（示例：创建Deployment） deploy := &appsv1.Deployment{ Spec: appsv1.DeploymentSpec{ Replicas: &demo.Spec.Replicas, Template: corev1.PodTemplateSpec{ Spec: corev1.PodSpec{ Containers: []corev1.Container{{ Image: demo.Spec.Image, }}, }, }, }, } // 3. 创建/更新资源 if err := r.Create(ctx, deploy); err != nil { return ctrl.Result{}, err } // 4. 更新状态 demo.Status.AvailableReplicas = *deploy.Spec.Replicas if err := r.Status().Update(ctx, demo); err != nil { return ctrl.Result{}, err } return ctrl.Result{}, nil } ``` --- ### 五、生成部署清单 1. **生成CRD YAML**（引用[5]） ```bash make manifests # 在config/crd/bases/生成CRD定义 ``` 2. **生成RBAC权限** 自动生成 `config/rbac/` 下的ClusterRole绑定文件 --- ### 六、部署与测试 1. **安装CRD到集群** ```bash make install # 应用CRD定义 ``` 2. **本地运行Operator**（调试用） ```bash make run # 本地启动控制器 ``` 3. **部署Operator到集群** ```bash # 构建镜像 docker build -t your-registry/demo-operator:v1 . docker push your-registry/demo-operator:v1 # 部署到集群 make deploy IMG=your-registry/demo-operator:v1 ``` 4. **创建自定义资源实例** ```yaml apiVersion: webapp.my.domain/v1 kind: DemoOperator metadata: name: demo-example spec: replicas: 3 image: nginx:1.21 ``` --- ### 七、验证操作 ```bash kubectl get demooperator # 查看自定义资源 kubectl get deployments # 检查Operator创建的负载 kubectl describe demooperator demo-example # 查看状态 ``` > 完整流程参考：[kubebuilder官方文档](https://book.kubebuilder.io/quick-start.html) [^3] > 最佳实践可学习阿里云原生技术公开课中的Operator开发范式 [^3]
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值