Configuring the OpenShift CLI¶

You can customize your command-line environment after installing the OpenShift CLI (oc).

Enabling tab completion¶

You can enable tab completion for the Bash or Zsh shells.

Enabling tab completion for Bash¶

After you install the OpenShift CLI (oc), you can enable tab completion to automatically complete oc commands or suggest options when you press Tab. The following procedure enables tab completion for the Bash shell.

Prerequisites

You must have the OpenShift CLI (oc) installed.
You must have the package bash-completion installed.

Procedure

Save the Bash completion code to a file:

$ oc completion bash > oc_bash_completion

Copy the file to /etc/bash_completion.d/:
```
$ sudo cp oc_bash_completion /etc/bash_completion.d/
```
You can also save the file to a local directory and source it from your .bashrc file instead. Tab completion is enabled when you open a new terminal.

Enabling tab completion for Zsh¶

After you install the OpenShift CLI (oc), you can enable tab completion to automatically complete oc commands or suggest options when you press Tab. The following procedure enables tab completion for the Zsh shell.

Prerequisites

You must have the OpenShift CLI (oc) installed.

Procedure

To add tab completion for oc to your .zshrc file, run the following command:

$ cat >>~/.zshrc<<EOF
autoload -Uz compinit
compinit
if [ $commands[oc] ]; then
  source <(oc completion zsh)
  compdef _oc oc
fi
EOF

Tab completion is enabled when you open a new terminal.

Accessing kubeconfig by using the oc CLI¶

You can use the oc CLI to log in to your OpenShift cluster and retrieve a kubeconfig file for accessing the cluster from the command line.

Warning

If you plan to reuse the exported kubeconfig file across sessions or machines, store it securely and avoid committing it to source control.

Prerequisites

You have access to the OpenShift Container Platform web console or API server endpoint.

Procedure

Log in to your OpenShift cluster by running the following command:
```
$ oc login <api_server_url> -u <username> -p <password>
```
where:

<api_server_url>

Specifies the full API server URL; for example, https://api.my-cluster.example.com:6443.

<username>

Specifies a valid username; for example, kubeadmin.

<password>

Specifies the password for the specified user; for example, the kubeadmin password generated during cluster installation.
Save the cluster configuration to a local file by running the following command:
```
$ oc config view --raw > kubeconfig
```
Set the KUBECONFIG environment variable to point to the exported file by running the following command:
```
$ export KUBECONFIG=./kubeconfig
```
Use oc to interact with your OpenShift cluster by running the following command:
```
$ oc get nodes
```