9abe8c7853
Podman machine os apply takes a takes a OCI image with container native ostree functionality and rebases the machine os on that image. Currently, this requires the guest os inside the vm to use rpm-ostree. When specifying an image, any container transport may be specified. If a container transport is not specified, OS apply will attempt to search the local containers-storage for the image, and if it is not found, it will then attempt to use the Docker transport to pull from a remote registry. The architecture of OS apply is as follows: podman machine os apply ssh's into the machine and calls podman machine os apply. on the secondary call to podman machine os apply, apply recognizes that it is inside the machine and does image operations, and finally calls rpm-ostree rebase. Tests are written but commented out, due to the chicken-and-egg problem. Signed-off-by: Ashley Cui <acui@redhat.com>
2.7 KiB
% podman-machine 1
NAME
podman-machine - Manage Podman's virtual machine
SYNOPSIS
podman machine subcommand
DESCRIPTION
podman machine is a set of subcommands that manage Podman's virtual machine.
Podman on MacOS and Windows requires a virtual machine. This is because containers are Linux - containers do not run on any other OS because containers' core functionality are tied to the Linux kernel. Podman machine must be used to manage MacOS and Windows machines, but can be optionally used on Linux.
All podman machine commands are rootless only.
NOTE: The podman-machine configuration file is managed under the
$XDG_CONFIG_HOME/containers/podman/machine/ directory. Changing the $XDG_CONFIG_HOME
environment variable while the machines are running can lead to unexpected behavior.
SUBCOMMANDS
| Command | Man Page | Description |
|---|---|---|
| info | podman-machine-info(1) | Display machine host info |
| init | podman-machine-init(1) | Initialize a new virtual machine |
| inspect | podman-machine-inspect(1) | Inspect one or more virtual machines |
| list | podman-machine-list(1) | List virtual machines |
| os | podman-machine-os(1) | Manage a Podman virtual machine's OS |
| rm | podman-machine-rm(1) | Remove a virtual machine |
| set | podman-machine-set(1) | Sets a virtual machine setting |
| ssh | podman-machine-ssh(1) | SSH into a virtual machine |
| start | podman-machine-start(1) | Start a virtual machine |
| stop | podman-machine-stop(1) | Stop a virtual machine |
SEE ALSO
podman(1), podman-machine-info(1), podman-machine-init(1), podman-machine-list(1), podman-machine-os(1), podman-machine-rm(1), podman-machine-ssh(1), podman-machine-start(1), podman-machine-stop(1), podman-machine-inspect(1)
HISTORY
March 2021, Originally compiled by Ashley Cui acui@redhat.com