ci: add release pipeline and getting-started doc

Signed-off-by: imeoer <yansong.ys@antgroup.com>

Author: imeoer

.github/workflows/release.yml

@@ -0,0 +1,86 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    env:
+      REGISTRY: ghcr.io
+      IMAGE_NAME: ${{ github.repository }}
+      CHART_NAME: model-csi-driver
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Cache Docker layers
+        uses: actions/cache@v4
+        with:
+          path: /tmp/.buildx-cache
+          key: ${{ runner.os }}-docker-buildx-${{ github.sha }}
+          restore-keys: |
+            ${{ runner.os }}-docker-buildx-
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Extract tag name (version)
+        id: extract_tag
+        run: echo "tag=${GITHUB_REF##*/}" >> "$GITHUB_OUTPUT"
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: ./build/Dockerfile
+          push: true
+          platforms: linux/amd64,linux/arm64
+          tags: |
+            ghcr.io/${{ github.repository }}:${{ steps.extract_tag.outputs.tag }}
+            ghcr.io/${{ github.repository }}:latest
+          cache-from: type=local,src=/tmp/.buildx-cache
+          cache-to: type=local,dest=/tmp/.buildx-cache-new
+
+      - name: Move Docker Build Cache
+        run: |
+          rm -rf /tmp/.buildx-cache
+          mv /tmp/.buildx-cache-new /tmp/.buildx-cache || true
+
+      - name: Install Helm
+        run: |
+          curl -fsSL https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
+
+      - name: Update chart version
+        run: |
+          TAG=$(echo ${{ steps.extract_tag.outputs.tag }} | sed 's/^v//')
+          sed -i "s/VERSION/${TAG}/g" charts/${CHART_NAME}/Chart.yaml
+
+      - name: Helm registry login
+        run: |
+          echo ${{ secrets.GITHUB_TOKEN }} | helm registry login ghcr.io --username ${{ github.actor }} --password-stdin
+
+      - name: Helm package chart
+        run: |
+          helm package charts/${CHART_NAME} --destination .
+      
+      - name: Helm push chart to GHCR
+        run: |
+          CHART_VERSION=$(yq e '.version' charts/${CHART_NAME}/Chart.yaml)
+          CHART_PKG=${CHART_NAME}-${CHART_VERSION}.tgz
+          helm push $CHART_PKG oci://ghcr.io/${{ github.repository_owner }}/charts

README.md

@@ -1,9 +1,11 @@
 # Model CSI Driver
 
-**Status**: 🚧 This project is actively developed, the CI setup and documentation are still in progress.
-
 Model CSI Driver is a Kubernetes CSI driver for serving OCI model artifacts, which are bundled based on [Model Spec](https://github.com/modelpack/model-spec).
 
+## Documentation
+
+You can find the full documentation on the [getting started](./docs/getting-started.md).
+
 ## Copyright
 
 Copyright © contributors to ModelPack, established as ModelPack a Series of LF Projects, LLC.

build/Dockerfile

@@ -0,0 +1,8 @@
+FROM golang:1.24 AS builder
+WORKDIR /app
+COPY . .
+RUN make release
+
+FROM ubuntu:24.04
+COPY --from=builder /app/model-csi-driver /usr/bin/model-csi-driver
+ENTRYPOINT ["/usr/bin/model-csi-driver"]

charts/model-csi-driver/Chart.yaml

@@ -15,7 +15,7 @@ type: application
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
-version: 0.1.0
+version: "0.1.0"
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application. Versions are not expected to

charts/model-csi-driver/values.yaml

@@ -9,12 +9,9 @@ config:
   # must be writable and have enough disk space for model storage
   rootDir: /var/lib/model-csi
   registryAuths:
-    # Registry host:port
-    registry.example.com:
-      # Based64 encoded username:password
-      auth: dXNlcm5hbWU6cGFzc3dvcmQ=
-      # Registry server scheme, http or https
-      serverscheme: https
+    # registry.example.com:
+    #   auth: dXNlcm5hbWU6cGFzc3dvcmQ=
+    #   serverscheme: https
 
 namespace: model-csi
 

docs/getting-started.md

@@ -48,7 +48,7 @@ config:
 
 3. Install the driver using Helm:
 ```bash
-helm install model-csi-driver ./charts/model-csi-driver \
+helm upgrade --install model-csi-driver ./charts/model-csi-driver \
     --namespace model-csi \
     --create-namespace \
     -f values-custom.yaml
@@ -61,6 +61,10 @@ kubectl get pods -n model-csi
 
 ## Basic Usage
 
+### Create model artifact with modctl
+
+Follow [guide](https://github.com/modelpack/modctl/blob/main/docs/getting-started.md) to build and push a model artifact to an OCI distribution-compatible registry.
+
 ### Create a Pod with Model Volume
 
 The Model CSI Driver uses inline volumes directly in pod specifications. Here's a basic example:
@@ -84,7 +88,7 @@ spec:
     csi:
       driver: model.csi.modelpack.org
       volumeAttributes:
-        modelRef: "registry.example.com/models/bert-base:latest"
+        modelRef: "registry.example.com/models/qwen3-0.6b:latest"
 ```
 
 ## Troubleshooting