mirror of
https://github.com/henrygd/beszel.git
synced 2026-08-19 16:57:47 +02:00
340 lines
6.5 KiB
Markdown
340 lines
6.5 KiB
Markdown
# Beszel Hub Helm Chart
|
|
|
|
A Kubernetes Helm chart for deploying [Beszel Hub](https://www.beszel.dev/) - a monitoring and alerting solution for systems, containers, and services.
|
|
|
|
## Overview
|
|
|
|
This Helm chart simplifies the deployment of Beszel Hub in Kubernetes environments. Beszel Hub is a centralized monitoring hub that collects and aggregates system metrics from multiple agents deployed across your infrastructure.
|
|
|
|
## Prerequisites
|
|
|
|
- Kubernetes 1.19+
|
|
- Helm 3.0+
|
|
- At least 500Mi of persistent storage (configurable)
|
|
|
|
## Quick Start
|
|
|
|
### 1. Install the OCI Chart
|
|
|
|
```bash
|
|
helm install beszel-hub oci://ghcr.io/henrygd/beszel-charts/beszel-hub
|
|
```
|
|
|
|
Or with a custom values file:
|
|
|
|
```bash
|
|
helm install beszel-hub oci://ghcr.io/henrygd/beszel-charts/beszel-hub -f custom-values.yaml
|
|
```
|
|
|
|
### 2. Access Beszel Hub
|
|
|
|
By default, Beszel Hub is accessible at `http://beszel-hub:8090` within the cluster.
|
|
|
|
```bash
|
|
# Port forward to access locally
|
|
kubectl port-forward svc/beszel-hub 8090:8090
|
|
```
|
|
|
|
Then visit: `http://localhost:8090`
|
|
|
|
## Configuration
|
|
|
|
### Basic Configuration
|
|
|
|
Key configuration options in `values.yaml`:
|
|
|
|
| Parameter | Default | Description |
|
|
|-----------|---------|-------------|
|
|
| `replicaCount` | `1` | Number of Beszel Hub replicas |
|
|
| `image.repository` | `henrygd/beszel` | Container image repository |
|
|
| `image.tag` | Chart AppVersion (0.18.8) | Container image tag |
|
|
| `image.pullPolicy` | `IfNotPresent` | Image pull policy |
|
|
| `service.port` | `8090` | Service port |
|
|
| `persistentVolumeClaim.enabled` | `true` | Enable persistent volume |
|
|
| `persistentVolumeClaim.size` | `500Mi` | PVC size |
|
|
|
|
### Installation with Custom Values
|
|
|
|
```bash
|
|
helm install beszel-hub ./beszel-hub \
|
|
--set replicaCount=2 \
|
|
--set persistentVolumeClaim.size=1Gi \
|
|
--set service.type=LoadBalancer
|
|
```
|
|
|
|
Or create a custom values file:
|
|
|
|
```yaml
|
|
# custom-values.yaml
|
|
replicaCount: 2
|
|
service:
|
|
type: LoadBalancer
|
|
persistentVolumeClaim:
|
|
size: 1Gi
|
|
```
|
|
|
|
Then install:
|
|
|
|
```bash
|
|
helm install beszel-hub ./beszel-hub -f custom-values.yaml
|
|
```
|
|
|
|
## Advanced Configuration
|
|
|
|
### Ingress Configuration
|
|
|
|
Enable and configure Ingress for external access:
|
|
|
|
```yaml
|
|
ingress:
|
|
enabled: true
|
|
className: nginx # or your ingress class
|
|
annotations:
|
|
cert-manager.io/cluster-issuer: "letsencrypt-prod"
|
|
hosts:
|
|
- host: beszel.example.com
|
|
paths:
|
|
- path: /
|
|
pathType: Prefix
|
|
tls:
|
|
- secretName: beszel-tls
|
|
hosts:
|
|
- beszel.example.com
|
|
```
|
|
|
|
### Persistent Volume Configuration
|
|
|
|
To use an existing PersistentVolumeClaim:
|
|
|
|
```yaml
|
|
persistentVolumeClaim:
|
|
enabled: true
|
|
existingClaim: "my-existing-pvc"
|
|
```
|
|
|
|
Or to use a specific storage class:
|
|
|
|
```yaml
|
|
persistentVolumeClaim:
|
|
enabled: true
|
|
storageClass: "fast-ssd"
|
|
size: 1Gi
|
|
```
|
|
|
|
### Resource Limits
|
|
|
|
Set CPU and memory limits:
|
|
|
|
```yaml
|
|
resources:
|
|
limits:
|
|
cpu: 500m
|
|
memory: 512Mi
|
|
requests:
|
|
cpu: 250m
|
|
memory: 256Mi
|
|
```
|
|
|
|
### Autoscaling
|
|
|
|
Enable Horizontal Pod Autoscaler:
|
|
|
|
```yaml
|
|
autoscaling:
|
|
enabled: true
|
|
minReplicas: 2
|
|
maxReplicas: 10
|
|
targetCPUUtilizationPercentage: 80
|
|
```
|
|
|
|
### Node Selection
|
|
|
|
Schedule pods on specific nodes:
|
|
|
|
```yaml
|
|
nodeSelector:
|
|
node-type: monitoring
|
|
|
|
tolerations:
|
|
- key: "monitoring"
|
|
operator: "Equal"
|
|
value: "true"
|
|
effect: "NoSchedule"
|
|
```
|
|
|
|
## Deployment Examples
|
|
|
|
### Production Setup
|
|
|
|
```yaml
|
|
replicaCount: 3
|
|
image:
|
|
tag: "0.18.8"
|
|
service:
|
|
type: LoadBalancer
|
|
ingress:
|
|
enabled: true
|
|
className: nginx
|
|
hosts:
|
|
- host: beszel.example.com
|
|
paths:
|
|
- path: /
|
|
pathType: Prefix
|
|
tls:
|
|
- secretName: beszel-tls
|
|
hosts:
|
|
- beszel.example.com
|
|
persistentVolumeClaim:
|
|
enabled: true
|
|
storageClass: "fast-ssd"
|
|
size: 2Gi
|
|
resources:
|
|
limits:
|
|
cpu: 1000m
|
|
memory: 1Gi
|
|
requests:
|
|
cpu: 500m
|
|
memory: 512Mi
|
|
autoscaling:
|
|
enabled: true
|
|
minReplicas: 3
|
|
maxReplicas: 10
|
|
targetCPUUtilizationPercentage: 75
|
|
```
|
|
|
|
### Development/Test Setup
|
|
|
|
```yaml
|
|
replicaCount: 1
|
|
service:
|
|
type: ClusterIP
|
|
persistentVolumeClaim:
|
|
enabled: true
|
|
size: 500Mi
|
|
resources:
|
|
limits:
|
|
cpu: 200m
|
|
memory: 256Mi
|
|
requests:
|
|
cpu: 100m
|
|
memory: 128Mi
|
|
```
|
|
|
|
## Managing Beszel Hub
|
|
|
|
### Upgrade
|
|
|
|
```bash
|
|
helm upgrade beszel-hub ./beszel-hub
|
|
```
|
|
|
|
### Check Status
|
|
|
|
```bash
|
|
# Get deployment status
|
|
kubectl get deployment beszel-hub
|
|
kubectl get pods -l app.kubernetes.io/name=beszel
|
|
|
|
# Get service info
|
|
kubectl get svc beszel-hub
|
|
```
|
|
|
|
### View Logs
|
|
|
|
```bash
|
|
kubectl logs -l app.kubernetes.io/name=beszel -f
|
|
```
|
|
|
|
### Access Pod Shell
|
|
|
|
```bash
|
|
kubectl exec -it <pod-name> -- sh
|
|
```
|
|
|
|
### Uninstall
|
|
|
|
```bash
|
|
helm uninstall beszel-hub
|
|
```
|
|
|
|
## Connecting Beszel Agents
|
|
|
|
After deploying Beszel Hub, you can connect Beszel agents running on:
|
|
- Kubernetes nodes
|
|
- VM instances
|
|
- Bare metal servers
|
|
- Docker containers
|
|
|
|
Agents communicate with the Hub on port `8090`. Configure the agent with the Hub's address:
|
|
|
|
```
|
|
HUB_URL=http://beszel-hub.default.svc.cluster.local:8090
|
|
```
|
|
|
|
Or for external access, use the LoadBalancer IP/DNS or Ingress hostname.
|
|
|
|
## Troubleshooting
|
|
|
|
### Pod won't start
|
|
|
|
```bash
|
|
# Check pod status and events
|
|
kubectl describe pod <pod-name>
|
|
kubectl logs <pod-name>
|
|
```
|
|
|
|
### Persistent volume issues
|
|
|
|
```bash
|
|
# Check PVC status
|
|
kubectl get pvc
|
|
kubectl describe pvc beszel-hub
|
|
```
|
|
|
|
### Connection issues with agents
|
|
|
|
- Verify the service is accessible: `kubectl get svc beszel-hub`
|
|
- Check network policies aren't blocking traffic
|
|
- Ensure agents can resolve the Hub's DNS name
|
|
- Verify port `8090` is open on the service
|
|
|
|
### Storage full
|
|
|
|
Increase PVC size:
|
|
|
|
```bash
|
|
# Update the PVC size in values
|
|
helm upgrade beszel-hub ./charts/beszel-hub \
|
|
--set persistentVolumeClaim.size=2Gi
|
|
```
|
|
|
|
## Security Considerations
|
|
|
|
- Use network policies to restrict traffic to Beszel Hub
|
|
- Enable RBAC and pod security policies
|
|
- Use TLS/HTTPS via Ingress with cert-manager
|
|
- Regularly update the image to the latest version
|
|
- Consider running with read-only filesystem
|
|
- Use private container registries if applicable
|
|
|
|
## Persistence
|
|
|
|
By default, Beszel Hub uses a PersistentVolumeClaim for data storage. Ensure your Kubernetes cluster has enough storage capacity and a default storage class configured.
|
|
|
|
## Support and Documentation
|
|
|
|
- **Project Homepage**: https://www.beszel.dev/
|
|
- **GitHub Repository**: https://github.com/henrygd/beszel
|
|
- **Chart Repository**: https://github.com/henrygd/beszel-kubernetes
|
|
|
|
## Chart Information
|
|
|
|
- **Chart Version**: 0.1.0
|
|
- **App Version**: 0.18.8
|
|
- **Kubernetes Version**: 1.19+
|
|
- **Maintainer**: cloudwithdan (nikoloskid@pm.me)
|
|
|
|
## License
|
|
|
|
Please refer to the main Beszel project repository for license information.
|