openshift-eng/hcp-create-powervs
plugins/hcp/skills/hcp-create-powervs/SKILL.md
Use this skill when you need to deploy HyperShift clusters on IBM Cloud PowerVS with proper processor configuration and resource management
$ install --global
skillsauthnpx skillsauth add openshift-eng/ai-helpers hcp-create-powervsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 21, 2026, 6:13 AM148.7s1 file scanned
SKILL.md
- name:
- hcp-create-powervs
- description:
- Use this skill when you need to deploy HyperShift clusters on IBM Cloud PowerVS with proper processor configuration and resource management
HyperShift PowerVS Provider
This skill provides implementation guidance for creating HyperShift clusters on IBM Cloud PowerVS, handling PowerVS-specific requirements including IBM Cloud API keys, processor types, and resource group management.
When to Use This Skill
This skill is automatically invoked by the /hcp:generate powervs command to guide the PowerVS provider cluster creation process.
Prerequisites
- IBM Cloud CLI configured with API key
- PowerVS service instance configured
- IBM Cloud resource group access
- HyperShift operator installed and configured
PowerVS Provider Overview
PowerVS Provider Peculiarities
- IBM Cloud specific: Requires IBM Cloud API key and resource group
- Different regions have different capabilities: Service availability varies by region
- Limited instance types: Fewer processor types compared to other clouds
- Network setup complex: Requires careful network planning
- Processor type selection: Shared, dedicated, or capped options
Implementation Steps
Step 1: Interactive Parameter Collection
Required Parameters:
-
IBM Cloud Authentication
🔹 **IBM Cloud API Key**: Configure IBM Cloud authentication - Set IBMCLOUD_API_KEY environment variable, OR - Provide IBMCLOUD_CREDENTIALS file path -
Resource Group
🔹 **Resource Group**: IBM Cloud resource group name? - Must exist in your IBM Cloud account - Example: default, hypershift-rg -
Region Configuration
🔹 **Region**: IBM Cloud region? [default: us-south] 🔹 **Zone**: Availability zone? [default: us-south] -
Processor Configuration
🔹 **Memory**: Memory allocation per instance? [default: 32GB] 🔹 **Processors**: Number of processors? [default: 0.5] 🔹 **Processor Type**: Processor type? - shared (default) - Shared processor pool - dedicated - Dedicated processors - capped - Capped shared processors
Step 2: Generate Command
Standard Configuration:
hypershift create cluster powervs \
--name powervs-cluster \
--namespace powervs-cluster-ns \
--region us-south \
--zone us-south \
--resource-group default \
--base-domain example.com \
--pull-secret /path/to/pull-secret.json \
--release-image quay.io/openshift-release-dev/ocp-release:4.18.0-multi \
--memory 32GB \
--processors 0.5 \
--proc-type shared \
--sys-type s922 \
--vpc-region us-south
High-Performance Configuration:
hypershift create cluster powervs \
--name powervs-prod \
--namespace powervs-prod-ns \
--region us-south \
--zone us-south \
--resource-group production-rg \
--base-domain clusters.company.com \
--pull-secret /path/to/pull-secret.json \
--release-image quay.io/openshift-release-dev/ocp-release:4.18.0-multi \
--memory 64GB \
--processors 2.0 \
--proc-type dedicated \
--sys-type s922 \
--vpc-region us-south
Error Handling
API Key Issues
IBM Cloud API key not configured or invalid.
Configure authentication:
export IBMCLOUD_API_KEY="your-api-key"
Or verify existing configuration:
ibmcloud auth list
Resource Group Not Found
Resource group "hypershift-rg" not found.
List available resource groups:
ibmcloud resource groups
Create new resource group:
ibmcloud resource group-create hypershift-rg
Region/Zone Issues
Zone "us-south-3" not available for PowerVS.
Available zones in us-south:
ibmcloud pi service-list
Choose appropriate zone for your region.
See Also
- IBM Cloud PowerVS Documentation
- HyperShift PowerVS Provider
Related Skills
openshift-eng/payload-snapshot
testing
VerifiedTrustedCommunity
Snapshot OpenShift payload data (release controller, PR diffs, comments, CI jobs, JUnit results, regression tracking) to a local directory for offline analysis
100SKILL.mdUpdated Jun 4, 2026
openshift-eng/status-analysis
research
VerifiedTrustedCommunity
Shared engine for analyzing Jira issue activity and generating status summaries
100SKILL.mdUpdated Apr 28, 2026
openshift-eng/setup-snowflake
tools
VerifiedTrustedCommunity
This skill should be used before any Snowflake command to verify MCP connectivity, guide users through access provisioning, and set the session context. Invoke this skill proactively whenever a command needs Snowflake data access.
99SKILL.mdUpdated Apr 28, 2026
openshift-eng/payload-analysis
development
VerifiedTrustedCommunity
Analyze a payload snapshot to identify root causes of blocking job failures, score candidate PRs, and produce an HTML report with revert recommendations
96SKILL.mdUpdated Jun 4, 2026