https://github.com/jsdelivr/globalping-helm
Official Globalping Probe Helm Chart
https://github.com/jsdelivr/globalping-helm
globalping helm helm-charts
Last synced: 5 months ago
JSON representation
Official Globalping Probe Helm Chart
- Host: GitHub
- URL: https://github.com/jsdelivr/globalping-helm
- Owner: jsdelivr
- Created: 2025-11-11T13:25:51.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2025-12-02T12:51:53.000Z (8 months ago)
- Last Synced: 2025-12-05T09:40:33.139Z (8 months ago)
- Topics: globalping, helm, helm-charts
- Language: Smarty
- Homepage:
- Size: 56.6 KB
- Stars: 1
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Globalping Probe Helm Chart
[](https://artifacthub.io/packages/search?repo=globalping)
Run your own [Globalping Probe](https://github.com/jsdelivr/globalping-probe) on Kubernetes.
## What's This?
Globalping lets you run network measurements (ping, traceroute, DNS, HTTP, MTR) from anywhere in the world. Deploy this chart to contribute your probe to the network and use it for your own measurements.
Get started at [globalping.io](https://globalping.io)
## Quick Install
```bash
# Get your token from globalping.io first
helm repo add globalping https://jsdelivr.github.io/globalping-helm
helm repo update
helm install globalping-probe globalping/globalping \
--set globalpingToken="YOUR_TOKEN" \
--namespace globalping \
--create-namespace
# Check if it's running
kubectl get pods -n globalping
kubectl logs -l app.kubernetes.io/instance=globalping-probe -n globalping -f
```
Your probe should appear in your Globalping dashboard within a minute or two.
## What You Need
- Kubernetes 1.19+
- Helm 3.2.0+
- Globalping token from [globalping.io](https://globalping.io)
## Common Configurations
**Run specific number of probes:**
```bash
helm install globalping-probe globalping/globalping \
--set globalpingToken="YOUR_TOKEN" \
--set deploymentType=deployment \
--set replicaCount=3 \
--namespace globalping \
--create-namespace
```
**Keep probe UUID across restarts:**
```bash
helm install globalping-probe globalping/globalping \
--set globalpingToken="YOUR_TOKEN" \
--set persistence.enabled=true \
--namespace globalping \
--create-namespace
```
**Limit resources:**
```bash
helm install globalping-probe globalping/globalping \
--set globalpingToken="YOUR_TOKEN" \
--set resources.limits.cpu=500m \
--set resources.limits.memory=512Mi \
--namespace globalping \
--create-namespace
```
See [chart README](charts/globalping/README.md) for all options.
## Managing Your Probe
**Upgrade:**
```bash
helm repo update
helm upgrade globalping-probe globalping/globalping \
--namespace globalping \
--reuse-values
```
**View logs:**
```bash
kubectl logs -l app.kubernetes.io/instance=globalping-probe -n globalping -f
```
**Uninstall:**
```bash
helm uninstall globalping-probe --namespace globalping
```
## FAQ
**Why does it need hostNetwork?**
ICMP packets (ping/traceroute) require direct network access. The chart enables this by default.
**Can I run multiple probes?**
Yes. Default is DaemonSet mode (one probe per node). Or use Deployment mode with `replicaCount`.
**Where are my probes?**
Check your [Globalping dashboard](https://globalping.io). They show up within a minute.
**Something not working?**
Check pod status: `kubectl describe pod -n globalping`
Check logs: `kubectl logs -l app.kubernetes.io/instance=globalping-probe -n globalping`
## Publishing Your Own Chart
If you're hosting this chart yourself:
1. **Review metadata** in `.github/cr.yaml`, `artifacthub-repo.yml`, and the chart `Chart.yaml` to match your organization.
2. **Run the “Bootstrap Pages” workflow** to create the `gh-pages` branch and configure GitHub Pages.
3. **Register on Artifact Hub:**
- Sign in with GitHub at [artifacthub.io](https://artifacthub.io)
- Add repository: `https://jsdelivr.github.io/globalping-helm`
4. **Release:** Push chart changes to `main` (or `master`) and the “Release Charts” workflow will publish packages automatically.
**Troubleshooting:**
- Pages not loading? Check Actions tab for workflow errors
- Chart not on Artifact Hub? Wait 30 minutes for scanning
- Need custom domain? Add CNAME record and create `CNAME` file in gh-pages branch
## More Info
- [Globalping Platform](https://globalping.io)
- [Probe Source Code](https://github.com/jsdelivr/globalping-probe)
- [Chart Configuration](charts/globalping/README.md)
## License
Mozilla Public License 2.0 - see [LICENSE](LICENSE)