Configuring SSH access to virtual machines

Navigate to Virtualization → Catalog in the web console.

Click a template tile.

Click Customize VirtualMachine.

Click Next.

Click the Scripts tab.

If you have not already added a public SSH key to your project, click the edit icon beside Authorized SSH key and select one of the following options:

Click Save.

Click Create VirtualMachine.

In the web console, navigate to Virtualization → Catalog.

Select either of the following options:

Optional: If you are creating a Windows VM, you can mount a Windows driver disk:

Optional: Click View YAML & CLI to view the YAML file. Click CLI to view the CLI commands. You can also download or copy either the YAML file contents or the CLI commands.

Click Create VirtualMachine.

Create a manifest file for a VirtualMachine object and a secret object:

apiVersion: kubevirt.io/v1
kind: VirtualMachine
metadata:
  name: example-vm
  namespace: example-namespace
spec:
  dataVolumeTemplates:
    - metadata:
        name: example-vm-volume
      spec:
        sourceRef:
          kind: DataSource
          name: rhel9
          namespace: openshift-virtualization-os-images
        storage:
          resources: {}
  instancetype:
    name: u1.medium
  preference:
    name: rhel.9
  running: true
  template:
    spec:
      domain:
        devices: {}
      volumes:
        - dataVolume:
            name: example-vm-volume
          name: rootdisk
        - cloudInitNoCloud: (1)
            userData: |-
              #cloud-config
              user: cloud-user
          name: cloudinitdisk
      accessCredentials:
        - sshPublicKey:
            propagationMethod:
              noCloud: {}
            source:
              secret:
                secretName: authorized-keys (2)
---
apiVersion: v1
kind: secret
metadata:
  name: authorized-keys
data:
  key: c3NoLXJzYSB... (3)

Create the VirtualMachine and secret objects by running the following command:

$ oc create -f <manifest_file>.yaml

Start the VM by running the following command:

$ virtctl start vm example-vm -n example-namespace

Navigate to Virtualization → Catalog in the web console.

Click the Red Hat Enterprise Linux 9 VM tile.

Click Customize VirtualMachine.

Click Next.

Click the Scripts tab.

If you have not already added a public SSH key to your project, click the edit icon beside Authorized SSH key and select one of the following options:

Set Dynamic SSH key injection to on.

Click Save.

Click Create VirtualMachine.

In the web console, navigate to Virtualization → Catalog.

Select either of the following options:

Click the Red Hat Enterprise Linux 9 VM tile.

Set Dynamic SSH key injection in the VirtualMachine details section to on.

Optional: If you are creating a Windows VM, you can mount a Windows driver disk:

Optional: Click View YAML & CLI to view the YAML file. Click CLI to view the CLI commands. You can also download or copy either the YAML file contents or the CLI commands.

Click Create VirtualMachine.

Navigate to Virtualization → VirtualMachines in the web console.

Select a VM to open the VirtualMachine details page.

On the Configuration tab, click Scripts.

If you have not already added a public SSH key to your project, click the edit icon beside Authorized SSH key and select one of the following options:

Set Dynamic SSH key injection to on.

Click Save.

Create a manifest file for a VirtualMachine object and a secret object:

apiVersion: kubevirt.io/v1
kind: VirtualMachine
metadata:
  name: example-vm
  namespace: example-namespace
spec:
  dataVolumeTemplates:
    - metadata:
        name: example-vm-volume
      spec:
        sourceRef:
          kind: DataSource
          name: rhel9
          namespace: openshift-virtualization-os-images
        storage:
          resources: {}
  instancetype:
    name: u1.medium
  preference:
    name: rhel.9
  running: true
  template:
    spec:
      domain:
        devices: {}
      volumes:
        - dataVolume:
            name: example-vm-volume
          name: rootdisk
        - cloudInitNoCloud: (1)
            userData: |-
              #cloud-config
              runcmd:
              - [ setsebool, -P, virt_qemu_ga_manage_ssh, on ]
          name: cloudinitdisk
      accessCredentials:
        - sshPublicKey:
            propagationMethod:
              qemuGuestAgent:
                users: ["cloud-user"]
            source:
              secret:
                secretName: authorized-keys (2)
---
apiVersion: v1
kind: secret
metadata:
  name: authorized-keys
data:
  key: c3NoLXJzYSB... (3)

Create the VirtualMachine and secret objects by running the following command:

$ oc create -f <manifest_file>.yaml

Start the VM by running the following command:

$ virtctl start vm example-vm -n example-namespace

Navigate to Virtualization → Overview.

On the Settings tab, click Cluster.

Expand General settings and SSH configuration.

Set SSH over LoadBalancer service to on.

Navigate to VirtualMachines and select a virtual machine to view the VirtualMachine details page.

On the Details tab, select SSH over LoadBalancer from the SSH service type list.

Optional: Click the copy icon to copy the SSH command to your clipboard.

Edit the VirtualMachine manifest to add the label for service creation:

apiVersion: kubevirt.io/v1
kind: VirtualMachine
metadata:
  name: example-vm
  namespace: example-namespace
spec:
  running: false
  template:
    metadata:
      labels:
        special: key (1)
# ...

Save the VirtualMachine manifest file to apply your changes.

Create a Service manifest to expose the VM:

apiVersion: v1
kind: Service
metadata:
  name: example-service
  namespace: example-namespace
spec:
# ...
  selector:
    special: key (1)
  type: NodePort (2)
  ports: (3)
    protocol: TCP
    port: 80
    targetPort: 9376
    nodePort: 30000

Save the Service manifest file.

Create the service by running the following command:

$ oc create -f example-service.yaml

Restart the VM to apply the changes.