OKS-CLI

🌐 Links

• 📘 OKS-CLI Documentation
• 📘 OKS API Reference
• 🐛 GitHub Issues

📄 Table of Contents

• Overview

• Requirements

• Installation

  • Standard Installation
  • User Installation

• Usage

  • Commands
  • Examples

• Development

  • Editable Mode
  • Project Structure
  • Dependencies

• Contributing

• License

• Support

🧭 Overview

OKS-CLI is a command-line interface that allows you to deploy and manage Kubernetes clusters on top of OUTSCALE infrastructure.

✅ Requirements

• Python 3.11 or later
• pip (Python package manager)
• kubectl (required for commands that interact with the Kubernetes API)

📦 Installation

Standard Installation

# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate

# Install the CLI
pip install oks-cli

# Check version of oks-cli
oks-cli version

🚀 Usage

Display all available commands:

oks-cli fullhelp

Commands

Examples

# List all projects
oks-cli project list

# Dry run project creation
oks-cli project create --project-name my-project --description "Test project" --dry-run

# Dry run cluster creation
oks-cli cluster create \
  --cluster-name my-cluster \
  --project-name my-project \
  --description "My test cluster" \
  --version "1.32" \
  --dry-run

# Set a default project profile
oks-cli project login --project-name my-project

🛠 Development

Editable Mode

Install the CLI in editable mode with development dependencies

# Clone the repository
git clone https://github.com/outscale/oks-cli.git
cd oks-cli

# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate

# CLI in editable mode
pip install -e ".[dev]"

Changes in the oks_cli/ directory will be immediately reflected without reinstalling.

Tests

Run the test suite using pytest to ensure code correctness and stability:

pytest

Project Structure

oks-cli/
├── oks_cli/              # Source code
│   ├── cache.py
│   ├── cluster.py
│   ├── main.py
│   ├── netpeering.py
│   ├── profile.py
│   ├── project.py
│   ├── quotas.py
│   └── utils.py
├── setup.py              # Packaging configuration
├── requirements.txt      # Dependencies
└── README.md             # Project documentation

Dependencies

Dependencies are managed via setup.py and requirements.txt.

To reinstall or update:

pip install -e .

🤝 Contributing

OKS-CLI is open source software licensed under BSD-3-Clause.

We welcome contributions! Please see CONTRIBUTING.md for guidelines and instructions.

📜 License

BSD-3-Clause © Outscale SAS

🆘 Support

• Official Documentation
• GitHub Issues