---

name: HyperShift PowerVS Provider 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:

1. IBM Cloud Authentication

   Copy🔹 **IBM Cloud API Key**: Configure IBM Cloud authentication
      - Set IBMCLOUD_API_KEY environment variable, OR
      - Provide IBMCLOUD_CREDENTIALS file path
   

2. Resource Group

   Copy🔹 **Resource Group**: IBM Cloud resource group name?
      - Must exist in your IBM Cloud account
      - Example: default, hypershift-rg
   

3. Region Configuration

   Copy🔹 **Region**: IBM Cloud region?
      [default: us-south]
   🔹 **Zone**: Availability zone?
      [default: us-south]
   

4. Processor Configuration

   Copy🔹 **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:

Copyhypershift 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:

Copyhypershift 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

CopyIBM 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

CopyResource 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

CopyZone "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