kubectl 的用法约定

kubectl 的推荐用法约定。

在可重用脚本中使用 kubectl

对于脚本中的稳定输出：

• 请求一个面向机器的输出格式，例如 -o name、-o json、-o yaml、-o go template 或 -o jsonpath。
• 完全限定版本。例如 jobs.v1.batch/myjob。这将确保 kubectl 不会使用其默认版本，该版本会随着时间的推移而更改。
• 不要依赖上下文、首选项或其他隐式状态。

最佳实践

kubectl run

若希望 kubectl run 满足基础设施即代码的要求：

• 使用特定版本的标签标记镜像，不要将该标签移动到新版本。例如，使用 :v1234、v1.2.3、r03062016-1-4，而不是 :latest（有关详细信息，请参阅配置的最佳实践)。
• 使用基于版本控制的脚本来运行包含大量参数的镜像。
• 对于无法通过 kubectl run 参数来表示的功能特性，使用基于源码控制的配置文件，以记录要使用的功能特性。

你可以使用 --dry-run=client 参数来预览而不真正提交即将下发到集群的对象实例：

说明：

所有的 kubectl run 生成器已弃用。 查阅 Kubernetes v1.17 文档中的生成器列表以及它们的用法。

生成器

你可以使用 kubectl 命令生成以下资源， kubectl create --dry-run=client -o yaml：

• clusterrole: 创建 ClusterRole。
• clusterrolebinding: 为特定的 ClusterRole 创建 ClusterRoleBinding。
• configmap: 使用本地文件、目录或文本值创建 Configmap。
• cronjob: 使用指定的名称创建 Cronjob。
• deployment: 使用指定的名称创建 Deployment。
• job: 使用指定的名称创建 Job。
• namespace: 使用指定的名称创建名称空间。
• poddisruptionbudget: 使用指定名称创建 Pod 干扰预算。
• priorityclass: 使用指定的名称创建 Priorityclass。
• quota: 使用指定的名称创建配额。
• role: 使用单一规则创建角色。
• rolebinding: 为特定角色或 ClusterRole 创建 RoleBinding。
• secret: 使用指定的子命令创建 Secret。
• service: 使用指定的子命令创建服务。
• serviceaccount: 使用指定的名称创建服务帐户。

kubectl apply

• 您可以使用 kubectl apply 命令创建或更新资源。有关使用 kubectl apply 更新资源的详细信息，请参阅 Kubectl 文档。