Back to Details

alibabacloud-nginx-ingress-to-api-gateway

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Nginx Ingress to APIG Migration

Nginx Ingress 到 APIG 迁移

Scenario Description

场景描述

Migrate Kubernetes nginx Ingress resources to Alibaba Cloud API Gateway (APIG). APIG is an Envoy-based gateway (Higress) that uses 
ingressClassName: apig
. This skill classifies every 
nginx.ingress.kubernetes.io/*
annotation into Compatible / Ignorable / Unsupported, resolves unsupported annotations via a four-level decision tree (Higress native → safe-to-drop → built-in plugin → custom WasmPlugin), generates migrated Ingress YAML, and produces a deployment-ready migration report.
Architecture: 
nginx Ingress Controller → APIG (Envoy/Higress) + optional WasmPlugin (Go, proxy-wasm-go-sdk)
The core analysis workflow operates entirely offline on user-provided YAML — no cluster access, CLI tools, or cloud credentials required.
将Kubernetes nginx Ingress资源迁移至阿里云API网关（APIG）。APIG是基于Envoy的网关（Higress），使用
ingressClassName: apig
。本技能会将所有
nginx.ingress.kubernetes.io/*
注解分类为兼容/可忽略/不支持三类，通过四级决策树（Higress原生支持→可安全丢弃→内置插件适配→自定义WasmPlugin开发）解决不兼容注解问题，生成迁移后的Ingress YAML，并输出可直接用于部署的迁移报告。
架构：
nginx Ingress Controller → APIG (Envoy/Higress) + 可选 WasmPlugin (Go, proxy-wasm-go-sdk)
核心分析流程完全基于用户提供的YAML离线运行，无需访问集群、安装CLI工具或提供云账号凭证。

Installation

安装说明

This skill operates entirely offline on user-provided YAML. No CLI tools, SDKs, or cloud credentials are required.
On-demand tools (only when the workflow reaches a step that needs them):
ToolWhen neededCheck commandMinimum version
jqScript-based offline analysis
jq --version
>= 1.6
python3 + PyYAMLYAML parsing (alternative to yq)
python3 -c "import yaml; print(yaml.__version__)"
python3 >= 3.8, PyYAML >= 5.0
yqYAML parsing (alternative to python3+PyYAML)
yq --version
>= 4.0
GoStep 3 determines a custom WasmPlugin is needed
go version
>= 1.24
DockerCustom WasmPlugin needs to be built as OCI image
docker version
—
Do NOT pre-check or prompt installation of any tool during analysis.
本技能完全基于用户提供的YAML离线运行，无需安装CLI工具、SDK或提供云凭证。
按需使用的工具（仅当工作流执行到对应步骤时才需要）：
工具需要场景检查命令最低版本
jq基于脚本的离线分析
jq --version
>= 1.6
python3 + PyYAMLYAML解析（yq的替代方案）
python3 -c "import yaml; print(yaml.__version__)"
python3 >= 3.8, PyYAML >= 5.0
yqYAML解析（python3+PyYAML的替代方案）
yq --version
>= 4.0
Go步骤3判定需要开发自定义WasmPlugin时
go version
>= 1.24
Docker需要将自定义WasmPlugin构建为OCI镜像时
docker version
—
分析过程中请勿预检查或提示安装任何工具。

Environment Variables

环境变量

No environment variables required. This skill does not invoke any cloud APIs or CLI tools.
无需配置环境变量。本技能不会调用任何云API或CLI工具。

Authentication

鉴权说明

Not applicable. This skill does not invoke Alibaba Cloud APIs or CLI. No credentials are needed.
不涉及鉴权。本技能不会调用阿里云API或CLI，无需任何凭证。

RAM Policy

RAM权限策略

Not applicable. This skill operates entirely on local YAML files and does not call any cloud APIs.
不涉及。本技能完全基于本地YAML文件运行，不会调用任何云API。

Parameter Confirmation

参数确认

This skill only performs analysis and code generation — it does NOT execute any deployment or cluster write operations.
When the user provides Ingress YAML, proceed immediately with the full workflow (Step 1→5) and output the complete result. Do NOT ask for RegionId, OCI registry, or any other parameter. Use 
<REGION>
and 
<YOUR_REGISTRY>
placeholders in the output.
请避免以下交互模式，直接执行对应操作即可：
  • "是否需要我分析这个 Ingress？" — 建议直接分析
  • "是否需要生成迁移后的 YAML？" — 建议直接生成
  • "是否需要创建迁移配置文件/检查清单？" — 建议直接创建
  • "是否需要开发 WasmPlugin？" — 如果决策树判定需要，建议直接开发
  • "请确认 RegionId / OCI 地址" — 建议使用占位符
Parameter NameRequired/OptionalDescriptionDefault Value
Ingress YAMLRequirednginx Ingress YAML to migrate (paste, file, or directory)—
When Ingress YAML is not provided: If the user asks about migration but does not provide YAML, respond with: "请提供需要迁移的 nginx Ingress YAML（可以直接粘贴、提供文件路径或目录路径）。" Do NOT abort the conversation — guide the user to provide the required input.
本技能仅执行分析和代码生成操作，不会执行任何部署或集群写入操作。
当用户提供Ingress YAML时，请立即执行完整工作流（步骤1→5）并输出完整结果，请勿询问RegionId、OCI镜像仓库地址或其他参数，输出中使用
<REGION>
和
<YOUR_REGISTRY>
作为占位符即可。
请避免以下交互模式，直接执行对应操作即可：
  • "是否需要我分析这个 Ingress？" — 建议直接分析
  • "是否需要生成迁移后的 YAML？" — 建议直接生成
  • "是否需要创建迁移配置文件/检查清单？" — 建议直接创建
  • "是否需要开发 WasmPlugin？" — 如果决策树判定需要，建议直接开发
  • "请确认 RegionId / OCI 地址" — 建议使用占位符
参数名称必填/可选描述默认值
Ingress YAML必填待迁移的nginx Ingress YAML（可直接粘贴、提供文件路径或目录路径）—
当未提供Ingress YAML时：如果用户询问迁移相关问题但未提供YAML，回复："请提供需要迁移的 nginx Ingress YAML（可以直接粘贴、提供文件路径或目录路径）。"请勿终止对话，引导用户提供所需输入即可。

Core Workflow

核心工作流

建议：收到 YAML 后一次性完成全部分析步骤
当用户提供 Ingress YAML 时，建议立即执行全部步骤（Step 1→5）并在一次响应中输出完整结果。
  • 对于未指定的参数（如 RegionId、OCI registry），使用 
    <REGION>
    等占位符
  • 收到 YAML 后直接进入分析流程，无需额外确认
  • 各步骤之间连续执行，无需中途暂停询问用户
  • 迁移配置文件和检查清单作为标准输出的一部分自动生成
  • 整个工作流是确定性的：YAML 输入 → 完整迁移报告输出，无需中间确认
  • 唯一必需的输入是 Ingress YAML 本身
建议：收到YAML后一次性完成全部分析步骤
当用户提供Ingress YAML时，建议立即执行全部步骤（步骤1→5）并在一次响应中输出完整结果。
  • 对于未指定的参数（如RegionId、OCI镜像仓库地址），使用
    <REGION>
    等占位符
  • 收到YAML后直接进入分析流程，无需额外确认
  • 各步骤连续执行，无需中途暂停询问用户
  • 迁移配置文件和检查清单作为标准输出的一部分自动生成
  • 整个工作流是确定性的：YAML输入 → 完整迁移报告输出，无需中间确认
  • 唯一必需的输入是Ingress YAML本身

Step 1: Parse Ingress YAML

步骤1：解析Ingress YAML

Accept YAML from any of the following input formats:
  • Direct paste in conversation (with or without markdown code fences)
  • File path (e.g., 
    ingress.yaml
    , 
    ./k8s/ingress.yaml
    )
  • Directory path (scan all 
    .yaml
    /
    .yml
    files for Ingress resources)
  • Multi-document YAML (separated by 
    ---
    )
  • Partial YAML (missing 
    apiVersion
    /
    kind
    — infer as Ingress if 
    annotations
    with 
    nginx.ingress.kubernetes.io/*
    are present)
For each Ingress found, extract all 
nginx.ingress.kubernetes.io/*
annotations.
If the user's message mentions migration/analysis but does NOT include any YAML, respond with: "请提供需要迁移的 nginx Ingress YAML（可以直接粘贴、提供文件路径或目录路径）。" Do NOT abort or error out — guide the user to provide input.
支持以下任意格式的YAML输入：
  • 对话中直接粘贴（带或不带markdown代码块标记均可）
  • 文件路径（例如
    ingress.yaml
    、
    ./k8s/ingress.yaml
    ）
  • 目录路径（扫描所有
    .yaml
    /
    .yml
    文件中的Ingress资源）
  • 多文档YAML（用
    ---
    分隔）
  • 不完整YAML（缺失
    apiVersion
    /
    kind
    ，如果存在
    nginx.ingress.kubernetes.io/*
    开头的注解则推断为Ingress资源）
对每个识别到的Ingress，提取所有
nginx.ingress.kubernetes.io/*
开头的注解。
如果用户消息提到迁移/分析但未提供任何YAML，回复："请提供需要迁移的 nginx Ingress YAML（可以直接粘贴、提供文件路径或目录路径）。"请勿报错或终止对话，引导用户提供输入即可。

Step 2: Classify Annotations

步骤2：注解分类

Classify each annotation into exactly one of three categories. See 
references/annotation-mapping.md
for the complete 117-annotation lookup table.
CategoryCountActionExample
Compatible50Keep in migrated YAML
rewrite-target
, 
enable-cors
, 
canary-weight
, 
ssl-redirect
Ignorable16Strip (Envoy handles natively)
proxy-connect-timeout
, 
proxy-buffering
, 
proxy-body-size
Unsupported51Strip → resolve via decision tree
auth-url
, 
server-snippet
, 
limit-rps
Inline Quick Lookup — High-Frequency Annotations:
AnnotationCategoryAction
rewrite-target
✅ CompatibleKeep
enable-cors
✅ CompatibleKeep
cors-allow-origin
✅ CompatibleKeep
ssl-redirect
✅ CompatibleKeep
canary
/ 
canary-weight
/ 
canary-by-header
✅ CompatibleKeep
whitelist-source-range
✅ CompatibleKeep
backend-protocol
✅ CompatibleKeep
use-regex
✅ CompatibleKeep
upstream-vhost
✅ CompatibleKeep
proxy-connect-timeout
⚪ IgnorableStrip
proxy-read-timeout
⚪ IgnorableStrip
proxy-send-timeout
⚪ IgnorableStrip
proxy-body-size
⚪ IgnorableStrip
proxy-buffering
⚪ IgnorableStrip
client-body-buffer-size
⚪ IgnorableStrip
auth-url
❌ UnsupportedWasmPlugin (HTTP callout)
server-snippet
❌ UnsupportedWasmPlugin (directive conversion)
configuration-snippet
❌ UnsupportedWasmPlugin (directive conversion)
limit-rps
❌ UnsupportedBuilt-in 
key-rate-limit
plugin
limit-connections
❌ UnsupportedBuilt-in 
key-rate-limit
plugin
enable-modsecurity
❌ UnsupportedBuilt-in 
waf
plugin
denylist-source-range
❌ UnsupportedHigress native 
higress.io/blacklist-source-range
service-upstream
❌ UnsupportedSafe to drop (Envoy default behavior)
ssl-ciphers
❌ UnsupportedRename to 
ssl-cipher
(compatible)
If an annotation is NOT in the above table, look it up in 
references/annotation-mapping.md
. If still not found, classify as Unsupported and resolve via the decision tree in Step 3.
Special value changes (compatible but value must change):
  • load-balance: ewma
    → 
    round_robin
    (APIG does not support EWMA)
  • ssl-ciphers
    → rename to 
    ssl-cipher
    (singular form)
  • affinity-mode: persistent
    → 
    balanced
    (APIG only supports balanced)
将每个注解归类到以下三类中的某一类，完整的117个注解映射表请参考
references/annotation-mapping.md
。
分类数量处理方式示例
兼容50迁移后的YAML中保留
rewrite-target
、
enable-cors
、
canary-weight
、
ssl-redirect
可忽略16直接移除（Envoy原生支持对应能力）
proxy-connect-timeout
、
proxy-buffering
、
proxy-body-size
不支持51移除后通过决策树适配
auth-url
、
server-snippet
、
limit-rps
高频注解快速查询表：
注解分类处理方式
rewrite-target
✅ 兼容保留
enable-cors
✅ 兼容保留
cors-allow-origin
✅ 兼容保留
ssl-redirect
✅ 兼容保留
canary
/ 
canary-weight
/ 
canary-by-header
✅ 兼容保留
whitelist-source-range
✅ 兼容保留
backend-protocol
✅ 兼容保留
use-regex
✅ 兼容保留
upstream-vhost
✅ 兼容保留
proxy-connect-timeout
⚪ 可忽略移除
proxy-read-timeout
⚪ 可忽略移除
proxy-send-timeout
⚪ 可忽略移除
proxy-body-size
⚪ 可忽略移除
proxy-buffering
⚪ 可忽略移除
client-body-buffer-size
⚪ 可忽略移除
auth-url
❌ 不支持WasmPlugin（HTTP回调）适配
server-snippet
❌ 不支持WasmPlugin（指令转换）适配
configuration-snippet
❌ 不支持WasmPlugin（指令转换）适配
limit-rps
❌ 不支持内置
key-rate-limit
插件适配
limit-connections
❌ 不支持内置
key-rate-limit
插件适配
enable-modsecurity
❌ 不支持内置
waf
插件适配
denylist-source-range
❌ 不支持Higress原生
higress.io/blacklist-source-range
适配
service-upstream
❌ 不支持可安全丢弃（Envoy默认行为）
ssl-ciphers
❌ 不支持重命名为
ssl-cipher
（兼容）
如果注解不在上表中，请查询
references/annotation-mapping.md
，如果仍未找到，归类为不支持并通过步骤3的决策树适配。
特殊值转换规则（兼容但值需要修改）：
  • load-balance: ewma
    → 
    round_robin
    （APIG不支持EWMA负载均衡算法）
  • ssl-ciphers
    → 重命名为
    ssl-cipher
    （单数形式）
  • affinity-mode: persistent
    → 
    balanced
    （APIG仅支持balanced亲和模式）

Step 3: Resolve Unsupported Annotations

步骤3：不兼容注解适配

For each unsupported annotation, follow this decision tree in order:
1. Higress native annotation?  → Use native equivalent (no WasmPlugin needed)
2. Safe to drop?               → Remove without replacement
3. Built-in platform plugin?   → Use built-in OCI image via higress.io/wasmplugin annotation
4. None of the above?          → Develop custom WasmPlugin
See 
references/migration-patterns.md
for the complete decision tree, and 
references/builtin-plugins.md
for the built-in plugin catalog.
Higress native mappings:
nginx annotationHigress equivalent
denylist-source-range
higress.io/blacklist-source-range
mirror-target
higress.io/mirror-target-service
+ 
higress.io/mirror-percentage
Safe-to-drop: 
service-upstream
, 
enable-access-log
, 
proxy-request-buffering: off
, 
connection-proxy-header
Built-in plugins: 
limit-rps
/
limit-connections
→ 
key-rate-limit
, 
enable-modsecurity
→ 
waf
. See 
references/builtin-plugins.md
.
Custom WasmPlugin (last resort): 
auth-url
, 
server-snippet
, 
configuration-snippet
, etc. See 
references/wasm-plugin-sdk.md
for SDK reference, 
references/snippet-patterns.md
for conversion patterns.
对每个不支持的注解，按顺序执行以下决策树：
1. 存在Higress原生对应注解？  → 使用原生等价注解（无需WasmPlugin）
2. 可安全丢弃？               → 直接移除无需替换
3. 存在平台内置插件支持？   → 通过higress.io/wasmplugin注解引用内置OCI镜像
4. 以上都不满足？          → 开发自定义WasmPlugin适配
完整决策树请参考
references/migration-patterns.md
，内置插件目录请参考
references/builtin-plugins.md
。
Higress原生映射：
nginx注解Higress等价注解
denylist-source-range
higress.io/blacklist-source-range
mirror-target
higress.io/mirror-target-service
+ 
higress.io/mirror-percentage
可安全丢弃的注解： 
service-upstream
、
enable-access-log
、
proxy-request-buffering: off
、
connection-proxy-header
内置插件适配： 
limit-rps
/
limit-connections
→ 
key-rate-limit
，
enable-modsecurity
→ 
waf
，详见
references/builtin-plugins.md
。
自定义WasmPlugin（最后方案）： 
auth-url
、
server-snippet
、
configuration-snippet
等场景使用，SDK参考请见
references/wasm-plugin-sdk.md
，转换规则请见
references/snippet-patterns.md
。

Step 4: Generate Migrated Ingress YAML

步骤4：生成迁移后的Ingress YAML

For each input Ingress, generate a migrated copy:
yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: <original-name>-apig
  namespace: <original-namespace>
  annotations:
    # Compatible annotations preserved
    # Unsupported annotations replaced with higress.io/wasmplugin if needed
spec:
  ingressClassName: apig    # MUST be hardcoded to apig
  rules: ...                # Preserved from original
  tls: ...                  # Preserved from original
为每个输入的Ingress生成迁移后的副本：
yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: <原始名称>-apig
  namespace: <原始命名空间>
  annotations:
    # 保留兼容的注解
    # 不兼容的注解按需替换为higress.io/wasmplugin注解
spec:
  ingressClassName: apig    # 必须固定为apig
  rules: ...                # 保留原始配置
  tls: ...                  # 保留原始配置

Step 5: Output Migration Report

步骤5：输出迁移报告

所有输出建议使用中文（中文）。包括分析表、迁移总结、后续操作指南及所有说明性文字。代码块（YAML、Go、bash）保持原始语法。
以下所有内容均为标准输出项，建议在一次响应中完整输出，无需逐项询问用户。
Output ALL of the following for each Ingress:
  1. 兼容性分析表 — annotation, value, category (兼容/可忽略/不支持), action
  2. 迁移后的 Ingress YAML — ready for user to apply
  3. 自定义 WasmPlugin 源码 — if Step 3 determined custom plugins are needed (skip only if no custom plugin is needed)
  4. 迁移总结 — what changed, value changes, plugins needed
  5. 后续操作指南 — 根据兼容性分析结果，分场景告知用户完整的迁移操作路径：
    • 完全兼容（无不兼容注解）：所有注解均为兼容或可忽略类型，用户可直接参考 Nginx Ingress 迁移到云原生 API 网关 完成迁移。
    • 不完全兼容（存在不兼容注解）：按以下顺序操作：
      1. 构建并推送自定义 WasmPlugin OCI 镜像
      2. 将迁移后 Ingress YAML 中的 OCI URL 占位符替换为真实的 WasmPlugin 镜像地址
      3. 将替换后的 Ingress YAML 部署到集群中
      4. 参考 Nginx Ingress 迁移到云原生 API 网关 继续后续操作，在步骤一「指定 IngressClass」处需指定为 
        apig
      5. 网关版本要求：使用 WasmPlugin 需确保云原生 API 网关版本在 2.1.16 及以上，否则需要升级版本或创建新网关
See 
references/deployment-guide-template.md
for the guide template.
Scope boundary: This skill generates all artifacts and instructions. It does NOT execute 
kubectl apply
, 
docker push
, or any cluster/registry write operations. Those are left to the user. No confirmation needed: Every item above is always generated. Never ask "是否需要生成迁移文件/检查清单/部署指南？"
所有输出建议使用中文。包括分析表、迁移总结、后续操作指南及所有说明性文字。代码块（YAML、Go、bash）保持原始语法。
以下所有内容均为标准输出项，建议在一次响应中完整输出，无需逐项询问用户。
为每个Ingress输出以下所有内容：
  1. 兼容性分析表 — 注解、值、分类（兼容/可忽略/不支持）、处理方式
  2. 迁移后的Ingress YAML — 用户可直接部署使用
  3. 自定义WasmPlugin源码 — 如果步骤3判定需要自定义插件则输出（无自定义插件时跳过）
  4. 迁移总结 — 变更内容、值转换说明、所需插件说明
  5. 后续操作指南 — 根据兼容性分析结果，分场景告知用户完整的迁移操作路径：
    • 完全兼容（无不兼容注解）：所有注解均为兼容或可忽略类型，用户可直接参考 Nginx Ingress 迁移到云原生 API 网关 完成迁移。
    • 不完全兼容（存在不兼容注解）：按以下顺序操作：
      1. 构建并推送自定义WasmPlugin OCI镜像
      2. 将迁移后Ingress YAML中的OCI URL占位符替换为真实的WasmPlugin镜像地址
      3. 将替换后的Ingress YAML部署到集群中
      4. 参考 Nginx Ingress 迁移到云原生 API 网关 继续后续操作，在步骤一「指定 IngressClass」处需指定为 
        apig
      5. 网关版本要求：使用WasmPlugin需确保云原生API网关版本在 2.1.16 及以上，否则需要升级版本或创建新网关
指南模板请参考
references/deployment-guide-template.md
。
能力边界： 本技能仅生成所有产物和操作指南，不会执行
kubectl apply
、
docker push
或任何集群/镜像仓库写入操作，这些操作由用户自行执行。 无需确认： 以上所有项都会默认生成，永远不要询问"是否需要生成迁移文件/检查清单/部署指南？"

Success Verification Method

成功验证方法

See 
references/verification-method.md
for verification steps to include in the migration report.
The migration report should instruct the user to verify with:
bash
undefined
迁移报告中需要包含的验证步骤请参考
references/verification-method.md
。
迁移报告应指导用户通过以下命令验证：
bash
undefined

Validate migrated YAML syntax (user runs this)

验证迁移后的YAML语法（用户自行执行）

kubectl apply --dry-run=client -f <migrated-ingress>.yaml
kubectl apply --dry-run=client -f <迁移后的Ingress文件>.yaml

Confirm ingressClassName is apig

确认ingressClassName为apig

grep "ingressClassName: apig" <migrated-ingress>.yaml

> This skill outputs verification instructions for the user. It does NOT execute these commands.
grep "ingressClassName: apig" <迁移后的Ingress文件>.yaml

> 本技能仅输出验证指导，不会执行这些命令。

Cleanup

清理说明

Not applicable. This skill only generates text output (YAML, Go source code, migration report). No cloud resources or cluster objects are created by this skill.
不涉及清理操作。本技能仅生成文本输出（YAML、Go源码、迁移报告），不会创建任何云资源或集群对象。

API and Command Tables

API与命令表

This skill does not execute any CLI commands or API calls. All output is text-based (YAML, Go source code, migration report with instructions for the user).
本技能不会执行任何CLI命令或API调用，所有输出均为文本格式（YAML、Go源码、带操作指南的迁移报告）。

Best Practices

最佳实践

  1. Always classify ALL annotations before generating migrated YAML — never skip annotations
  2. Use placeholders (
    <REGION>
    , 
    <YOUR_REGISTRY>
    ) for unspecified parameters; never hardcode user-specific values
  3. Preserve original 
    rules
    , 
    tls
    , and 
    namespace
    in migrated YAML
  4. Add 
    -apig
    suffix to migrated Ingress name for easy identification
  5. Prefer built-in plugins over custom WasmPlugin — check 
    references/builtin-plugins.md
    first
  6. For custom WasmPlugin, use 
    github.com/higress-group/wasm-go/pkg/wrapper
    SDK exclusively
  7. Track annotation value changes (e.g., 
    ewma
    → 
    round_robin
    ) explicitly in the report
  8. For 
    server-snippet
    /
    configuration-snippet
    , enumerate every directive and verify 1:1 conversion completeness
  9. Never execute cluster write operations (
    kubectl apply
    , 
    docker push
    , etc.) — only output instructions for the user
  1. 生成迁移YAML前必须完成所有注解的分类，不得遗漏任何注解
  2. 未指定的参数使用占位符（
    <REGION>
    、
    <YOUR_REGISTRY>
    ），永远不要硬编码用户专属值
  3. 迁移后的YAML中保留原始的
    rules
    、
    tls
    和
    namespace
    配置
  4. 迁移后的Ingress名称添加
    -apig
    后缀便于识别
  5. 优先使用内置插件而非自定义WasmPlugin，优先查询
    references/builtin-plugins.md
  6. 自定义WasmPlugin必须使用
    github.com/higress-group/wasm-go/pkg/wrapper
    SDK
  7. 迁移报告中明确标注注解值的变更（例如
    ewma
    → 
    round_robin
    ）
  8. 处理
    server-snippet
    /
    configuration-snippet
    时，枚举所有指令并验证1:1转换完整性
  9. 永远不要执行集群写入操作（
    kubectl apply
    、
    docker push
    等），仅输出操作指南供用户执行

Reference Links

参考链接

ReferenceContents
references/annotation-mapping.md
Complete 117-annotation compatibility lookup table
references/migration-patterns.md
Decision tree, Higress native mappings, safe-to-drop list, special handling
references/builtin-plugins.md
APIG built-in platform plugins catalog with OCI URLs
references/platform-oci-registry.md
Region-specific OCI registry addresses for built-in plugins
references/snippet-patterns.md
server-snippet / configuration-snippet → WasmPlugin conversion patterns
references/wasm-plugin-sdk.md
Higress WASM Go Plugin SDK reference (core API)
references/wasm-http-client.md
WasmPlugin HTTP client patterns (external auth, callouts)
references/wasm-redis-client.md
WasmPlugin Redis client patterns (rate limiting, session)
references/wasm-advanced-patterns.md
Advanced WasmPlugin patterns (streaming, tick, leader election)
references/wasm-local-testing.md
Local WasmPlugin testing with Docker Compose
references/plugin-deployment.md
WasmPlugin build, OCI push, and Ingress annotation binding
references/deployment-guide-template.md
Migration report deployment guide template
references/acceptance-criteria.md
Testing acceptance criteria with correct/incorrect patterns
references/verification-method.md
Success verification steps and commands
references/security-review-policy.md
定期安全复审策略与检查项
references/security-impact-assessment.md
安全影响评估与数据处理流程
references/ram-policies.md
RAM 权限声明（本 Skill 无需任何权限）
参考文件内容说明
references/annotation-mapping.md
完整的117个注解兼容性查询表
references/migration-patterns.md
决策树、Higress原生映射、可丢弃注解列表、特殊处理规则
references/builtin-plugins.md
APIG内置平台插件目录及对应OCI地址
references/platform-oci-registry.md
不同区域的内置插件OCI镜像仓库地址
references/snippet-patterns.md
server-snippet / configuration-snippet 转 WasmPlugin 规则
references/wasm-plugin-sdk.md
Higress WASM Go Plugin SDK参考（核心API）
references/wasm-http-client.md
WasmPlugin HTTP客户端实现模式（外部鉴权、回调）
references/wasm-redis-client.md
WasmPlugin Redis客户端实现模式（限流、会话管理）
references/wasm-advanced-patterns.md
WasmPlugin高级实现模式（流式处理、定时任务、主节点选举）
references/wasm-local-testing.md
使用Docker Compose本地测试WasmPlugin的方法
references/plugin-deployment.md
WasmPlugin构建、OCI推送、Ingress注解绑定指南
references/deployment-guide-template.md
迁移报告部署指南模板
references/acceptance-criteria.md
测试验收标准及正确/错误示例
references/verification-method.md
成功验证步骤与命令
references/security-review-policy.md
定期安全复审策略与检查项
references/security-impact-assessment.md
安全影响评估与数据处理流程
references/ram-policies.md
RAM权限声明（本Skill无需任何权限）