---
title: "Artisan & diagnostics — Kubernetes API for Laravel | Roundly"
description: "Check connectivity with kubernetes:ping and inspect the default cluster, rate limits, resources and Traefik group in php artisan about."
url: https://roundly-consulting.com/open-source/docs/kubernetes-api-for-laravel/commands
language: en
---

[All packages](https://roundly-consulting.com/open-source.md)

[Kubernetes API for Laravel](https://roundly-consulting.com/open-source/docs/kubernetes-api-for-laravel.md)

# Artisan & diagnostics

kubernetes:ping verifies connectivity to a cluster by calling its /version endpoint with the cluster’s credentials:

```bash
php artisan kubernetes:ping production
# Connected to production — server v1.34.0

php artisan kubernetes:ping
# pings the default cluster (config kubernetes.default)
```

- The argument is a configured or registered cluster name. Without it the command pings the default cluster (kubernetes.default).
- It fails with a readable error when the name is unknown, the cluster has no URL, or the request fails.
- The probe goes through the cluster’s transport — the same per-cluster rate limiter as resource operations, and Kubernetes::fake() answers it in tests.
- In code, Kubernetes::ping() and Kubernetes::cluster('production')->ping() return a bool, and version() returns a VersionInfo DTO (major, minor, gitVersion, gitCommit, buildDate, goVersion, compiler, platform).

## php artisan about

The package adds a Kubernetes section to php artisan about — the default cluster, how many clusters are configured, whether rate limiting and adaptive throttling are on, how many resources are registered and the Traefik group. It shows names and counts only, never a URL, token or certificate path:

```bash
php artisan about --only=kubernetes
```

## Show your open-source love

This package is free and MIT-licensed. If it saves you time, a one-off donation or a Patreon membership keeps it maintained, tested and documented.

[More ways to support, including crypto](https://roundly-consulting.com/support-us.md)

By donating, you agree to our [donation terms](https://roundly-consulting.com/donation-terms.md).

[Support our open source work (opens in a new tab)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Join us on Patreon (opens in a new tab)](https://www.patreon.com/cw/roundly)

## Want this built into your product?

We integrate our packages into custom Laravel and AI builds. Tell us what you're working on and we'll reply within 48 hours.

[Get a quote in 48 hours](https://roundly-consulting.com/contact.md) [Browse all packages](https://roundly-consulting.com/open-source/docs/kubernetes-api-for-laravel.md)
