Skip to content

feat: share hub parameter between deployments and plugins with separate namespaces#3521

Merged
johnlanni merged 1 commit intohigress-group:mainfrom
johnlanni:feat/hub-plugin-config
Feb 20, 2026
Merged

feat: share hub parameter between deployments and plugins with separate namespaces#3521
johnlanni merged 1 commit intohigress-group:mainfrom
johnlanni:feat/hub-plugin-config

Conversation

@johnlanni
Copy link
Copy Markdown
Collaborator

What this PR does

This PR refactors the global.hub parameter to be shared between Higress deployments and built-in Wasm plugins, with separate namespaces for each.

Changes

  1. helm/core/values.yaml:

    • Changed global.hub from registry/higress to registry only
    • Added global.pluginNamespace parameter (default: "plugins")
  2. Helm templates (controller-deployment, plugin-server-deployment, _pod.tpl, redis statefulset):

    • Updated image paths to include /higress/ prefix for deployments
    • Image path format: {hub}/higress/{image}
  3. README.md & README_ZH.md:

    • Added documentation for K8s deployment with hub configuration
    • Listed available mirror registries

Image Path Changes

Type Before After
Deployments {hub}/{image} {hub}/higress/{image}
Plugins N/A {hub}/{pluginNamespace}/{plugin-name}

hub value change:

  • Before: higress-registry.cn-hangzhou.cr.aliyuncs.com/higress
  • After: higress-registry.cn-hangzhou.cr.aliyuncs.com

Usage

Users can now configure a single global.hub parameter to use mirror registries:

# Example: Using North America mirror for both deployments and plugins
helm install higress -n higress-system higress.io/higress \
  --set global.hub=higress-registry.us-west-1.cr.aliyuncs.com \
  --create-namespace

Available mirror registries:

  • China (Hangzhou): higress-registry.cn-hangzhou.cr.aliyuncs.com (default)
  • North America: higress-registry.us-west-1.cr.aliyuncs.com
  • Southeast Asia: higress-registry.ap-southeast-7.cr.aliyuncs.com

Related

This PR works together with higress-console PR #666 to provide a complete solution for customizing image registries.

…te namespaces

- Change global.hub from 'registry/higress' to 'registry' only
- Add '/higress/' prefix in image paths for deployments
- Add global.pluginNamespace parameter for plugin image namespace (default: plugins)
- Update all helm templates to use new hub format
- Add K8s deployment hub configuration docs in README.md and README_ZH.md

Image path changes:
- Deployments: {hub}/higress/{image} (e.g., gateway, controller, pilot)
- Plugins: {hub}/{pluginNamespace}/{plugin-name} (e.g., plugins/ai-proxy)

Users can now configure a single global.hub parameter to use mirror registries
for both Higress components and built-in Wasm plugins.
@johnlanni johnlanni force-pushed the feat/hub-plugin-config branch from aef01d1 to b01b339 Compare February 20, 2026 14:45
@johnlanni johnlanni merged commit caa5317 into higress-group:main Feb 20, 2026
13 checks passed
JayLi52 added a commit to JayLi52/higress that referenced this pull request Feb 24, 2026
* 'main' of github.com:alibaba/higress: (106 commits)
  Add release notes (higress-group#3524)
  feat(ai-statistics): add Claude/Anthropic streaming tool calls parsing support (higress-group#3523)
  feat: share hub parameter between deployments and plugins with separate namespaces (higress-group#3521)
  Update index.ts
  refactor: migrate MCP SDK to main repo (higress-group#3516)
  Fix model pattern for Dashscope entry
  Rename qwen3-coder-plus to qwen3.5-plus
  feat(ai-proxy): strip dynamic cch field from billing header to enable caching (higress-group#3518)
  fix(ai-proxy): convert OpenAI tool role to Claude user role with tool_result (higress-group#3517)
  fix(ai-statistics): lightweight mode should include question and model (higress-group#3513)
  feat(ai-statistics): add lightweight mode with use_default_response_attributes (higress-group#3512)
  feat(ai-statistics): add system field support for Claude /v1/messages API (higress-group#3511)
  fix(ai-proxy): fix Claude protocol conversion issues (higress-group#3510)
  fix(ai-proxy): add streaming tool_calls support for Claude provider (higress-group#3507)
  fix(ai-proxy): convert Claude tool_use stop_reason to OpenAI tool_calls format (higress-group#3506)
  fix(ai-statistics): use RuleAppend as default for streaming answer extraction (higress-group#3505)这个
  fix(ai-proxy): preserve text content alongside tool_result in Claude to OpenAI conversion (higress-group#3503)
  fix(ai-proxy): add missing event field in Claude streaming response (higress-group#3502)
  feat(ai-proxy): add consumer affinity for stateful APIs (higress-group#3499)
  fix(ci): pin GitHub Actions runner to ubuntu-22.04 (higress-group#3500)
  ...
daixijun pushed a commit to daixijun/higress that referenced this pull request Mar 11, 2026
Libres-coder pushed a commit to Libres-coder/higress that referenced this pull request Mar 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant