{"id":13646434,"url":"https://github.com/kubernetes-sigs/cri-tools","last_synced_at":"2025-05-14T21:02:07.357Z","repository":{"id":37405760,"uuid":"80172100","full_name":"kubernetes-sigs/cri-tools","owner":"kubernetes-sigs","description":"CLI and validation tools for Kubelet Container Runtime Interface (CRI) .","archived":false,"fork":false,"pushed_at":"2025-05-07T12:51:17.000Z","size":42517,"stargazers_count":1806,"open_issues_count":10,"forks_count":471,"subscribers_count":35,"default_branch":"master","last_synced_at":"2025-05-07T19:47:42.372Z","etag":null,"topics":["containers","k8s-sig-node","kubelet-cri","kubernetes"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kubernetes-sigs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"code-of-conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY_CONTACTS","support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-01-27T01:22:52.000Z","updated_at":"2025-05-07T17:23:56.000Z","dependencies_parsed_at":"2024-03-25T09:27:27.484Z","dependency_job_id":"14f4930b-43e3-4f90-b162-98f574345d8a","html_url":"https://github.com/kubernetes-sigs/cri-tools","commit_stats":{"total_commits":1113,"total_committers":135,"mean_commits":8.244444444444444,"dds":0.7250673854447439,"last_synced_commit":"31ae1acefb41de3830d95cdb1dafd12aee799aac"},"previous_names":["kubernetes-incubator/cri-tools"],"tags_count":39,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fcri-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fcri-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fcri-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fcri-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kubernetes-sigs","download_url":"https://codeload.github.com/kubernetes-sigs/cri-tools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254227603,"owners_count":22035667,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["containers","k8s-sig-node","kubelet-cri","kubernetes"],"created_at":"2024-08-02T01:02:55.588Z","updated_at":"2025-05-14T21:02:06.917Z","avatar_url":"https://github.com/kubernetes-sigs.png","language":"Go","funding_links":[],"categories":["Cli/Management/Tooling:","kubernetes","Go","Diagnostics \u0026 Troubleshooting"],"sub_categories":[],"readme":"# cri-tools\n\nCLI and validation tools for Kubelet Container Runtime Interface (CRI) .\n\n[![Build Status](https://github.com/kubernetes-sigs/cri-tools/workflows/build/badge.svg)](https://github.com/kubernetes-sigs/cri-tools/actions/workflows/build.yml)\n[![e2e](https://github.com/kubernetes-sigs/cri-tools/workflows/cri-tools%20e2e%20test/badge.svg)](https://github.com/kubernetes-sigs/cri-tools/actions/workflows/e2e.yml)\n[![critest containerd](https://github.com/kubernetes-sigs/cri-tools/workflows/critest%20containerd/badge.svg)](https://github.com/kubernetes-sigs/cri-tools/actions/workflows/containerd.yml)\n[![critest CRI-O](https://github.com/kubernetes-sigs/cri-tools/workflows/critest%20CRI-O/badge.svg)](https://github.com/kubernetes-sigs/cri-tools/actions/workflows/crio.yml)\n[![Go Report Card](https://goreportcard.com/badge/github.com/kubernetes-sigs/cri-tools)](https://goreportcard.com/report/github.com/kubernetes-sigs/cri-tools)\n\n## What is the scope of this project?\n\ncri-tools aims to provide a series of debugging and validation tools for Kubelet CRI, which includes:\n\n- crictl: CLI for kubelet CRI.\n- critest: validation test suites for kubelet CRI.\n\n## What is not in scope for this project?\n\n- Building a new kubelet container runtime based on CRI.\n- Managing pods/containers for CRI-compatible runtimes by end-users, e.g. pods created by crictl may be removed automatically by kubelet because of non-exist on the kube-apiserver.\n\n## Compatibility matrix: cri-tools ⬄ Kubernetes\n\n| Kubernetes Version | cri-tools Version | cri-tools branch |\n| ------------------ | ----------------- | ---------------- |\n| ≥ 1.27.x           | ≥ 1.27.x          | master           |\n| ≥ 1.16.x ≤ 1.26.x  | ≥ 1.16.x ≤ 1.26.x | master           |\n| 1.15.X             | v1.15.0           | release-1.15     |\n| 1.14.X             | v1.14.0           | release-1.14     |\n| 1.13.X             | v1.13.0           | release-1.13     |\n| 1.12.X             | v1.12.0           | release-1.12     |\n| 1.11.X             | v1.11.1           | release-1.11     |\n| 1.10.X             | v1.0.0-beta.2     | release-1.10     |\n| 1.9.X              | v1.0.0-alpha.1    | release-1.9      |\n| 1.8.X              | v0.2              | release-1.8      |\n| 1.7.X              | v0.1              | release-1.7      |\n\nIt's recommended to use the same cri-tools and Kubernetes minor version, because\nnew features added to the Container Runtime Interface (CRI) may not be fully\nsupported if they diverge.\n\ncri-tools follows the Kubernetes release cycles with respect to its minor\nversions (`1.x.y`). Patch releases (`1.x.z`) for Kubernetes are not in sync with\nthose from cri-tools, because they are scheduled for each month, whereas\ncri-tools provides them only if necessary. If a Kubernetes release goes [End of\nLife](https://kubernetes.io/releases/patch-releases/), then the corresponding\ncri-tools version can be considered in the same way.\n\nAll new minor versions of cri-tools are being created from the `master` branch,\nwhereas corresponding `release-1.x` branches will be created if a patch release\nis planned.\n\nSee the [roadmap](docs/roadmap.md) for information about current and future\nmilestones.\n\n## Install\n\n### Install crictl\n\n```sh\nVERSION=\"v1.33.0\"\nwget https://github.com/kubernetes-sigs/cri-tools/releases/download/$VERSION/crictl-$VERSION-linux-amd64.tar.gz\nsudo tar zxvf crictl-$VERSION-linux-amd64.tar.gz -C /usr/local/bin\nrm -f crictl-$VERSION-linux-amd64.tar.gz\n```\n\n### Install critest\n\n```sh\nVERSION=\"v1.33.0\"\nwget https://github.com/kubernetes-sigs/cri-tools/releases/download/$VERSION/critest-$VERSION-linux-amd64.tar.gz\nsudo tar zxvf critest-$VERSION-linux-amd64.tar.gz -C /usr/local/bin\nrm -f critest-$VERSION-linux-amd64.tar.gz\n```\n\n### deb/rpm packages\n\nPackages for various distributions using deb's and rpm's are available in the\n[OBS repository](https://build.opensuse.org/package/show/devel:kubic:libcontainers:stable/cri-tools).\n\n## Documentation\n\n- **[CRI `crictl` CLI](docs/crictl.md)**\n- [CRI validation test suite](docs/validation.md)\n- [CRI performance benchmarking](docs/benchmark.md)\n\n## Community, discussion, contribution, and support\n\nLearn how to engage with the Kubernetes community on the [community page](http://kubernetes.io/community/).\n\nYou can reach the maintainers of this project at:\n\n- Slack: #sig-node\n- Mailing List: \u003chttps://groups.google.com/forum/#!forum/kubernetes-sig-node\u003e\n\n## Contributing\n\nInterested in contributing? Check out the [documentation](CONTRIBUTING.md).\n\n## Code of conduct\n\nParticipation in the Kubernetes community is governed by the [Kubernetes Code of Conduct](code-of-conduct.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubernetes-sigs%2Fcri-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkubernetes-sigs%2Fcri-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubernetes-sigs%2Fcri-tools/lists"}