Red Hat build of MicroShift

Access the MicroShift node remotely

Access the MicroShift service from a remote location by using a kubeconfig file.

The user@workstation login is used to access the host machine remotely. The <user> value in the procedure is the name of the user that user@workstation logs in with to the MicroShift host.

Prerequisites

You installed the OpenShift CLI (oc).
The user@microshift has opened the firewall from the local host.
You generated additional kubeconfig files.

Procedure

As user@workstation, create a ~/.kube/ folder if your Red Hat Enterprise Linux (RHEL) machine does not have one by running the following command:
```
[user@workstation]$ mkdir -p ~/.kube/
```
As user@workstation, set a variable for the hostname of your MicroShift host by running the following command:
```
[user@workstation]$ MICROSHIFT_MACHINE=<microshift_hostname>
```
Replace the value, <MicroShift_hostname>, with the either the name or the IP address of the host running {microshift}.
As user@workstation, copy the generated kubeconfig file that has the hostname or IP address you want to connect to from the RHEL machine running MicroShift to your local machine by running the following command:
```
[user@workstation]$ ssh <user>@$MICROSHIFT_MACHINE "sudo cat /var/lib/microshift/resources/kubeadmin/$MICROSHIFT_MACHINE/kubeconfig" > ~/.kube/config #
```
Replace <user> with your SSH login credentials.
As user@workstation, update the permissions on your ~/.kube/config file by running the following command:
```
$ chmod go-r ~/.kube/config
```

Verification

As user@workstation, verify that MicroShift is running by entering the following command:

$ oc get pods -A

Example output

NAMESPACE                   NAME                                                     READY   STATUS   RESTARTS  AGE
default                     i-06166fbb376f14a8bus-west-2computeinternal-debug-qtwcr  1/1     Running  0		    46m
kube-system                 csi-snapshot-controller-5c6586d546-lprv4                 1/1     Running  0		    51m
openshift-dns               dns-default-45jl7                                        2/2     Running  0		    50m
openshift-dns               node-resolver-7wmzf                                      1/1     Running  0		    51m
openshift-ingress           router-default-78b86fbf9d-qvj9s                          1/1     Running  0		    51m
openshift-ovn-kubernetes    ovnkube-master-5rfhh                                     4/4     Running  0		    51m
openshift-ovn-kubernetes    ovnkube-node-gcnt6                                       1/1     Running  0		    51m
openshift-service-ca        service-ca-bf5b7c9f8-pn6rk                               1/1     Running  0		    51m
openshift-storage           topolvm-controller-549f7fbdd5-7vrmv                      5/5     Running  0		    51m
openshift-storage           topolvm-node-rht2m                                       3/3     Running  0		    50m

This example output shows a basic MicroShift installation. If you installed optional RPMs, the status of pods running those services is displayed in the output.