skills.rest
openshift
openshiftCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

Create HC AWS

Creates a HyperShift HostedCluster on AWS for development and testing workflows.

538|560|Updated Jan 18, 2021
Search Tags:#AWS#hypershift#openShift#control plane#cluster provisioning#devOps#hostedcluster
One-click install
npx skills add https://github.com/openshift/hypershift --skill create-hc-aws
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Create HC AWS
Source: https://github.com/openshift/hypershift/tree/main/.claude/skills/dev/create-hc-aws
Command: npx skills add https://github.com/openshift/hypershift --skill create-hc-aws

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up a HyperShift HostedCluster on AWS requires assembling many parameters, credentials, and environment variables correctly; this Skill standardizes that process so developers can spin up dev/test clusters without memorizing the hypershift CLI syntax.

Core Features & Use Cases

  • HostedCluster Provisioning: Runs hypershift create cluster aws with the correct credentials, region, base domain, pull secret, and release image to create a full cluster including VPC, subnets, Route53 zones, OIDC provider, and IAM roles.
  • Custom Image Testing: Supports overriding the control plane operator image via --control-plane-operator-image so developers can validate CPO or HO code changes against a live cluster.
  • Post-Creation Guidance: Provides commands to check HostedCluster status, wait for control plane availability, scale NodePools, and retrieve the guest cluster kubeconfig.
  • Use Case: A HyperShift developer iterating on control plane operator changes builds a custom CPO image, then uses this Skill to create a test cluster with that image and verify the changes end to end.

Quick Start

Ask the assistant to create a HyperShift HostedCluster on AWS named my-test-cluster with two node pool replicas using the configured environment.

Frequently Asked Questions about Create HC AWS

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a HyperShift HostedCluster on AWS?▼

Source your AWS credentials and run `hypershift create cluster aws` with the cluster name, base domain, AWS credentials file, pull secret, region, and release image. Set KUBECONFIG to your management cluster before running the command.

How to test a custom control plane operator image with HyperShift?▼

Pass the `--control-plane-operator-image` flag with your custom image repository and tag when creating the cluster. This deploys the HostedCluster using your CPO build instead of the default release image.

What prerequisites are needed for hypershift create cluster aws?▼

You need valid AWS credentials, a kubeconfig pointing to the management cluster, a built hypershift binary, a pull secret, and a base domain hosted in Route53. Environment variables are typically loaded from dev/claude-env.sh.

Why is my HostedCluster control plane not becoming available?▼

Check the hosted control plane pods with `kubectl get pods -n clusters-<CLUSTER_NAME>` and inspect conditions via `kubectl get hcp -n clusters-<CLUSTER_NAME> -o yaml`. Common causes include invalid AWS credentials, missing Route53 base domain, or inaccessible OIDC S3 bucket.

How do I get the kubeconfig for a HyperShift guest cluster?▼

Retrieve the admin kubeconfig secret with `kubectl get secret <CLUSTER_NAME>-admin-kubeconfig -n clusters -o jsonpath='{.data.kubeconfig}'` against the management cluster, then base64-decode it into a file.

When should I not use this cluster creation workflow?▼

This workflow is intended for local development and testing only, not production use. For production clusters or other platforms like Azure or bare metal, use the appropriate hypershift create command variant for that provider.

Related Skills

Explore More Software Engineering Skills→
kagentikagenti
292

hypershift:preflight

Validate AWS, OpenShift, and HyperShift prerequisites before cluster provisioning.

Official
Intermediate
rh-ai-quickstartrh-ai-quickstart
8

teardown-rosa-aws

Tear down a ROSA HCP cluster on AWS and remove leftover infrastructure.

Official
Advanced
openshiftopenshift
536

Debug Cluster

Automate debugging workflows for HyperShift hosted clusters using kubectl and operator logs.

Community
Advanced
openshift-engopenshift-eng
112

HyperShift Agent Provider

Generate HyperShift cluster deployment plans for bare metal, edge, and disconnected environments.

Community
Advanced