beku

Version: 0.0.10

Fast Kuttl tests expander for Stackable integration tests.

beku -i tests/test-definition.yaml -t tests/templates/kuttl -k tests/kuttl-test.yaml.jinja2 -o tests/_work

beku parses a test definition YAML file together with a directory of templated Kuttl test definitions. From this it generates Kuttl test suites which can then be run with plain Kuttl. This was built on top of Kuttl to support running tests with different version combinations of products, or slightly different features enabled, without having to duplicate tests.

Installation

We recommend to use pipx:

pipx install beku-stackabletech

But you can also use pip:

# from PyPI
pip install beku-stackabletech
# from GitHub
pip install git+https://github.com/stackabletech/beku.py.git@main

Or via NixOS and Nix Shell:

{ lib, pkgs, ... }:
with lib;
let
  beku = pkgs.callPackage(pkgs.fetchFromGitHub {
    owner = "stackabletech";
    repo = "beku.py";
    rev = "145e8210f5786b8128e3af43f60b61f065cc2c39";
    hash = "sha256-hLaIY4BE+VIMeKmS3JLOZy87OC2VuQtbX/NCIbQr2p4="; # use lib.fakeHash to find new hashes when upgrading
  } + "/beku.nix") {};
in
{
  packages = with pkgs; [
    beku
    # ...
  ];

  // ...
}

Usage

cd <stackable operator directory>
rm -rf tests/_work && beku
cd tests/_work && kubectl kuttl test

Also see the examples folder.

Release a new version

A new release involves bumping the package version and publishing it to PyPI. The easiest way to publish to PyPI is to allow the release GitHub action to do it for you. This action is also the preferred way, as it will publish a verified package using PyPI attestations.

To release a new version follow the steps below:

1. Create a new Git branch. For example release-1.2.3.
2. Update the version string (1.2.3) in: src/beku/version.py andREADME.md.
3. Commit, push and create a PR.
4. After the PR is merged, switch to the main branch and update it by executing git pull.
5. On the main branch, create and push the release tag. For example: git tag 1.2.3 -m 1.2.3 && git push origin 1.2.3.
6. Done!