Skip to main content
Version: 0.6.12

FAQs

Error "413 Client Error: Request Entity Too Large" when Copying Starwhale Models to Server

  • Cause: The proxy-body-size set in the Ingress (Nginx default is 1MB) is smaller than the actual uploaded file size.
  • Solution: Check the Ingress configuration of the Starwhale Server and add nginx.ingress.kubernetes.io/proxy-body-size: 30g to the annotations field.

RBAC Authorization Error when Starwhale Server Submits Jobs to Kubernetes Cluster

The Kubernetes cluster has RBAC enabled, and the service account for the Starwhale Server does not have sufficient permissions. It requires at least the following permissions:

ResourceAPI GroupGetListWatchCreateDelete
jobsbatchYYYYY
podscoreYYY
nodescoreYYY
events""Y

Example YAML:

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
name: starwhale-role
rules:
- apiGroups:
- ""
resources:
- pods
- nodes
verbs:
- get
- list
- watch
- apiGroups:
- "batch"
resources:
- jobs
verbs:
- create
- get
- list
- watch
- delete
- apiGroups:
- ""
resources:
- events
verbs:
- get
- watch
- list
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
name: starwhale-binding
roleRef:
apiGroup: rbac.authorization.k8s.io
kind: ClusterRole
name: starwhale-role
subjects:
- kind: ServiceAccount
name: starwhale

How to use swcli server start command to start the local Starwhale Server in macOS (Apple Silicon) environment?

  1. Install Docker Desktop for Mac(Apple Silicon)

  2. Install Docker Compose:

    curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
    chmod +x /usr/local/bin/docker-compose
    docker compose version