Patch, scale, rollout & dry-run

use RoundlyConsulting\KubernetesApi\DataTransferObjects\KubernetesPatch;

// Strategic merge patch
$cluster->deployments()->setNamespace('shop')->withName('checkout')
    ->patch(KubernetesPatch::strategicMerge(['spec' => ['replicas' => 4]]));

// JSON merge patch
$cluster->deployments()->setNamespace('shop')->withName('checkout')
    ->patch(KubernetesPatch::merge(['spec' => ['paused' => true]]));

// JSON Patch — a list of operations
$cluster->deployments()->setNamespace('shop')->withName('checkout')
    ->patch(KubernetesPatch::json([
        ['op' => 'replace', 'path' => '/spec/replicas', 'value' => 6],
        ['op' => 'add', 'path' => '/metadata/labels/release', 'value' => 'v1.4.0'],
    ]));

use RoundlyConsulting\KubernetesApi\DataTransferObjects\KubernetesPatch;

// Server-side apply: sent with your manager name as fieldManager. force: true takes over
// fields another manager owns instead of failing with a 409 conflict.
$cluster->deployments()->setNamespace('shop')->withName('checkout')->patch(
    KubernetesPatch::apply([
        'apiVersion' => 'apps/v1',
        'kind' => 'Deployment',
        'metadata' => ['name' => 'checkout', 'namespace' => 'shop'],
        'spec' => ['replicas' => 4],
    ], force: true),
);

// A fieldManager in the query array wins over the manager name.
$cluster->deployments()->setNamespace('shop')->withName('checkout')->patch(
    KubernetesPatch::apply(['apiVersion' => 'apps/v1', 'kind' => 'Deployment', 'metadata' => ['name' => 'checkout']]),
    ['fieldManager' => 'shop-app'],
);

use RoundlyConsulting\KubernetesApi\DataTransferObjects\KubernetesPatch;
use RoundlyConsulting\KubernetesApi\Enums\PatchType;

PatchType::StrategicMerge->contentType(); // 'application/strategic-merge-patch+json'
PatchType::StrategicMerge->label();       // 'Strategic Merge'
PatchType::values();                      // the four content types
PatchType::toOptions();                   // content type => label, for a select input
PatchType::validationRule();              // 'in:application/strategic-merge-patch+json,…'
PatchType::fromName('Json');              // PatchType::Json

// Build a patch from validated input
$patch = new KubernetesPatch(PatchType::from($request->input('type')), $request->input('body'));

// Scale via the /scale subresource. Returns the apiserver's Scale answer (a DTO), not the
// Deployment: $scale->replicas (desired), ->currentReplicas (observed), ->selector.
$scale = $cluster->deployments()->setNamespace('shop')->withName('checkout')->scale(5);
$cluster->statefulSets()->setNamespace('shop')->withName('search')->scale(3);

// Roll the pods by stamping the restartedAt annotation (like kubectl rollout restart).
$cluster->deployments()->setNamespace('shop')->withName('checkout')->rolloutRestart();
$cluster->daemonSets()->setNamespace('monitoring')->withName('node-agent')->rolloutRestart();

// Validate a write without persisting it by appending ?dryRun=All.
$preview = $cluster->deployments()->setNamespace('shop')->withName('checkout')->dryRun()->scale(5);