podman-machine-os-apply(1) General Commands Manual podman-machine-os-apply(1)

podman-machine-os-apply - اعمال یک ایمیج OCI روی سیستم‌عامل ماشین پادمن

podman machine os apply [گزینه‌ها] uri [vm]

اعمال تغییرات سیستم‌عامل ماشین از طریق یک ایمیج OCI.

ماشین مجازی پادمن قابلیت تغییر پایه (rebase) خود را از محتوای یک ایمیج OCI دارد. دستور podman machine image apply یک ایمیج OCI با قابلیت‌های نیتیو ostree کانتینر را دریافت کرده و پایه سیستم‌عامل خود را بر روی آن ایمیج بازنشانی می‌کند.

به‌طور پیش‌فرض، ماشین‌های پادمن در Mac، لینوکس و Windows Hyper-V از یک توزیع سفارشی‌شده بر پایه rpm-ostree (توزیع Fedora CoreOS) استفاده می‌کنند. ماشین‌های مبتنی بر Microsoft WSL از یک توزیع سفارشی دیگر استفاده می‌کنند و نمی‌توان آن‌ها را با این دستور به‌روزرسانی کرد.

نکته: ماشین‌های مبتنی بر WSL با استفاده از دستور podman machine ssh <machine_name> و سپس اجرای sudo dnf update قابل ارتقا هستند. با این حال، این کار ممکن است به دلیل اختلاف نسخه بین کلاینت و سرور پادمن به نتایج غیرمنتظره‌ای منجر شود.

اعمال ایمیج OCI توسط دستوری به نام bootc و به‌ویژه bootc switch انجام می‌شود. به‌طور پیش‌فرض، این دستور یک ارجاع به ایمیج رجیستری OCI مانند quay.io/custom/machine-os:latest دریافت می‌کند. با این حال، bootc ارجاع‌هایی با روش‌های انتقال (transports) مختلف را نیز درک می‌کند. در حال حاضر، پادمن از روش‌های انتقال زیر پشتیبانی می‌کند:

  • containers-storage
  • oci
  • oci-archive
  • registry

مثال‌هایی از این روش‌های انتقال در قالب URI در زیر آورده شده است.

ایمیج‌های ماشین پادمن به عنوان ایمیج‌های OCI در quay.io/podman/machine-os نگهداری می‌شوند. هنگام اعمال یک ایمیج با استفاده از این دستور، باید نام ارجاع کامل OCI به همراه تگ استفاده شود؛ که تگ، نسخه پادمن موجود در ماشین مجازی است. به‌طور پیش‌فرض، پادمن تلاش می‌کند فقط همان نسخه مطابق با خود را دریافت کند.

نام پیش‌فرض ماشین podman-machine-default است. اگر نام ماشینی به عنوان آرگومان مشخص نشود، تغییرات سیستم‌عامل روی podman-machine-default اعمال خواهد شد.

چاپ اعلان راهنمای استفاده.

راه‌اندازی مجدد ماشین مجازی پس از اعمال تغییرات.

به‌روزرسانی ماشین پیش‌فرض پادمن به آخرین نسخه در حال توسعه ایمیج قابل بوت OCI.

نکته: این عمل ممکن است باعث شود نسخه پادمن درون ماشین از کلاینت جدیدتر باشد و نتایج غیرمنتظره‌ای رخ دهد.

اعمال یک سیستم‌عامل سفارشی جدید از یک ایمیج قابل بوت OCI در quay:

$ podman machine os apply quay.io/custom/machine-os:latest

اعمال یک سیستم‌عامل سفارشی جدید به یک ماشین خاص از یک ایمیج قابل بوت OCI در quay:

$ podman machine os apply quay.io/custom/machine-os:latest mymachine

اعمال یک سیستم‌عامل سفارشی جدید که توسط کاربر غیرممتاز روی ماشین فعلی دریافت یا ساخته شده است. به استفاده از کروشه‌ها در اطراف مسیر توجه کنید، زیرا این دستور توسط کاربر ریشه اجرا می‌شود:

$ podman machine os apply containers-storage:[/home/core/.local/share/containers/storage]localhost/mycustomimage:latest

اعمال یک سیستم‌عامل سفارشی جدید که توسط کاربر ممتاز روی ماشین فعلی دریافت یا ساخته شده است. توجه داشته باشید چون کاربر ممتاز ایمیج را ساخته یا دریافت کرده است، bootc فضای ذخیره‌سازی آن کاربر را شناسایی کرده و نیازی به مسیر نیست:

$ podman machine os apply containers-storage:localhost/mycustomimage:latest

اعمال یک سیستم‌عامل سفارشی جدید از یک آرشیو OCI در قالب tar:

$ podman machine os apply oci-archive:/tmp/oci-image.tar

اعمال یک سیستم‌عامل سفارشی جدید از یک دایرکتوری در قالب OCI:

$ podman machine os apply oci:/tmp/oci-image/

podman(1), podman-machine(1), podman-machine-os(1)

فوریه ۲۰۲۳، در ابتدا توسط Ashley Cui acui@redhat.com ⟨mailto:acui@redhat.com⟩ گردآوری شد.