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