June 2021
Intermediate to advanced
335 pages
5h 50m
Chinese
Content preview from Kubernetes编程
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.
128
｜
第
5
章
对于有些类型的标签，注释写在不同的位置可能会有不同的效果。
准确地模仿示例程序（包括注释块）
有些标签必须紧接在一个类型的前面（或者对于全局标签来说，需要写
在包定义前面），而有些需要与类型（或包名）隔开至少一个空行。比如：
// +second-comment-block-tag
// +first-comment-block-tag
type Foo struct {
}
历史原因造就了这样区别：以前
Kubernetes
的
API
文档生成器不认识代
码生成标签，并只能输出第一个注释块。因此，第一个注释块中定义的
标签会出现在
API HTML
文档中。
代码生成器解析标签的逻辑也不是一成不变的，并且出错处理的机制也
还不完善。相关的逻辑在更新的版本中会更完善，为了保证一致性就需
要始终精确按照现有的代码来写。一个额外的空行都可能带来不同的行
为。
5.3.1
全局标签
全局标签会写在包的
doc.go
文件中。下面是一个典型的
pkg/apis/
group
/
version
/doc.go
文件：
// +k8s:deepcopy-gen=package
// Package v1 is the v1alpha1 version of the API.
// +groupName=cnat.programming-kubernetes.info
package v1alpha1
这个文件的第一行注释告诉
deepcopy-gen
需要为这个包中的所有类型生成对
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access
More than 5,000 organizations count on O’Reilly
O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.Julian F.
I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.Addison B.
I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.Amir M.
I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.