docs/doc/source/kube-virt/set-up-remote-management-of-vms-a082461d660e.rst
Joao Victor Portal 191b184763 Review K8s local and remote auth instructions (cherry pick to stx 9.0)
This change replaces the usage of Service Tokens by OIDC tokens in the
instructions of Kubernetes cluster local and remote access. Some other
changes were made, like the deletion of redundant pages.

Story: 2010738
Task: 49561

Change-Id: Ie8206ecd316efd356a5889899a68f9a9ddbcdfa6
Signed-off-by: Joao Victor Portal <Joao.VictorPortal@windriver.com>
2024-03-11 10:51:09 -03:00

55 lines
1.6 KiB
ReStructuredText

.. _set-up-remote-management-of-vms-a082461d660e:
===============================
Set up remote management of VMs
===============================
.. rubric:: |context|
Configure the ``kubectl``, ``virtctl`` and ``virt-viewer`` clients on a remote
workstation, in order to manage KubeVirt |VMs| remotely. Note that the
graphical console of a VM can only be accessed remotely from a workstation with
X Windows (e.g. graphical ubuntu desktop), kubectl, ``virtctl`` and
``virt-viewer`` installed.
.. rubric:: |prereq|
To configure kubectl and helm, you must have configured the **oidc-auth-apps**
|OIDC| Identity Provider (dex) on the target |prod| environment to get
Kubernetes authentication tokens. See :ref:`Set up OIDC Auth Applications
<configure-oidc-auth-applications>` for more information.
.. rubric:: |proc|
Configure kubectl and helm
==========================
.. include:: /shared/_includes/install-kubectl-and-helm-clients-directly-on-a-host-6383c5f2b484.rest
:start-after: begin-install-proc
:end-before: end-install-proc
Configure virtctl
=================
On the remote workstation, install virtctl client tool.
.. code-block::
$ export VERSION=v0.53.1
$ wget https://github.com/kubevirt/kubevirt/releases/download/${VERSION}/virtctl-${VERSION}-linux-amd64
$ chmod a+x ./virtctl-${VERSION}-linux-amd64
$ sudo cp ./virtctl-${VERSION}-linux-amd64 /usr/bin/virtctl
Configure virt-viewer
=====================
On the remote workstation, install virt-viewer in order to enable use of
graphical console.
.. code-block::
$ sudo apt -y install virt-viewer