hypershift-powervs-provider
当您需要使用适当的处理器配置和资源管理在IBM Cloud PowerVS上部署HyperShift集群时使用此技能
📖 中文导读:当您需要使用适当的处理器配置和资源管理在IBM Cloud PowerVS上部署HyperShift集群时使用此技能 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
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:
IBM Cloud Authentication
🔹 **IBM Cloud API Key**: Configure IBM Cloud authentication - Set IBMCLOUD_API_KEY environment variable, OR - Provide IBMCLOUD_CREDENTIALS file pathResource Group
🔹 **Resource Group**: IBM Cloud resource group name? - Must exist in your IBM Cloud account - Example: default, hypershift-rgRegion 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.