# alibabacloud-nginx-ingress-to-api-gateway

alibabacloud-nginx-ingress-to-api-gateway migrates Kubernetes nginx Ingress to Alibaba Cloud API Gateway. Analyzes YAML locally, classifies annotations, generates Higress config and migration report.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 152 installs · ★ 300 repo stars
- Author: aliyun
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aliyun/alibabacloud-aiops-skills/tree/HEAD/skills/middleware/apigateway/alibabacloud-nginx-ingress-to-api-gateway/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/alibabacloud-nginx-ingress-to-api-gateway

## What it does

The skill parses `nginx.ingress.kubernetes.io/*` annotations into three groups: compatible (50 like `rewrite-target`, `enable-cors`, `canary-weight` — kept as-is), ignorable (16 that Envoy handles natively — `proxy-connect-timeout`, `proxy-buffering`), unsupported (51 — replaced with Higress built-in plugins, native annotations, or custom WasmPlugin). Produces new YAML with `ingressClassName: apig` and a deployment checklist.

Runs entirely offline: no cloud APIs, cluster connections, or CLI tools needed. Only YAML input required. Go >= 1.24 and Docker are needed only if analysis determines a custom WasmPlugin is necessary — they are not default dependencies.

Parsing, classification, and generation run in one pass. Parameters like `RegionId` and OCI registry address use placeholders — you supply actual values at deployment time.

## Requirements
- Works with: Kubernetes

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-nginx-ingress-to-api-gateway -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/alibabacloud-nginx-ingress-to-api-gateway/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/alibabacloud-nginx-ingress-to-api-gateway/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-nginx-ingress-to-api-gateway -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/alibabacloud-nginx-ingress-to-api-gateway/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-nginx-ingress-to-api-gateway -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/alibabacloud-nginx-ingress-to-api-gateway/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aliyun/alibabacloud-aiops-skills skills/middleware/apigateway/alibabacloud-nginx-ingress-to-api-gateway
```

2. **Manually: put the files in place**
- File: `.github/skills/alibabacloud-nginx-ingress-to-api-gateway/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-nginx-ingress-to-api-gateway -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/aliyun/alibabacloud-aiops-skills --path skills/middleware/apigateway/alibabacloud-nginx-ingress-to-api-gateway
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/alibabacloud-nginx-ingress-to-api-gateway/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-nginx-ingress-to-api-gateway -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/aliyun/alibabacloud-aiops-skills/tree/HEAD/skills/middleware/apigateway/alibabacloud-nginx-ingress-to-api-gateway/SKILL.md

## When to use it
- migrate nginx Ingress to Alibaba Cloud API Gateway
- classify `nginx.ingress.kubernetes.io/*` annotations by compatibility
- generate Higress Ingress YAML with `ingressClassName: apig`
- replace unsupported annotations with built-in plugins or WasmPlugin
- produce migration report with deployment checklist

## Example prompts
- Check if `ingress.yaml` annotations are compatible with Alibaba Cloud APIG
- Migrate all Ingress files from `k8s/manifests/` to Higress and create deployment checklist
- Which annotations in `production/gateway.yaml` are unsupported by APIG and what replaces them

## Similar
- [kubernetes-deploying](https://affpapa.org/en/nevibecode/skills/kubernetes-deploying.md) — skill · 406 installs
- [gke-service-networking](https://affpapa.org/en/nevibecode/skills/gke-service-networking.md) — skill · 4800 installs
- [connecting-lambda-to-api-gateway](https://affpapa.org/en/nevibecode/skills/connecting-lambda-to-api-gateway.md) — skill · 7400 installs
- [creating-api-gateway-stage](https://affpapa.org/en/nevibecode/skills/creating-api-gateway-stage.md) — skill · 7100 installs
- [api-gateway-configuration](https://affpapa.org/en/nevibecode/skills/api-gateway-configuration.md) — skill · 509 installs
- [api-gateway-patterns](https://affpapa.org/en/nevibecode/skills/nickcrew-api-gateway-patterns.md) — skill · 101 installs

From the same set: [aliyun/alibabacloud-aiops-skills](https://affpapa.org/en/nevibecode/by/aliyun/alibabacloud-aiops-skills.md) — 66 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
