machinectl - 云端在线

程序：

您的姓名

machinectl - 控制 systemd 机器管理器

概要

机器控制 [选项...] {命令} [姓名...]

商品描述

机器控制 可用于自省和控制状态 systemd(1) 虚拟
机器和容器注册管理器 systemd-machined.service（8）。

机器控制 可用于在机器和图像上执行操作。 机器在这
感觉被视为正在运行的实例：

· 虚拟化硬件以运行完整操作系统 (OS) 的虚拟机 (VM)
位于主机之上的虚拟化环境中的实例（包括它们的内核）
OS。

· 与主机操作系统共享硬件和操作系统内核的容器，以便运行操作系统
主机操作系统之上的用户空间实例。

· 主机系统本身

机器由遵循与 UNIX 和 DNS 主机名相同规则的名称来标识，
有关详细信息，请参见下文。 机器是从磁盘或文件系统映像实例化的
经常——但不一定——与从它们运行的​​机器同名。
在这个意义上的图像被认为是：

· 包含操作系统的目录树，包括其顶级目录 在/ usr, /等及
等。

· btrfs 子卷包含操作系统树，类似于普通目录树。

· 包含 MBR 或 GPT 分区表和 Linux 文件系统的二进制“原始”磁盘映像
分区。

· 主机操作系统本身的文件系统树。

配置

理解以下选项：

-p, --属性=
显示机器或图像属性时，将输出限制为某些属性，如
由参数指定。 如果未指定，则显示所有设置的属性。 这
参数应该是属性名称，例如“Name”。 如果指定不止一次，所有
显示具有指定名称的属性。

-a, - 全部
显示机器或图像属性时，无论是否显示所有属性
它们是否已设置。

列出 VM 或容器映像时，不要禁止以点开头的映像
特点 （”。”）。

-l, - 满的
不要省略进程树条目。

--不问密码
不要向用户查询特权操作的身份验证。

--杀死谁=
当与 杀, 选择要杀死的进程。 必须是其中之一 领导者或 所有 至
选择是只杀死本机的leader进程还是本机的所有进程
机器。 如果省略，默认为 所有.

-s, --信号=
当与 杀, 选择要发送到选定进程的信号。 必须是其中之一
众所周知的信号说明符，例如 目标期限, SIGINT or 停止信号. 如果省略，
默认为 目标期限.

--uid=
当与 壳 命令，选择用户 ID 打开交互式 shell
会话作为。 如果未指定此开关，则默认为“root”。 注意这个开关
不支持 登录 命令（见下文）。

--setenv=
当与 壳 命令，设置一个环境变量传递给执行的
贝壳。 取一对环境变量名和值，用“=”隔开作为
争论。 这个开关可以多次使用来设置多个环境
变量。 请注意，此开关不支持 登录 命令（见下文）。

--mkdir
当与 绑定, 在应用绑定安装之前创建目标目录。

- 只读
当与 绑定, 应用只读绑定安装。

-n, --行=
当与 状态, 控制要显示的日志行数，从
最近的。 采用正整数参数。 默认为 10。

-o, --输出=
当与 状态, 控制显示的日记帐分录的格式。
有关可用选项，请参阅 日记(1). 默认为“短”。

--验证=
下载容器或VM镜像时，指定是否验证镜像
在它可用之前。 采用“否”、“校验和”和“签名”之一。 如果不”，
没有进行验证。 如果指定了“校验和”，则检查下载
传输完成后的完整性，但没有验证签名。 如果
“签名”被指定，校验和被验证，图像的签名是
对照可信赖供应商的本地密钥环进行检查。 强烈建议
如果服务器和协议支持此选项，请将此选项设置为“签名”。 默认为
“签名”。

- 力量
下载容器或虚拟机镜像时，以及指定本地的本地副本时
机器名已经存在，先删除，替换为新下载的
图片。

--格式=
当与 出口焦油 or 出口原料 命令，指定压缩格式
用于生成的文件。 采用“未压缩”、“xz”、“gzip”、“bzip2”之一。 经过
默认情况下，格式是根据传递的图像文件名自动确定的。

-H, --主机=
远程执行操作。 指定主机名，或用户名和主机名
以“@”分隔，连接到。 主机名可以选择后缀
容器名称，以“:”分隔，直接连接到特定容器
指定的主机。 这将使用 SSH 与远程机器管理器实例通信。
容器名称可以枚举为 机器控制 -H 主办方.

-M, --机器=
在本地容器上执行操作。 指定要连接的容器名称。

--无寻呼机
不要将输出通过管道传送到寻呼机。

--无图例
不要打印图例，即列标题和带有提示的页脚。

-h, - 帮帮我
打印简短的帮助文本并退出。

- 版
打印一个简短的版本字符串并退出。

指令

理解如下命令：

系统 命令
名单
列出当前运行的（在线）虚拟机和容器。 枚举机器
可以启动的图像，使用 列表图像 （见下文）。 请注意，此命令隐藏
默认情况下特殊的“.host”机器。 使用 - 全部 切换以显示它。

状态 您的姓名...
显示有关一个或多个虚拟机和容器的运行时状态信息，
其次是来自日志的最新日志数据。 该功能旨在
生成人类可读的输出。 如果您正在寻找计算机可解析的输出，请使用
显示 反而。 请注意，显示的日志数据是由虚拟机或
容器管理器，经常包含机器的控制台输出，但不包含
必须是机器本身的日志内容。

显示 [您的姓名...]
显示一个或多个已注册虚拟机或容器的属性或
经理本身。 如果未指定参数，将显示管理器的属性。
如果指定了 NAME，则会显示此虚拟机或容器的属性。 经过
默认情况下，空属性被抑制。 用 - 全部 也显示这些。 选择
要显示、使用的特定属性 --属性=. 此命令旨在用于
每当需要计算机可解析的输出时，并且不打印 cgroup 树或
日志条目。 用 状态 如果您正在寻找格式化的人类可读输出。

开始 您的姓名...
启动一个容器作为系统服务，使用 systemd-nspawn(1). 这开始
[电子邮件保护]，为指定的机器名称实例化，类似于
的作用 systemctl 开始 在服务名称上。 systemd-nspawn 寻找一个容器
/var/lib/machines/ 中指定名称的图像（和其他搜索路径，见下文）
并运行它。 用 列表图像 （见下文）列出可用的容器镜像
启动。

需要注意的是 systemd-machined.service(8) 还与其他各种接口
容器和虚拟机管理器， systemd-nspawn 只是它的一种实现。 大多数
中可用的命令 机器控制 可用于容器或由以下控制的虚拟机
其他经理，不仅仅是 systemd-nspawn. 在这些上启动 VM 和容器映像
管理人员需要特定于管理人员的工具。

在命令行上以交互方式启动容器，并具有对
容器的控制台，请调用 systemd-nspawn 直接地。 停止跑步
容器使用 机器控制 断电， 见下文。

登录 [您的姓名]
在容器或本地主机上打开交互式终端登录会话。 如果
提供了参数，它指的是要连接的容器机器。 如果没有
指定，或容器名称指定为空字符串，或特殊
指定机器名称“.host”（见下文），连接到本地
主机代替。 这将创建到特定容器或本地的 TTY 连接
主机并要求对其执行 getty。 请注意，这仅支持
容器运行 systemd(1) 作为初始化系统。

此命令将在容器或本地主机上打开一个完整的登录提示，其中
然后询问用户名和密码。 用 壳 （见下文）或 系统运行(1) 与
--机器= 切换到直接调用单个命令，以交互方式或在
背景。

壳 [[您的姓名@]您的姓名 [PATH [争论...]]]]
在容器或本地主机上打开交互式 shell 会话。 首先
参数是指要连接的容器机器。 如果没有指定，或者
机器名被指定为空字符串，或特殊机器名“.host”
（见下文），则连接到本地主机。 这有效
像 登录 但立即调用用户进程。 此命令运行
具有指定参数的指定可执行文件，或 / bin / sh的 如果没有指定。 经过
默认情况下，打开一个“root”shell，但通过使用 --uid=, 或者在机器名前加上前缀
使用用户名和“@”字符，可以选择不同的用户。 用 --setenv=
为执行的进程设置环境变量。

使用时 壳 不带参数的命令，（从而调用执行的 shell 或
本地主机上的命令），它在很多方面类似于 su(1) session，但是，不像
su，将新会话与原始会话完全隔离，使其
不共享进程或会话属性，并且处于干净且定义明确的状态。 它
将在新的 utmp、登录、审计、安全和密钥环会话中进行跟踪，并将
不继承任何环境变量或资源限制，以及其他属性。

需要注意的是 系统运行(1) 可以代替 壳 命令，并允许更多
被调用单元的详细、低级配置。 然而，它往往更
特权比 壳 命令。

enable 您的姓名...， 关闭 您的姓名...
启用或禁用容器作为系统服务以在系统启动时启动，使用
systemd-nspawn(1). 这会启用或禁用 [电子邮件保护]，实例化为
指定机器名，效果类似 systemctl enable or systemctl
关闭 在服务名称上。

断电 您的姓名...
关闭一个或多个容器的电源。 这将通过发送 SIGRTMIN+4 来触发重启
容器的 init 进程，这会导致 systemd 兼容的 init 系统关闭
干净地下来。 此操作不适用于不运行
systemd(1)-兼容的init系统，比如sysvinit。 用 终止 （见下文）到
立即终止容器或 VM，而无需彻底关闭它。

重新启动 您的姓名...
重启一个或多个容器。 这将通过将 SIGINT 发送到
容器的 init 进程，大致相当于按 Ctrl+Alt+Del
非容器化系统，与运行任何系统的容器兼容
经理。

终止 您的姓名...
立即终止虚拟机或容器，而无需彻底关闭它
下。 这会杀死虚拟机或容器的所有进程并释放所有进程
附加到该实例的资源。 用 断电 发出干净的关闭请求。

杀 您的姓名...
向虚拟机或容器的一个或多个进程发送信号。 这意味着
主机看到的进程，而不是虚拟机内部的进程或
容器。 用 --杀死谁= 选择要杀死的进程。 用 --信号= 选择
要发送的信号。

绑定 您的姓名 PATH [PATH]
Bind 将一个目录从主机挂载到指定的容器中。 首先
directory 参数是主机上的源目录，第二个目录参数
是容器中的目标目录。 当省略后者时，
容器中的目标路径与主机上的源路径相同。 什么时候
结合 - 只读 切换，创建一个就绪的绑定安装。 什么时候
结合 --mkdir 切换，目标路径首先创建之前
安装。 请注意，此选项目前仅支持 systemd-
生成(1)容器。

复制到 您的姓名 PATH [PATH]
将文件或目录从主机系统复制到正在运行的容器中。 需要一个
容器名称，后跟主机上的源路径和目标路径
容器。 如果省略目的路径，则与源路径相同
用过的。

复制自 您的姓名 PATH [PATH]
将容器中的文件或目录复制到主机系统中。 需要一个容器
名称，后跟容器中的源路径主机上的目标路径。
如果省略目标路径，则使用与源路径相同的路径。

图片 命令
列表图像
显示本地安装的容器和 VM 映像的列表。 这将枚举所有原始磁盘
/var/lib/machines/ 中的图像和容器目录和子卷（以及其他
搜索路径，见下文）。 用 开始 （见上文）从其中一个运行容器
列出的图像。 请注意，默认情况下，名称以点（“.”）开头的容器
未显示。 要也显示这些，请指定 - 全部. 请注意特殊图像“.host”
始终隐式存在并引用主机本身从其启动的映像。

图像状态 [您的姓名...]
显示有关一个或多个容器或 VM 映像的简洁状态信息。 这个功能
旨在生成人类可读的输出。 用 显示图像 （见下文）生成
计算机可解析的输出。

显示图像 [您的姓名...]
显示一个或多个已注册虚拟机或容器映像的属性，或
经理本身。 如果未指定参数，将显示管理器的属性。
如果指定了 NAME，则此虚拟机或容器映像的属性为
显示。 默认情况下，禁止空属性。 用 - 全部 也显示这些。 到
选择要显示的特定属性，使用 --属性=. 此命令旨在
每当需要计算机可解析输出时使用。 用 图像状态 如果你是
寻找格式化的人类可读输出。

克隆 您的姓名 您的姓名
克隆容器或 VM 映像。 参数指定要克隆的图像的名称
以及新克隆图像的名称。 请注意，普通目录容器图像是
使用此命令克隆到子卷图像。 请注意，克隆容器或 VM
图像针对 btrfs 文件系统进行了优化，在其他系统上可能效率不高，因为
到文件系统限制。

请注意，此命令会留下主机名、机器 ID 和所有其他可以
标识未修改的实例。 因此，原始图像和克隆副本将
共享这些凭据，并且可能需要在
复制。

重命名 您的姓名 您的姓名
重命名容器或 VM 映像。 参数指定要重命名的图像的名称
和图像的新名称。

唯读 您的姓名 [BOOL]
将容器或 VM 映像标记或（取消标记）为只读。 获取 VM 或容器映像
名称，后跟一个布尔值作为参数。 如果省略布尔值，则为正
暗示，即图像被标记为只读。

去掉 您的姓名...
删除一个或多个容器或 VM 映像。 特殊图像“.host”，指的是
主机自己的目录树，可能不会被删除。

设置限制 [您的姓名] 字节
设置特定容器或 VM 映像或所有映像的最大大小（以字节为单位），
可能会增长到磁盘（磁盘配额）。 采用一个或两个参数。 首先，
可选参数是指容器或 VM 映像名称。 如果指定，则大小
更改指定图像的限制。 如果省略，总和的总大小限制
本地存储的所有图像的 。 最后一个参数指定大小限制
以字节为单位，可能以通常的 K、M、G、T 单位为后缀。 如果大小限制为
禁用，指定“-”作为大小。

请注意，每个容器的大小限制仅在 btrfs 文件系统上受支持。 还
请注意，如果 设置限制 在没有图像参数的情况下调用，和 /var/lib/machines
为空，且目录不在 btrfs 上，一个 btrfs 环回文件是
隐式创建为具有给定大小的 /var/lib/machines.raw，并安装到
/var/lib/machines. 环回的大小可以稍后重新调整 设置限制作为
好。 如果使用这样一个环回挂载的 /var/lib/machines 目录， 设置限制
没有图像名称会改变文件系统中的配额设置以及
回送文件和文件系统大小本身。

图片 转让 命令
拉焦油 网址 [您的姓名]
从指定的 URL 下载 .tar 容器映像，并使其在
指定的本地机器名称。 URL 的类型必须为“http://”或“https://”，并且
必须引用 .tar、.tar.gz、.tar.xz 或 .tar.bz2 存档文件。 如果本地机器
name 被省略，它自动从 URL 的最后一个组件派生，用
其后缀已删除。

图像在可用之前经过验证，除非 --验证=否 已指定。
验证是通过需要制作的 SHA256SUMS 和 SHA256SUMS.gpg 文件完成的
在与 .tar 文件相同的 URL 下，在同一 Web 服务器上可用，但带有
替换的 URL 的最后一个组件（文件名）。 和 --verify=校验和， 只有
基于 SHA256SUMS 文件验证文件的 SHA256 校验和。 和
--verify=签名, SHA256SUMS 文件首先使用分离的 GPG 签名进行验证
文件 SHA256SUMS.gpg。 此验证步骤的公钥需要可用
在 /usr/lib/systemd/import-pubring.gpg 或 /etc/systemd/import-pubring.gpg 中。

容器镜像将被下载并存储在一个只读子卷中
/var/lib/machines/ 以指定的 URL 及其 HTTP etag 命名。 一个可写
然后从此子卷中获取快照，并以指定的本地名称命名。
此行为可确保创建同一 URL 的多个容器实例
高效，因为不需要多次下载。 为了只创建
只读映像，并避免创建其可写快照，指定“-”为本地
机器名称。

请注意，只读子卷以 .tar- 为前缀，因此未显示在
列表图像，除非 - 全部 通过了。

请注意，在执行此命令期间按 Cc 不会中止下载。
使用 VHDL 语言编写 取消转移， 如下面所描述的。

拉生 网址 [您的姓名]
从指定的 URL 下载 .raw 容器或 VM 磁盘映像，并使其
在指定的本地机器名称下可用。 URL 的类型必须是“http://”或
“https://”。 容器映像必须是 .qcow2 或原始磁盘映像，可选
压缩为 .gz、.xz 或 .bz2。 如果省略本地机器名，则为
自动派生自 URL 的最后一个组件，并删除其后缀。

原始图像和焦油图像的图像验证是相同的（见上文）。

如果下载的图像是 .qcow2 格式，则将其转换为原始图像文件
在它可用之前。

下载的这种类型的图像将作为只读 .raw 文件放置在
/var/lib/machines/. 然后在
指定的本地机器名称。 要省略创建本地可写副本传递“-”作为
本地机器名。

类似的行为 拉焦油，只读图像以 .raw- 为前缀，并且
因此没有显示 列表图像，除非 - 全部 通过了。

请注意，在执行此命令期间按 Cc 不会中止下载。
使用 VHDL 语言编写 取消转移， 如下面所描述的。

进口焦油 文件 [您的姓名], 进口原料 文件 [您的姓名]
导入 TAR 或 RAW 容器或 VM 映像，并将其放在指定名称下
/var/lib/machines/. 什么时候 进口焦油 使用时，指定为第一个参数的文件
应该是 tar 存档，可能用 xz、gzip 或 bzip2 压缩。 然后就会
解压到 /var/lib/machines 中它自己的子卷中。 什么时候 进口原料 使用，
文件应该是 qcow2 或原始磁盘映像，可能使用 xz、gzip 或 bzip2 压缩。
如果未指定第二个参数（结果图像名称），则为
自动从文件名派生。 如果文件名以“-”传递，则图像
从标准输入读取，在这种情况下，第二个参数是强制性的。

以上皆是 拉焦油 和 拉生 将调整 /var/lib/machines.raw 和文件系统的大小
根据需要在其中。 可选地， - 只读 开关可用于创建一个
只读容器或 VM 映像。 导入时不进行加密验证
图片。

很像图像下载，正在进行的导入可能会列出 列表转移 和
中止 取消转移.

出口焦油 您的姓名 [文件], 出口原料 您的姓名 [文件]
导出 TAR 或 RAW 容器或 VM 映像并将其存储在指定文件中。 这
第一个参数应该是 VM 或容器映像名称。 第二个参数应该是
写入 TAR 或 RAW 图像的文件路径。 如果路径以“.gz”结尾，则文件为
用 gzip 压缩，如果它以“.xz”结尾，用 xz，如果它以“.bz2”结尾，用
bzip2。 如果路径以两者结尾，则文件将保持未压缩状态。 如果第二个
缺少参数，图像被写入标准输出。 压缩还可以
明确选择 --格式= 转变。 这在以下情况下特别有用
第二个参数未指定。

就像图像下载和导入一样，正在进行的导出可能会列出
列表转移 并中止 取消转移.

请注意，目前只有目录和子卷图像可以导出为 TAR
图像，并且只有原始磁盘图像作为 RAW 图像。

列表转移
显示容器或 VM 映像下载、导入和导出的列表
目前正在进行中。

取消转移 ID...
中止下载、导入或导出具有指定的容器或 VM 映像
ID。 要列出正在进行的传输及其 ID，请使用 列表转移.

机 AND 图像 名字

这款 机器控制 工具在其名称必须选择以下的机器和图像上运行
条规严格。 机器名必须适合用作主机名
DNS 和 UNIX/Linux 语义的保守子集。 具体来说，它们必须包括
一个或多个非空标签字符串，用点分隔。 没有前导或尾随点
允许。 不允许有多个点的序列。 标签字符串只能由
字母数字字符以及破折号和下划线。 最大长度
机器名称为 64 个字符。

名称为“.host”的特殊机器是指正在运行的主机系统本身。 这是
对执行操作或检查主机系统也很有用。 注意
机器控制 名单 不会显示这台特殊的机器，除非 - 全部 开关被指定。

对图像名称的要求不那么严格，但是，它们必须是有效的 UTF-8，必须是
适合作为文件名（因此不是单点或双点，也不包括斜线），
并且可能不包含控制字符。 由于许多操作通过
请求机器的名称，建议以同样严格的方式命名图像
作为机器。

名为“.host”的特殊映像是指正在运行的主机系统的映像。 它
因此在概念上映射到上述特殊的“.host”机器名称。 注意
机器控制 列表图像 也不会显示此特殊图像，除非 - 全部 已指定。

FILES AND 目录

机器映像最好存储在 /var/lib/machines/ 中，但也会在
/usr/local/lib/machines/ 和 /usr/lib/machines/。 出于兼容性原因，目录
/var/lib/container/ 也被搜索。 请注意，下面存储的图像 在/ usr 总是
视为只读。 可以符号链接来自其他目录的机器图像
进入 /var/lib/machines/ 使它们可用于控制 机器控制.

注意很多图片操作只支持btrfs文件，高效或者原子
系统。 因此，如果 拉焦油, 拉生, 进口焦油, 进口原料 和 设置限制
命令注意到 /var/lib/machines 是空的并且不在 btrfs 上，它们将
隐式设置一个包含 btrfs 文件系统的环回文件 /var/lib/machines.raw
挂载到/var/lib/machines。 这个环回文件的大小可以控制
动态地与 设置限制.

磁盘映像被理解为 systemd-nspawn（1）和 机器控制 三种格式：

· 一个简单的目录树，包含容器的文件和目录
开机。

· 子卷（在 btrfs 文件系统上），类似于简单目录，
如上所述。 然而，它们还有额外的好处，例如高效的克隆和
配额报告。

· “原始”磁盘映像，即具有 GPT 或 MBR 分区表的磁盘的二进制映像。
这种类型的图像是带有后缀“.raw”的常规文件。

参见 systemd-nspawn(1) 有关图像格式的更多信息，尤其是其
--目录= 和 --图像= 选项​​。

示例

例如： 1. 下载 an Ubuntu 图片 和 open a 壳 in it

# machinectl pull-tar https://cloud-images.ubuntu.com/trusty/current/trusty-server-cloudimg-amd64-root.tar.gz
# systemd-nspawn -M trusty-server-cloudimg-amd64-root

这将下载并验证指定的 .tar 映像，然后使用 systemd-nspawn（1）来
在里面打开一个壳。

例如： 2. 下载 a Fedora 图片， 集 a 根 密码 in 它， 开始 it as 服务

# machinectl pull-raw --verify=no http://ftp.halifax.rwth-aachen.de/fedora/linux/releases/21/Cloud/Images/x86_64/Fedora-Cloud-Base-20141203-21.x86_64.raw.xz
# systemd-nspawn -M Fedora-Cloud-Base-20141203-21
#passwd
＃ 出口
# machinectl 启动 Fedora-Cloud-Base-20141203-21
# machinectl 登录 Fedora-Cloud-Base-20141203-21

这将下载指定的 .raw 图像并禁用验证。 然后，一个壳是
在其中打开并设置了root密码。 然后留下外壳，机器
作为系统服务启动。 使用最后一个命令，进入容器的登录提示是
请求。

例如： 3. 出口 a 容器 图片 as 焦油 文件

# machinectl 导出 tar fedora myfedora.tar.xz

将容器“fedora”作为 xz 压缩的 tar 文件 myfedora.tar.xz 导出到
当前目录。

例如： 4. 创建 a 新 壳 会议

# machinectl shell --uid=lennart

这会在本地主机上为用户 ID“lennart”创建一个新的 shell 会话，在一个
su(1)式样时装。

退出 状态

成功时，返回 0，否则返回非零失败代码。

环境

$SYSTEMD_PAGER
寻呼机何时使用 --无寻呼机 没有给出； 覆盖 $寻呼机. 将此设置为空
字符串或值“cat”相当于传递 --无寻呼机.

$SYSTEMD_LESS
覆盖传递给的默认选项 减 （“FRSXMK”）。

使用 onworks.net 服务在线使用 machinectl