Kubernetes

Raku kubectl helpers for Kubernetes and OpenShift workflows.

Distribution: Kubernetes:auth<zef:rmv>
Repository: Rmv-Kubernetes

Synopsis

use Kubernetes::Resources::Core;
use Kubernetes::Resources::Namespace;
use Kubernetes::Client;

my $kubectl = Kubernetes::Client::resolve-kubectl();

# Typed resource with apply/delete
class MyApp does Kubernetes::Resources::Core::NamespacedResource {
    submethod BUILD(Str :$!name!, Str :$!namespace!) {
        $!apiVersion = 'v1';
        $!kind       = 'ConfigMap';
    }
    method to-yaml(--> Str) { ... }
}

# Namespace lifecycle
my $ns = Kubernetes::Resources::Namespace::Namespace.new(:name<my-ns>);
$ns.ensure($kubectl);
$ns.label($kubectl, 'tenant=true');
$ns.delete($kubectl);

# Lightweight handle for resources without a manifest class
my $ref = Kubernetes::Resources::Core::ResourceRef.new(
    :name<my-sub>, :namespace<my-namespace>,
    :kubectl-name<subscription>, :kind<Subscription>,
);
$ref.delete($kubectl);

# Poll until a pod reaches Running
use Kubernetes::Resources::Pod;
my $pod = Kubernetes::Resources::Pod::Pod.new(:name<my-pod>, :namespace<default>);
my ($ready, $phase) = $pod.wait-until-ready($kubectl, :timeout-s(120));

Installation

From zef:

zef install 'Kubernetes:auth<zef:rmv>'

Local development:

git clone https://github.com/ruivieira/Rmv-Kubernetes.git
cd Rmv-Kubernetes
zef install --force-install .

Requires kubectl (or set KUBECTL to an alternate binary path).

Modules

Development

make check        # syntax-check all .rakumod files
make unit         # unit tests (dry-run, no cluster)
make integration  # integration tests (requires KUBECONFIG / KinD)
make lint         # style checks (trailing whitespace, tabs, …)
make secrets      # gitleaks scan
make pre-commit   # run all pre-commit hooks
make all          # check + lint + unit + secrets

Install git hooks:

pre-commit install

Testing

Unit tests (t/*.rakutest) exercise roles and dry-run paths without a live cluster.

Integration tests (t/integration/*.rakutest) run against a reachable cluster. They skip when kubectl cluster-info fails (no kubeconfig or cluster unavailable).

Local KinD example:

kind create cluster
make integration
kind delete cluster

CI

GitHub Actions runs two jobs on every push and pull request:

License

Apache-2.0