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

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

2. Resource Group

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

3. Region Configuration

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

4. 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