Machine init --provider

Add the ability for users to override the default provider when creating mahcines.  The new flag is `--provider` and allows you to specifiy a valid vmtype for the platform.  This PR also removes the previous list test where we tested listing all providers.  I added a PR for testing --provider which includes a standard `machine ls` which defaults now to showing all providers.

Signed-off-by: Brent Baude <[email protected]>

Author: baude

cmd/podman/machine/info.go

@@ -100,7 +100,7 @@ func hostInfo() (*entities.MachineHostInfo, error) {
 	host.Arch = runtime.GOARCH
 	host.OS = runtime.GOOS
 
-	dirs, err := env.GetMachineDirs(provider.VMType())
+	dirs, err := env.GetMachineDirs(machineProvider.VMType())
 	if err != nil {
 		return nil, err
 	}
@@ -126,7 +126,7 @@ func hostInfo() (*entities.MachineHostInfo, error) {
 			host.DefaultMachine = vm.Name
 		}
 		// If machine is running or starting, it is automatically the current machine
-		state, err := provider.State(vm, false)
+		state, err := machineProvider.State(vm, false)
 		if err != nil {
 			return nil, err
 		}
@@ -149,7 +149,7 @@ func hostInfo() (*entities.MachineHostInfo, error) {
 		}
 	}
 
-	host.VMType = provider.VMType().String()
+	host.VMType = machineProvider.VMType().String()
 
 	host.MachineImageDir = dirs.DataDir.GetPath()
 	host.MachineConfigDir = dirs.ConfigDir.GetPath()

cmd/podman/machine/init.go

@@ -6,12 +6,15 @@ import (
 	"errors"
 	"fmt"
 	"os"
+	"slices"
 
 	"github.com/containers/podman/v6/cmd/podman/registry"
 	ldefine "github.com/containers/podman/v6/libpod/define"
 	"github.com/containers/podman/v6/libpod/events"
 	"github.com/containers/podman/v6/pkg/machine/define"
+	"github.com/containers/podman/v6/pkg/machine/provider"
 	"github.com/containers/podman/v6/pkg/machine/shim"
+	"github.com/containers/podman/v6/pkg/machine/vmconfigs"
 	"github.com/shirou/gopsutil/v4/mem"
 	"github.com/sirupsen/logrus"
 	"github.com/spf13/cobra"
@@ -36,6 +39,7 @@ var (
 	initOptionalFlags  = InitOptionalFlags{}
 	defaultMachineName = define.DefaultMachineName
 	now                bool
+	providerOverride   string
 )
 
 // Flags which have a meaning when unspecified that differs from the flag default
@@ -158,6 +162,10 @@ func init() {
 
 	flags.BoolVar(&initOptionalFlags.tlsVerify, "tls-verify", true,
 		"Require HTTPS and verify certificates when contacting registries")
+
+	providerFlagName := "provider"
+	flags.StringVar(&providerOverride, providerFlagName, "", "Override the default machine provider")
+	_ = initCmd.RegisterFlagCompletionFunc(providerFlagName, autocompleteMachineProvider)
 }
 
 func initMachine(cmd *cobra.Command, args []string) error {
@@ -173,6 +181,21 @@ func initMachine(cmd *cobra.Command, args []string) error {
 		}
 	}
 
+	// If the provider option was given, we need to override the
+	// current provider
+	if cmd.Flags().Changed("provider") {
+		// var found bool
+		indexFunc := func(s vmconfigs.VMProvider) bool {
+			return s.VMType().String() == providerOverride
+		}
+		providers := provider.GetAll()
+		indexVal := slices.IndexFunc(providers, indexFunc)
+		if indexVal == -1 {
+			return fmt.Errorf("unsupported provider %q", providerOverride)
+		}
+		machineProvider = providers[indexVal]
+	}
+
 	// The vmtype names need to be reserved and cannot be used for podman machine names
 	if _, err := define.ParseVMType(initOpts.Name, define.UnknownVirt); err == nil {
 		return fmt.Errorf("cannot use %q for a machine name", initOpts.Name)
@@ -251,7 +274,7 @@ func initMachine(cmd *cobra.Command, args []string) error {
 	// 	return err
 	// }
 
-	err = shim.Init(initOpts, provider)
+	err = shim.Init(initOpts, machineProvider)
 	if err != nil {
 		// The installation is partially complete and podman should
 		// exit gracefully with no error and no success message.

cmd/podman/machine/inspect.go

@@ -60,7 +60,7 @@ func inspect(cmd *cobra.Command, args []string) error {
 			continue
 		}
 
-		dirs, err := env.GetMachineDirs(provider.VMType())
+		dirs, err := env.GetMachineDirs(machineProvider.VMType())
 		if err != nil {
 			return err
 		}

cmd/podman/machine/machine.go

@@ -41,10 +41,7 @@ var (
 	}
 )
 
-var (
-	// TODO This needs to be deleted!
-	provider vmconfigs.VMProvider
-)
+var machineProvider vmconfigs.VMProvider
 
 func init() {
 	registry.Commands = append(registry.Commands, registry.CliCommand{
@@ -54,7 +51,7 @@ func init() {
 
 func machinePreRunE(c *cobra.Command, args []string) error {
 	var err error
-	provider, err = provider2.Get()
+	machineProvider, err = provider2.Get()
 	if err != nil {
 		return err
 	}
@@ -104,6 +101,14 @@ func autocompleteMachine(_ *cobra.Command, args []string, toComplete string) ([]
 	return nil, cobra.ShellCompDirectiveNoFileComp
 }
 
+func autocompleteMachineProvider(_ *cobra.Command, _ []string, _ string) ([]string, cobra.ShellCompDirective) {
+	suggestions := make([]string, 0)
+	for _, p := range provider2.GetAll() {
+		suggestions = append(suggestions, p.VMType().String())
+	}
+	return suggestions, cobra.ShellCompDirectiveNoFileComp
+}
+
 func getMachines(toComplete string) ([]string, cobra.ShellCompDirective) {
 	suggestions := []string{}
 	provider, err := provider2.Get()

docs/source/markdown/podman-machine-init.1.md.in

@@ -96,6 +96,12 @@ Add the provided Ansible playbook to the machine and execute it after the first
 Note: The playbook will be executed with the same privileges given to the user in the virtual machine. The playbook provided cannot include other files from the host system, as they will not be copied.
 Use of the `--playbook` flag will require the image to include Ansible. The default image provided will have Ansible included.
 
+
+#### **--provider**
+
+Specify the provider for the machine to be created.  This allows users to override the default provider on platforms
+that have multiple providers.
+
 #### **--rootful**
 
 Whether this machine prefers rootful (`true`) or rootless (`false`)
@@ -237,6 +243,11 @@ Initialize the default Podman machine with a usb device passthrough with specifi
 $ podman machine init --usb bus=1,devnum=3
 ```
 
+Initialize a machine on different provider than the default
+```
+$ podman machine init --provider applehv
+```
+
 ## SEE ALSO
 **[podman(1)](podman.1.md)**, **[podman-machine(1)](podman-machine.1.md)**, **containers.conf(5)**
 

docs/source/markdown/podman-machine.1.md

@@ -22,6 +22,17 @@ environment variable while the machines are running can lead to unexpected behav
 
 Podman machine behaviour can be modified via the [machine] section in the containers.conf(5) file.
 
+Podman is based on virtual machine providers. The following table describes which providers are
+supported by platform.  The asterisk denotes the default provider for the platform.
+
+| Platform | Provider |
+| --------  |----------|
+| Linux | qemu*    |
+| MacOS | libkrun* |
+| MacOS | applehv  |
+| Windows | wsl*     |
+| Windows | hyperv   |
+
 ## SUBCOMMANDS
 
 | Command | Man Page                                                 | Description                                                     |

pkg/machine/e2e/config_darwin_test.go

@@ -1,14 +1,3 @@
 package e2e_test
 
-import "github.com/containers/podman/v6/pkg/machine/define"
-
 const podmanBinary = "../../../bin/darwin/podman"
-
-func getOtherProvider() string {
-	if isVmtype(define.AppleHvVirt) {
-		return "libkrun"
-	} else if isVmtype(define.LibKrun) {
-		return "applehv"
-	}
-	return ""
-}

pkg/machine/e2e/config_freebsd_test.go

@@ -1,7 +1,3 @@
 package e2e_test
 
 const podmanBinary = "../../../bin/podman-remote"
-
-func getOtherProvider() string {
-	return ""
-}

pkg/machine/e2e/config_init_test.go

@@ -10,22 +10,8 @@ import (
 )
 
 type initMachine struct {
-	/*
-	      --cpus uint              Number of CPUs (default 1)
-	      --disk-size uint         Disk size in GiB (default 100)
-	      --ignition-path string   Path to ignition file
-	      --username string        Username of the remote user (default "core" for FCOS, "user" for Fedora)
-	      --image-path string      Path to bootable image (default "testing")
-	  -m, --memory uint            Memory in MiB (default 2048)
-	      --now                    Start machine now
-	      --rootful                Whether this machine should prefer rootful container execution
-	      --playbook string        Run an ansible playbook after first boot
-	      --tls-verify             Require HTTPS and verify certificates when contacting registries
-	      --timezone string        Set timezone (default "local")
-	  -v, --volume stringArray     Volumes to mount, source:target
-	      --volume-driver string   Optional volume driver
-	*/
 	playbook           string
+	provider           string
 	cpus               *uint
 	diskSize           *uint
 	swap               *uint
@@ -80,6 +66,9 @@ func (i *initMachine) buildCmd(m *machineTestBuilder) []string {
 	if l := len(i.playbook); l > 0 {
 		cmd = append(cmd, "--playbook", i.playbook)
 	}
+	if l := len(i.provider); l > 0 {
+		cmd = append(cmd, "--provider", i.provider)
+	}
 	if i.userModeNetworking {
 		cmd = append(cmd, "--user-mode-networking")
 	}
@@ -176,6 +165,11 @@ func (i *initMachine) withRunPlaybook(p string) *initMachine {
 	return i
 }
 
+func (i *initMachine) withProvider(p string) *initMachine {
+	i.provider = p
+	return i
+}
+
 func (i *initMachine) withTlsVerify(tlsVerify *bool) *initMachine {
 	i.tlsVerify = tlsVerify
 	return i

pkg/machine/e2e/config_linux_test.go

@@ -1,7 +1,3 @@
 package e2e_test
 
 const podmanBinary = "../../../bin/podman-remote"
-
-func getOtherProvider() string {
-	return ""
-}