machinectl - Online di Cloud

PROGRAM:

NAMA

machinectl - Mengontrol manajer mesin systemd

RINGKASAN

mesinctl [OPSI...] {COMMAND} [NAME...]

DESKRIPSI

mesinctl dapat digunakan untuk introspeksi dan mengontrol keadaan systemd(1) maya
manajer pendaftaran mesin dan kontainer systemd-machined.service(8).

mesinctl dapat digunakan untuk menjalankan operasi pada mesin dan gambar. Mesin dalam hal ini
sense dianggap menjalankan instance dari:

· Mesin Virtual (VM) yang memvirtualisasikan perangkat keras untuk menjalankan sistem operasi (OS) penuh
instance (termasuk kernelnya) dalam lingkungan virtual di atas host
OS.

· Wadah yang berbagi perangkat keras dan kernel OS dengan OS host, untuk menjalankan OS
contoh userspace di atas OS host.

· Sistem host itu sendiri

Mesin diidentifikasi dengan nama yang mengikuti aturan yang sama dengan nama host UNIX dan DNS,
untuk detailnya, lihat di bawah. Mesin dibuat dari disk atau gambar sistem file yang
sering — tetapi tidak harus — membawa nama yang sama dengan mesin yang menjalankannya.
Gambar dalam pengertian ini dianggap:

· Pohon direktori yang berisi OS, termasuk direktori tingkat atas / usr, / Etc, dan
begitu seterusnya.

· subvolume btrfs yang berisi pohon OS, mirip dengan pohon direktori normal.

· Gambar disk "mentah" biner yang berisi tabel partisi MBR atau GPT dan sistem file Linux
partisi.

· Pohon sistem file dari OS host itu sendiri.

PILIHAN

Opsi berikut dipahami:

-p, --properti=
Saat menampilkan properti mesin atau gambar, batasi output ke properti tertentu sebagai
ditentukan oleh argumen. Jika tidak ditentukan, semua properti yang ditetapkan akan ditampilkan. NS
argumen harus berupa nama properti, seperti "Nama". Jika ditentukan lebih dari sekali, semua
properti dengan nama yang ditentukan akan ditampilkan.

-a, --semua
Saat menampilkan properti mesin atau gambar, tampilkan semua properti terlepas dari apakah
mereka ditetapkan atau tidak.

Saat mencantumkan gambar VM atau container, jangan menyembunyikan gambar yang dimulai dengan titik
karakter (".").

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

--tidak-tanya-kata sandi
Jangan meminta pengguna untuk otentikasi untuk operasi istimewa.

--bunuh-siapa=
Saat digunakan dengan membunuh, pilih proses mana yang akan dimatikan. Harus menjadi salah satu pemimpin, atau semua untuk
pilih apakah hanya mematikan proses pemimpin mesin atau semua proses
mesin. Jika dihilangkan, defaultnya adalah semua.

-s, --sinyal=
Saat digunakan dengan membunuh, pilih sinyal mana yang akan dikirim ke proses yang dipilih. Harus menjadi salah satu
penentu sinyal yang terkenal, seperti JANGKA TARGET, SIGINT or PEMBERHENTIAN SELANJUTNYA. Jika dihilangkan,
default ke JANGKA TARGET.

--uid=
Saat digunakan dengan tempurung perintah, memilih ID pengguna untuk membuka shell interaktif
sesi sebagai. Jika sakelar ini tidak ditentukan, defaultnya adalah "root". Perhatikan bahwa sakelar ini
tidak didukung untuk masuk perintah (lihat di bawah).

--setenv=
Saat digunakan dengan tempurung perintah, menetapkan variabel lingkungan untuk diteruskan ke dieksekusi
kerang. Mengambil sepasang nama dan nilai variabel lingkungan, dipisahkan oleh "=" as
argumen. Sakelar ini dapat digunakan beberapa kali untuk mengatur beberapa lingkungan
variabel. Perhatikan bahwa sakelar ini tidak didukung untuk masuk perintah (lihat di bawah).

--mkdir
Saat digunakan dengan mengikat, membuat direktori tujuan sebelum menerapkan pengikatan mount.

--hanya-baca
Saat digunakan dengan mengikat, menerapkan pengikatan hanya-baca.

-n, --baris=
Saat digunakan dengan status, mengontrol jumlah baris jurnal untuk ditampilkan, dihitung dari
yang terbaru. Mengambil argumen bilangan bulat positif. Default ke 10.

-o, --keluaran=
Saat digunakan dengan status, mengontrol pemformatan entri jurnal yang ditampilkan.
Untuk pilihan yang tersedia, lihat journalctl(1). Default ke "pendek".

--verifikasi=
Saat mengunduh gambar container atau VM, tentukan apakah gambar harus diverifikasi
sebelum tersedia. Mengambil salah satu dari "tidak", "checksum" dan "tanda tangan". Jika tidak",
tidak ada verifikasi yang dilakukan. Jika "checksum" ditentukan, unduhan diperiksa untuk
integritas setelah transfer selesai, tetapi tidak ada tanda tangan yang diverifikasi. Jika
"tanda tangan" ditentukan, checksum diverifikasi dan tanda tangan gambar adalah
diperiksa terhadap keyring lokal vendor terpercaya. Sangat disarankan untuk
atur opsi ini ke "tanda tangan" jika server dan protokol mendukung ini. Default untuk
"tanda tangan".

--memaksa
Saat mengunduh wadah atau gambar VM, dan salinan lokal oleh lokal yang ditentukan
nama mesin sudah ada, hapus dulu dan ganti dengan yang baru diunduh
gambar.

--format=
Saat digunakan dengan ekspor-tar or ekspor-mentah perintah, menentukan format kompresi
digunakan untuk file yang dihasilkan. Mengambil salah satu dari "tidak terkompresi", "xz", "gzip", "bzip2". Oleh
default, format ditentukan secara otomatis dari nama file gambar yang diteruskan.

-H, --tuan rumah=
Jalankan operasi dari jarak jauh. Tentukan nama host, atau nama pengguna dan nama host
dipisahkan oleh "@", untuk terhubung. Nama host secara opsional dapat diakhiri dengan a
nama wadah, dipisahkan oleh ":", yang menghubungkan langsung ke wadah tertentu di
tuan rumah yang ditentukan. Ini akan menggunakan SSH untuk berbicara dengan instance manajer mesin jarak jauh.
Nama kontainer dapat disebutkan dengan mesinctl -H HOST.

-M, --mesin=
Jalankan operasi pada wadah lokal. Tentukan nama penampung yang akan dihubungkan.

--tanpa-halaman
Jangan menyalurkan output ke pager.

--tidak ada legenda
Jangan mencetak legenda, yaitu header kolom dan footer dengan petunjuk.

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

--Versi: kapan
Cetak string versi singkat dan keluar.

PERINTAH

Perintah berikut dipahami:

Mesin Perintah
daftar
Daftar mesin virtual dan kontainer (online) yang sedang berjalan. Untuk menghitung mesin
gambar yang dapat dimulai, gunakan daftar-gambar (Lihat di bawah). Perhatikan bahwa perintah ini menyembunyikan
mesin ".host" khusus secara default. Menggunakan --semua beralih untuk menunjukkannya.

status NAMA...
Tampilkan informasi status runtime tentang satu atau lebih mesin virtual dan wadah,
diikuti oleh data log terbaru dari jurnal. Fungsi ini dimaksudkan untuk
menghasilkan keluaran yang dapat dibaca manusia. Jika Anda mencari keluaran yang dapat diurai komputer, gunakan
Menunjukkan sebagai gantinya. Perhatikan bahwa data log yang ditampilkan dilaporkan oleh mesin virtual atau
manajer kontainer, dan sering berisi output konsol mesin, tetapi tidak
tentu jurnal isi dari mesin itu sendiri.

Menunjukkan [NAMA...]
Tampilkan properti dari satu atau lebih mesin atau wadah virtual terdaftar atau
manajer itu sendiri. Jika tidak ada argumen yang ditentukan, properti manajer akan ditampilkan.
Jika NAMA ditentukan, properti mesin virtual atau wadah ini akan ditampilkan. Oleh
default, properti kosong ditekan. Menggunakan --semua untuk menunjukkan itu juga. Memilih
properti khusus untuk ditampilkan, gunakan --properti=. Perintah ini dimaksudkan untuk digunakan
kapan pun output yang dapat diurai komputer diperlukan, dan tidak mencetak pohon cgroup atau
entri jurnal. Menggunakan status jika Anda mencari keluaran terformat yang dapat dibaca manusia.

awal NAMA...
Mulai wadah sebagai layanan sistem, menggunakan systemd-nspawn(1). Ini dimulai
[email dilindungi], dipakai untuk nama mesin yang ditentukan, mirip dengan
efek dari systemctl awal pada nama layanan. systemd-nspawn mencari wadah
gambar dengan nama yang ditentukan di /var/lib/machines/ (dan jalur pencarian lainnya, lihat di bawah)
dan menjalankannya. Menggunakan daftar-gambar (lihat di bawah) untuk daftar gambar kontainer yang tersedia untuk
memulai.

Perhatikan bahwa systemd-machined.service(8) juga berinteraksi dengan berbagai lainnya
wadah dan manajer VM, systemd-nspawn hanyalah salah satu implementasinya. Kebanyakan
perintah yang tersedia di mesinctl dapat digunakan pada container atau VM yang dikendalikan oleh
manajer lain, bukan hanya systemd-nspawn. Memulai VM dan image container pada itu
manajer memerlukan alat khusus manajer.

Untuk memulai wadah secara interaktif di baris perintah dengan akses penuh ke
konsol container, silakan panggil systemd-nspawn secara langsung. Untuk menghentikan lari
penggunaan wadah mesinctl matikan, Lihat di bawah.

masuk [NAMA]
Buka sesi login terminal interaktif dalam wadah atau di host lokal. Jika
argumen diberikan, itu mengacu pada mesin kontainer untuk terhubung. Jika tidak ada
ditentukan, atau nama wadah ditentukan sebagai string kosong, atau khusus
nama mesin ".host" (lihat di bawah) ditentukan, koneksi dibuat ke lokal
tuan rumah sebagai gantinya. Ini akan membuat koneksi TTY ke wadah tertentu atau lokal
host dan meminta eksekusi getty di atasnya. Perhatikan bahwa ini hanya didukung untuk
kontainer berjalan systemd(1) sebagai sistem init.

Perintah ini akan membuka prompt login penuh pada wadah atau host lokal, yang
kemudian menanyakan username dan password. Menggunakan tempurung (lihat di bawah) atau systemd-jalankan(1) dengan
--mesin= beralih untuk secara langsung menjalankan satu perintah, baik secara interaktif atau di
latar belakang.

tempurung [[NAMA@]NAMA [PATH [ARGUMEN...]]]
Buka sesi shell interaktif dalam wadah atau di host lokal. Pertama
argumen mengacu pada mesin kontainer untuk terhubung. Jika tidak ada yang ditentukan, atau
nama mesin ditentukan sebagai string kosong, atau nama mesin khusus ".host"
(lihat di bawah) ditentukan, koneksi dibuat ke host lokal sebagai gantinya. Ini bekerja
mirip dengan masuk tetapi segera memanggil proses pengguna. Perintah ini menjalankan
ditentukan dieksekusi dengan argumen yang ditentukan, atau / Bin / sh jika tidak ada yang ditentukan. Oleh
default, membuka shell "root", tetapi dengan menggunakan --uid=, atau dengan mengawali nama mesin
dengan nama pengguna dan karakter "@", pengguna yang berbeda dapat dipilih. Menggunakan --setenv=
untuk mengatur variabel lingkungan untuk proses yang dijalankan.

Saat menggunakan tempurung perintah tanpa argumen, (dengan demikian memanggil shell yang dieksekusi atau
perintah pada host lokal), dalam banyak hal mirip dengan a su(1) sesi, tetapi, tidak seperti
su, benar-benar mengisolasi sesi baru dari sesi asal, sehingga
tidak membagikan properti proses atau sesi, dan dalam keadaan bersih dan terdefinisi dengan baik. Dia
akan dilacak dalam sesi utmp, login, audit, keamanan dan keyring baru, dan akan
tidak mewarisi variabel lingkungan atau batasan sumber daya, di antara properti lainnya.

Perhatikan bahwa systemd-jalankan(1) dapat digunakan sebagai pengganti tempurung perintah, dan memungkinkan lebih banyak
konfigurasi tingkat rendah yang terperinci dari unit yang dipanggil. Namun, seringkali lebih
diistimewakan daripada tempurung perintah.

aktif NAMA... menonaktifkan NAMA...
Aktifkan atau nonaktifkan wadah sebagai layanan sistem untuk memulai saat boot sistem, menggunakan
systemd-nspawn(1). Ini mengaktifkan atau menonaktifkan [email dilindungi], dipakai untuk
nama mesin yang ditentukan, mirip dengan efek systemctl aktif or systemctl
menonaktifkan pada nama layanan.

matikan NAMA...
Matikan satu atau lebih wadah. Ini akan memicu reboot dengan mengirimkan SIGRTMIN+4 ke
proses init container, yang menyebabkan sistem init yang kompatibel dengan systemd ditutup
turun dengan bersih. Operasi ini tidak bekerja pada container yang tidak berjalan
systemd(1) sistem init yang kompatibel, seperti sysvinit. Menggunakan Selesai (lihat di bawah) untuk
segera hentikan container atau VM, tanpa mematikannya dengan bersih.

restart NAMA...
Reboot satu atau lebih kontainer. Ini akan memicu reboot dengan mengirimkan SIGINT ke
proses init container, yang kira-kira setara dengan menekan Ctrl+Alt+Del pada
sistem non-kontainer, dan kompatibel dengan kontainer yang menjalankan sistem apa pun
manajer.

Selesai NAMA...
Segera menghentikan mesin atau wadah virtual, tanpa menutupnya dengan bersih
turun. Ini membunuh semua proses mesin virtual atau wadah dan membatalkan alokasi semua
sumber daya yang melekat pada instance itu. Menggunakan matikan untuk mengeluarkan permintaan shutdown bersih.

membunuh NAMA...
Kirim sinyal ke satu atau lebih proses mesin virtual atau wadah. Ini berarti
proses seperti yang terlihat oleh host, bukan proses di dalam mesin virtual atau
wadah. Menggunakan --bunuh-siapa= untuk memilih proses mana yang akan dimatikan. Menggunakan --sinyal= untuk memilih
sinyal untuk dikirim.

mengikat NAMA PATH [PATH]
Bind memasang direktori dari Host ke dalam wadah yang ditentukan. Pertama
argumen direktori adalah direktori sumber pada host, argumen direktori kedua
adalah direktori tujuan dalam wadah. Ketika yang terakhir dihilangkan,
jalur tujuan dalam wadah sama dengan jalur sumber di host. Kapan
dikombinasikan dengan --hanya-baca switch, pengikatan hanya siap dibuat. Kapan
dikombinasikan dengan --mkdir switch, jalur tujuan pertama kali dibuat sebelum
mount diterapkan. Perhatikan bahwa opsi ini saat ini hanya didukung untuk sistemd-
tidak bertelur(1) wadah.

Salin ke NAMA PATH [PATH]
Menyalin file atau direktori dari sistem host ke wadah yang sedang berjalan. mengambil
nama wadah, diikuti dengan jalur sumber di host dan jalur tujuan di
wadah. Jika jalur tujuan dihilangkan, sama dengan jalur sumber adalah
bekas.

copy-dari NAMA PATH [PATH]
Menyalin file atau direktori dari wadah ke sistem host. Mengambil wadah
nama, diikuti dengan jalur sumber di wadah jalur tujuan di host.
Jika jalur tujuan dihilangkan, sama dengan jalur sumber yang digunakan.

Gambar Perintah
daftar-gambar
Tampilkan daftar container dan image VM yang diinstal secara lokal. Ini menyebutkan semua disk mentah
gambar dan direktori wadah dan subvolume di /var/lib/machines/ (dan lainnya
jalur pencarian, lihat di bawah). Menggunakan awal (lihat di atas) untuk menjalankan wadah dari salah satu
gambar yang terdaftar. Perhatikan bahwa, secara default, wadah yang namanya dimulai dengan titik (".")
tidak ditampilkan. Untuk menunjukkan ini juga, tentukan --semua. Perhatikan bahwa gambar khusus ".host"
selalu ada secara implisit dan mengacu pada gambar tempat host itu sendiri di-boot.

gambar-status [NAMA...]
Tampilkan informasi status singkat tentang satu atau beberapa penampung atau gambar VM. Fungsi ini
dimaksudkan untuk menghasilkan keluaran yang dapat dibaca manusia. Menggunakan menunjukkan-gambar (lihat di bawah) untuk menghasilkan
output yang dapat diurai oleh komputer sebagai gantinya.

menunjukkan-gambar [NAMA...]
Tampilkan properti dari satu atau lebih mesin virtual terdaftar atau gambar kontainer, atau
manajer itu sendiri. Jika tidak ada argumen yang ditentukan, properti manajer akan ditampilkan.
Jika NAMA ditentukan, properti mesin virtual atau gambar wadah ini adalah
ditampilkan. Secara default, properti kosong ditekan. Menggunakan --semua untuk menunjukkan itu juga. Ke
pilih properti tertentu untuk ditampilkan, gunakan --properti=. Perintah ini dimaksudkan untuk menjadi
digunakan kapan pun output yang dapat diurai komputer diperlukan. Menggunakan gambar-status jika Anda
mencari keluaran terformat yang dapat dibaca manusia.

clone NAMA NAMA
Mengkloning container atau image VM. Argumen menentukan nama gambar yang akan dikloning
dan nama gambar yang baru dikloning. Perhatikan bahwa gambar wadah direktori biasa adalah
kloning menjadi gambar subvolume dengan perintah ini. Perhatikan bahwa mengkloning wadah atau VM
gambar dioptimalkan untuk sistem file btrfs, dan mungkin tidak efisien pada yang lain, karena
untuk batasan sistem file.

Perhatikan bahwa perintah ini meninggalkan nama host, ID mesin, dan semua pengaturan lain yang dapat
mengidentifikasi instance yang tidak dimodifikasi. Gambar asli dan salinan kloning akan karenanya
bagikan kredensial ini, dan mungkin perlu mengubahnya secara manual di
salinan.

mengubah nama NAMA NAMA
Mengganti nama container atau image VM. Argumen menentukan nama gambar yang akan diganti namanya
dan nama baru dari gambar tersebut.

read-only NAMA [BOOL]
Menandai atau (menghapus tanda) penampung atau gambar VM hanya-baca. Mengambil gambar VM atau container
nama, diikuti oleh boolean sebagai argumen. Jika boolean dihilangkan, positif adalah
tersirat, yaitu gambar ditandai hanya-baca.

menghapus NAMA...
Menghapus satu atau beberapa container atau gambar VM. Gambar khusus ".host", yang mengacu pada
pohon direktori host sendiri, tidak boleh dihapus.

set-batas [NAMA] BYTE
Menyetel ukuran maksimum dalam byte yang wadah tertentu atau gambar VM, atau semua gambar,
dapat tumbuh hingga pada disk (kuota disk). Mengambil satu atau dua parameter. Pertama,
parameter opsional mengacu pada wadah atau nama gambar VM. Jika ditentukan, ukuran
batas gambar yang ditentukan diubah. Jika dihilangkan, batas ukuran keseluruhan dari jumlah
semua gambar yang disimpan secara lokal diubah. Argumen terakhir menentukan batas ukuran
dalam byte, mungkin diberi akhiran oleh satuan K, M, G, T biasa. Jika batas ukuran harus
dinonaktifkan, tentukan "-" sebagai ukuran.

Perhatikan bahwa batas ukuran per wadah hanya didukung pada sistem file btrfs. Juga
perhatikan bahwa, jika set-batas dipanggil tanpa parameter gambar, dan /var/lib/machines
kosong, dan direktori tidak terletak di btrfs, file loopback btrfs adalah
secara implisit dibuat sebagai /var/lib/machines.raw dengan ukuran yang diberikan, dan dipasang ke
/var/lib/mesin. Ukuran loopback nantinya dapat disesuaikan dengan set-batas, sebagai
dengan baik. Jika direktori /var/lib/machines yang dipasang di loopback seperti itu digunakan, set-batas
tanpa nama gambar mengubah pengaturan kuota dalam sistem file serta
file loopback dan ukuran sistem file itu sendiri.

Gambar Transfer Perintah
tarik-tar URL [NAMA]
Mengunduh gambar wadah .tar dari URL yang ditentukan, dan membuatnya tersedia di bawah
nama mesin lokal yang ditentukan. URL harus bertipe "http://" atau "https://", dan
harus merujuk ke file arsip .tar, .tar.gz, .tar.xz, atau .tar.bz2. Jika mesin lokal
nama dihilangkan, itu secara otomatis diturunkan dari komponen terakhir URL, dengan
sufiksnya dihilangkan.

Gambar diverifikasi sebelum tersedia, kecuali --verifikasi=tidak ditentukan.
Verifikasi dilakukan melalui file SHA256SUMS dan SHA256SUMS.gpg yang perlu dibuat
tersedia di server web yang sama, di bawah URL yang sama dengan file .tar, tetapi dengan
komponen terakhir (nama file) dari URL diganti. Dengan --verifikasi=checksum, hanya
Checksum SHA256 untuk file diverifikasi, berdasarkan file SHA256SUMS. Dengan
--verifikasi=tanda tangan, file SHA256SUMS pertama kali diverifikasi dengan tanda tangan GPG terpisah
file SHA256SUMS.gpg. Kunci publik untuk langkah verifikasi ini harus tersedia
di /usr/lib/systemd/import-pubring.gpg atau /etc/systemd/import-pubring.gpg.

Gambar kontainer akan diunduh dan disimpan dalam subvolume baca-saja di
/var/lib/machines/ yang dinamai sesuai dengan URL yang ditentukan dan HTTP etag-nya. Dapat ditulisi
snapshot kemudian diambil dari subvolume ini, dan dinamai menurut nama lokal yang ditentukan.
Perilaku ini memastikan bahwa membuat beberapa instance container dari URL yang sama adalah
efisien, karena banyak unduhan tidak diperlukan. Untuk membuat hanya
gambar hanya-baca, dan hindari membuat snapshot yang dapat ditulis, tentukan "-" sebagai lokal
nama mesin.

Perhatikan bahwa subvolume read-only diawali dengan .tar-, dan dengan demikian tidak ditunjukkan oleh
daftar-gambar, kecuali kalau --semua dilewatkan.

Perhatikan bahwa menekan Cc selama menjalankan perintah ini tidak akan membatalkan unduhan.
penggunaan batalkan transfer, dijelaskan di bawah ini.

tarik mentah URL [NAMA]
Mengunduh wadah .raw atau gambar disk VM dari URL yang ditentukan, dan membuatnya
tersedia di bawah nama mesin lokal yang ditentukan. URL harus bertipe "http://" atau
"https://". Gambar wadah harus berupa .qcow2 atau gambar disk mentah, opsional
dikompresi sebagai .gz, .xz, atau .bz2. Jika nama mesin lokal dihilangkan, itu adalah
secara otomatis diturunkan dari komponen terakhir URL, dengan akhiran dihapus.

Verifikasi gambar identik untuk gambar mentah dan tar (lihat di atas).

Jika gambar yang diunduh dalam format .qcow2, itu diubah menjadi file gambar mentah
sebelum tersedia.

Gambar yang diunduh dari jenis ini akan ditempatkan sebagai file .raw hanya-baca di
/var/lib/mesin/. Salinan lokal yang dapat ditulis (di-reflink) kemudian dibuat di bawah
nama mesin lokal yang ditentukan. Untuk menghilangkan pembuatan salinan lokal yang dapat ditulis, pass "-" as
nama mesin lokal.

Mirip dengan perilaku tarik-tar, gambar read-only diawali dengan .raw-, dan
dengan demikian tidak ditunjukkan oleh daftar-gambar, kecuali kalau --semua dilewatkan.

Perhatikan bahwa menekan Cc selama menjalankan perintah ini tidak akan membatalkan unduhan.
penggunaan batalkan transfer, dijelaskan di bawah ini.

impor-tar FILE [NAMA], impor-mentah FILE [NAMA]
Mengimpor wadah TAR atau RAW atau gambar VM, dan menempatkannya di bawah nama yang ditentukan di
/var/lib/mesin/. Kapan impor-tar digunakan, file ditentukan sebagai argumen pertama
harus berupa arsip tar, mungkin dikompresi dengan xz, gzip atau bzip2. Maka akan menjadi
membongkar ke dalam subvolumenya sendiri di /var/lib/machines. Kapan impor-mentah digunakan, itu
file harus berupa qcow2 atau gambar disk mentah, mungkin dikompresi dengan xz, gzip atau bzip2.
Jika argumen kedua (nama gambar yang dihasilkan) tidak ditentukan, itu adalah
secara otomatis berasal dari nama file. Jika nama file dilewatkan sebagai "-", gambar
dibaca dari input standar, dalam hal ini argumen kedua adalah wajib.

Kedua tarik-tar dan tarik mentah akan mengubah ukuran /var/lib/machines.raw dan sistem file
didalamnya sesuai kebutuhan. Secara opsional, --hanya-baca switch dapat digunakan untuk membuat
wadah baca-saja atau gambar VM. Tidak ada validasi kriptografi yang dilakukan saat mengimpor
gambar.

Sama seperti unduhan gambar, impor yang sedang berlangsung mungkin terdaftar dengan daftar-transfer dan
dibatalkan dengan batalkan transfer.

ekspor-tar NAMA [FILE], ekspor-mentah NAMA [FILE]
Mengekspor wadah TAR atau RAW atau gambar VM dan menyimpannya dalam file yang ditentukan. NS
parameter pertama harus berupa VM atau nama image container. Parameter kedua seharusnya
jalur file tempat gambar TAR atau RAW ditulis. Jika path diakhiri dengan ".gz", file tersebut adalah
dikompresi dengan gzip, jika diakhiri dengan ".xz", dengan xz, dan jika diakhiri dengan ".bz2", dengan
bzip2. Jika jalur tidak berakhir di keduanya, file dibiarkan tidak terkompresi. Jika yang kedua
argumen hilang, gambar ditulis ke output standar. Kompresi mungkin juga
dipilih secara eksplisit dengan --format= mengalihkan. Ini khususnya berguna jika
parameter kedua dibiarkan tidak ditentukan.

Sama seperti unduhan dan impor gambar, ekspor yang sedang berlangsung mungkin terdaftar dengan
daftar-transfer dan dibatalkan dengan batalkan transfer.

Perhatikan bahwa, saat ini, hanya gambar direktori dan subvolume yang dapat diekspor sebagai TAR
gambar, dan hanya gambar disk mentah sebagai gambar RAW.

daftar-transfer
Menampilkan daftar unduhan, impor, dan ekspor gambar container atau VM yang
sedang berlangsung.

batalkan transfer ID...
Membatalkan unduhan, impor, atau ekspor wadah atau gambar VM dengan yang ditentukan
INDO. Untuk membuat daftar transfer yang sedang berlangsung dan ID mereka, gunakan daftar-transfer.

MESIN DAN IMAGE NAMA

mesinctl alat beroperasi pada mesin dan gambar yang namanya harus dipilih berikut:
aturan yang ketat. Nama mesin harus sesuai untuk digunakan sebagai nama host setelah a
subset konservatif dari semantik DNS dan UNIX/Linux. Secara khusus, mereka harus terdiri dari
satu atau lebih string label yang tidak kosong, dipisahkan oleh titik. Tidak ada titik awal atau akhir yang
diizinkan. Urutan beberapa titik tidak diperbolehkan. String label hanya boleh terdiri dari
karakter alfanumerik serta tanda hubung dan garis bawah. Panjang maksimum
nama mesin adalah 64 karakter.

Mesin khusus dengan nama ".host" mengacu pada sistem host yang sedang berjalan itu sendiri. Ini adalah
berguna untuk operasi eksekusi atau memeriksa sistem host juga. Perhatikan bahwa
mesinctl daftar tidak akan menampilkan mesin khusus ini kecuali jika --semua saklar ditentukan.

Persyaratan nama gambar kurang ketat, namun harus UTF-8 yang valid, harus
cocok sebagai nama file (karenanya tidak berupa titik tunggal atau ganda, dan tidak menyertakan garis miring),
dan tidak boleh berisi karakter kontrol. Karena banyak operasi mencari gambar dengan
nama mesin yang diminta, disarankan untuk memberi nama gambar dengan cara yang sama ketatnya
sebagai mesin.

Gambar khusus dengan nama ".host" mengacu pada gambar sistem host yang sedang berjalan. Dia
maka secara konseptual memetakan ke nama mesin ".host" khusus yang dijelaskan di atas. Perhatikan bahwa
mesinctl daftar-gambar tidak akan menampilkan gambar khusus ini juga, kecuali --semua ditentukan.

FILE DAN DIREKTORI

Gambar mesin sebaiknya disimpan di /var/lib/machines/, tetapi juga dicari di
/usr/local/lib/machines/ dan /usr/lib/machines/. Untuk alasan kompatibilitas, direktori
/var/lib/container/ juga dicari. Perhatikan bahwa gambar disimpan di bawah / usr selalu
dianggap hanya-baca. Dimungkinkan untuk menghubungkan gambar mesin dari direktori lain
ke /var/lib/machines/ untuk membuatnya tersedia untuk dikontrol dengan mesinctl.

Perhatikan bahwa banyak operasi gambar hanya didukung, efisien atau atom pada file btrfs
sistem. Karena itu, jika tarik-tar, tarik mentah, impor-tar, impor-mentah dan set-batas
perintah memperhatikan bahwa /var/lib/machines kosong dan tidak terletak di btrfs, mereka akan
secara implisit menyiapkan file loopback /var/lib/machines.raw yang berisi sistem file btrfs
yang dipasang ke /var/lib/machines. Ukuran file loopback ini dapat dikontrol
secara dinamis dengan set-batas.

Gambar disk dipahami oleh systemd-nspawn(1) dan mesinctl dalam tiga format:

· Pohon direktori sederhana, berisi file dan direktori wadah untuk
boot

· Subvolume (pada sistem file btrfs), yang mirip dengan direktori sederhana,
dijelaskan di atas. Namun, mereka memiliki manfaat tambahan, seperti kloning yang efisien dan
pelaporan kuota.

· Gambar disk "mentah", yaitu citra biner disk dengan tabel partisi GPT atau MBR.
Gambar jenis ini adalah file biasa dengan akhiran ".raw".

Lihat systemd-nspawn(1) untuk informasi lebih lanjut tentang format gambar, khususnya
--direktori= dan --gambar= Pilihan.

CONTOH

Example 1. Unduh an Ubuntu gambar dan Buka a tempurung in it

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

Ini mengunduh dan memverifikasi gambar .tar yang ditentukan, dan kemudian menggunakan systemd-nspawn(1) ke
membuka cangkang di dalamnya.

Example 2. Unduh a Fedora gambar, set a akar kata sandi in saya t, awal it as layanan

# mesinctl tarik-mentah --verifikasi=tidak 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
# keluar
# machinectl mulai Fedora-Cloud-Base-20141203-21
# login machinectl Fedora-Cloud-Base-20141203-21

Ini mengunduh gambar .raw yang ditentukan dengan verifikasi dinonaktifkan. Kemudian, cangkang adalah
dibuka di dalamnya dan kata sandi root ditetapkan. Setelah itu cangkangnya dibiarkan, dan mesinnya
dimulai sebagai layanan sistem. Dengan perintah terakhir, prompt login ke dalam wadah adalah
diminta.

Example 3. Ekspor a wadah gambar as ter fillet

# mesinctl ekspor-tar fedora myfedora.tar.xz

Mengekspor wadah "fedora" sebagai file tar terkompresi xz myfedora.tar.xz ke
direktori saat ini.

Example 4. membuat a yang baru tempurung Sidang

# mesinctl shell --uid=lennart

Ini membuat sesi shell baru pada host lokal untuk ID pengguna "lennart", di a
su(1)-seperti mode.

EXIT STATUS

Saat berhasil, 0 dikembalikan, kode kegagalan bukan nol sebaliknya.

LINGKUNGAN

$SYSTEMD_PAGER
Pager untuk digunakan saat --tanpa-halaman tidak diberikan; menimpa $HALAMAN. Mengatur ini menjadi kosong
string atau nilai "cat" sama dengan passing --tanpa-halaman.

$SYSTEMD_LESS
Ganti opsi default yang diteruskan ke kurang ("FRSXMK").

Gunakan machinectl online menggunakan layanan onworks.net