Initial commit

2025-11-30 08:45:56 +08:00
commit 9fc59ddec1
11 changed files with 3200 additions and 0 deletions
--- a/skills/hcp-create-powervs/SKILL.md
+++ b/skills/hcp-create-powervs/SKILL.md
@@ -0,0 +1,146 @@
+---
+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**
+   ```
+   🔹 **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:**
+```bash
+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:**
+```bash
+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](https://cloud.ibm.com/docs/power-iaas)
+- [HyperShift PowerVS Provider](https://hypershift.openshift.io/how-to/powervs/)