Function runQEMUShell

internal/cli/guests.go:738–768

(_ *cobra.Command, session *cliSession, vm *api.VM)

}

func runQEMUShell(_ *cobra.Command, session *cliSession, vm *api.VM) error {
	if vm.IP == "" {
		return printError(fmt.Errorf(
			"no IP address available for VM %d (%s); ensure QEMU guest agent is running and the VM has network connectivity",
			vm.ID, vm.Name,
		))
	}

	vmSSHUser := session.resolveVMSSHUser(vm)
	if vmSSHUser == "" {
		return printError(fmt.Errorf("VM SSH user not configured; set vm_ssh_user (or ssh_user) in config or use --vm-ssh-user"))
	}

	keyfile := session.resolveVMSSHKeyfile(vm)

	_, jumpHost := session.resolveNodeSSHCreds(&api.Node{
		Name:          vm.Node,
		SourceProfile: vm.SourceProfile,
	})

	sshArgs := ssh.BuildSSHArgs(vmSSHUser, vm.IP, jumpHost)

	fmt.Fprintf(os.Stderr, "Connecting to QEMU VM %s (ID: %d) at %s as %s...\n",
		vm.Name, vm.ID, vm.IP, vmSSHUser)

	if err := execInteractiveShell(sshArgs, keyfile); err != nil {
		return printError(fmt.Errorf("SSH session ended with error: %w", err))
	}

	return nil
}

// ── guests create ────────────────────────────────────────────────────────────