oc clusterset plugin

The oc clusterset plugin manages logins for clusterset.

Typical use case is to log in to the hub and managed clusters when working with ACM managed clusters.

Requirements

• oc - OpenShift Command Line Interface (CLI)

Installing

Download the executable for your operating system and architecture and install in the PATH.

Example for GNU/Linux on X86_64, installing in /usr/local/bin:

curl -L -o oc-clusterset https://github.com/nirs/oc-clusterset/releases/download/v0.1.0/oc-clusterset-v0.1.0-linux-amd64
sudo install oc-clusterset /usr/local/bin
rm oc-clusterset

Shell completion

To enable shell completion install the oc_complete-clusterset script in the PATH.

curl -L -O https://raw.githubusercontent.com/nirs/oc-clusterset/main/oc_complete-clusterset
sudo install oc_complete-clusterset /usr/local/bin
rm oc_complete-clusterset

Clusterset configuration

To use this tool, prepare a yaml file with the cluster details:

$ cat config.yaml
clusters:
  - name: hub
    url: cluster1.example.com:8443
    username: kubeadmin
    password: PeSkM-R6YcH-LyPZa-oTOO1
  - name: c1
    url: cluster2.example.com:8443
    username: kubeadmin
    password: ZjIZn-SFUyR-aE4gI-fJcfL
  - name: c2
    url: cluster3.example.com:8443
    username: kubeadmin
    password: 7C700-oVS3Q-25rtx-YMew5
current-context: hub

Log in to cluterset

To login to all clusters in config.yaml:

oc clusterset login --config config.yaml

Log out from cluterset

To log out from all clusters in config.yaml:

oc clusterset logout --config config.yaml

License

oc-clusterset is released under the Apache 2.0 license. See LICENSE