alibabacloud-nginx-ingress-to-api-gateway

Migrate Kubernetes Nginx Ingress resources to Alibaba Cloud APIG with YAML output.

213|24|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/aliyun/alibabacloud-aiops-skills --skill alibabacloud-nginx-ingress-to-api-gateway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: alibabacloud-nginx-ingress-to-api-gateway
Source: https://github.com/aliyun/alibabacloud-aiops-skills/tree/main/skills/middleware/apigateway/alibabacloud-nginx-ingress-to-api-gateway
Command: npx skills add https://github.com/aliyun/alibabacloud-aiops-skills --skill alibabacloud-nginx-ingress-to-api-gateway

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables offline analysis and migration of Kubernetes Nginx Ingress resources to Alibaba Cloud API Gateway (APIG) by classifying annotations, mapping to Higress native features, selecting built-in plugins, and generating migrated Ingress YAML plus a migration report.

Core Features & Use Cases

  • Classifies nginx.ingress.kubernetes.io annotations into Compatible, Ignorable, andUnsupported for APIG migration.
  • Generates a migrated Ingress YAML set with ingressClassName set to apig and preserves rules and TLS while removing unsupported annotations or annotating with wasmplugin as needed.
  • Produces a complete migration report with deployment guidance and verifications for post-migration steps.

Quick Start

Paste or provide Ingress YAML to start offline analysis and generate the migrated artifacts in one step.

Frequently Asked Questions about alibabacloud-nginx-ingress-to-api-gateway

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate Kubernetes Nginx Ingress to Alibaba Cloud APIG?

Migrate Nginx Ingress to APIG by analyzing your YAML to classify nginx.ingress.kubernetes.io annotations, mapping compatible rules to Higress features, and outputting migrated YAML with ingressClassName set to apig.

What happens to unsupported Nginx Ingress annotations when moving to API Gateway?

Unsupported annotations are removed or mapped to WasmPlugin configurations during migration. The skill classifies annotations into Compatible, Ignorable, and Unsupported categories, preserving valid rules while annotating unsupported ones with wasmplugin as needed.

Can I analyze my Ingress YAML offline to generate an APIG migration report?

Yes, you can analyze Ingress YAML offline to generate a deployment-ready migration report. The process operates entirely on your provided YAML, producing compatibility analysis, migrated Ingress YAMLs, and post-migration verification guidance.

How does WasmPlugin handle Nginx Ingress features not natively supported by Higress?

WasmPlugin extends Higress by replacing unsupported Nginx Ingress annotations with custom Wasm plugins. The migration logic decides which annotations require WasmPlugin implementation and annotates the migrated YAML accordingly to retain original routing behaviors.

Does migrating Ingress to API Gateway preserve my existing TLS and routing rules?

Migrating Ingress to API Gateway preserves your existing TLS and routing rules. The skill generates migrated YAML that retains original traffic rules and TLS configurations while changing the ingressClassName to apig and stripping incompatible annotations.

What is the best way to classify Nginx Ingress annotations for APIG compatibility?

The best way to classify Nginx Ingress annotations for APIG compatibility is to use an automated migration tool that evaluates each annotation against Higress native features, categorizing them as Compatible, Ignorable, or Unsupported for accurate YAML conversion.