Cloud Command Line Tools in Aletyx Enterprise Build of Kogito and Drools 10.1.0-aletyx

Kubernetes CLI (Kubectl)

MacOS
Linux
Microsoft Windows

Using Homebrew (recommended):
brew install kubectl

Manual installation:

Download kubectl
curl -LO "https://dl.k8s.io/release/v1.29.2/bin/darwin/arm64/kubectl"

Make kubectl executable
chmod +x ./kubectl

Move kubectl to a directory in your PATH

sudo mv ./kubectl /usr/local/bin/kubectl

Using package manager (Ubuntu/Debian):

# Add Kubernetes apt repository
sudo apt-get update
sudo apt-get install -y apt-transport-https ca-certificates curl
curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.29/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg
echo 'deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.29/deb/ /' | sudo tee /etc/apt/sources.list.d/kubernetes.list
sudo apt-get update
sudo apt-get install -y kubectl

Manual installation:

# Download kubectl
curl -LO "https://dl.k8s.io/release/v1.29.2/bin/linux/amd64/kubectl"

Make kubectl executable

chmod +x ./kubectl

Move kubectl to a directory in your PATH

sudo mv ./kubectl /usr/local/bin/kubectl

Using Chocolatey® (recommended):
choco install kubernetes-cli

Manual installation:

# Create directory for kubectl
New-Item -Path 'C:\Program Files\kubectl' -Type Directory

Download kubectl

curl.exe -LO "https://dl.k8s.io/release/v1.29.2/bin/windows/amd64/kubectl.exe"

Move kubectl to the created directory

Move-Item .\kubectl.exe 'C:\Program Files\kubectl\'

Add to PATH

$env:Path += ";C:\Program Files\kubectl"
[Environment]::SetEnvironmentVariable(
    "Path",
    [Environment]::GetEnvironmentVariable("Path", [System.EnvironmentVariableTarget]::Machine) + ";C:\Program Files\kubectl",
    [System.EnvironmentVariableTarget]::Machine)

Red Hat OpenShift® CLI (oc)

Windows
macOS
Linux

Using web console:
- Log into your OpenShift web console
- Click ? icon in the top right
- Select “Command Line Tools”
- Download Windows oc client
- Extract the archive

Create directory for OpenShift CLI

New-Item -Path 'C:\Program Files\OpenShift' -Type Directory

Move oc.exe to the created directory

Move-Item .\oc.exe 'C:\Program Files\OpenShift\'

Add to PATH

$env:Path += ";C:\Program Files\OpenShift"
[Environment]::SetEnvironmentVariable(
"Path",
[Environment]::GetEnvironmentVariable("Path", [System.EnvironmentVariableTarget]::Machine) + ";C:\Program Files\OpenShift",
[System.EnvironmentVariableTarget]::Machine)

Using Homebrew:
brew install openshift-cli

Manual installation:

Log into your OpenShift web console
Click ? icon in the top right
Select “Command Line Tools”
Download macOS oc client

Extract the downloaded archive

# Extract the downloaded archive
tar xvf oc.tar.gz

# Make oc executable
chmod +x ./oc

# Move to a directory in your PATH
sudo mv ./oc /usr/local/bin/oc

Manual installation:

Log into your OpenShift web console
Click ? icon in the top right
Select “Command Line Tools”
Download Linux oc client
Extract the downloaded archive

# Extract the downloaded archive
tar xvf oc.tar.gz

# Make oc executable
chmod +x ./oc

# Move to a directory in your PATH
sudo mv ./oc /usr/local/bin/oc

Verification and Configuration

Verify the installations:

# Verify kubectl
kubectl version --client

# Verify oc
oc version --client

kubectl Configuration

# Create kubectl config directory if it doesn't exist
mkdir -p ~/.kube

# Set KUBECONFIG environment variable
export KUBECONFIG=~/.kube/config

# Login to OpenShift cluster
oc login --token=<token> --server=https://api.cluster-url:6443

# View available projects
oc projects

# Switch to a specific project
oc project <project-name>

Store your OpenShift login token securely. You can get a new token from the OpenShift web console under your profile → Copy login command.

Shell Completion

Bash
Zsh
PowerShell

# kubectl completion
echo 'source <(kubectl completion bash)' >>~/.bashrc

# oc completion
echo 'source <(oc completion bash)' >>~/.bashrc

# kubectl completion
echo '[[$commands[kubectl]]] && source <(kubectl completion zsh)' >>~/.zshrc

# oc completion
echo '[[ $commands[oc] ]] && source <(oc completion zsh)' >>~/.zshrc

# kubectl completion
kubectl completion powershell | Out-String | Invoke-Expression

# oc completion
oc completion powershell | Out-String | Invoke-Expression

Common Issues and Troubleshooting

If you’re behind a corporate proxy, you might need to configure proxy settings for both kubectl and oc.

Common troubleshooting steps:

# Check kubectl context
kubectl config current-context

# Check oc login status
oc whoami

# View cluster info
kubectl cluster-info
oc cluster-info

# Check connection to cluster
kubectl get nodes
oc get nodes

Keep your CLI tools up to date with the cluster version to avoid compatibility issues. You can check the required versions in your cluster’s documentation.

Home

Get started

AI Assistant

Core Concepts

Guides

Platform

Deployment

Decision Control

Decision Control Tower

Drools

KIE Server

Reference

FAQ

Cloud Command Line Tools in Aletyx Enterprise Build of Kogito and Drools 10.1.0-aletyx

Kubernetes CLI (Kubectl)

Red Hat OpenShift® CLI (oc)

Verification and Configuration

kubectl Configuration

Shell Completion

Common Issues and Troubleshooting

​Kubernetes CLI (Kubectl)

​Red Hat OpenShift® CLI (oc)

​Verification and Configuration

​kubectl Configuration

​Red Hat OpenShift Login

​Shell Completion

​Common Issues and Troubleshooting

Kubernetes CLI (Kubectl)

Red Hat OpenShift® CLI (oc)

Verification and Configuration

kubectl Configuration

Red Hat OpenShift Login

Shell Completion

Common Issues and Troubleshooting