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

Before you begin

You need to have a Kubernetes cluster, and the kubectl command-line tool must be configured to communicate with your cluster. If you do not already have a cluster, you can create one by using Minikube, or you can use one of these Kubernetes playgrounds:

To check the version, enter kubectl version.

创建Pod时为其下的容器设置启动时要执行的命令及其入参

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

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

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

commands.yaml
apiVersion: v1
kind: Pod
metadata:
  name: command-demo
  labels:
    purpose: demonstrate-command
spec:
  containers:
  - name: command-demo-container
    image: debian
    command: ["printenv"]
    args: ["HOSTNAME", "KUBERNETES_PORT"]
  restartPolicy: OnFailure
  1. 基于YAML文件创建一个Pod:

    kubectl create -f https://k8s.io/docs/tasks/inject-data-application/commands.yaml
    
  2. 获取一下当前正在运行的Pods信息:

    kubectl get pods
    

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

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

    kubectl logs command-demo
    

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

     command-demo
     tcp://10.3.240.1:443
    

使用环境变量来设置入参

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

env:
- name: MESSAGE
  value: "hello world"
command: ["/bin/echo"]
args: ["$(MESSAGE)"]

这样一来,我们就可以将那些用来设置环境变量的方法应用于设置命令的入参,其 中包括了ConfigMapsSecrets.

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

通过shell来执行命令

有时候,需要通过shell来执行命令。 例如,命令可能由多个命令组合而成,抑或包含 在一个shell脚本中。这时,就可以通过如下方式在shell中执行命令:

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

注意

下表给出了Docker 与 Kubernetes中对应的字段名称。

Description Docker field name Kubernetes field name
The command run by the container Entrypoint command
The arguments passed to the command Cmd args

如果要覆盖默认的Entrypoint 与 Cmd,需要遵循如下规则:

下表涵盖了各类设置场景:

Image Entrypoint Image Cmd Container command Container args Command run
[/ep-1] [foo bar] <not set> <not set> [ep-1 foo bar]
[/ep-1] [foo bar] [/ep-2] <not set> [ep-2]
[/ep-1] [foo bar] <not set> [zoo boo] [ep-1 zoo boo]
[/ep-1] [foo bar] [/ep-2] [zoo boo] [ep-2 zoo boo]

What’s next