Skip to content

Latest commit

 

History

7,675 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Strimzi

Run Apache Kafka on Kubernetes and OpenShift

OpenSSF Best Practices OpenSSF Scorecard OSPS Baseline Build Status GitHub release License Twitter Follow Artifact Hub FOSSA Status Known Vulnerabilities

Strimzi provides a way to run an Apache Kafka® cluster on Kubernetes or OpenShift in various deployment configurations. See our website for more details about the project.

Quick Starts

To get up and running quickly, check our Quick Start for Minikube, OKD (OpenShift Origin) and Kubernetes Kind.

Documentation

Documentation for the current main branch as well as all releases can be found on our website.

Roadmap

The roadmap of the Strimzi Operator project is maintained as GitHub Project.

Getting help

If you encounter any issues while using Strimzi, you can get help using:

Strimzi Community Meetings

You can join our regular community meetings:

Resources:

Contributing

You can contribute by:

  • Raising issues you find while using Strimzi
  • Fixing issues by opening Pull Requests
  • Improving Strimzi documentation
  • Talking about Strimzi

All bugs, tasks or enhancements are tracked as GitHub issues. Issues which might be a good start for new contributors are marked with "good-start" label.

The development guide describes how to quickly get set up to build Strimzi from source. Before submitting a patch, make sure you understand how to test your changes by reading the Test guide. The release checklist describes the steps needed for a new version release. The documentation contributor guide describes how to contribute to Strimzi documentation.

Developer Certificate of Origin

The Developer Certificate of Origin (DCO) is a lightweight way for contributors to certify that they wrote or otherwise have the right to submit the code they are contributing to the project. All commits must be signed off by adding a Signed-off-by line to the commit message.

This is my commit message

Signed-off-by: John Doe <[email protected]>

Git has a -s option to append this automatically:

git commit -s -m 'This is my commit message'

If you have already made a commit and forgot to include the sign-off, you can amend your last commit:

git commit --amend -s

Getting help with your contributions

If you want to get in touch with us first before contributing, you can use:

License

Strimzi is licensed under the Apache License, Version 2.0

Community Testing

Linux on IBM Z (s390x)

Jenkins

Note: This badge represents a community-led initiative and is not officially endorsed by the Strimzi project maintainers.

Container signatures

From the 0.38.0 release, Strimzi containers are signed using the cosign tool. Strimzi uses keyless signing since 0.49.0 release. To verify the container, you can run the following command:

cosign verify --certificate-identity-regexp='https://github.com/strimzi/.*' \
    --certificate-oidc-issuer='https://token.actions.githubusercontent.com' \
    quay.io/strimzi/operator:latest

In case you want to verify containers of older version of Strimzi than 0.49.0, then use our public key:

-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAET3OleLR7h0JqatY2KkECXhA9ZAkC
TRnbE23Wb5AzJPnpevvQ1QUEQQ5h/I4GobB7/jkGfqYkt6Ct5WOU2cc6HQ==
-----END PUBLIC KEY-----

And use it to verify the signature:

cosign verify --key strimzi.pub quay.io/strimzi/operator:latest --insecure-ignore-tlog=true

Software Bill of Materials (SBOM)

From the 0.38.0 release, Strimzi publishes the software bill of materials (SBOM) of our containers. The SBOMs are published as an archive with SPDX-JSON and Syft-Table formats signed using cosign. For releases, they are also pushed into the container registry.

Strimzi uses keyless signing since 0.49.0 release. To verify the SBOM signatures, you can run the following command:

cosign verify-blob --bundle <SBOM-file>.bundle \
    --certificate-identity-regexp='https://github.com/strimzi/.*' \
    --certificate-oidc-issuer='https://token.actions.githubusercontent.com' \
    <SBOM-file>

In case you want to verify SBOM signatures of older version of Strimzi than 0.49.0, then use our public key:

-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAET3OleLR7h0JqatY2KkECXhA9ZAkC
TRnbE23Wb5AzJPnpevvQ1QUEQQ5h/I4GobB7/jkGfqYkt6Ct5WOU2cc6HQ==
-----END PUBLIC KEY-----

You can use it to verify the signature of the SBOM files with the following command:

cosign verify-blob --key cosign.pub --bundle <SBOM-file>.bundle --insecure-ignore-tlog=true <SBOM-file>

Strimzi is a Cloud Native Computing Foundation incubating project.

CNCF ><

Artifact attestations

Strimzi release archives, container images and the Helm Chart are published with GitHub artifact attestations containing SLSA build provenance and, for container images, an SPDX SBOM. The attestations are signed keylessly with Sigstore using the GitHub Actions OIDC identity, so no public key is needed to verify them. They are created by the shared Strimzi GitHub Actions workflows, so the --signer-repo strimzi/github-actions option is required when verifying them. You can verify them with the GitHub CLI.

To verify a release archive downloaded from the GitHub release page:

gh attestation verify strimzi-<version>.tar.gz --repo strimzi/strimzi-kafka-operator --signer-repo strimzi/github-actions

Each GitHub release also contains the attestation bundle release-<version>.intoto.jsonl. You can use it to verify the archive without querying the GitHub Attestation API:

gh attestation verify strimzi-<version>.tar.gz --bundle release-<version>.intoto.jsonl --repo strimzi/strimzi-kafka-operator --signer-repo strimzi/github-actions

Container images are attested per architecture, so use the architecture-specific tag (for example -amd64, -arm64, -ppc64le or -s390x) or its digest instead of the multi-architecture tag. To verify the build provenance of a container image:

gh attestation verify oci://quay.io/strimzi/operator:<version>-amd64 --repo strimzi/strimzi-kafka-operator --signer-repo strimzi/github-actions

To verify the SBOM attestation of a container image:

gh attestation verify oci://quay.io/strimzi/operator:<version>-amd64 --repo strimzi/strimzi-kafka-operator --signer-repo strimzi/github-actions --predicate-type https://spdx.dev/Document/v2.3

To verify the Helm Chart published as an OCI artifact:

gh attestation verify oci://quay.io/strimzi-helm/strimzi-kafka-operator:<version> --repo strimzi/strimzi-kafka-operator --signer-repo strimzi/github-actions