Skip to main content

Command Line Interface (CLI)

Okustera supports terminal infrastructure management using the standard OpenStack Unified CLI ecosystem (openstack command suite). A dedicated standalone okustera / omc developer CLI is also on the active platform roadmap.

Setting up OpenStack CLI​

The OpenStack Unified CLI suite provides direct terminal orchestration for compute (Nova), networking (Neutron), block storage (Cinder), and Kubernetes clusters (Magnum).

1. Installation​

# Using pip / pipx
pip install python-openstackclient python-magnumclient python-cinderclient

2. Authentication with openrc.sh​

Download your environment configuration file from the Okustera Cloud Portal or create okustera.env:

export OS_AUTH_URL="https://iam.okustera.com:5000/v3"
export OS_PROJECT_ID="tenant-production"
export OS_PROJECT_NAME="production"
export OS_USER_DOMAIN_NAME="Default"
export OS_PROJECT_DOMAIN_ID="default"
export OS_USERNAME="<USERNAME>"
export OS_PASSWORD="<PASSWORD>"
export OS_REGION_NAME="RegionOne"
export OS_INTERFACE="public"
export OS_IDENTITY_API_VERSION=3

Source the file:

source okustera.env

Common CLI Operations​

Compute Instances​

# List instances
openstack server list

# Reboot an instance
openstack server reboot web-server-01

Managed Kubernetes Clusters​

# List clusters
openstack coe cluster list

# Show cluster details
openstack coe cluster show production-cluster

# Upgrade cluster to target template
openstack coe cluster upgrade production-cluster <new-template-id>

Block Storage​

# List volumes
openstack volume list

# Create a 50GB NVMe volume
openstack volume create --size 50 --type ceph-nvme my-volume