简介
架构
快速开始
入门
版本兼容性与可支持性
1.
教程:构建 CronJob
1.1.
基础项目包含什么?
1.2.
每段旅程都有起点,每个程序都有 main
1.3.
Groups、Versions 与 Kind,哇哦!
1.4.
添加一个新的 API
1.5.
设计一个 API
1.5.1.
简短插曲:其他这些东西是什么?
1.6.
控制器包含什么?
1.7.
实现一个控制器
1.7.1.
你刚才提到 main?
1.8.
实现 defaulting/validating Webhook
1.9.
运行并部署控制器
1.9.1.
部署 cert-manager
1.9.2.
部署 Webhook
1.10.
编写测试
1.11.
尾声
2.
教程:多版本 API
2.1.
变更内容
2.2.
Hub、Spoke 以及其他轮式隐喻
2.3.
实现转换
2.3.1.
并配置 Webhook
2.4.
部署与测试
3.
迁移
3.1.
旧版(<= v3.0.0 之前)
3.1.1.
Kubebuilder v1 与 v2
3.1.1.1.
迁移指南
3.1.2.
Kubebuilder v2 与 v3
3.1.2.1.
迁移指南
3.1.2.2.
通过更新文件进行迁移
3.2.
从 v3.0.0 起(带插件)
3.2.1.
go/v3 与 go/v4
3.2.1.1.
迁移指南
3.2.1.2.
通过更新文件进行迁移
3.3.
单组到多组
4.
Alpha 命令
4.1.
alpha generate
4.2.
alpha update
5.
参考
5.1.
生成 CRD
5.2.
使用 Finalizer
5.3.
最佳实践
5.4.
触发事件
5.5.
监视资源
5.5.1.
被拥有的资源
5.5.2.
非拥有的资源
5.5.3.
使用谓词
5.6.
用于开发与 CI 的 Kind
5.7.
什么是 Webhook?
5.7.1.
准入 Webhook
5.8.
用于配置/代码生成的 Marker
5.8.1.
CRD 生成
5.8.2.
CRD 校验
5.8.3.
CRD 处理
5.8.4.
Webhook
5.8.5.
对象/DeepCopy
5.8.6.
RBAC
5.8.7.
Scaffold
5.9.
controller-gen CLI
5.10.
completion
5.11.
构建产物
5.12.
平台支持
5.13.
使用 pprof 进行监控
5.14.
Manager 与 CRD 作用域
5.15.
子模块布局
5.16.
使用外部资源/API
5.17.
配置 EnvTest
5.18.
指标
5.18.1.
参考
5.19.
项目配置
6.
插件
6.1.
可用插件
6.1.1.
autoupdate/v1-alpha
6.1.2.
deploy-image/v1-alpha
6.1.3.
go/v4
6.1.4.
grafana/v1-alpha
6.1.5.
helm/v1-alpha
6.1.6.
kustomize/v2
6.2.
扩展
6.2.1.
CLI 与插件
6.2.2.
外部插件
6.2.3.
E2E 测试
6.3.
插件版本管理
常见问题
Light (default)
Rust
Coal
Navy
Ayu
latest (v4-book)
v3-book
v2-book
v1-book
默认导出的指标参考(Default Exported Metrics References)
以下为
controller-runtime
默认导出并提供的指标:
指标名
类型
说明
workqueue_depth
Gauge
工作队列当前深度。
workqueue_adds_total
Counter
工作队列累计入队次数。
workqueue_queue_duration_seconds
Histogram
条目在被处理前在队列中停留的时长(秒)。
workqueue_work_duration_seconds
Histogram
处理一个队列条目所耗时间(秒)。
workqueue_unfinished_work_seconds
Gauge
尚未完成的工作总时长(秒)。该值过大意味着可能存在阻塞线程;可通过其增长速率推断阻塞线程数。
workqueue_longest_running_processor_seconds
Gauge
当前队列中运行时间最长的处理器已运行的秒数。
workqueue_retries_total
Counter
工作队列累计重试次数。
rest_client_requests_total
Counter
HTTP 请求次数,按状态码、方法与主机维度分区统计。
controller_runtime_reconcile_total
Counter
每个控制器的调谐(reconcile)总次数。
controller_runtime_reconcile_errors_total
Counter
每个控制器的调谐错误总次数。
controller_runtime_terminal_reconcile_errors_total
Counter
调谐器产生的不可恢复/终止性错误总次数。
controller_runtime_reconcile_time_seconds
Histogram
每次调谐耗时分布。
controller_runtime_max_concurrent_reconciles
Gauge
每个控制器的最大并发调谐数。
controller_runtime_active_workers
Gauge
每个控制器当前活跃的 worker 数。
controller_runtime_webhook_latency_seconds
Histogram
处理准入请求的延迟分布。
controller_runtime_webhook_requests_total
Counter
准入请求总数,按 HTTP 状态码分区统计。
controller_runtime_webhook_requests_in_flight
Gauge
当前正在处理的准入请求数量。