Pod logs, exec & status

use RoundlyConsulting\KubernetesApi\DataTransferObjects\PodLogOptions;

$pod = $cluster->pods()->setNamespace('shop')->withName('checkout-5f7c9d8b6-x2kqj');

// Fetch logs as a string.
$logs = $pod->logs(new PodLogOptions(container: 'app', tailLines: 200, timestamps: true));

// The previous (crashed) instance of the container, last hour only.
$crash = $pod->logs(new PodLogOptions(container: 'app', previous: true, sinceSeconds: 3600));

// Stream logs line by line (tail). With follow: true it runs until the container stops
// (or client.stream_timeout seconds pass with no output), not the request timeout.
foreach ($pod->streamLogs(new PodLogOptions(container: 'app', follow: true)) as $line) {
    echo $line.PHP_EOL;
}

// Exec a command inside a pod (over a WebSocket; returns stdout, stderr, and exit code).
$result = $cluster->pods()
    ->setNamespace('shop')
    ->withName('checkout-5f7c9d8b6-x2kqj')
    ->exec(['php', 'artisan', 'cache:clear'], container: 'app');

$result->stdout;       // captured standard output
$result->stderr;       // captured standard error
$result->exitCode;     // 0 (null if the stream ended before the command finished)
$result->successful(); // true only for exit code 0
$result->completed();  // false if the connection dropped or client.stream_timeout passed

// Need a shell? Ask for one explicitly.
$cluster->pods()->setNamespace('shop')->withName('checkout-5f7c9d8b6-x2kqj')
    ->exec(['sh', '-c', 'df -h /var/cache && echo done']);

$pod = $cluster->pods()->setNamespace('shop')->withName('checkout-5f7c9d8b6-x2kqj')->find();

$pod->isRunning();             // status.phase === 'Running'
$pod->isSuccessful();          // 'Succeeded'
$pod->hasFailed();             // 'Failed'
$pod->containersReady();       // every container status is ready
$pod->initContainersReady();
$pod->getQos();                // status.qosClass, 'BestEffort' when absent
$pod->getStatusMessage();

$status = $pod->getContainerStatus('app');   // ?ContainerStatus
$status?->getState();          // 'running' | 'waiting' | 'terminated' | 'unknown'
$status?->getStateReason();    // e.g. 'CrashLoopBackOff'
$status?->restarts();          // restart count
$status?->isReady();
$status?->getStartedAt();      // ?Carbon