machinectl - Online en la nube

PROGRAMA:

NOMBRE

machinectl - Controla el administrador de máquinas systemd

SINOPSIS

máquinactl [OPCIONES ...] {COMANDO} [NOMBRE ...]

DESCRIPCIÓN

máquinactl se puede utilizar para introspectar y controlar el estado de la sistemad(1) virtuales
gerente de registro de máquinas y contenedores systemd-machined.servicio(8).

máquinactl se puede utilizar para ejecutar operaciones en máquinas e imágenes. Máquinas en este
sense se consideran instancias en ejecución de:

· Máquinas virtuales (VM) que virtualizan el hardware para ejecutar el sistema operativo (SO) completo
instancias (incluidos sus núcleos) en un entorno virtualizado en la parte superior del host
OS.

· Contenedores que comparten el hardware y el kernel del sistema operativo con el sistema operativo host, para ejecutar el sistema operativo
instancias de espacio de usuario en la parte superior del sistema operativo host.

· El propio sistema anfitrión

Las máquinas se identifican por nombres que siguen las mismas reglas que los nombres de host de UNIX y DNS,
para obtener más detalles, consulte a continuación. Se crean instancias de las máquinas a partir de imágenes de disco o sistema de archivos que
con frecuencia, pero no necesariamente, llevan el mismo nombre que las máquinas que se ejecutan desde ellos.
Se consideran imágenes en este sentido:

· Árboles de directorios que contienen un sistema operativo, incluidos sus directorios de nivel superior / usr, / Etc y
pronto.

· Subvolúmenes btrfs que contienen árboles de SO, similares a los árboles de directorios normales.

· Imágenes de disco binarias "sin procesar" que contienen tablas de particiones MBR o GPT y sistema de archivos Linux
particiones

· El árbol del sistema de archivos del propio SO host.

OPCIONES

Se entienden las siguientes opciones:

-p, --property =
Al mostrar las propiedades de la máquina o la imagen, limite la salida a ciertas propiedades como
especificado por el argumento. Si no se especifica, se muestran todas las propiedades establecidas. los
El argumento debe ser un nombre de propiedad, como "Nombre". Si se especifica más de una vez, todos
se muestran las propiedades con los nombres especificados.

-a, --todas
Al mostrar las propiedades de la máquina o la imagen, muestre todas las propiedades independientemente de si
están configurados o no.

Al enumerar imágenes de contenedores o máquinas virtuales, no suprima las imágenes que comienzan con un punto
personaje (".").

-l, --lleno
No elipsize las entradas del árbol de procesos.

--sin-pedir-contraseña
No solicite al usuario autenticación para operaciones privilegiadas.

--kill-who =
Cuando se usa con matar, elija qué procesos eliminar. Debe ser uno de líder o que todas a
seleccione si desea matar solo el proceso líder de la máquina o todos los procesos del
máquina. Si se omite, el valor predeterminado es que todas.

-s, --señal =
Cuando se usa con matar, elija qué señal enviar a los procesos seleccionados. Debe ser uno de
los especificadores de señal conocidos, como SIGNO, SIGINT or SEGUIMIENTO. Si se omite,
por defecto es SIGNO.

--uid =
Cuando se usa con el shell comando, elige el ID de usuario para abrir el shell interactivo
sesión como. Si no se especifica este modificador, el valor predeterminado es "root". Tenga en cuenta que este interruptor
no es compatible con Inicie sesión comando (ver más abajo).

--setenv =
Cuando se usa con el shell comando, establece una variable de entorno para pasar al ejecutado
cascarón. Toma un par de nombre y valor de variable de entorno, separados por "=" como
argumento. Este interruptor se puede utilizar varias veces para configurar varios entornos
variables. Tenga en cuenta que este conmutador no es compatible con Inicie sesión comando (ver más abajo).

--mkdir
Cuando se usa con se unen, crea el directorio de destino antes de aplicar el montaje de enlace.

--solo lectura
Cuando se usa con se unen, aplica un montaje de enlace de solo lectura.

-n, --lines =
Cuando se usa con estado, controla el número de líneas de diario que se mostrarán, contando desde el
los más recientes. Toma un argumento entero positivo. El valor predeterminado es 10.

-o, --salida =
Cuando se usa con estado, controla el formato de las entradas de diario que se muestran.
Para conocer las opciones disponibles, consulte journalctl(1). El valor predeterminado es "corto".

--verify =
Al descargar un contenedor o una imagen de VM, especifique si la imagen debe ser verificada
antes de que esté disponible. Toma uno de "no", "suma de comprobación" y "firma". Si no",
no se realiza ninguna verificación. Si se especifica "suma de comprobación", se comprueba la descarga.
integridad una vez completada la transferencia, pero no se verifican las firmas. Si
se especifica la "firma", se verifica la suma de comprobación y la firma de la imagen se
cotejado con un llavero local de proveedores confiables. Se recomienda encarecidamente
establezca esta opción en "firma" si el servidor y el protocolo lo admiten. Predeterminado a
"firma".

--fuerza
Al descargar un contenedor o una imagen de VM, y una copia local por el local especificado
El nombre de la máquina ya existe, elimínelo primero y reemplácelo por el recién descargado.
imagen.

--format =
Cuando se usa con el exportación-alquitrán or exportación-crudo comandos, especifica el formato de compresión
utilizar para el archivo resultante. Toma uno de "sin comprimir", "xz", "gzip", "bzip2". Por
Por defecto, el formato se determina automáticamente a partir del nombre del archivo de imagen pasado.

-H, --host =
Ejecute la operación de forma remota. Especifique un nombre de host o un nombre de usuario y un nombre de host
separados por "@", para conectarse. El nombre de host puede tener opcionalmente un sufijo
nombre del contenedor, separado por ":", que se conecta directamente a un contenedor específico en
el host especificado. Esto usará SSH para comunicarse con la instancia del administrador de la máquina remota.
Los nombres de los contenedores se pueden enumerar con máquinactl -H HOST.

-M, --machine =
Ejecutar la operación en un contenedor local. Especifique un nombre de contenedor al que conectarse.

--sin buscapersonas
No canalice la salida a un buscapersonas.

--no-leyenda
No imprima la leyenda, es decir, los encabezados de las columnas y el pie de página con sugerencias.

-h, --ayuda
Imprima un breve texto de ayuda y salga.

--versión
Imprima una cadena de versión corta y salga.

COMANDOS

Se entienden los siguientes comandos:

Máquina Comandos
lista
Enumere las máquinas virtuales y los contenedores que se ejecutan actualmente (en línea). Para enumerar la máquina
imágenes que se pueden iniciar, utilice lista-imágenes (vea abajo). Tenga en cuenta que este comando oculta
la máquina especial ".host" por defecto. Utilizar el --todas cambiar para mostrarlo.

estado NOMBRE...
Muestra información sobre el estado del tiempo de ejecución sobre una o más máquinas virtuales y contenedores.
seguido de los datos de registro más recientes del diario. Esta función está destinada a
generar resultados legibles por humanos. Si está buscando una salida analizable por computadora, use
show en lugar de. Tenga en cuenta que los datos de registro que se muestran los informa la máquina virtual o
administrador de contenedores, y con frecuencia contiene la salida de la consola de la máquina, pero no
necesariamente el contenido del diario de la propia máquina.

show [NOMBRE...]
Mostrar propiedades de una o más máquinas virtuales o contenedores registrados o el
gerente en sí. Si no se especifica ningún argumento, se mostrarán las propiedades del administrador.
Si se especifica un NOMBRE, se muestran las propiedades de esta máquina virtual o contenedor. Por
por defecto, las propiedades vacías están suprimidas. Usar --todas para mostrarlos también. Para seleccionar
propiedades específicas para mostrar, usar --property =. Este comando está destinado a ser utilizado
siempre que se requiera una salida analizable por computadora, y no imprima el árbol cgroup o
entradas de diario. Usar estado si está buscando una salida con formato legible por humanos.

comienzo NOMBRE...
Inicie un contenedor como servicio del sistema, utilizando sistemad-nspawn(1). Esto comienza
[email protected], instanciado para el nombre de máquina especificado, similar al
efecto de systemctl comienzo en el nombre del servicio. sistemad-nspawn busca un contenedor
imagen por el nombre especificado en / var / lib / machines / (y otras rutas de búsqueda, ver más abajo)
y lo ejecuta. Usar lista-imágenes (ver a continuación) para enumerar las imágenes de contenedores disponibles para
comenzar.

Tenga en cuenta que systemd-machined.servicio(8) también interactúa con una variedad de otros
administradores de contenedores y máquinas virtuales, sistemad-nspawn es solo una implementación de la misma. La mayoría de
los comandos disponibles en máquinactl se puede utilizar en contenedores o máquinas virtuales controladas por
otros gerentes, no solo sistemad-nspawn. Iniciar máquinas virtuales e imágenes de contenedores en esos
los gerentes requieren herramientas específicas para los gerentes.

Para iniciar de forma interactiva un contenedor en la línea de comando con acceso completo al
consola del contenedor, invoca sistemad-nspawn directamente. Para detener una carrera
uso de contenedores máquinactl poweroff, vea abajo.

Inicie sesión [NOMBRE]
Abra una sesión de inicio de sesión de terminal interactivo en un contenedor o en el host local. Si una
se proporciona el argumento, se refiere a la máquina contenedora a la que conectarse. Si ninguno es
especificado, o el nombre del contenedor se especifica como la cadena vacía, o el especial
se especifica el nombre de la máquina ".host" (ver más abajo), la conexión se realiza al local
anfitrión en su lugar. Esto creará una conexión TTY a un contenedor específico o al local
host y solicita la ejecución de un getty en él. Tenga en cuenta que esto solo es compatible con
contenedores corriendo sistemad(1) como sistema de inicio.

Este comando abrirá un indicador de inicio de sesión completo en el contenedor o en el host local, que
luego solicita nombre de usuario y contraseña. Usar shell (ver más abajo) o systemd-ejecutar(1) con el
--machine = cambiar para invocar directamente un solo comando, ya sea de forma interactiva o en el
fondo.

shell [[NOMBRE@]NOMBRE [TRAYECTORIA [ARGUMENTOS...]]]
Abra una sesión de shell interactiva en un contenedor o en el host local. El primero
El argumento se refiere a la máquina contenedora a la que conectarse. Si no se especifica ninguno, o el
El nombre de la máquina se especifica como una cadena vacía o el nombre especial de la máquina ".host"
(ver más abajo), la conexión se realiza al host local en su lugar. Esto funciona
similar a Inicie sesión pero invoca inmediatamente un proceso de usuario. Este comando ejecuta el
ejecutable especificado con los argumentos especificados, o / Bin / sh si no se especifica ninguno. Por
predeterminado, abre un shell "raíz", pero usando --uid =, o prefijando el nombre de la máquina
con un nombre de usuario y un carácter "@", se puede seleccionar un usuario diferente. Usar --setenv =
para establecer variables de entorno para el proceso ejecutado.

Cuando se utiliza el shell comando sin argumentos, (invocando así el shell ejecutado o
comando en el host local), es en muchos aspectos similar a un su(1) sesión, pero, a diferencia de
su, aísla completamente la nueva sesión de la sesión de origen, de modo que
no comparte propiedades de proceso o sesión, y está en un estado limpio y bien definido. Eso
se rastreará en una nueva sesión de utmp, inicio de sesión, auditoría, seguridad y anillo de claves, y
No heredará ninguna variable de entorno ni límites de recursos, entre otras propiedades.

Tenga en cuenta que systemd-ejecutar(1) se puede utilizar en lugar del shell comando, y permite más
configuración detallada de bajo nivel de la unidad invocada. Sin embargo, con frecuencia es más
privilegiado que el shell mando.

habilitar NOMBRE... inhabilitar NOMBRE...
Habilite o deshabilite un contenedor como servicio del sistema para que se inicie en el inicio del sistema, utilizando
sistemad-nspawn(1). Esto habilita o deshabilita [email protected], instanciado para
el nombre de máquina especificado, similar al efecto de systemctl habilitar or systemctl
inhabilitar en el nombre del servicio.

poweroff NOMBRE...
Apague uno o más contenedores. Esto activará un reinicio enviando SIGRTMIN + 4 a
el proceso de inicio del contenedor, lo que hace que los sistemas de inicio compatibles con systemd se cierren
hacia abajo limpiamente. Esta operación no funciona en contenedores que no ejecutan un
sistemad(1) -sistema de inicio compatible, como sysvinit. Usar terminar (ver más abajo) para
terminar inmediatamente un contenedor o VM, sin cerrarlo limpiamente.

reiniciar NOMBRE...
Reinicie uno o más contenedores. Esto activará un reinicio enviando SIGINT al
proceso de inicio del contenedor, que es aproximadamente equivalente a presionar Ctrl + Alt + Supr en un
sistema no contenedorizado, y es compatible con contenedores que ejecutan cualquier sistema
gerente.

terminar NOMBRE...
Finaliza inmediatamente una máquina virtual o un contenedor, sin cerrarlo limpiamente
abajo. Esto mata todos los procesos de la máquina virtual o contenedor y desasigna todos
recursos adjuntos a esa instancia. Usar poweroff para emitir una solicitud de apagado limpia.

matar NOMBRE...
Envíe una señal a uno o más procesos de la máquina virtual o contenedor. Esto significa
procesos como los ve el host, no los procesos dentro de la máquina virtual o
envase. Usar --kill-who = para seleccionar qué proceso matar. Usar --señal = para seleccionar
la señal a enviar.

se unen NOMBRE TRAYECTORIA [TRAYECTORIA]
Bind monta un directorio del host en el contenedor especificado. El primero
El argumento de directorio es el directorio de origen en el host, el segundo argumento de directorio
es el directorio de destino en el contenedor. Cuando se omite este último, el
La ruta de destino en el contenedor es la misma que la ruta de origen en el host. Cuando
combinada con la --solo lectura switch, se crea un montaje de enlace listo solo. Cuando
combinada con la --mkdir Switch, la ruta de destino se crea primero antes de
se aplica el montaje. Tenga en cuenta que esta opción solo se admite actualmente para sistemad-
engendrar(1) contenedores.

copiar a NOMBRE TRAYECTORIA [TRAYECTORIA]
Copia archivos o directorios del sistema host en un contenedor en ejecución. Toma una
el nombre del contenedor, seguido de la ruta de origen en el host y la ruta de destino en
El contenedor. Si se omite la ruta de destino, lo mismo que la ruta de origen es
usado.

Copiado de NOMBRE TRAYECTORIA [TRAYECTORIA]
Copia archivos o directorios de un contenedor al sistema host. Toma un recipiente
nombre, seguido de la ruta de origen en el contenedor, la ruta de destino en el host.
Si se omite la ruta de destino, se usa la misma que la ruta de origen.

Imagen Comandos
lista-imágenes
Muestra una lista de imágenes de VM y contenedores instalados localmente. Esto enumera todos los discos sin procesar
imágenes y directorios de contenedores y subvolúmenes en / var / lib / machines / (y otros
rutas de búsqueda, ver más abajo). Usar comienzo (ver arriba) para ejecutar un contenedor de uno de los
imágenes enumeradas. Tenga en cuenta que, de forma predeterminada, los contenedores cuyo nombre comienza con un punto (".")
no se muestran. Para mostrar estos también, especifique --todas. Tenga en cuenta que una imagen especial ".host"
siempre existe implícitamente y se refiere a la imagen desde la que se inicia el host.

estado de la imagen [NOMBRE...]
Muestre información concisa sobre el estado de uno o más contenedores o imágenes de VM. Esta función
está destinado a generar resultados legibles por humanos. Usar mostrar imagen (ver más abajo) para generar
en su lugar, salida analizable por computadora.

mostrar imagen [NOMBRE...]
Mostrar las propiedades de una o más imágenes de contenedor o máquina virtual registradas, o
gerente en sí. Si no se especifica ningún argumento, se mostrarán las propiedades del administrador.
Si se especifica un NOMBRE, las propiedades de esta máquina virtual o imagen de contenedor son
mostrado. De forma predeterminada, las propiedades vacías están suprimidas. Usar --todas para mostrarlos también. Para
seleccione propiedades específicas para mostrar, use --property =. Este comando está destinado a ser
se utiliza siempre que se requiere una salida analizable por computadora. Usar estado de la imagen si usted es
buscando una salida con formato legible por humanos.

clonar NOMBRE NOMBRE
Clona un contenedor o una imagen de VM. Los argumentos especifican el nombre de la imagen a clonar.
y el nombre de la imagen recién clonada. Tenga en cuenta que las imágenes de contenedor de directorio simple son
clonado en imágenes de subvolumen con este comando. Tenga en cuenta que la clonación de un contenedor o VM
La imagen está optimizada para sistemas de archivos btrfs y es posible que no sea eficiente en otros, debido
a las limitaciones del sistema de archivos.

Tenga en cuenta que este comando deja el nombre de host, la ID de la máquina y todas las demás configuraciones que podrían
identificar la instancia sin modificar. Por tanto, la imagen original y la copia clonada
compartir estas credenciales, y puede ser necesario cambiarlas manualmente en el
dupdo.

rebautizar NOMBRE NOMBRE
Cambia el nombre de un contenedor o una imagen de máquina virtual. Los argumentos especifican el nombre de la imagen a renombrar
y el nuevo nombre de la imagen.

sólo lectura NOMBRE [BOOL]
Marca o (desmarca) un contenedor o una imagen de máquina virtual como de solo lectura. Toma una imagen de contenedor o VM
nombre, seguido de un booleano como argumentos. Si se omite el booleano, positivo es
implícito, es decir, la imagen está marcada como de solo lectura.

remove NOMBRE...
Elimina uno o más contenedores o imágenes de VM. La imagen especial ".host", que se refiere a
el árbol de directorios propio del host, no se puede eliminar.

establecer límite [NOMBRE] BYTES
Establece el tamaño máximo en bytes que un contenedor específico o una imagen de VM, o todas las imágenes,
puede crecer hasta en disco (cuota de disco). Toma uno o dos parámetros. El primero,
El parámetro opcional hace referencia a un contenedor o un nombre de imagen de máquina virtual. Si se especifica, el tamaño
se cambia el límite de la imagen especificada. Si se omite, el límite de tamaño total de la suma
de todas las imágenes almacenadas localmente se cambia. El argumento final especifica el límite de tamaño
en bytes, posiblemente con el sufijo de las unidades habituales K, M, G, T. Si el límite de tamaño debe ser
desactivado, especifique "-" como tamaño.

Tenga en cuenta que los límites de tamaño por contenedor solo se admiten en sistemas de archivos btrfs. También
tenga en cuenta que, si establecer límite se invoca sin un parámetro de imagen, y / var / lib / machines
está vacío, y el directorio no está ubicado en btrfs, un archivo de loopback btrfs es
creado implícitamente como /var/lib/machines.raw con el tamaño dado, y montado en
/ var / lib / machines. El tamaño del loopback se puede reajustar más tarde con establecer límite, ya que
bien. Si se utiliza dicho directorio / var / lib / machines montado en bucle invertido, establecer límite
sin un nombre de imagen altera tanto la configuración de la cuota dentro del sistema de archivos como
el archivo de bucle invertido y el tamaño del sistema de archivos.

Imagen Transferencia Comandos
tirar-alquitrán URL [NOMBRE]
Descarga una imagen de contenedor .tar desde la URL especificada y la pone a disposición en
el nombre de la máquina local especificado. La URL debe ser del tipo "http: //" o "https: //" y
debe hacer referencia a un archivo .tar, .tar.gz, .tar.xz o .tar.bz2. Si la máquina local
se omite el nombre, se deriva automáticamente del último componente de la URL, con
su sufijo eliminado.

La imagen se verifica antes de que esté disponible, a menos que --verify = no está especificado.
La verificación se realiza a través de los archivos SHA256SUMS y SHA256SUMS.gpg que deben realizarse
disponible en el mismo servidor web, bajo la misma URL que el archivo .tar, pero con la
último componente (el nombre de archivo) de la URL reemplazada. Con --verify = suma de comprobación, Solo el
Se verifica la suma de comprobación SHA256 para el archivo, según el archivo SHA256SUMS. Con
--verify = firma, el archivo SHA256SUMS se verifica primero con la firma GPG separada
archivo SHA256SUMS.gpg. La clave pública para este paso de verificación debe estar disponible
en /usr/lib/systemd/import-pubring.gpg o /etc/systemd/import-pubring.gpg.

La imagen del contenedor se descargará y almacenará en un subvolumen de solo lectura en
/ var / lib / machines / que lleva el nombre de la URL especificada y su HTTP etag. Un escribible
A continuación, se toma una instantánea de este subvolumen y se le asigna el nombre del nombre local especificado.
Este comportamiento asegura que la creación de múltiples instancias de contenedor de la misma URL sea
eficiente, ya que no son necesarias varias descargas. Para crear solo el
imagen de solo lectura, y evite crear su instantánea grabable, especifique "-" como local
nombre de la máquina.

Tenga en cuenta que el subvolumen de solo lectura tiene el prefijo .tar- y, por lo tanto, no se muestra con
lista-imágenes, a no ser que --todas esta pasado.

Tenga en cuenta que presionar Cc durante la ejecución de este comando no abortará la descarga.
Utilice cancelar-transferencia, descrito abajo.

tirar-crudo URL [NOMBRE]
Descarga un contenedor .raw o una imagen de disco de VM desde la URL especificada y lo hace
disponible bajo el nombre de máquina local especificado. La URL debe ser de tipo "http: //" o
"https: //". La imagen del contenedor debe ser .qcow2 o una imagen de disco sin formato, opcionalmente
comprimido como .gz, .xz o .bz2. Si se omite el nombre de la máquina local, es
derivado automáticamente del último componente de la URL, con su sufijo eliminado.

La verificación de imágenes es idéntica para imágenes sin formato y alquitrán (ver arriba).

Si la imagen descargada está en formato .qcow2, se convierte en un archivo de imagen sin procesar
antes de que esté disponible.

Las imágenes descargadas de este tipo se colocarán como archivo .raw de solo lectura en
/ var / lib / machines /. A continuación, se realiza una copia local grabable (reflinked) bajo el
nombre de máquina local especificado. Para omitir la creación de la copia local grabable, pase "-" como
nombre de la máquina local.

Similar al comportamiento de tirar-alquitrán, la imagen de solo lectura tiene el prefijo .raw-, y
por lo que no se muestra por lista-imágenes, a no ser que --todas esta pasado.

Tenga en cuenta que presionar Cc durante la ejecución de este comando no abortará la descarga.
Utilice cancelar-transferencia, descrito abajo.

alquitrán de importación ARCHIVO [NOMBRE], importación-crudo ARCHIVO [NOMBRE]
Importa un contenedor TAR o RAW o una imagen de VM y lo coloca con el nombre especificado en
/ var / lib / machines /. Cuando alquitrán de importación se utiliza, el archivo especificado como primer argumento
debe ser un archivo tar, posiblemente comprimido con xz, gzip o bzip2. Entonces sera
descomprimido en su propio subvolumen en / var / lib / machines. Cuando importación-crudo Se utiliza, el
El archivo debe ser un qcow2 o una imagen de disco sin formato, posiblemente comprimido con xz, gzip o bzip2.
Si no se especifica el segundo argumento (el nombre de la imagen resultante), es
derivado automáticamente del nombre del archivo. Si el nombre del archivo se pasa como "-", la imagen
se lee de la entrada estándar, en cuyo caso el segundo argumento es obligatorio.

Ambos tirar-alquitrán y tirar-crudo cambiará el tamaño de /var/lib/machines.raw y el sistema de archivos
allí según sea necesario. Opcionalmente, el --solo lectura El interruptor se puede utilizar para crear un
contenedor de solo lectura o imagen de máquina virtual. No se realiza ninguna validación criptográfica al importar
las imagenes.

Al igual que las descargas de imágenes, las importaciones en curso pueden aparecer con transferencias de lista y
abortado con cancelar-transferencia.

exportación-alquitrán NOMBRE [ARCHIVO], exportación-crudo NOMBRE [ARCHIVO]
Exporta un contenedor TAR o RAW o una imagen de VM y lo almacena en el archivo especificado. los
El primer parámetro debe ser una máquina virtual o un nombre de imagen de contenedor. El segundo parámetro debe ser
una ruta de archivo en la que se escribe la imagen TAR o RAW. Si la ruta termina en ".gz", el archivo es
comprimido con gzip, si termina en ".xz", con xz, y si termina en ".bz2", con
bzip2. Si la ruta no termina en ninguno, el archivo se deja sin comprimir. Si el segundo
Falta el argumento, la imagen se escribe en la salida estándar. La compresión también puede
ser seleccionado explícitamente con el --format = cambiar. Esto es especialmente útil si el
el segundo parámetro se deja sin especificar.

Al igual que las descargas e importaciones de imágenes, las exportaciones en curso se pueden enumerar con
transferencias de lista y abortado con cancelar-transferencia.

Tenga en cuenta que, actualmente, solo las imágenes de directorios y subvolúmenes se pueden exportar como TAR
imágenes, y solo imágenes de disco sin procesar como imágenes RAW.

transferencias de lista
Muestra una lista de descargas, importaciones y exportaciones de imágenes de contenedores o máquinas virtuales
actualmente en marcha.

cancelar-transferencias ID...
Anula una descarga, importación o exportación del contenedor o la imagen de VM con el
IDENTIFICACIÓN. Para enumerar las transferencias en curso y sus ID, utilice transferencias de lista.

MÁQUINA Y IMAGEN NOMBRES

La máquinactl La herramienta opera en máquinas e imágenes cuyos nombres deben elegirse siguiendo
reglas estrictas. Los nombres de máquinas deben ser adecuados para su uso como nombres de host siguiendo un
subconjunto conservador de la semántica de DNS y UNIX / Linux. En concreto, deben constar de
una o más cadenas de etiquetas no vacías, separadas por puntos. No hay puntos iniciales o finales
permitido. No se permiten secuencias de varios puntos. Las cadenas de etiquetas solo pueden constar de
caracteres alfanuméricos, así como el guión y el subrayado. La longitud máxima de un
El nombre de la máquina tiene 64 caracteres.

Una máquina especial con el nombre ".host" se refiere al propio sistema host en ejecución. Este es
útil para ejecutar operaciones o inspeccionar el sistema host. Tenga en cuenta que
máquinactl lista no mostrará esta máquina especial a menos que el --todas se especifica el interruptor.

Los requisitos sobre los nombres de las imágenes son menos estrictos, sin embargo, deben ser UTF-8 válido, deben ser
adecuado como nombre de archivo (por lo tanto, no debe ser el punto simple o doble, y no incluir una barra),
y no puede contener caracteres de control. Dado que muchas operaciones buscan una imagen por
nombre de una máquina solicitada, se recomienda nombrar las imágenes de la misma manera estricta
como máquinas.

Una imagen especial con el nombre ".host" se refiere a la imagen del sistema host en ejecución. Eso
por lo tanto, se asigna conceptualmente al nombre de máquina especial ".host" descrito anteriormente. Tenga en cuenta que
máquinactl lista-imágenes tampoco mostrará esta imagen especial, a menos que --todas está especificado.

ARCHIVOS Y DIRECTORIOS

Las imágenes de la máquina se almacenan preferiblemente en / var / lib / machines /, pero también se buscan en
/ usr / local / lib / machines / y / usr / lib / machines /. Por razones de compatibilidad, el directorio
/ var / lib / container / también se busca. Tenga en cuenta que las imágenes almacenadas a continuación / usr son siempre
considerado de solo lectura. Es posible enlazar simbólicamente imágenes de máquinas de otros directorios
en / var / lib / machines / para que estén disponibles para su control con máquinactl.

Tenga en cuenta que muchas operaciones de imágenes solo son compatibles, eficientes o atómicas en archivos btrfs
sistemas. Debido a esto, si el tirar-alquitrán, tirar-crudo, alquitrán de importación, importación-crudo y establecer límite
Los comandos notan que / var / lib / machines está vacío y no se encuentra en btrfs,
configurar implícitamente un archivo loopback /var/lib/machines.raw que contiene un sistema de archivos btrfs
que está montado en / var / lib / machines. El tamaño de este archivo de bucle invertido puede controlarse
dinámicamente con establecer límite.

Las imágenes de disco se entienden por sistemad-nspawn(1) y máquinactl en tres formatos:

· Un árbol de directorios simple, que contiene los archivos y directorios del contenedor para
bota.

· Subvolúmenes (en sistemas de archivos btrfs), que son similares a los directorios simples,
descrito arriba. Sin embargo, tienen beneficios adicionales, como la clonación eficiente y
informes de cuotas.

· Imágenes de disco "sin procesar", es decir, imágenes binarias de discos con una tabla de particiones GPT o MBR.
Las imágenes de este tipo son archivos normales con el sufijo ".raw".

See sistemad-nspawn(1) para obtener más información sobre los formatos de imagen, en particular su
--directory = y --image = .

EJEMPLOS

Ejemplo 1. Descargar an Ubuntu imagen y abierto a shell in it

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

Esto descarga y verifica la imagen .tar especificada y luego usa sistemad-nspawn(1) a
abre un caparazón en él.

Ejemplo 2. Descargar a Fedora imagen, . a raíz la contraseña in eso, comienzo it as TRANSPORTE GRATUITO

# 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
#contraseña
# Salida
# machinectl iniciar Fedora-Cloud-Base-20141203-21
# machinectl iniciar sesión Fedora-Cloud-Base-20141203-21

Esto descarga la imagen .raw especificada con la verificación deshabilitada. Entonces, un caparazón es
se abre en él y se establece una contraseña de root. Luego se deja la cáscara y la máquina
comenzó como servicio del sistema. Con el último comando, se muestra un indicador de inicio de sesión en el contenedor.
solicitada.

Ejemplo 3. Exportaciones a envase imagen as alquitrán presentar

# machinectl export-tar fedora myfedora.tar.xz

Exporta el contenedor "fedora" como un archivo tar comprimido xz myfedora.tar.xz al
directorio actual.

Ejemplo 4. Crear a new shell Sesión

# machinectl shell --uid = lennart

Esto crea una nueva sesión de shell en el host local para el ID de usuario "lennart", en un
su(1) -como la moda.

SALIR ESTADO

En caso de éxito, se devuelve 0, de lo contrario un código de falla distinto de cero.

MEDIO AMBIENTE

$ SYSTEMD_PAGER
Buscapersonas para usar cuando --sin buscapersonas no se da; anula $ PAGER. Poniendo esto en un vacío
cadena o el valor "gato" es equivalente a pasar --sin buscapersonas.

$ SYSTEMD_LESS
Anular las opciones predeterminadas pasadas a less ("FRSXMK").

Utilice machinectl en línea utilizando los servicios de onworks.net