Podman 教程

podman run 命令手册

执行 podman run --help 命令:

C:\Users\hxstr> podman run --help
在新容器中运行命令

描述:
  基于指定镜像,在新容器中执行命令

用法:
  podman run [选项] 镜像名 [命令 [参数...]]

示例:
  podman run 镜像ID ls -alF /etc
  podman run --network=host 镜像ID dnf -y install java
  podman run --volume /var/hostdir:/var/ctrdir -i -t fedora /bin/bash

选项:
      --add-host strings                         添加自定义主机到IP的映射(格式:主机名:IP)(默认空)
      --annotation stringArray                   为容器添加注解(格式:键=值)
      --arch 架构                                选择镜像时,使用指定架构替代本机架构
  -a, --attach strings                           关联到标准输入(STDIN)、标准输出(STDOUT)或标准错误(STDERR)
      --authfile 路径                            认证文件的路径,可通过环境变量 REGISTRY_AUTH_FILE 覆盖
      --blkio-weight 字符串                      块设备IO权重(相对权重),取值范围10-1000
      --blkio-weight-device 设备名:权重          块设备IO权重(按设备分配相对权重,格式:设备名:权重)
      --cap-add strings                          为容器添加权限
      --cap-drop strings                         从容器中移除权限
      --cgroup-conf strings                      配置cgroup v2(格式:键=值)
      --cgroup-parent 路径                       容器的可选父cgroup
      --cgroupns 字符串                          要使用的cgroup命名空间
      --cgroups 字符串                           控制容器cgroup配置(可选值:enabled/disabled/no-conmon/split)
      --chrootdirs stringArray                   容器内的chroot目录
      --cidfile 路径                             将容器ID写入指定文件
      --cpu-period 整数                          限制CPU完全公平调度器(CFS)周期
      --cpu-quota 整数                           限制CPU完全公平调度器(CFS)配额
      --cpu-rt-period 整数                       限制CPU实时调度周期(单位:微秒)
      --cpu-rt-runtime 整数                      限制CPU实时调度运行时间(单位:微秒)
  -c, --cpu-shares 整数                          CPU份额(相对权重)
      --cpus 浮点数                              CPU核心数,默认0.000表示无限制
      --cpuset-cpus 字符串                       允许容器运行的CPU核心(格式:0-3、0,1)
      --cpuset-mems 字符串                       允许容器运行的内存节点(格式:0-3、0,1),仅在NUMA架构生效
      --creds 认证信息                           用于仓库认证的凭据(格式:用户名:密码)
  -d, --detach                                   后台运行容器并输出容器ID
      --detach-keys [a-Z]                        覆盖容器分离的按键序列,格式为单个字符[a-Z]或逗号分隔的ctrl-<值>
                                                 (<值>可选:a-cf、@、^、[、\、]、_)(默认"ctrl-p,ctrl-q")
      --device stringArray                       向容器添加主机设备
      --device-cgroup-rule strings               向cgroup允许设备列表添加规则
      --device-read-bps stringArray              限制设备读取速率(字节/秒)(示例:--device-read-bps=/dev/sda:1mb)
      --device-read-iops stringArray             限制设备读取速率(IO/秒)(示例:--device-read-iops=/dev/sda:1000)
      --device-write-bps stringArray             限制设备写入速率(字节/秒)(示例:--device-write-bps=/dev/sda:1mb)
      --device-write-iops stringArray            限制设备写入速率(IO/秒)(示例:--device-write-iops=/dev/sda:1000)
      --disable-content-trust                    Docker兼容选项,无实际作用(空操作)
      --dns strings                              设置自定义DNS服务器
      --dns-option strings                       设置自定义DNS选项
      --dns-search strings                       设置自定义DNS搜索域
      --entrypoint 字符串                        覆盖镜像的默认ENTRYPOINT(入口命令)
  -e, --env stringArray                          在容器中设置环境变量
      --env-file stringArray                     从文件读取环境变量
      --env-merge stringArray                    注入容器前,预处理镜像中的环境变量
      --expose strings                           暴露一个或多个端口(支持端口范围)
      --gidmap strings                           用户命名空间使用的GID映射
      --gpus strings                             向容器添加GPU设备("all"表示添加所有GPU)
      --group-add strings                        为容器主进程添加额外组,"keep-groups"允许使用补充组
      --group-entry 字符串                       写入容器/etc/group文件的条目
      --health-cmd 字符串                        为容器设置健康检查命令("none"禁用已有健康检查)
      --health-interval 字符串                   健康检查间隔("disable"表示不自动定时检查)(默认"30s")
      --health-log-destination 字符串            健康检查日志输出目标(目录路径、local或events_logger,local表示写入容器状态文件)(默认"local")
      --health-max-log-count 整数                健康检查日志最大记录次数(0表示无限制)(默认5)
      --health-max-log-size 整数                 健康检查日志最大存储长度(字符数,0表示无限制)(默认500)
      --health-on-failure 字符串                 容器变为不健康后的操作(默认"none")
      --health-retries 整数                      健康检查失败多少次后标记容器不健康(默认3)
      --health-start-period 字符串               容器启动初始化时间(默认"0s")
      --health-startup-cmd 字符串                为容器设置启动阶段健康检查命令
      --health-startup-interval 字符串           启动阶段健康检查间隔(默认"30s")
      --health-startup-retries 整数              启动阶段健康检查失败多少次后重启容器
      --health-startup-success 整数              启动阶段健康检查连续成功多少次后切换为常规健康检查(0表示一次成功即可)
      --health-startup-timeout 字符串            启动阶段健康检查超时时间(默认"30s")
      --health-timeout 字符串                    健康检查最长执行时间,超时视为失败并发送SIGKILL信号(默认"30s")
      --help                                     显示帮助信息
  -h, --hostname 字符串                          设置容器主机名
      --hosts-file 字符串                        生成容器/etc/hosts文件的基础文件,或指定特殊值("image"/"none")
      --hostuser strings                         添加主机用户到容器/etc/passwd文件
      --http-proxy                               根据主机代理变量,在容器中设置代理环境变量(默认true)
      --image-volume 字符串                      定义Podman如何处理镜像内置卷(可选值:bind/tmpfs/ignore)(默认"anonymous")
      --init                                     在容器内运行init程序,用于转发信号和回收进程
      --init-path 路径                           container-init程序的路径
  -i, --interactive                              保持标准输入对容器进程可用(支持交互)
      --ip 字符串                                为容器指定静态IPv4地址
      --ip6 字符串                               为容器指定静态IPv6地址
      --ipc 字符串                               要使用的IPC命名空间
  -l, --label stringArray                        为容器设置元数据标签
      --label-file stringArray                   从换行分隔的文件中读取标签
      --log-driver 字符串                        容器的日志驱动
      --log-opt stringArray                      日志驱动选项
      --mac-address 字符串                       容器MAC地址(示例:92:d0:c6:0a:29:33)
  -m, --memory <数字>[<单位>]                    内存限制(格式:<数字>[<单位>],单位支持b/字节、k/千字节、m/兆字节、g/吉字节)
      --memory-reservation <数字>[<单位>]         内存软限制(格式同上)
      --memory-swap 字符串                       交换分区限制(内存+交换分区,-1表示无限制)
      --memory-swappiness 整数                   调整容器内存交换倾向(0-100,-1使用系统默认)(默认-1)
      --mount stringArray                        为容器挂载文件系统
      --name 字符串                              为容器分配名称
      --network stringArray                      将容器连接到指定网络
      --network-alias strings                    为容器添加网络范围的别名
      --no-healthcheck                           禁用容器的健康检查
      --no-hostname                              不在容器内创建/etc/hostname,使用镜像中的默认文件
      --no-hosts                                 不在容器内创建/etc/hosts,使用镜像中的默认文件
      --oom-kill-disable                         禁用OOM Killer(内存溢出终止器)
      --oom-score-adj 整数                       调整主机对容器的OOM优先级(-1000到1000)
      --os 操作系统                              选择镜像时,使用指定操作系统替代当前运行系统
      --passwd                                   向容器/etc/passwd和/etc/group添加条目(默认true)
      --passwd-entry 字符串                       写入容器/etc/passwd文件的条目
      --personality 字符串                       通过personality配置执行域(示例:LINUX/LINUX32)
      --pid 字符串                               要使用的PID命名空间
      --pids-limit 整数                          调整容器PID限制(-1表示无限制)(默认-1)
      --platform 字符串                          指定选择镜像的平台(与--arch和--os冲突)
      --pod 字符串                               在现有Pod中运行容器
      --pod-id-file 路径                         从文件读取Pod ID
      --privileged                               为容器授予扩展权限
  -p, --publish strings                          将容器的一个或多个端口映射到主机(默认空)
  -P, --publish-all                              将所有暴露的端口映射到主机的随机端口
      --pull 字符串                              镜像拉取策略(可选值:always/missing/never/newer)
  -q, --quiet                                    拉取镜像时抑制输出信息
      --rdt-class 字符串                         为容器分配的服务等级(COS)
      --read-only                                使容器根文件系统为只读
      --read-only-tmpfs                          运行只读容器时,在/dev、/dev/shm、/run、/tmp和/var/tmp挂载可写tmpfs(默认true)
      --replace                                  若同名容器已存在,则替换它
      --requires strings                         添加一个或多个依赖容器,需先启动依赖容器再启动当前容器
      --restart 字符串                           容器退出后的重启策略(可选值:always/no/never/on-failure/unless-stopped)
      --retry 整数                               拉取镜像失败时的重试次数
      --retry-delay 字符串                       拉取镜像失败后的重试间隔
      --rm                                       容器退出后,删除容器及关联的匿名卷
      --rmi                                      除非镜像被其他容器使用,否则删除镜像(隐含--rm)
      --rootfs                                   第一个参数不是镜像,而是已解压容器的根文件系统
      --sdnotify 字符串                          控制sd-notify行为(可选值:container/conmon/healthy/ignore)(默认"container")
      --seccomp-policy 字符串                    选择seccomp配置文件的策略(实验性)(默认"default")
      --secret stringArray                       向容器添加密钥
      --security-opt stringArray                 安全选项
      --shm-size <数字>[<单位>]                   /dev/shm分区大小(格式同上)
      --shm-size-systemd <数字>[<单位>]           systemd专用tmpfs挂载大小(/run、/run/lock)(格式同上)
      --sig-proxy                                将接收到的信号代理给容器进程(默认true)
      --stop-signal 字符串                       停止容器的信号(默认SIGTERM)
      --stop-timeout 整数                        用户停止容器时的退出超时时间(秒),超时后发送SIGKILL强制停止(默认10)
      --subgidname 字符串                        /etc/subgid中列出的、用于用户命名空间的GID范围名称
      --subuidname 字符串                        /etc/subuid中列出的、用于用户命名空间的UID范围名称
      --sysctl strings                           Sysctl配置选项
      --systemd 字符串                           以systemd模式运行容器(可选值:true/false/always)(默认"true")
      --timeout 整数                             容器允许运行的最长时间,超时后自动终止
      --tls-verify                               拉取镜像时要求HTTPS并验证仓库证书
      --tmpfs tmpfs                              向容器挂载临时文件系统(tmpfs)
  -t, --tty                                      为容器分配伪终端(TTY)
      --tz 字符串                                设置容器时区
      --uidmap strings                           用户命名空间使用的UID映射
      --ulimit strings                           Ulimit限制选项
      --umask 字符串                             设置容器的umask权限(默认"0022")
      --unsetenv stringArray                     取消容器中的默认环境变量
      --unsetenv-all                             取消容器中所有默认环境变量
  -u, --user 字符串                              用户名或UID(格式:<名称|UID>[:<组名|GID>])
      --userns 字符串                            要使用的用户命名空间
      --uts 字符串                               要使用的UTS命名空间
      --variant 变体                             选择镜像时,使用指定架构变体替代当前运行架构变体
  -v, --volume stringArray                       将卷绑定挂载到容器(卷源路径位于服务器端,而非客户端)
      --volumes-from stringArray                 从指定容器挂载卷
  -w, --workdir 字符串                           容器内的工作目录

  

说说我的看法
全部评论(
没有评论
关于
本网站专注于 Java、数据库(MySQL、Oracle)、Linux、软件架构及大数据等多领域技术知识分享。涵盖丰富的原创与精选技术文章,助力技术传播与交流。无论是技术新手渴望入门,还是资深开发者寻求进阶,这里都能为您提供深度见解与实用经验,让复杂编码变得轻松易懂,携手共赴技术提升新高度。如有侵权,请来信告知:hxstrive@outlook.com
其他应用
公众号