hypershift

name	hypershift
description	Manage HyperShift clusters on AWS for Rossoctl testing. Create, destroy, debug clusters and check quotas.

flowchart LR
    SETUP["hypershift:setup"]:::hs --> PRE["hypershift:preflight"]:::hs
    PRE --> QUOTAS["hypershift:quotas"]:::hs
    QUOTAS --> CREATE["hypershift:cluster"]:::hs
    CREATE --> USE([Use cluster])
    USE --> DESTROY["hypershift:cluster destroy"]:::hs
    CREATE -.->|fails| DEBUG["hypershift:debug"]:::hs
    DESTROY -.->|stuck| DEBUG

    classDef hs fill:#3F51B5,stroke:#333,color:white

Follow this diagram as the workflow.

HyperShift Skills

Skills for managing HyperShift (hosted OpenShift) clusters on AWS.

Available Sub-Skills

Skill	Description
hypershift:cluster	Create and destroy HyperShift clusters
hypershift:debug	Debug AWS resources for stuck clusters
hypershift:quotas	Check AWS service quotas and usage
hypershift:setup	Setup local environment for HyperShift
hypershift:preflight	Run pre-flight checks before setup

Quick Start

# 1. Stay in main repo (run worktree scripts from here)
cd /Users/ladas/Projects/OCTO/rossoctl/rossoctl

# 2. Source credentials env file
source .env.rossoctl-hypershift-custom

# 3. Create cluster, deploy Rossoctl, run E2E tests (all-in-one)
# Cluster name: max 5 chars (AWS IAM limit)
./.github/scripts/local-setup/hypershift-full-test.sh pr529 --skip-cluster-destroy

# 4. Destroy cluster when done
./.github/scripts/local-setup/hypershift-full-test.sh pr529 --include-cluster-destroy

Testing a Worktree Branch

# Run from main repo, execute worktree's scripts
source .env.rossoctl-hypershift-custom

# Example: test ui-agent-discovery branch (name max 5 chars)
.worktrees/ui-agent-discovery/.github/scripts/local-setup/hypershift-full-test.sh uitst --skip-cluster-destroy

# Destroy when done
.worktrees/ui-agent-discovery/.github/scripts/local-setup/hypershift-full-test.sh uitst --include-cluster-destroy

First-Time Setup (credentials)

# Run preflight check
./.github/scripts/hypershift/preflight-check.sh

# Setup credentials (requires IAM admin)
./.github/scripts/hypershift/setup-hypershift-ci-credentials.sh

# Setup local tools
./.github/scripts/hypershift/local-setup.sh

Prerequisites

• AWS CLI with admin credentials
• OpenShift CLI (oc) logged into management cluster
• Ansible (pip install ansible-core)

Related Documentation

• .github/scripts/local-setup/README.md - Local setup documentation
• docs/hypershift-hcp-research.md - HyperShift research and architecture