名称

podman-start - 启动一个或多个容器

简介

podman start [选项] 容器

podman container start [选项] 容器

描述

使用容器 ID 或名称作为输入启动一个或多个容器。attachinteractive 选项不能用于覆盖创建容器时指定的 --tty--interactive 选项。当使用 --attach 选项启动一个已在运行的容器时,Podman 只会连接到该容器。

选项

--all

启动所有容器,默认为只启动正在运行的容器。

--attach, -a

连接容器的 STDOUT 和 STDERR。默认为 false。当启动多个容器时,不能使用此选项。

--detach-keys=序列

指定用于分离容器的键序列。格式为单个字符 [a-Z] 或一个或多个 ctrl-<value> 字符,其中 <value> 是以下之一:a-z@^[,_。指定空字符串 "" 会禁用此功能。默认为 ctrl-p,ctrl-q

此选项也可以在 containers.conf(5) 文件中设置。

--filter, -f

过滤将从给定参数中启动的容器。可以使用多个 --filter 标志来给定多个过滤器。具有相同键的过滤器是包含性的,唯一的例外是 label 它是排他性的。具有不同键的过滤器总是排他性的。

下面列出了有效的过滤器

过滤器

描述

id

[ID] 容器的 ID(默认情况下 CID 前缀匹配;接受正则表达式)

name

[名称] 容器的名称(接受正则表达式)

label

[键] 或 [键=值] 分配给容器的标签

exited

[整数] 容器的退出代码

status

[状态] 容器的状态:“created”、“initialized”、“exited”、“paused”、“running”、“unknown”

ancestor

[ImageName] 用于创建容器的镜像或其后代

before

[ID] 或 [名称] 在此容器之前创建的容器

since

[ID] 或 [名称] 在此容器之后创建的容器

volume

[卷名称] 或 [挂载点目标] 挂载在容器中的卷

health

[状态] healthy 或 unhealthy

pod

[Pod] pod 的名称或完整或部分 ID

network

[网络] 网络的名称或完整 ID

until

[DateTime] 在给定持续时间或时间之前创建的容器。

command

[命令] 容器正在执行的命令,只取 argv[0]

--interactive, -i

设置为 true 时,使 stdin 可用于所包含的进程。如果为 false,所包含进程的 stdin 将为空并立即关闭。

如果已附加,stdin 将管道传输到所包含的进程。如果已分离,读取 stdin 将阻塞,直到稍后附加。

注意: Podman 会在 stdin 可用时立即消耗输入,即使所包含的进程未请求它。

--latest, -l

不提供名称或 ID,而是使用最新创建的容器。注意:最新创建的容器可能来自主机上 Podman 的其他用户。(此选项不适用于远程 Podman 客户端,包括 Mac 和 Windows(WSL2 除外)机器)

--sig-proxy

将接收到的信号代理到容器进程。SIGCHLD、SIGURG、SIGSTOP 和 SIGKILL 不会代理。

连接时默认为 true,否则为 false

示例

启动指定的容器

podman start mywebserver

启动多个容器

podman start 860a4b231279 5421ab43b45

在交互模式下启动指定的容器并连接终端

podman start --interactive --attach 860a4b231279

以交互模式启动最后创建的容器(此选项不适用于远程 Podman 客户端,包括 Mac 和 Windows (WSL2 除外) 机器)

podman start -i -l

按标签启动容器

$ podman start --filter label=app=frontend
9351ccb3ef4272532bc0c188bd4f0ddfc2b0de217732cd108259ea126b014647

按名称启动容器

$ podman start --filter name=backend-app1
93308911bd4769cda03b75eb7f56588e862e0ea3568f25e1e3defa4138b9b973

按状态启动容器

$ podman start --filter status=exited
f8e85f84a749b205fb602895afa6ec8a866045ff27b82f843033712c8b93a2c9
34f997d354017a0076402c3a79245a5b8bd11b597c84385bec25ae8941fd5238
47972eb04aa7c77705b597a929957d1e8a392e00b44c0a2a7f88a01f9f860d11

按名称启动容器

$ podman start --filter name=backend-app1
93308911bd4769cda03b75eb7f56588e862e0ea3568f25e1e3defa4138b9b973

按卷启动容器

$ podman start --filter volume=web-vol
4a3332649ed8bec1e0d82e113074b9a13d45582007aeac969c005992cc480a73

按网络启动容器

$ podman start --filter network=web-net
4a3332649ed8bec1e0d82e113074b9a13d45582007aeac969c005992cc480a73
f8e85f84a749b205fb602895afa6ec8a866045ff27b82f843033712c8b93a2c9

按祖先启动容器

$ podman start --filter ancestor=nginx
4a3332649ed8bec1e0d82e113074b9a13d45582007aeac969c005992cc480a73
47972eb04aa7c77705b597a929957d1e8a392e00b44c0a2a7f88a01f9f860d11

另请参阅

podman(1)

历史

2018 年 11 月,最初由 Brent Baude bbaude@redhat.com 编译