📚 Sync docs from alaudadevops/tektoncd-operator on 5cca5b6d0e45d64059ff5e4df66593cb8b0b53d1

Source: docs: add hubs-wrapper configuration for enhanced API compatibility (#298)
Author: l-qing
Ref: refs/heads/release-4.1
Commit: 5cca5b6d0e45d64059ff5e4df66593cb8b0b53d1

This commit automatically syncs documentation changes from the source-docs repository.

🔗 View source commit: AlaudaDevops/tektoncd-operator@5cca5b6
🤖 Synced on 2025-08-02 02:38:47 UTC

Author: l-qing

.github/SYNC_INFO.md

@@ -1,10 +1,10 @@
 # Documentation Sync Information
 
-- **Last synced**: 2025-07-30 02:02:48 UTC
+- **Last synced**: 2025-08-02 02:38:47 UTC
 - **Source repository**: alaudadevops/tektoncd-operator
-- **Source commit**: [6b7f006944f52c6f52fd0216047a28a6a5f871a9](https://github.com/alaudadevops/tektoncd-operator/commit/6b7f006944f52c6f52fd0216047a28a6a5f871a9)
+- **Source commit**: [5cca5b6d0e45d64059ff5e4df66593cb8b0b53d1](https://github.com/alaudadevops/tektoncd-operator/commit/5cca5b6d0e45d64059ff5e4df66593cb8b0b53d1)
 - **Triggered by**: l-qing
-- **Workflow run**: [#27](https://github.com/alaudadevops/tektoncd-operator/actions/runs/16611664851)
+- **Workflow run**: [#29](https://github.com/alaudadevops/tektoncd-operator/actions/runs/16688979512)
 
 ## Files synced:
 - docs/

docs/en/how_to/deploy_global.mdx

@@ -37,12 +37,33 @@ kind: TektonConfig
 spec:
   pipeline:
     options:
+      disabled: false
       ingress:
-        tektoncd-hubs-api:
+        hubs-wrapper:
+          spec:
+            ingressClassName: global-alb2
+        tektoncd-hubs-api: # ensure compatibility with earlier versions
           spec:
             ingressClassName: global-alb2
       deployments:
-        tektoncd-hubs-api:
+        hubs-wrapper:
+          spec:
+            template:
+              spec:
+                containers:
+                  - env:
+                      - name: KUBERNETES_PORT_443_TCP
+                        value: tcp://erebus.cpaas-system:443
+                      - name: KUBERNETES_PORT_443_TCP_ADDR
+                        value: erebus.cpaas-system
+                      - name: KUBERNETES_PORT
+                        value: tcp://erebus.cpaas-system:443
+                      - name: EREBUS
+                        value: https://erebus.cpaas-system:443
+                      - name: KUBERNETES_SERVICE_HOST
+                        value: erebus.cpaas-system
+                    name: hubs-wrapper
+        tektoncd-hubs-api: # ensure compatibility with earlier versions
           spec:
             template:
               spec:
@@ -59,9 +80,10 @@ spec:
                       - name: KUBERNETES_SERVICE_HOST
                         value: erebus.cpaas-system
                     name: tektoncd-hubs-api
-      disabled: false
 ```
 
+> If both `hubs-wrapper` and `tektoncd-hubs-api` are configured simultaneously, all versions can be supported at the same time.
+
 ## Optional: Deploying tekton-results in a global cluster
 
 If users have deployed tekton-results in a global cluster, they also need to configure the `options` for the results component. Similar to the pipeline configuration, you need to configure both ingress and deployment settings for the `tektoncd-results-api` component.
@@ -98,4 +120,4 @@ spec:
                       value: erebus.cpaas-system
                   name: tektoncd-results-api
     disabled: false
-```
+```