machinectl - Dalam talian di Awan

JADUAL:

NAMA

machinectl - Kawal pengurus mesin systemd

SINOPSIS

machinectl [PILIHAN...] {PERINTAH} [NAMA...]

DESCRIPTION

machinectl boleh digunakan untuk introspeksi dan mengawal keadaan sistem(1) maya
pengurus pendaftaran mesin dan kontena systemd-machined.service(8).

machinectl boleh digunakan untuk melaksanakan operasi pada mesin dan imej. Mesin dalam ini
sense dianggap sebagai contoh berjalan:

· Mesin Maya (VM) yang memayakan perkakasan untuk menjalankan sistem pengendalian penuh (OS)
contoh (termasuk kernel mereka) dalam persekitaran maya di atas hos
OS.

· Bekas yang berkongsi perkakasan dan kernel OS dengan OS hos, untuk menjalankan OS
contoh ruang pengguna di atas OS hos.

· Sistem hos itu sendiri

Mesin dikenal pasti dengan nama yang mengikut peraturan yang sama seperti nama hos UNIX dan DNS,
untuk butiran, lihat di bawah. Mesin dibuat seketika daripada imej cakera atau sistem fail yang
kerap — tetapi tidak semestinya — membawa nama yang sama seperti mesin yang dijalankan daripadanya.
Imej dalam pengertian ini dianggap:

· Pepohon direktori yang mengandungi OS, termasuk direktori peringkat atasnya / usr, / Etc, dan
sebagainya.

· btrfs subvolum yang mengandungi pepohon OS, serupa dengan pepohon direktori biasa.

· Imej cakera "mentah" binari yang mengandungi jadual partition MBR atau GPT dan sistem fail Linux
sekatan.

· Pepohon sistem fail OS hos itu sendiri.

PILIHAN

Pilihan berikut difahami:

-p, --harta =
Apabila menunjukkan sifat mesin atau imej, hadkan output kepada sifat tertentu sebagai
ditentukan oleh hujah. Jika tidak dinyatakan, semua sifat set ditunjukkan. The
hujah hendaklah nama harta, seperti "Nama". Jika dinyatakan lebih daripada sekali, semua
sifat dengan nama yang ditentukan ditunjukkan.

-a, --semua
Apabila menunjukkan sifat mesin atau imej, tunjukkan semua sifat tidak kira sama ada
mereka ditetapkan atau tidak.

Apabila menyenaraikan imej VM atau bekas, jangan sekat imej bermula dengan titik
watak (".").

-l, --penuh
Jangan elips entri pokok proses.

--tiada-tanya-kata laluan
Jangan tanya pengguna untuk pengesahan untuk operasi istimewa.

--bunuh-siapa=
Apabila digunakan dengan membunuh, pilih proses yang hendak dibunuh. Mesti salah satu pemimpin, Atau semua kepada
pilih sama ada untuk membunuh hanya proses peneraju mesin atau semua proses
mesin. Jika ditinggalkan, lalai kepada semua.

-s, --isyarat=
Apabila digunakan dengan membunuh, pilih isyarat yang hendak dihantar ke proses terpilih. Mesti salah satu
penentu isyarat yang terkenal, seperti TANDATANGAN, SIGINT or TANDATANGAN. Jika ditinggalkan,
lalai kepada TANDATANGAN.

--uid=
Apabila digunakan dengan shell arahan, memilih ID pengguna untuk membuka cangkerang interaktif
sesi sebagai. Jika suis ini tidak dinyatakan, lalai kepada "root". Ambil perhatian bahawa suis ini
tidak disokong untuk log masuk arahan (lihat di bawah).

--setenv=
Apabila digunakan dengan shell arahan, menetapkan pembolehubah persekitaran untuk dihantar kepada yang dilaksanakan
cangkerang. Mengambil sepasang nama dan nilai pembolehubah persekitaran, dipisahkan dengan "=" as
hujah. Suis ini boleh digunakan beberapa kali untuk menetapkan berbilang persekitaran
pembolehubah. Ambil perhatian bahawa suis ini tidak disokong untuk log masuk arahan (lihat di bawah).

--mkdir
Apabila digunakan dengan mengikat, mencipta direktori destinasi sebelum menggunakan pelekap bind.

--baca sahaja
Apabila digunakan dengan mengikat, menggunakan pelekap bind baca sahaja.

-n, --garisan=
Apabila digunakan dengan terkini, mengawal bilangan baris jurnal untuk ditunjukkan, mengira dari
yang terbaru. Mengambil hujah integer positif. Lalai kepada 10.

-o, --output=
Apabila digunakan dengan terkini, mengawal pemformatan entri jurnal yang ditunjukkan.
Untuk pilihan yang tersedia, lihat jurnalctl(1). Lalai kepada "pendek".

--sahkan=
Apabila memuat turun bekas atau imej VM, nyatakan sama ada imej itu akan disahkan
sebelum ia tersedia. Mengambil salah satu daripada "tidak", "checksum" dan "tandatangan". Jika tidak",
tiada pengesahan dilakukan. Jika "checksum" ditentukan, muat turun akan diperiksa
integriti selepas pemindahan selesai, tetapi tiada tandatangan disahkan. Jika
"tandatangan" ditentukan, jumlah semak disahkan dan tandatangan imej adalah
disemak terhadap cincin kunci tempatan vendor yang boleh dipercayai. Ia amat disyorkan untuk
tetapkan pilihan ini kepada "tandatangan" jika pelayan dan protokol menyokongnya. Lalai kepada
"tandatangan".

- kekuatan
Apabila memuat turun bekas atau imej VM dan salinan tempatan oleh tempatan yang ditentukan
nama mesin sudah wujud, padamkannya dahulu dan gantikannya dengan yang baru dimuat turun
gambar.

--format=
Apabila digunakan dengan eksport-tar or eksport-mentah arahan, menentukan format mampatan
untuk digunakan untuk fail yang terhasil. Mengambil salah satu daripada "tidak dimampatkan", "xz", "gzip", "bzip2". Oleh
lalai, format ditentukan secara automatik daripada nama fail imej yang diluluskan.

-H, --tuan rumah=
Jalankan operasi dari jauh. Tentukan nama hos, atau nama pengguna dan nama hos
dipisahkan dengan "@", untuk disambungkan. Nama hos secara pilihan boleh diakhiri dengan a
nama bekas, dipisahkan dengan ":", yang bersambung terus ke bekas tertentu pada
hos yang ditentukan. Ini akan menggunakan SSH untuk bercakap dengan contoh pengurus mesin jauh.
Nama bekas boleh disenaraikan dengan machinectl -H HOST.

-M, --mesin=
Jalankan operasi pada bekas tempatan. Tentukan nama bekas untuk disambungkan.

--tiada-halaman muka surat
Jangan paipkan output ke dalam pager.

--tiada-legenda
Jangan cetak legenda, iaitu pengepala lajur dan pengaki dengan petunjuk.

-h, - membantu
Cetak teks bantuan pendek dan keluar.

--versi
Cetak rentetan dan keluar versi pendek.

PERINTAH

Perintah berikut difahami:

mesin arahan
senarai
Senaraikan mesin dan bekas maya (dalam talian) yang sedang berjalan. Untuk menghitung mesin
imej yang boleh dimulakan, gunakan senarai-imej (lihat di bawah). Ambil perhatian bahawa arahan ini bersembunyi
mesin ".host" khas secara lalai. Menggunakan --semua beralih untuk menunjukkannya.

terkini NAMA...
Tunjukkan maklumat status masa jalan tentang satu atau lebih mesin dan bekas maya,
diikuti dengan data log terkini daripada jurnal. Fungsi ini bertujuan untuk
menjana output yang boleh dibaca manusia. Jika anda sedang mencari output yang boleh dihuraikan komputer, gunakan
Menunjukkan sebaliknya. Ambil perhatian bahawa data log yang ditunjukkan dilaporkan oleh mesin maya atau
pengurus kontena, dan selalunya mengandungi output konsol mesin, tetapi tidak
semestinya kandungan jurnal mesin itu sendiri.

Menunjukkan [NAMA...]
Tunjukkan sifat satu atau lebih mesin maya atau bekas berdaftar atau
pengurus itu sendiri. Jika tiada hujah dinyatakan, sifat pengurus akan ditunjukkan.
Jika NAME ditentukan, sifat mesin atau bekas maya ini ditunjukkan. Oleh
lalai, sifat kosong ditindas. guna --semua untuk menunjukkan mereka juga. Untuk memilih
sifat khusus untuk ditunjukkan, digunakan --harta =. Perintah ini bertujuan untuk digunakan
bila-bila masa output boleh pars komputer diperlukan, dan tidak mencetak pokok cgroup atau
catatan jurnal. guna terkini jika anda sedang mencari output yang boleh dibaca manusia yang diformatkan.

permulaan NAMA...
Mulakan bekas sebagai perkhidmatan sistem, menggunakan systemd-nspawn(1). Ini bermula
[e-mel dilindungi], digunakan untuk nama mesin yang ditentukan, serupa dengan
kesan daripada systemctl permulaan pada nama perkhidmatan. systemd-nspawn mencari bekas
imej dengan nama yang ditentukan dalam /var/lib/machines/ (dan laluan carian lain, lihat di bawah)
dan menjalankannya. guna senarai-imej (lihat di bawah) untuk menyenaraikan imej bekas yang tersedia kepada
mulakan.

Perhatikan bahawa systemd-machined.service(8) juga antara muka dengan pelbagai yang lain
pengurus kontena dan VM, systemd-nspawn hanyalah satu pelaksanaannya. Kebanyakan daripada
arahan yang terdapat dalam machinectl boleh digunakan pada bekas atau VM yang dikawal oleh
pengurus lain, bukan sahaja systemd-nspawn. Memulakan VM dan imej bekas pada mereka
pengurus memerlukan alat khusus pengurus.

Untuk memulakan kontena secara interaktif pada baris arahan dengan akses penuh ke
konsol kontena, sila gunakan systemd-nspawn secara langsung. Untuk menghentikan larian
penggunaan bekas machinectl matikan, lihat di bawah.

log masuk [NAMA]
Buka sesi log masuk terminal interaktif dalam bekas atau pada hos tempatan. Jika an
hujah dibekalkan, ia merujuk kepada mesin kontena untuk disambungkan. Jika tiada
ditentukan, atau nama bekas ditentukan sebagai rentetan kosong, atau istimewa
nama mesin ".host" (lihat di bawah) ditentukan, sambungan dibuat kepada tempatan
tuan rumah sebaliknya. Ini akan mewujudkan sambungan TTY ke bekas tertentu atau setempat
hos dan meminta pelaksanaan getty ke atasnya. Ambil perhatian bahawa ini hanya disokong untuk
bekas berjalan sistem(1) sebagai sistem init.

Perintah ini akan membuka gesaan log masuk penuh pada bekas atau hos tempatan, yang
kemudian meminta nama pengguna dan kata laluan. guna shell (lihat di bawah) atau systemd-run(1) dengan
--mesin= beralih untuk menggunakan terus satu arahan, sama ada secara interaktif atau dalam
latar belakang.

shell [[NAMA@]NAMA [PATH [HUJAH...]]]
Buka sesi shell interaktif dalam bekas atau pada hos tempatan. Yang pertama
hujah merujuk kepada mesin kontena untuk disambungkan. Jika tiada yang dinyatakan, atau
nama mesin ditentukan sebagai rentetan kosong, atau nama mesin khas ".host"
(lihat di bawah) ditentukan, sebaliknya sambungan dibuat kepada hos tempatan. Ini berfungsi
sama dengan log masuk tetapi segera memanggil proses pengguna. Perintah ini menjalankan
boleh laku yang ditentukan dengan argumen yang ditentukan, atau / Bin / sh jika tiada yang dinyatakan. Oleh
lalai, membuka cangkerang "root", tetapi dengan menggunakan --uid=, atau dengan memberi awalan pada nama mesin
dengan nama pengguna dan aksara "@", pengguna lain boleh dipilih. guna --setenv=
untuk menetapkan pembolehubah persekitaran untuk proses yang dilaksanakan.

Apabila menggunakan shell perintah tanpa hujah, (dengan itu menggunakan shell yang dilaksanakan atau
arahan pada hos tempatan), ia dalam banyak cara serupa dengan a su(1) sesi, tetapi, tidak seperti
su, mengasingkan sepenuhnya sesi baharu daripada sesi asal, supaya ia
tidak berkongsi sifat proses atau sesi, dan berada dalam keadaan bersih dan jelas. Ia
akan dijejaki dalam sesi utmp, log masuk, audit, keselamatan dan keyring baharu serta akan
tidak mewarisi sebarang pembolehubah persekitaran atau had sumber, antara sifat lain.

Perhatikan bahawa systemd-run(1) boleh digunakan sebagai ganti shell perintah, dan membolehkan lebih banyak lagi
konfigurasi peringkat rendah terperinci bagi unit yang digunakan. Walau bagaimanapun, ia lebih kerap
keistimewaan daripada shell perintah.

membolehkan NAMA... melumpuhkan NAMA...
Dayakan atau lumpuhkan bekas sebagai perkhidmatan sistem untuk bermula pada but sistem, menggunakan
systemd-nspawn(1). Ini membolehkan atau melumpuhkan [e-mel dilindungi], dibuat seketika untuk
nama mesin yang ditentukan, serupa dengan kesan daripada systemctl membolehkan or systemctl
melumpuhkan pada nama perkhidmatan.

matikan NAMA...
Matikan satu atau lebih bekas. Ini akan mencetuskan but semula dengan menghantar SIGRTMIN+4 kepada
proses init bekas, yang menyebabkan sistem init yang serasi dengan systemd ditutup
turun dengan bersih. Operasi ini tidak berfungsi pada bekas yang tidak berjalan a
sistem(1)-sistem init yang serasi, seperti sysvinit. guna menamatkan (lihat di bawah) kepada
segera menamatkan bekas atau VM, tanpa menutupnya dengan bersih.

reboot NAMA...
But semula satu atau lebih bekas. Ini akan mencetuskan but semula dengan menghantar SIGINT ke
proses init bekas, yang hampir sama dengan menekan Ctrl+Alt+Del pada
sistem bukan kontena, dan serasi dengan bekas yang menjalankan sebarang sistem
Pengurus.

menamatkan NAMA...
Menamatkan mesin atau bekas maya dengan serta-merta, tanpa menutupnya dengan bersih
turun. Ini membunuh semua proses mesin maya atau bekas dan mendelokasi semua
sumber yang dilampirkan pada contoh itu. guna matikan untuk mengeluarkan permintaan penutupan bersih.

membunuh NAMA...
Hantar isyarat kepada satu atau lebih proses mesin atau bekas maya. Ini bermaksud
proses seperti yang dilihat oleh hos, bukan proses di dalam mesin maya atau
bekas. guna --bunuh-siapa= untuk memilih proses yang hendak dibunuh. guna --isyarat= untuk memilih
isyarat untuk dihantar.

mengikat NAMA PATH [PATH]
Bind melekapkan direktori daripada hos ke dalam bekas yang ditentukan. Yang pertama
argumen direktori ialah direktori sumber pada hos, argumen direktori kedua
ialah direktori destinasi dalam bekas. Apabila yang terakhir ditinggalkan, yang
laluan destinasi dalam bekas adalah sama dengan laluan sumber pada hos. Bila
digabungkan dengan --baca sahaja suis, pelekap ikatan sedia sahaja dibuat. Bila
digabungkan dengan --mkdir suis, laluan destinasi dibuat terlebih dahulu sebelum
mount digunakan. Ambil perhatian bahawa pada masa ini pilihan ini hanya disokong untuk systemd-
nspawn(1) bekas.

Salin ke NAMA PATH [PATH]
Menyalin fail atau direktori daripada sistem hos ke dalam bekas yang sedang berjalan. Mengambil a
nama kontena, diikuti dengan laluan sumber pada hos dan laluan destinasi masuk
bekas itu. Jika laluan destinasi ditinggalkan, sama seperti laluan sumber
terpakai.

salinan-daripada NAMA PATH [PATH]
Menyalin fail atau direktori daripada bekas ke dalam sistem hos. Mengambil bekas
nama, diikuti dengan laluan sumber dalam bekas laluan destinasi pada hos.
Jika laluan destinasi ditinggalkan, sama seperti laluan sumber digunakan.

Image arahan
senarai-imej
Tunjukkan senarai bekas yang dipasang secara setempat dan imej VM. Ini menyenaraikan semua cakera mentah
imej dan direktori kontena dan subvolum dalam /var/lib/machines/ (dan lain-lain
laluan carian, lihat di bawah). guna permulaan (lihat di atas) untuk menjalankan bekas dari salah satu
imej tersenarai. Ambil perhatian bahawa, secara lalai, bekas yang namanya bermula dengan titik (".")
tidak ditunjukkan. Untuk menunjukkan ini juga, nyatakan --semua. Ambil perhatian bahawa imej khas ".host"
sentiasa wujud secara tersirat dan merujuk kepada imej yang dibut oleh hos itu sendiri.

status imej [NAMA...]
Tunjukkan maklumat status ringkas tentang satu atau lebih bekas atau imej VM. Fungsi ini
bertujuan untuk menjana output yang boleh dibaca manusia. guna tunjuk-gambar (lihat di bawah) untuk menjana
output yang boleh dihuraikan komputer sebaliknya.

tunjuk-gambar [NAMA...]
Tunjukkan sifat satu atau lebih mesin maya atau imej bekas berdaftar, atau
pengurus itu sendiri. Jika tiada hujah dinyatakan, sifat pengurus akan ditunjukkan.
Jika NAMA ditentukan, sifat mesin maya atau imej bekas ini adalah
ditunjukkan. Secara lalai, sifat kosong ditindas. guna --semua untuk menunjukkan mereka juga. Kepada
pilih sifat khusus untuk ditunjukkan, digunakan --harta =. Perintah ini bertujuan untuk menjadi
digunakan apabila output boleh dihuraikan komputer diperlukan. guna status imej jika anda adalah
mencari output yang boleh dibaca manusia berformat.

mengklon NAMA NAMA
Mengklonkan bekas atau imej VM. Argumen menentukan nama imej untuk diklon
dan nama imej yang baru diklon. Ambil perhatian bahawa imej bekas direktori biasa adalah
diklonkan ke dalam imej subvolum dengan arahan ini. Ambil perhatian bahawa pengklonan bekas atau VM
imej dioptimumkan untuk sistem fail btrfs, dan mungkin tidak cekap pada yang lain, disebabkan
kepada had sistem fail.

Ambil perhatian bahawa arahan ini meninggalkan nama hos, ID mesin dan semua tetapan lain yang boleh
mengenal pasti contoh yang tidak diubah suai. Oleh itu, imej asal dan salinan klon
berkongsi kelayakan ini, dan mungkin perlu menukarnya secara manual dalam
salinan.

menamakan semula NAMA NAMA
Menamakan semula bekas atau imej VM. Argumen menentukan nama imej untuk dinamakan semula
dan nama baharu imej tersebut.

baca sahaja NAMA [BOOL]
Tandai atau (nyahtanda) bekas atau imej VM baca sahaja. Mengambil imej VM atau bekas
nama, diikuti dengan boolean sebagai hujah. Jika boolean diabaikan, positif ialah
tersirat, iaitu imej ditanda baca sahaja.

mengeluarkan NAMA...
Mengalih keluar satu atau lebih bekas atau imej VM. Imej khas ".host", yang merujuk kepada
pokok direktori hos sendiri, mungkin tidak dialih keluar.

set-had [NAMA] BYTES
Menetapkan saiz maksimum dalam bait bahawa bekas tertentu atau imej VM, atau semua imej,
boleh membesar pada cakera (kuota cakera). Mengambil sama ada satu atau dua parameter. Yang pertama,
parameter pilihan merujuk kepada bekas atau nama imej VM. Jika dinyatakan, saiznya
had imej yang ditentukan diubah. Jika ditinggalkan, had saiz keseluruhan jumlah
daripada semua imej yang disimpan secara setempat diubah. Argumen akhir menentukan had saiz
dalam bait, mungkin diakhiri dengan unit K, M, G, T biasa. Jika had saiz hendaklah
dilumpuhkan, nyatakan "-" sebagai saiz.

Ambil perhatian bahawa had saiz setiap bekas hanya disokong pada sistem fail btrfs. Juga
ambil perhatian bahawa, jika set-had digunakan tanpa parameter imej dan /var/lib/machines
kosong, dan direktori tidak terletak pada btrfs, fail gelung balik btrfs adalah
dibuat secara tersirat sebagai /var/lib/machines.raw dengan saiz yang diberikan, dan dipasang pada
/var/lib/machines. Saiz gelung balik kemudian boleh dilaraskan semula dengan set-had, Seperti
baiklah. Jika direktori /var/lib/machines yang dipasang gelung balik sedemikian digunakan, set-had
tanpa nama imej mengubah kedua-dua tetapan kuota dalam sistem fail serta
fail loopback dan saiz sistem fail itu sendiri.

Image Pemindahan arahan
tarik-tar URL [NAMA]
Memuat turun imej bekas .tar daripada URL yang ditentukan dan menjadikannya tersedia di bawah
nama mesin tempatan yang ditentukan. URL mestilah daripada jenis "http://" atau "https://", dan
mesti merujuk kepada fail arkib .tar, .tar.gz, .tar.xz atau .tar.bz2. Jika mesin tempatan
nama ditinggalkan, ia secara automatik diperoleh daripada komponen terakhir URL, dengan
akhirannya dibuang.

Imej itu disahkan sebelum ia tersedia, melainkan --sahkan=tidak dinyatakan.
Pengesahan dilakukan melalui fail SHA256SUMS dan SHA256SUMS.gpg yang perlu dibuat
tersedia pada pelayan web yang sama, di bawah URL yang sama dengan fail .tar, tetapi dengan
komponen terakhir (nama fail) URL diganti. Dengan --verify=checksum, hanya
Jumlah semak SHA256 untuk fail disahkan, berdasarkan fail SHA256SUMS. Dengan
--verify=tandatangan, fail SHA256SUMS mula-mula disahkan dengan tandatangan GPG yang dipisahkan
fail SHA256SUMS.gpg. Kunci awam untuk langkah pengesahan ini perlu tersedia
dalam /usr/lib/systemd/import-pubring.gpg atau /etc/systemd/import-pubring.gpg.

Imej bekas akan dimuat turun dan disimpan dalam subjilid baca sahaja dalam
/var/lib/machines/ yang dinamakan sempena URL yang ditentukan dan etag HTTPnya. Boleh ditulis
syot kilat kemudian diambil daripada subjilid ini, dan dinamakan sempena nama tempatan yang ditentukan.
Tingkah laku ini memastikan bahawa membuat berbilang contoh kontena bagi URL yang sama adalah
cekap, kerana berbilang muat turun tidak diperlukan. Untuk mencipta hanya
imej baca sahaja, dan elakkan mencipta syot kilatnya yang boleh ditulis, nyatakan "-" sebagai setempat
nama mesin.

Ambil perhatian bahawa subvolum baca sahaja diawali dengan .tar-, dan oleh itu tidak ditunjukkan oleh
senarai-imej, melainkan --semua dilalui.

Ambil perhatian bahawa menekan Cc semasa melaksanakan arahan ini tidak akan membatalkan muat turun.
Penggunaan batal-pemindahan, terangkan di bawah.

tarik-mentah URL [NAMA]
Memuat turun bekas .raw atau imej cakera VM daripada URL yang ditentukan dan menjadikannya
tersedia di bawah nama mesin tempatan yang ditentukan. URL mestilah daripada jenis "http://" atau
"https://". Imej bekas mestilah sama ada imej cakera .qcow2 atau mentah, secara pilihan
dimampatkan sebagai .gz, .xz atau .bz2. Jika nama mesin tempatan ditinggalkan, ia adalah
diperoleh secara automatik daripada komponen terakhir URL, dengan akhirannya dialih keluar.

Pengesahan imej adalah sama untuk imej mentah dan tar (lihat di atas).

Jika imej yang dimuat turun dalam format .qcow2 ia ditukar kepada fail imej mentah
sebelum ia tersedia.

Imej yang dimuat turun jenis ini akan diletakkan sebagai fail .raw baca sahaja dalam
/var/lib/machines/. Salinan tempatan yang boleh ditulis (dipaut semula) kemudiannya dibuat di bawah
nama mesin tempatan yang ditentukan. Untuk meninggalkan penciptaan salinan tempatan yang boleh ditulis pas "-" sebagai
nama mesin tempatan.

Serupa dengan tingkah laku tarik-tar, imej baca sahaja diawali dengan .raw-, dan
dengan itu tidak ditunjukkan oleh senarai-imej, melainkan --semua dilalui.

Ambil perhatian bahawa menekan Cc semasa melaksanakan arahan ini tidak akan membatalkan muat turun.
Penggunaan batal-pemindahan, terangkan di bawah.

import-tar FAIL [NAMA], import-mentah FAIL [NAMA]
Mengimport bekas TAR atau RAW atau imej VM dan meletakkannya di bawah nama yang ditentukan dalam
/var/lib/machines/. Bila import-tar digunakan, fail dinyatakan sebagai hujah pertama
mestilah arkib tar, mungkin dimampatkan dengan xz, gzip atau bzip2. Ia kemudiannya
dibongkar ke dalam subvolumnya sendiri dalam /var/lib/machines. Bila import-mentah digunakan, yang
fail mestilah qcow2 atau imej cakera mentah, mungkin dimampatkan dengan xz, gzip atau bzip2.
Jika hujah kedua (nama imej yang terhasil) tidak dinyatakan, ia adalah
secara automatik diperolehi daripada nama fail. Jika nama fail diluluskan sebagai "-", imej
dibaca daripada input standard, dalam hal ini hujah kedua adalah wajib.

Kedua-dua tarik-tar and tarik-mentah akan mengubah saiz /var/lib/machines.raw dan sistem fail
di dalamnya jika perlu. Secara pilihan, --baca sahaja suis boleh digunakan untuk mencipta a
bekas baca sahaja atau imej VM. Tiada pengesahan kriptografi dilakukan semasa mengimport
imej.

Sama seperti muat turun imej, import berterusan mungkin disenaraikan dengan pemindahan senarai and
digugurkan dengan batal-pemindahan.

eksport-tar NAMA [FAIL], eksport-mentah NAMA [FAIL]
Mengeksport bekas TAR atau RAW atau imej VM dan menyimpannya dalam fail yang ditentukan. The
parameter pertama mestilah nama imej VM atau bekas. Parameter kedua sepatutnya
laluan fail yang digunakan untuk menulis imej TAR atau RAW. Jika laluan berakhir dengan ".gz", fail itu ialah
dimampatkan dengan gzip, jika ia berakhir dengan ".xz", dengan xz, dan jika ia berakhir dengan ".bz2", dengan
bzip2. Jika laluan berakhir dengan kedua-duanya, fail dibiarkan tidak dimampatkan. Jika yang kedua
hujah tiada, imej ditulis pada output standard. Pemampatan juga boleh
dipilih secara eksplisit dengan --format= suis. Ini amat berguna jika
parameter kedua dibiarkan tidak ditentukan.

Sama seperti muat turun dan import imej, eksport berterusan mungkin disenaraikan dengan
pemindahan senarai dan digugurkan dengan batal-pemindahan.

Ambil perhatian bahawa, pada masa ini, hanya imej direktori dan subvolum boleh dieksport sebagai TAR
imej, dan hanya imej cakera mentah sebagai imej RAW.

pemindahan senarai
Menunjukkan senarai muat turun, import dan eksport imej kontena atau VM
sedang berjalan.

pembatalan-pemindahan ID...
Menghentikan muat turun, import atau eksport bekas atau imej VM dengan yang ditentukan
ID. Untuk menyenaraikan pemindahan yang sedang berjalan dan ID mereka, gunakan pemindahan senarai.

MESIN DAN GAMBAR NAMA

. machinectl alat beroperasi pada mesin dan imej yang namanya mesti dipilih berikut
peraturan yang ketat. Nama mesin mestilah sesuai untuk digunakan sebagai nama hos berikutan a
subset konservatif DNS dan semantik UNIX/Linux. Khususnya, mereka mesti terdiri daripada
satu atau lebih rentetan label bukan kosong, dipisahkan dengan titik. Tiada titik di hadapan atau di belakang
dibenarkan. Tiada urutan berbilang titik dibenarkan. Rentetan label hanya boleh terdiri daripada
aksara abjad angka serta sempang dan garis bawah. Panjang maksimum a
nama mesin ialah 64 aksara.

Mesin khas dengan nama ".host" merujuk kepada sistem hos yang sedang berjalan itu sendiri. Ini adalah
berguna untuk operasi pelaksanaan atau memeriksa sistem hos juga. Perhatikan bahawa
machinectl senarai tidak akan menunjukkan mesin khas ini melainkan jika --semua suis ditentukan.

Keperluan pada nama imej adalah kurang ketat, namun, ia mestilah sah UTF-8, mestilah
sesuai sebagai nama fail (oleh itu bukan satu atau dua titik, dan tidak termasuk garis miring),
dan mungkin tidak mengandungi aksara kawalan. Oleh kerana banyak operasi mencari imej oleh
nama mesin yang diminta, adalah disyorkan untuk menamakan imej dengan cara yang sama
sebagai mesin.

Imej khas dengan nama ".host" merujuk kepada imej sistem hos yang sedang berjalan. Ia
maka secara konsepnya memetakan kepada nama mesin ".host" khas yang diterangkan di atas. Perhatikan bahawa
machinectl senarai-imej tidak akan menunjukkan imej istimewa ini sama ada, melainkan --semua dinyatakan.

FILES DAN DIREKTORI

Imej mesin sebaiknya disimpan dalam /var/lib/machines/, tetapi juga dicari dalam
/usr/local/lib/machines/ dan /usr/lib/machines/. Atas sebab keserasian, direktori
/var/lib/container/ juga dicari. Ambil perhatian bahawa imej yang disimpan di bawah / usr sentiasa
dianggap baca sahaja. Ia adalah mungkin untuk symlink mesin imej dari direktori lain
ke dalam /var/lib/machines/ untuk menjadikannya tersedia untuk dikawal machinectl.

Ambil perhatian bahawa banyak operasi imej hanya disokong, cekap atau atom pada fail btrfs
sistem. Disebabkan ini, jika tarik-tar, tarik-mentah, import-tar, import-mentah and set-had
arahan melihat bahawa /var/lib/machines kosong dan tidak terletak pada btrfs, mereka akan melakukannya
secara tersirat menyediakan fail loopback /var/lib/machines.raw yang mengandungi sistem fail btrfs
yang dipasang pada /var/lib/machines. Saiz fail gelung balik ini mungkin dikawal
secara dinamik dengan set-had.

Imej cakera difahami oleh systemd-nspawn(1) dan machinectl dalam tiga format:

· Pepohon direktori ringkas, yang mengandungi fail dan direktori bekas ke
but.

· Subvolum (pada sistem fail btrfs), yang serupa dengan direktori ringkas,
diterangkan di atas. Walau bagaimanapun, mereka mempunyai faedah tambahan, seperti pengklonan yang cekap dan
pelaporan kuota.

· Imej cakera "Mentah", iaitu imej binari cakera dengan jadual partition GPT atau MBR.
Imej jenis ini ialah fail biasa dengan akhiran ".raw".

Lihat systemd-nspawn(1) untuk mendapatkan maklumat lanjut tentang format imej, khususnya format imej
--direktori= and --imej= pilihan.

CONTOH

Contoh 1. muat turun an Ubuntu gambar and membuka a shell 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

Ini memuat turun dan mengesahkan imej .tar yang ditentukan, dan kemudian menggunakan systemd-nspawn(1) kepada
buka cangkerang di dalamnya.

Contoh 2. muat turun a Fedora gambar, menetapkan a akar kata laluan in ia, permulaan it as perkhidmatan

# 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
#jalan
# keluar
# machinectl mulakan Fedora-Cloud-Base-20141203-21
# log masuk machinectl Fedora-Cloud-Base-20141203-21

Ini memuat turun imej .raw yang ditentukan dengan pengesahan dilumpuhkan. Kemudian, cangkerang adalah
dibuka di dalamnya dan kata laluan akar ditetapkan. Selepas itu cangkerang ditinggalkan, dan mesin
bermula sebagai perkhidmatan sistem. Dengan arahan terakhir, gesaan log masuk ke dalam bekas ialah
diminta.

Contoh 3. Eksport a bekas gambar as tar fail

# machinectl export-tar fedora myfedora.tar.xz

Mengeksport bekas "fedora" sebagai fail tar termampat xz myfedora.tar.xz ke dalam
direktori semasa.

Contoh 4. Buat a baru shell Sesi

# shell machinectl --uid=lennart

Ini mencipta sesi shell baharu pada hos tempatan untuk ID pengguna "lennart", dalam a
su(1) seperti fesyen.

EXIT STATUS

Apabila berjaya, 0 dikembalikan, kod kegagalan bukan sifar sebaliknya.

PERSEKITARAN

$SYSTEMD_PAGER
Pager untuk digunakan apabila --tiada-halaman muka surat tidak diberikan; mengatasi $PAGER. Tetapkan ini kepada kosong
rentetan atau nilai "kucing" bersamaan dengan lulus --tiada-halaman muka surat.

$SYSTEMD_LESS
Gantikan pilihan lalai yang diserahkan kepada kurang ("FRSXMK").

Gunakan machinectl dalam talian menggunakan perkhidmatan onworks.net