138 lines
5.8 KiB
Markdown
138 lines
5.8 KiB
Markdown
---
|
||
title: 使用命令式的方式管理 Kubernetes 对象
|
||
content_template: templates/concept
|
||
---
|
||
|
||
{{% capture overview %}}
|
||
直接使用内置的 `kubectl` 命令行工具，以命令式方式可以快速创建，更新和删除 Kubernetes 对象。本文档介绍了这些命令是如何组织的，以及如何使用它们来管理活动对象。
|
||
{{% /capture %}}
|
||
|
||
{{% capture body %}}
|
||
|
||
## 权衡
|
||
|
||
`kubectl` 工具支持三种方式进行对象的管理:
|
||
|
||
* 命令式的方式
|
||
* 命令式的对象配置
|
||
* 声明式的对象配置
|
||
|
||
参见[Kubernetes对象管理](/docs/concepts/tools/kubectl/object-management-overview/)
|
||
讨论各种对象管理方式的优缺点.
|
||
|
||
## 如何创建对象
|
||
|
||
`kubectl` 工具支持用于创建一些最常用的对象类型的动词驱动命令，这些命令的命名让不熟悉Kubernetes 对象的用户也可以见名知义。
|
||
|
||
- `run`: 创建一个新的 Deployment 对象以在一个或多个 Pod 中运行 Containers。
|
||
- `expose`: 创建一个新的 Service 对象用于负载均衡 Pods 上的的网络流量。
|
||
- `autoscale`: 创建一个新的 Autoscaler 对象，来实现 Deployment 等控制器的自动水平拓展。
|
||
|
||
`kubectl` 工具也支持由对象类型驱动的创建命令。 这些命令支持更多的对象类型，并且对其意图更为明确，但要求用户知道他们打算创建的对象的类型。
|
||
|
||
- `create <objecttype> [<subtype>] <instancename>`
|
||
|
||
某些对象类型具有您可以在“create"命令中指定的子类型。例如，Service对象有ClusterIP，LoadBalancer和NodePort等几种子类型。以下是使用子类型NodePort创建一个服务的示例:
|
||
|
||
```shell
|
||
kubectl create service nodeport <myservicename>
|
||
```
|
||
|
||
在前面的例子中， `create service nodeport`命令叫做 `create service`命令的子命令.
|
||
|
||
您可以使用 `-h` 标志来查找子命令支持的参数和标志:
|
||
|
||
```shell
|
||
kubectl create service nodeport -h
|
||
```
|
||
|
||
## 如何更新对象
|
||
|
||
`kubectl` 命令支持一些常见更新操作的动词驱动命令。这些命令的命名方式可以让不熟悉 Kubernetes 对象的用户，在不知道必须设置的特定字段的情况下也可以执行更新操作:
|
||
|
||
- `scale`: 通过更新控制器的副本数量，水平扩展控制器以添加或删除 Pod。
|
||
- `annotate`: 从对象添加或删除注释。
|
||
- `label`: 为对象添加或删除标签。
|
||
|
||
`kubectl`命令还支持由对象的一个切面驱动的更新命令.设置此切面可能会为不同的对象类型设置不同的字段:
|
||
|
||
- `set` <field>: 设置对象的一个切面。
|
||
|
||
**注**: 在 Kubernetes 版本 1.5 中，并不是每个动词驱动的命令都有一个相关的切面驱动的命令。
|
||
|
||
`kubectl` 工具支持直接更新活动对象的其他方法，然而，它们需要更好的了解 Kubernetes 对象模式。
|
||
|
||
- `edit`: 通过在编辑器中打开其配置，直接编辑活动对象的原始配置。
|
||
- `patch`: 通过使用补丁字符串直接修改活动对象的特定字段。
|
||
|
||
有关补丁字符串的更多详细信息，请参阅补丁部分
|
||
[API 公约](https://github.com/kubernetes/community/blob/master/contributors/devel/api-conventions.md#patch-operations)。
|
||
|
||
## 如何删除对象
|
||
|
||
您可以使用 `delete` 命令从集群中删除一个对象:
|
||
|
||
- `delete <type>/<name>`
|
||
|
||
**注意**: 您可以对命令式命令和命令式对象配置都使用 `kubectl delete` 方法。两者的差异在于传递的命令参数不同。要将
|
||
`kubectl delete` 作为命令式命令使用，需将要删除的对象作为参数传递。以下是传递名为 nginx 的 Deployment 对象的示例:
|
||
|
||
```shell
|
||
kubectl delete deployment/nginx
|
||
```
|
||
|
||
## 如何查看对象
|
||
|
||
{{< comment >}}
|
||
TODO(pwittrock): 实现时取消注释。
|
||
|
||
您可以使用 `kubectl view` 打印对象的指定字段。
|
||
|
||
- `view`: 打印对象的特定字段的值。
|
||
|
||
{{< /comment >}}
|
||
|
||
|
||
|
||
有几个命令用于打印有关对象的信息:
|
||
|
||
- `get`: 打印有关匹配对象的基本信息。使用 `get -h` 来查看选项列表。
|
||
- `describe`: 打印有关匹配对象的聚合详细信息。
|
||
- `logs`: 打印 Pod 运行容器的 stdout 和 stderr 信息。
|
||
|
||
## 使用 `set` 命令在创建之前修改对象
|
||
|
||
有一些对象字段没有可以在 `create` 命令中使用的标志。在某些情况下，您可以组合使用 `set` 和 `create` 在对象创建之前指定字段的值。这是通过将 `create` 命令的输出管道连接到 `set` 命令，然后回到 `create` 命令。以下是一个例子:
|
||
|
||
```sh
|
||
kubectl create service clusterip <myservicename> -o yaml --dry-run | kubectl set selector --local -f - 'environment=qa' -o yaml | kubectl create -f -
|
||
```
|
||
|
||
1. 使用 `create service -o yaml --dry-run` 创建服务配置，并将其作为 YAML 打印到 stdout，而不是将其发送到 Kubernetes API 服务器。
|
||
1. 使用 `set --local -f - -o yaml` 从 stdin 读取配置，并将更新后的配置作为 YAML 写入 stdout。
|
||
1. 使用 `kubectl create -f -` 从 stdin 提供的配置创建对象。
|
||
|
||
## 使用 `--edit` 在创建之前修改对象
|
||
|
||
您可以使用 `kubectl create --edit` 命令在对象创建之前，对对象进行任意更改。以下是一个例子:
|
||
|
||
```sh
|
||
kubectl create service clusterip my-svc -o yaml --dry-run > /tmp/srv.yaml
|
||
kubectl create --edit -f /tmp/srv.yaml
|
||
```
|
||
|
||
1. 使用`create service` 创建服务的配置并将其保存到 `/tmp/srv.yaml`。
|
||
1. 使用`create --edit` 在创建对象之前打开配置文件进行编辑。
|
||
|
||
|
||
{{% /capture %}}
|
||
|
||
{{% capture whatsnext %}}
|
||
- [使用对象配置管理 Kubernetes 对象(必要)](/docs/tutorials/object-management-kubectl/imperative-object-management-configuration/)
|
||
- [使用对象配置(声明式)管理 Kubernetes 对象](/docs/tutorials/object-management-kubectl/declarative-object-management-configuration/)
|
||
- [Kubectl 命令参考](/docs/user-guide/kubectl/v1.6/)
|
||
- [Kubernetes 对象模式参考](/docs/resources-reference/v1.6/)
|
||
{{% /capture %}}
|
||
|
||
|