Merge pull request opensandbox-group#342 from Spground/feature/public-tag-server-component-helm

chore(k8s): add opensandbox release chart(all-in-one) & update controller release name

Author: Spground

.github/workflows/publish-helm-chart.yml

@@ -9,6 +9,8 @@ on:
         type: choice
         options:
           - opensandbox-controller
+          - opensandbox-server
+          - opensandbox
         default: 'opensandbox-controller'
       app_version:
         description: 'App version (without v prefix, e.g., 0.1.0)'
@@ -66,6 +68,10 @@ jobs:
           
           if [ "$COMPONENT" == "opensandbox-controller" ]; then
             CHART_PATH="kubernetes/charts/opensandbox-controller"
+          elif [ "$COMPONENT" == "opensandbox-server" ]; then
+            CHART_PATH="kubernetes/charts/opensandbox-server"
+          elif [ "$COMPONENT" == "opensandbox" ]; then
+            CHART_PATH="kubernetes/charts/opensandbox"
           else
             echo "Error: Unknown component: $COMPONENT"
             exit 1
@@ -92,6 +98,13 @@ jobs:
           echo "Updated Chart.yaml:"
           cat $CHART_PATH/Chart.yaml
 
+      - name: Build dependencies (for opensandbox all-in-one chart)
+        if: ${{ steps.parse_tag.outputs.component == 'opensandbox' }}
+        run: |
+          CHART_PATH="${{ steps.chart_path.outputs.path }}"
+          echo "Building dependencies for all-in-one chart..."
+          helm dependency build $CHART_PATH
+
       - name: Lint Helm chart
         run: |
           CHART_PATH="${{ steps.chart_path.outputs.path }}"
@@ -118,7 +131,7 @@ jobs:
             直接从 GitHub Release 安装:
             
             ```bash
-            helm install opensandbox \
+            helm install ${{ steps.parse_tag.outputs.component }} \
               https://github.com/${{ github.repository }}/releases/download/helm/${{ steps.parse_tag.outputs.component }}/${{ steps.parse_tag.outputs.app_version }}/${{ steps.parse_tag.outputs.component }}-${{ steps.chart_version.outputs.version }}.tgz \
               --namespace opensandbox-system \
               --create-namespace
@@ -131,11 +144,13 @@ jobs:
             wget https://github.com/${{ github.repository }}/releases/download/helm/${{ steps.parse_tag.outputs.component }}/${{ steps.parse_tag.outputs.app_version }}/${{ steps.parse_tag.outputs.component }}-${{ steps.chart_version.outputs.version }}.tgz
             
             # 安装
-            helm install opensandbox ./${{ steps.parse_tag.outputs.component }}-${{ steps.chart_version.outputs.version }}.tgz \
+            helm install ${{ steps.parse_tag.outputs.component }} ./${{ steps.parse_tag.outputs.component }}-${{ steps.chart_version.outputs.version }}.tgz \
               --namespace opensandbox-system \
               --create-namespace
             ```
             
+            ${{ steps.parse_tag.outputs.component == 'opensandbox' && '**Note**: This is an all-in-one chart that bundles controller and server. The packaged chart already includes all dependencies, no need to run `helm dependency build` when installing from release.' || '' }}
+            
             ### What's Changed
             
             - Chart version: ${{ steps.chart_version.outputs.version }}

kubernetes/Makefile

@@ -428,14 +428,14 @@ helm-lint: ## Lint the Helm chart
 .PHONY: helm-template
 helm-template: ## Generate Kubernetes manifests from Helm chart
 	@echo "Generating manifests from Helm chart..."
-	helm template opensandbox $(HELM_CHART_PATH) \
+	helm template opensandbox-controller $(HELM_CHART_PATH) \
 		--set controller.image.repository=$(IMAGE_TAG_BASE) \
 		--set controller.image.tag=v$(VERSION)
 
 .PHONY: helm-template-debug
 helm-template-debug: ## Generate Kubernetes manifests with debug output
 	@echo "Generating manifests from Helm chart with debug..."
-	helm template opensandbox $(HELM_CHART_PATH) \
+	helm template opensandbox-controller $(HELM_CHART_PATH) \
 		--set controller.image.repository=$(IMAGE_TAG_BASE) \
 		--set controller.image.tag=v$(VERSION) \
 		--debug
@@ -449,7 +449,7 @@ helm-package: ## Package the Helm chart
 .PHONY: helm-install
 helm-install: ## Install the Helm chart
 	@echo "Installing Helm chart..."
-	helm install opensandbox $(HELM_CHART_PATH) \
+	helm install opensandbox-controller $(HELM_CHART_PATH) \
 		--set controller.image.repository=$(IMAGE_TAG_BASE) \
 		--set controller.image.tag=v$(VERSION) \
 		--namespace opensandbox-system \
@@ -458,20 +458,20 @@ helm-install: ## Install the Helm chart
 .PHONY: helm-upgrade
 helm-upgrade: ## Upgrade the Helm chart
 	@echo "Upgrading Helm chart..."
-	helm upgrade opensandbox $(HELM_CHART_PATH) \
+	helm upgrade opensandbox-controller $(HELM_CHART_PATH) \
 		--set controller.image.repository=$(IMAGE_TAG_BASE) \
 		--set controller.image.tag=v$(VERSION) \
 		--namespace opensandbox-system
 
 .PHONY: helm-uninstall
 helm-uninstall: ## Uninstall the Helm chart
 	@echo "Uninstalling Helm chart..."
-	helm uninstall opensandbox --namespace opensandbox-system
+	helm uninstall opensandbox-controller --namespace opensandbox-system
 
 .PHONY: helm-test
 helm-test: ## Run Helm chart tests
 	@echo "Running Helm chart tests..."
-	helm test opensandbox --namespace opensandbox-system
+	helm test opensandbox-controller --namespace opensandbox-system
 
 .PHONY: helm-docs
 helm-docs: ## Generate Helm chart documentation (requires helm-docs)
@@ -486,7 +486,7 @@ helm-docs: ## Generate Helm chart documentation (requires helm-docs)
 .PHONY: helm-dry-run
 helm-dry-run: ## Perform a dry-run install of the Helm chart
 	@echo "Performing dry-run installation..."
-	helm install opensandbox $(HELM_CHART_PATH) \
+	helm install opensandbox-controller $(HELM_CHART_PATH) \
 		--set controller.image.repository=$(IMAGE_TAG_BASE) \
 		--set controller.image.tag=v$(VERSION) \
 		--namespace opensandbox-system \

kubernetes/README-ZH.md

@@ -156,15 +156,15 @@ kind delete cluster
 
 ```sh
 # 将 <version> 替换为所需版本（例如：0.1.0）
-helm install opensandbox \
+helm install opensandbox-controller \
   https://github.com/alibaba/OpenSandbox/releases/download/helm/opensandbox-controller/<version>/opensandbox-controller-<version>.tgz \
   --namespace opensandbox-system \
   --create-namespace
 ```
 
 具体版本示例：
 ```sh
-helm install opensandbox \
+helm install opensandbox-controller \
   https://github.com/alibaba/OpenSandbox/releases/download/helm/opensandbox-controller/0.1.0/opensandbox-controller-0.1.0.tgz \
   --namespace opensandbox-system \
   --create-namespace
@@ -176,7 +176,7 @@ helm install opensandbox \
 wget https://github.com/alibaba/OpenSandbox/releases/download/helm/opensandbox-controller/<version>/opensandbox-controller-<version>.tgz
 
 # 从本地文件安装
-helm install opensandbox ./opensandbox-controller-<version>.tgz \
+helm install opensandbox-controller ./opensandbox-controller-<version>.tgz \
   --namespace opensandbox-system \
   --create-namespace
 ```
@@ -187,7 +187,7 @@ helm install opensandbox ./opensandbox-controller-<version>.tgz \
 
 ```sh
 # 示例：自定义资源限制
-helm install opensandbox \
+helm install opensandbox-controller \
   https://github.com/alibaba/OpenSandbox/releases/download/helm/opensandbox-controller/0.1.0/opensandbox-controller-0.1.0.tgz \
   --namespace opensandbox-system \
   --create-namespace \
@@ -196,7 +196,7 @@ helm install opensandbox \
   --set controller.resources.limits.memory=512Mi
 
 # 示例：自定义日志级别
-helm install opensandbox \
+helm install opensandbox-controller \
   https://github.com/alibaba/OpenSandbox/releases/download/helm/opensandbox-controller/0.1.0/opensandbox-controller-0.1.0.tgz \
   --namespace opensandbox-system \
   --create-namespace \
@@ -221,7 +221,7 @@ controller:
 EOF
 
 # 使用自定义 values 安装
-helm install opensandbox \
+helm install opensandbox-controller \
   https://github.com/alibaba/OpenSandbox/releases/download/helm/opensandbox-controller/0.1.0/opensandbox-controller-0.1.0.tgz \
   --namespace opensandbox-system \
   --create-namespace \
@@ -243,7 +243,7 @@ helm install opensandbox \
 
 2. **使用 Helm 安装：**
    ```sh
-   helm install opensandbox ./charts/opensandbox-controller \
+   helm install opensandbox-controller ./charts/opensandbox-controller \
      --set controller.image.repository=<some-registry>/opensandbox-controller \
      --set controller.image.tag=<tag> \
      --namespace opensandbox-system \
@@ -265,15 +265,15 @@ kubectl logs -n opensandbox-system -l control-plane=controller-manager -f
 
 ```sh
 # 升级到新版本
-helm upgrade opensandbox \
+helm upgrade opensandbox-controller \
   https://github.com/alibaba/OpenSandbox/releases/download/helm/opensandbox-controller/<new-version>/opensandbox-controller-<new-version>.tgz \
   --namespace opensandbox-system
 ```
 
 **卸载：**
 
 ```sh
-helm uninstall opensandbox -n opensandbox-system
+helm uninstall opensandbox-controller -n opensandbox-system
 ```
 
 有关更多配置选项和高级用法，请参阅 [Helm Chart README](charts/opensandbox-controller/README.md)。

kubernetes/README.md

@@ -155,15 +155,15 @@ You can install OpenSandbox Controller directly from GitHub Releases. Check the
 
 ```sh
 # Replace <version> with the desired version (e.g., 0.1.0)
-helm install opensandbox \
+helm install opensandbox-controller \
   https://github.com/alibaba/OpenSandbox/releases/download/helm/opensandbox-controller/<version>/opensandbox-controller-<version>.tgz \
   --namespace opensandbox-system \
   --create-namespace
 ```
 
 Example with specific version:
 ```sh
-helm install opensandbox \
+helm install opensandbox-controller \
   https://github.com/alibaba/OpenSandbox/releases/download/helm/opensandbox-controller/0.1.0/opensandbox-controller-0.1.0.tgz \
   --namespace opensandbox-system \
   --create-namespace
@@ -175,7 +175,7 @@ You can also download the chart first and then install:
 wget https://github.com/alibaba/OpenSandbox/releases/download/helm/opensandbox-controller/<version>/opensandbox-controller-<version>.tgz
 
 # Install from local file
-helm install opensandbox ./opensandbox-controller-<version>.tgz \
+helm install opensandbox-controller ./opensandbox-controller-<version>.tgz \
   --namespace opensandbox-system \
   --create-namespace
 ```
@@ -186,7 +186,7 @@ Use `--set` flags to customize the configuration:
 
 ```sh
 # Example: Custom resource limits
-helm install opensandbox \
+helm install opensandbox-controller \
   https://github.com/alibaba/OpenSandbox/releases/download/helm/opensandbox-controller/0.1.0/opensandbox-controller-0.1.0.tgz \
   --namespace opensandbox-system \
   --create-namespace \
@@ -195,7 +195,7 @@ helm install opensandbox \
   --set controller.resources.limits.memory=512Mi
 
 # Example: Custom log level
-helm install opensandbox \
+helm install opensandbox-controller \
   https://github.com/alibaba/OpenSandbox/releases/download/helm/opensandbox-controller/0.1.0/opensandbox-controller-0.1.0.tgz \
   --namespace opensandbox-system \
   --create-namespace \
@@ -220,7 +220,7 @@ controller:
 EOF
 
 # Install with custom values
-helm install opensandbox \
+helm install opensandbox-controller \
   https://github.com/alibaba/OpenSandbox/releases/download/helm/opensandbox-controller/0.1.0/opensandbox-controller-0.1.0.tgz \
   --namespace opensandbox-system \
   --create-namespace \
@@ -242,7 +242,7 @@ If you're developing or need to customize the chart:
 
 2. **Install with Helm:**
    ```sh
-   helm install opensandbox ./charts/opensandbox-controller \
+   helm install opensandbox-controller ./charts/opensandbox-controller \
      --set controller.image.repository=<some-registry>/opensandbox-controller \
      --set controller.image.tag=<tag> \
      --namespace opensandbox-system \
@@ -264,15 +264,15 @@ kubectl logs -n opensandbox-system -l control-plane=controller-manager -f
 
 ```sh
 # Upgrade to a new version
-helm upgrade opensandbox \
+helm upgrade opensandbox-controller \
   https://github.com/alibaba/OpenSandbox/releases/download/helm/opensandbox-controller/<new-version>/opensandbox-controller-<new-version>.tgz \
   --namespace opensandbox-system
 ```
 
 **Uninstall:**
 
 ```sh
-helm uninstall opensandbox -n opensandbox-system
+helm uninstall opensandbox-controller -n opensandbox-system
 ```
 
 For more configuration options and advanced usage, see the [Helm Chart README](charts/opensandbox-controller/README.md).

kubernetes/charts/opensandbox-controller/README.md

@@ -19,10 +19,10 @@ This chart bootstraps an OpenSandbox Controller deployment on a Kubernetes clust
 
 ## Installing the Chart
 
-To install the chart with the release name `opensandbox`:
+To install the chart with the release name `opensandbox-controller`:
 
 ```bash
-helm install opensandbox ./opensandbox-controller \
+helm install opensandbox-controller ./opensandbox-controller \
   --set controller.image.repository=<your-registry>/opensandbox-controller \
   --set controller.image.tag=v0.1.0 \
   --namespace opensandbox-system \
@@ -33,10 +33,10 @@ The command deploys OpenSandbox Controller on the Kubernetes cluster with defaul
 
 ## Uninstalling the Chart
 
-To uninstall/delete the `opensandbox` deployment:
+To uninstall/delete the `opensandbox-controller` deployment:
 
 ```bash
-helm delete opensandbox -n opensandbox-system
+helm delete opensandbox-controller -n opensandbox-system
 ```
 
 The command removes all the Kubernetes components associated with the chart. Note that CRDs are kept by default (can be changed via `crds.keep`).
@@ -190,7 +190,7 @@ spec:
 To upgrade the chart:
 
 ```bash
-helm upgrade opensandbox ./opensandbox-controller \
+helm upgrade opensandbox-controller ./opensandbox-controller \
   --namespace opensandbox-system \
   -f custom-values.yaml
 ```

kubernetes/charts/opensandbox/.gitignore

@@ -0,0 +1,3 @@
+# Helm dependencies - auto-generated by 'helm dependency build'
+# Do not commit packaged sub-charts; they will be rebuilt from source
+charts/

kubernetes/charts/opensandbox/Chart.lock

@@ -0,0 +1,9 @@
+dependencies:
+- name: opensandbox-controller
+  repository: file://../opensandbox-controller
+  version: 0.1.0
+- name: opensandbox-server
+  repository: file://../opensandbox-server
+  version: 0.1.0
+digest: sha256:c66976fab3f4eea75ec3004c1842079d754387ea430c56cce5514e4f457ee40c
+generated: "2026-03-04T17:56:49.467373+08:00"

kubernetes/charts/opensandbox/Chart.yaml

@@ -0,0 +1,57 @@
+# Copyright 2026 Alibaba Group Holding Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+apiVersion: v2
+name: opensandbox
+description: All-in-one Helm chart for deploying OpenSandbox controller and server
+type: application
+version: 0.1.0
+appVersion: "0.1.0"
+
+keywords:
+  - sandbox
+  - kubernetes
+  - operator
+  - api
+  - lifecycle
+  - batchsandbox
+
+home: https://github.com/alibaba/OpenSandbox
+sources:
+  - https://github.com/alibaba/OpenSandbox/tree/main/kubernetes
+
+maintainers:
+  - name: OpenSandbox Team
+    email: opensandbox@example.com
+
+# Kubernetes version constraints
+kubeVersion: ">=1.21.1-0"
+
+dependencies:
+  - name: opensandbox-controller
+    version: "0.1.0"
+    repository: "file://../opensandbox-controller"
+  - name: opensandbox-server
+    version: "0.1.0"
+    repository: "file://../opensandbox-server"
+
+annotations:
+  artifacthub.io/category: integration-delivery
+  artifacthub.io/license: Apache-2.0
+  artifacthub.io/prerelease: "false"
+  artifacthub.io/links: |
+    - name: Documentation
+      url: https://github.com/alibaba/OpenSandbox/blob/main/kubernetes/README.md
+    - name: Support
+      url: https://github.com/alibaba/OpenSandbox/issues