为容器设置启动时要执行的命令和参数

本页将展示如何为 Pod 中容器设置启动时要执行的命令及其参数。

Before you begin

你必须拥有一个 Kubernetes 的集群,同时你的 Kubernetes 集群必须带有 kubectl 命令行工具。 建议在至少有两个节点的集群上运行本教程,且这些节点不作为控制平面主机。 如果你还没有集群,你可以通过 Minikube 构建一个你自己的集群,或者你可以使用下面任意一个 Kubernetes 工具构建:

To check the version, enter kubectl version.

创建 Pod 时设置命令及参数

创建 Pod 时,可以为其下的容器设置启动时要执行的命令及其参数。如果要设置命令,就填写在配置文件的 command 字段下,如果要设置命令的参数,就填写在配置文件的 args 字段下。一旦 Pod 创建完成,该命令及其参数就无法再进行更改了。

如果在配置文件中设置了容器启动时要执行的命令及其参数,那么容器镜像中自带的命令与参数将会被覆盖而不再执行。如果配置文件中只是设置了参数,却没有设置其对应的命令,那么容器镜像中自带的命令会使用该新参数作为其执行时的参数。

Note: 在有些容器运行时中,command 字段对应 entrypoint,请参阅下面的 说明事项

本示例中,将创建一个只包含单个容器的 Pod。在 Pod 配置文件中设置了一个命令与两个参数:

pods/commands.yaml

  1. apiVersion: v1
  2. kind: Pod
  3. metadata:
  4. name: command-demo
  5. labels:
  6. purpose: demonstrate-command
  7. spec:
  8. containers:
  9. - name: command-demo-container
  10. image: debian
  11. command: ["printenv"]
  12. args: ["HOSTNAME", "KUBERNETES_PORT"]
  13. restartPolicy: OnFailure
  1. 基于 YAML 文件创建一个 Pod:

    1. kubectl apply -f https://k8s.io/examples/pods/commands.yaml
  2. 获取正在运行的 Pods:

    1. kubectl get pods

    查询结果显示在 command-demo 这个 Pod 下运行的容器已经启动完成。

  3. 如果要获取容器启动时执行命令的输出结果,可以通过 Pod 的日志进行查看:

    1. kubectl logs command-demo

    日志中显示了 HOSTNAME 与 KUBERNETES_PORT 这两个环境变量的值:

    1. command-demo
    2. tcp://10.3.240.1:443

使用环境变量来设置参数

在上面的示例中,我们直接将一串字符作为命令的参数。除此之外,我们还可以将环境变量作为命令的参数。

  1. env:
  2. - name: MESSAGE
  3. value: "hello world"
  4. command: ["/bin/echo"]
  5. args: ["$(MESSAGE)"]

这意味着你可以将那些用来设置环境变量的方法应用于设置命令的参数,其中包括了 ConfigMapsSecrets

Note: 环境变量需要加上括号,类似于 "$(VAR)"。这是在 commandargs 字段使用变量的格式要求。

在 Shell 来执行命令

有时候,你需要在 Shell 脚本中运行命令。 例如,你要执行的命令可能由多个命令组合而成,或者它就是一个 Shell 脚本。 这时,就可以通过如下方式在 Shell 中执行命令:

  1. command: ["/bin/sh"]
  2. args: ["-c", "while true; do echo hello; sleep 10;done"]

What’s next

最后修改 March 12, 2022 at 10:32 PM PST: [zh] Update define-command-argument-container.md (f50abc18f)