cri-tools

No entries match these filters. Clear filters

1. v1.37.0 Sep 1, 2026 · issue 061

   crictl gains --max-retries for connection retry with exponential backoff, plus OpenTelemetryOpenTelemetryAn open standard and set of tools for collecting traces, metrics and logs from applications. It lets services export observability data without tying instrumentation to one monitoring vendor. root spans and CRICTL_CREDSCRICTL_CREDSAn environment variable used to pass container registry credentials to crictl, the CLI for CRI-compatible container runtimes; cyber tools use it to pull images without embedding secrets in command arguments./CRICTL_AUTH support on create/run.

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v1.37.0 https://github.com/kubernetes-sigs/cri-tools.git
   # already have the repo? check out this version:
   $ git checkout v1.37.0

   └──▷ TRY IT
   Pull and run a container from a private registry using credentials via environment variables, matching the behaviour already available in crictl pull.
   copy

   $ CRICTL_CREDS='myuser:mypassword' crictl run container-config.json pod-config.json

   • Adds --max-retries flag to crictl to control connection retry attempts with exponential backoff (default: 3).
   • Adds CRICTL_CREDS and CRICTL_AUTH environment variables and -u alias for --username to the crictl create and crictl run commands, aligning them with crictl pull.
   • OpenTelemetry tracing now emits a root span per crictl execution that groups all gRPCgRPCAn open-source remote procedure call framework from Google that uses HTTP/2 and Protocol Buffers to let services call each other's functions across a network, giving tools low-latency, strongly typed inter-process communication. calls made to the runtime during that invocation.
   • New critest conformance tests for image volumes, NRI callbacks during container and pod sandbox lifecycle events, and NRI plugin failure scenarios in CreateContainer and RunPodSandbox.

   4 details in Everything

2. v1.36.0 Apr 24, 2026 · release notes

   cri-tools v1.36.0 adds critest coverage for CRI API image ID/ref consistency and warns on multi-tag image removal

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v1.36.0 https://github.com/kubernetes-sigs/cri-tools.git
   # already have the repo? check out this version:
   $ git checkout v1.36.0

   • Adds critest cases to validate CRI API image ID and image ref consistency across operations.
   • Adds critest cases to validate image operation consistency end-to-end.
   • Adds a warning to crictl rmi when removing a multi-tagged image, since the CRI API removes all tags, not just the specified one.

   3 details in Everything

3. v1.34.0 Aug 21, 2025 · release notes

   cri-tools v1.34.0 adds a metricdescs subcommand, WebSocketWebSocketA protocol that upgrades an HTTP connection into a persistent, full-duplex channel, letting a server push data to a client without repeated polling. Cyber tools use it for real-time event streaming and live command output. streaming test flags, and automatic pod UUIDUUIDA universally unique identifier, usually a 128-bit value used to identify an object across systems. It is designed to make independently generated identifiers unlikely to collide. generation.

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v1.34.0 https://github.com/kubernetes-sigs/cri-tools.git
   # already have the repo? check out this version:
   $ git checkout v1.34.0

   └──▷ TRY IT
   List all metric descriptors exposed by the container runtime to discover available metrics.
   copy

   $ crictl metricdescs

   Run CRI streaming conformance tests using WebSocket transport instead of the default HTTP streaming, useful for validating WebSocket support in a runtime.
   copy

   $ critest --websocket-attach --websocket-exec --websocket-portforward

   • Adds metricdescs subcommand to crictl for querying the ListMetricDescriptors API.
   • Adds critest flags --websocket-attach, --websocket-exec, and --websocket-portforward to run streaming tests over WebSockets.
   • Automatically generates a pod UUID when none is provided in the pod config JSON.
   • Emits a warning when the cgroup_parent field is left empty in pod config.json.

   4 details in Everything

4. v1.33.0 Apr 22, 2025 · release notes

   crictl v1.33.0 adds metric descriptors, OOMOOMAn out-of-memory condition: a program requests more memory than the system or device can provide. The allocation fails or the operating system may stop the process. score tuning, runtime features info, and per-stream log filtering.

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v1.33.0 https://github.com/kubernetes-sigs/cri-tools.git
   # already have the repo? check out this version:
   $ git checkout v1.33.0

   └──▷ TRY IT
   List all metric descriptors supported by the container runtime to understand what metrics are available before scraping.
   copy

   $ crictl metricdescs

   Lower the OOM priority of a misbehaving container so the kernel is more likely to kill it before other workloads.
   copy

   $ crictl update --oom-score-adj 500 <container-id>

   Tail only stderr from a container — useful when stdout is noisy and you want to isolate error output.
   copy

   $ crictl logs --stream stderr <container-id>

   • New crictl metricdescs subcommand exposes the ListMetricDescriptors API for querying available metric descriptors from the runtime.
   • New --oom-score-adj flag on crictl update lets operators tune the OOM score of a running container.
   • Adds crictl info now surfaces a RuntimeFeatures object under the .features field (KEP-3619), showing which capabilities the runtime supports.
   • New --stream flag on crictl logs allows fetching a specific log stream (stdout/stderr) from a container.

   4 details in Everything

5. v1.32.0 Dec 9, 2024 · release notes

   crictl v1.32.0 adds TLS for exec/attach, parallel container/image removal, multi-container exec, namespace filtering, and CPUCPUThe main general-purpose processor in a computer. It runs application instructions and coordinates work with memory and other hardware./mem profiling flags.

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v1.32.0 https://github.com/kubernetes-sigs/cri-tools.git
   # already have the repo? check out this version:
   $ git checkout v1.32.0

   └──▷ TRY IT
   Secure a streaming session to a container when the CRI runtime requires mutual TLSmutual TLSMutual TLS, an encrypted connection where both client and server present certificates to prove their identity. It helps services verify who they are communicating with. authentication.
   copy

   $ crictl exec --tls-ca /etc/cri/ca.crt --tls-cert /etc/cri/client.crt --tls-key /etc/cri/client.key --tls-server-name cri-runtime <container-id> /bin/sh

   Profile crictl's own CPU usage while diagnosing a slow stats call, writing a pprof file for offline analysis.
   copy

   $ crictl --profile-cpu /tmp/crictl-cpu.pprof stats

   • Adds TLS support for crictl exec, portforward, and attach via --tls-ca, --tls-cert, --tls-key, and --tls-server-name flags.
   • Adds --profile-cpu and --profile-mem flags to crictl for on-demand CPU and memory profiling.
   • Enables crictl exec to run a single command across multiple containers simultaneously using new --image, --label, --last, --latest, --name, --pod, or --state filter flags.
   • Adds --quiet/-q, --ignore-error/-e, and --parallel/-x flags to crictl exec for quieter, fault-tolerant, parallel execution.
   • Adds --namespace flag to crictl ps and crictl inspect for filtering by pod namespace.

   +4 more show less

   • Outputs container namespace in crictl ps table and verbose output.
   • Enables parallel container removal via crictl rm.
   • Enables parallel image removal via crictl rmi.
   • Adds swap usage to crictl stats default output.

   9 details in Everything

6. v1.31.0 Aug 8, 2024 · release notes

   crictl v1.31.0 adds pull timeouts, JSON schema introspection, runtime config updates, and Ctrl-C interruptibility across commands.

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v1.31.0 https://github.com/kubernetes-sigs/cri-tools.git
   # already have the repo? check out this version:
   $ git checkout v1.31.0

   └──▷ TRY IT
   Cap how long a slow registry pull can block container creation in automated pipelines.
   copy

   $ crictl run --pull-timeout 60s container-config.json pod-config.json

   • Adds --pull-timeout flag to crictl create, run, and pull commands to cap image pull duration.
   • Adds crictl [create,runp,run,pull] jsonschema subcommands to display the pod and/or container config JSON schema.
   • Adds crictl logs --reopen/-r flag to reopen container log files.
   • Adds crictl update-runtime-config subcommand to update the runtime configuration.
   • Adds filtering flags to crictl inspect, inspectp, and inspecti; with no filter, commands now inspect all containers, pods, or images.

   +4 more show less

   • Supports pulling OCIOCIOpen Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. object mounts on container creation when crictl create or crictl run is invoked with --with-pull.
   • Makes container, sandbox, and image commands interruptible via Ctrl-C.
   • Supports Fine-grained SupplementalGroups control (KEP-3619).
   • Outputs JSON, YAML, and go-template slices correctly for crictl inspect, inspectp, and images.

   9 details in Everything

   └──▷ BREAKING ON UPGRADE

   • !The --timeout/-t flag for crictl run is renamed to --cancel-timeout/-T.
7. v1.30.0 Apr 18, 2024 · release notes

   crictl v1.30 adds --transport flags, OTELOTELAn open standard and set of tools for collecting traces, metrics and logs from applications. It lets services export observability data without tying instrumentation to one monitoring vendor. tracing CLI options, and --filter for images

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v1.30.0 https://github.com/kubernetes-sigs/cri-tools.git
   # already have the repo? check out this version:
   $ git checkout v1.30.0

   └──▷ USE IT
   Connect via WebSocketWebSocketA protocol that upgrades an HTTP connection into a persistent, full-duplex channel, letting a server push data to a client without repeated polling. Cyber tools use it for real-time event streaming and live command output. for better firewall compatibility when executing into a container.
   shell copy

   crictl exec --transport websocket <container-id> sh

   List only dangling images to identify and clean up unused layers.
   shell copy

   crictl images --filter dangling=true

   • Adds --transport / -r flag to crictl exec, attach, port-forward to select between spdy (default) and websocket transport.
   • Adds OTEL tracing via CLI flags --enable-tracing, --tracing-endpoint, and --tracing-sampling-rate-per-million.
   • Changes default behavior in crictl rm to delete container logs; adds --keeplogs, -k option to preserve them.
   • Implements --filter flag for crictl images with support for dangling, reference, before, and since filters.
   • Adds user namespace tests to critest that try a working runtime handler and skip automatically if missing.

   5 details in Everything

   └──▷ BREAKING ON UPGRADE

   • !The default behavior of crictl rm now deletes the container's log file; use --keeplogs or -k to preserve them.
8. v1.29.0 Dec 12, 2023 · release notes

   cri-tools v1.29.0 adds crictl events command for container event streaming

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v1.29.0 https://github.com/kubernetes-sigs/cri-tools.git
   # already have the repo? check out this version:
   $ git checkout v1.29.0

   └──▷ USE IT
   Stream container events in real-time to monitor lifecycle changes across pods and containers.
   shell copy

   crictl events --container-id <container_id>

   • Added crictl events command to fetch and print container events
   • Added support for container runtime use systemd cgroups
   • Allow for imagefsinfo to report container_filesystem and image_filesystem

   3 details in Everything

   └──▷ BREAKING ON UPGRADE

   • !Removed support for linux/arm from the release binaries
9. v1.28.0 Aug 14, 2023 · release notes

   cri-tools v1.28.0 adds crictl metricsp and crictl runtime-config subcommands

   └──▷ GET THIS VERSION

   copy

   $ git clone --branch v1.28.0 https://github.com/kubernetes-sigs/cri-tools.git
   # already have the repo? check out this version:
   $ git checkout v1.28.0

   └──▷ USE IT
   Inspect container runtime configuration to verify default settings or limits.
   shell copy

   crictl runtime-config

   Retrieve real-time resource usage metrics for pods via the CRI interface.
   shell copy

   crictl metricsp

   • crictl metricsp command to display pod metrics from the CRI
   • crictl runtime-config command added

   2 details in Everything

10. v1.27.1 Jul 11, 2023 · release notes

    crictl imagefsinfo -o table now outputs InodesUsed and UsedBytes fields

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.27.1 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.27.1

11. v1.27.0 Apr 17, 2023 · release notes

    cri-tools v1.27.0 adds Windows pod stats display, crictl config list flag, and NAME row to stats output

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.27.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.27.0

    └──▷ USE IT
    Print the resolved crictl configuration (e.g., runtime endpoint, timeout) to stdout without editing config files.
    shell copy

    crictl config list

    • crictl config gains a list flag to display the current configuration values
    • crictl stats adds a NAME column to its output table
    • crictl can now display Windows pod statistics

    3 details in Everything

12. v1.26.1 Mar 15, 2023 · release notes

    Adds --list flag to crictl circt config and NAME column to stats output

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.26.1 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.26.1

    └──▷ USE IT
    List all available Circt configurations on the node.
    shell copy

    crictl circt config --list

13. v1.26.0 Dec 14, 2022 · release notes

    crictl pull now accepts --username for registry authentication

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.26.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.26.0

14. v1.25.0 Aug 26, 2022 · release notes

    cri-tools v1.25 adds --benchmarking-params-file and --benchmarking-output-dir flags for custom benchmark control

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.25.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.25.0

    └──▷ TRY IT
    Run benchmarks using custom parallelism settings defined in an external YAML file instead of defaults.
    copy

    $ critest --benchmarking-params-file=custom-bench.yaml

    Store benchmark output logs and metrics in a specific directory for later analysis or CI integration.
    copy

    $ critest --benchmarking-output-dir=/var/log/critest-benchmarks

    • Adds --benchmarking-params-file CLI flag to specify a YAML file with custom benchmark parameters controlling total and parallel execution counts
    • Adds --benchmarking-output-dir CLI flag to specify a pre-existing directory where benchmark results are saved

    2 details in Everything

15. v1.24.2 May 27, 2022 · release notes

    Critest gains --benchmarking-params-file and --benchmarking-output-dir flags for custom benchmark control

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.24.2 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.24.2

    └──▷ USE IT
    Run critest benchmarks using custom parallelism and timing parameters defined in a YAML file, with results saved to a specific folder.
    shell copy

    critest --benchmarking-params-file /path/to/params.yaml --benchmarking-output-dir /tmp/benchmarks

    • Adds optional --benchmarking-params-file CLI flag to critest for specifying a YAML file with custom benchmark parameters.
    • Adds optional --benchmarking-output-dir CLI flag to critest for saving benchmark results to a pre-existing directory.

    2 details in Everything

16. v1.24.1 May 12, 2022 · release notes

    cri-tools v1.24.1 adds optional --benchmarking-params-file and --benchmarking-output-dir flags to critest.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.24.1 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.24.1

    └──▷ TRY IT
    Run critest with custom parallelism limits defined in a config file instead of defaults.
    copy

    $ critest --benchmarking-params-file /path/to/custom-params.yaml

    Save benchmark output to a specific directory for archival or analysis.
    copy

    $ critest --benchmarking-output-dir /var/log/critest-benchmarks

    • critest now accepts --benchmarking-params-file to specify a YAML file defining custom benchmark parameters controlling total and parallel execution counts
    • critest now accepts --benchmarking-output-dir to save benchmark results into a pre-existing directory

    2 details in Everything

17. v1.24.0 May 5, 2022 · release notes

    cri-tools v1.24.0 adds crictl statsp command, CRICTL_AUTH/CREDS env vars, and pod info to ps output

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.24.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.24.0

    └──▷ TRY IT
    Monitor resource usage for the sandbox of a specific pod.
    copy

    $ crictl statsp --pod-sandbox-id <POD_SANDBOX_ID>

    Authenticate crictl pull against a private registry using base64-encoded credentials.
    copy

    $ CRICTL_AUTH='Bearer <token>' crictl pull <registry>/<image>:<tag>

    Resolve and display the full image path in crictl ps output instead of the image ID.
    copy

    $ crictl ps -r

    • Adds the crictl statsp subcommand to retrieve pod sandbox statistics
    • Supports authentication via the CRICTL_AUTH environment variable for registry credentials
    • Supports credential file paths via the CRICTL_CREDSCRICTL_CREDSAn environment variable used to pass container registry credentials to crictl, the CLI for CRI-compatible container runtimes; cyber tools use it to pull images without embedding secrets in command arguments. environment variable
    • crictl pull accepts the --annotation flag for passing image annotations
    • crictl ps now displays a POD column showing the container's pod name

    +2 more show less

    • Adds -r / --resolve-image-path boolean flag to crictl ps to resolve and display image paths instead of IDs
    • Switches default CRI API to v1, requiring Kubernetes v1.23.0+ with a v1 runtime

    7 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The default CRI API version is switched to v1, which requires a Kubernetes cluster running at least v1.23.0 with a v1 runtime configured.
18. v1.23.0 Jan 17, 2022 · release notes

    cri-tools v1.23.0 adds --test-images-file flag for custom test images and auto-detection of cri-dockerd socket

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.23.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.23.0

    └──▷ TRY IT
    Run CRI tests using custom container images defined in a YAML file
    copy

    $ critest --test-images-file /path/to/custom-images.yaml

    • Adds --test-images-file CLI flag to critest for providing a YAML file with custom container image overrides like defaultTestContainerImage and webServerTestImage. (new)
    • Adds automatic detection of the cri-dockerd socket after dockershim removal. (new)

    2 details in Everything

19. v1.22.0 Aug 5, 2021 · release notes

    crictl can now update resource limits for Windows Containers.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.22.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.22.0

20. v1.21.0 Apr 9, 2021 · release notes

    cri-tools v1.21.0 adds mips64le release artifacts and SHA-256SHA-256A cryptographic hash function that turns data into a fixed 256-bit fingerprint. It is used to check integrity; hashing does not encrypt the original data. checksums

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.21.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.21.0

    • Adds *.sha256 sum files to release artifacts for integrity verification
    • Adds support for mips64le architecture in release download URLs

    2 details in Everything

21. v1.20.0 Jan 6, 2021 · release notes

    cri-tools v1.20.0 adds --timeout flag to crictl create/run/runp for CRI request cancellation

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.20.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.20.0

    └──▷ USE IT
    Cancel a CRI container create request if it hangs for more than 30 seconds.
    shell copy

    crictl --timeout 30s create sandbox-id container-config.json sandbox-config.json

    • Adds --timeout option to crictl create, crictl run, and crictl runp requests to cancel long-running CRI operations.

    1 detail in Everything

    └──▷ BREAKING ON UPGRADE

    • !The timeout option in create, run, and runp requests is renamed to cancel-timeout.
22. v1.19.0 Aug 28, 2020 · release notes

    cri-tools v1.19.0 adds pull-image management for crictl create/run commands and parallel pod sandbox removal

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.19.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.19.0

    └──▷ USE IT
    Filter containers by their state (e.g., created) using the new short flag.
    shell copy

    crictl ps -s created

    • Adds --pull flag to crictl create and crictl run commands to control image pulling behavior
    • Adds -s short option for --state when listing containers with crictl ps
    • Adds Runtime column displaying the RuntimeHandler in crictl ps output
    • Enables parallel removal of pod sandboxes for improved performance

    4 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !Removed darwin/386 release binaries due to go1.15 incompatibility
23. v1.17.0 Dec 16, 2019 · release notes

    crictl v1.17.0 adds rmi --prune for bulk image removal and fish shell completion.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.17.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.17.0

    └──▷ USE IT
    Bulk remove all dangling or unreferenced container images to reclaim disk space.
    shell copy

    crictl rmi --prune

    • Adds the --prune flag to the crictl rmi command to remove unused images in a single pass
    • Enables crictl logs --previous (or -p) to retrieve the previous log output of a container

    2 details in Everything

24. v1.16.0 Sep 17, 2019 · release notes

    crictl adds container run subcommand and several new flags for removal operations in v1.16.0.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.16.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.16.0

    └──▷ USE IT
    Create and start a new container from an image in a single command without separate run steps.
    shell copy

    crictl container run --image nginx:latest

    Force remove all running or stopped containers immediately, bypassing graceful shutdown.
    shell copy

    crictl rm -f -a

    Bulk remove all images from the local store to free up disk space.
    shell copy

    crictl rmi -a

    • Adds crictl container run subcommand to create and start a container in one step
    • Adds -a (remove all) option to rmp command for removing all containers at once
    • Adds --force, -f and --all, -a flags to the crictl rm subcommand
    • Adds --all, -a flag to the crictl rmi subcommand for bulk image removal

    4 details in Everything

25. v1.15.0 Jul 3, 2019 · release notes

    cri-tools v1.15.0 adds --force to crictl rmp and --watch to crictl stats

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.15.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.15.0

    • Adds --force, -f flags to crictl rmp command to allow removing containers that are still running
    • Adds --watch, -w flag to crictl stats command for live monitoring of container resource usage

    2 details in Everything

26. v1.14.0 Mar 25, 2019 · release notes

    cri-tools v1.14.0 adds imagefsinfo subcommand, container image filtering, zsh completion, and Windows critest support

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.14.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.14.0

    └──▷ TRY IT
    Check filesystem usage stats for the container runtime via the CRI API
    copy

    $ crictl imagefsinfo

    List only containers running a specific image, filtering out all others
    copy

    $ crictl ps --image nginx:latest

    Get runtime info in a machine-parseable format without human-readable headers
    copy

    $ crictl info -q

    • Adds the imagefsinfo subcommand to crictl for querying CRI ImageFSInfo() method details
    • Adds filter support to list containers by image name
    • Adds -q flag to crictl info for quiet output mode
    • Adds zsh shell completion scripts for crictl commands
    • Adds full critest validation testing support for Windows container runtimes

    5 details in Everything

27. v1.13.0 Dec 13, 2018 · release notes

    crictl adds --auth flag for pull, container name filter to ps, metadata support in filters, and inspect output for annotations/labels

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.13.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.13.0

    • Adds --auth option to the pull command to allow providing authentication credentials explicitly.
    • Adds a container name filter to the ps command.
    • Adds support for matching against metadata fields in filters.
    • The inspect command now prints annotations and labels for containers and pods.

    4 details in Everything

28. 1.12.0 Sep 25, 2018 · release notes

    cri-tools v1.12.0 adds runtime handler support and Windows npipe to crictl

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch 1.12.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout 1.12.0

    • Adds runtimeHandler flag to crictl pull via new sandbox config option
    • Enables connection to the Windows Dockershim endpoint via the new npipe protocol support
    • Extends crictl ps output to include the pod ID in its list view

    3 details in Everything

29. v1.11.1 Jul 13, 2018 · release notes

    Adds prefix-matching filter flags to crictl pods and ps subcommands

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.11.1 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.11.1

    └──▷ USE IT
    List only pods whose names start with nginx in the production namespace without typing the full pod name.
    shell copy

    crictl pods --namespace production --name nginx

    Filter running containers by a partial container name in a specific namespace.
    shell copy

    crictl ps --namespace kube-system --name etcd

    • Add --name and --namespace flags with prefix matching support to crictl pods and crictl ps for filtering results by partial name or namespace strings

    1 detail in Everything

30. v1.11.0 Jun 19, 2018 · release notes

    cri-tools v1.11.0 adds multi-arch support for test images and container host path validation tests.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.11.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.11.0

    • Adds container host path validation tests to the critest suite.
    • Updates cri-tools to GA status with CRI protocol version v1alpha2 compatibility.

    2 details in Everything

31. 1.0.0-beta.1 Prerelease May 3, 2018 · release notes

    critest gains host network pod portforward test and static linking; crictl update drops oom-score-adj flag

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch 1.0.0-beta.1 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout 1.0.0-beta.1

    • Adds host network pod portforward test to critest for validating pod networking with the host network namespace.
    • Makes both critest and crictl binaries statically linked, removing external library dependencies for binary deployment.

    2 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The oom-score-adj flag is removed from crictl update; passing it will now result in an error.
32. v1.0.0-beta.0 Prerelease Mar 27, 2018 · release notes

    crictl adds ps -q for quiet mode, Windows support, and new env vars

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.0.0-beta.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.0.0-beta.0

    └──▷ TRY IT
    Get a clean list of container IDs for script parsing.
    copy

    $ crictl ps -q

    Configure crictl to connect to a custom runtime and image service on Windows or Linux.
    copy

    $ export CONTAINER_RUNTIME_ENDPOINT=unix:///run/containerd/containerd.sock
    export IMAGE_SERVICE_ENDPOINT=unix:///run/containerd/image.sock
    crictl images

    • Adds crictl ps -q flag to output only container IDs
    • Adds Windows platform support for the crictl CLI
    • Renames endpoint environment variables to CONTAINER_RUNTIME_ENDPOINT and IMAGE_SERVICE_ENDPOINT

    3 details in Everything

    └──▷ BREAKING ON UPGRADE

    • !The sandboxes subcommand is renamed to pods, and the internal type sandbox is renamed to podsandbox in all subcommands.
    • !Environment variables CRI_ENDPOINT and IMAGE_CRI_ENDPOINT (implied by rename) are no longer used; use CONTAINER_RUNTIME_ENDPOINT and IMAGE_SERVICE_ENDPOINT instead.
33. v1.0.0-alpha.0 Prerelease Dec 14, 2017 · release notes

    First release of cri-tools introduces new crictl subcommands (config, stats, completion) and flags for sandbox/image management.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v1.0.0-alpha.0 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v1.0.0-alpha.0

    └──▷ TRY IT
    View resource usage stats for containers via the new crictl subcommand.
    copy

    $ crictl stats

    Configure runtime options for a specific sandbox using the new config command.
    copy

    $ crictl config --help

    Filter pod logs to show only entries from the last 10 minutes with timestamps.
    copy

    $ crictl logs --since 10m --timestamps <container_id>

    • Adds the config command to crictl for runtime configuration
    • Adds the stats command to crictl for container resource monitoring
    • Adds the completion command to crictl for shell auto-completion
    • Adds --digest flag to crictl images command
    • Adds --latest and --last flags to crictl ps and crictl sandboxes commands

    +3 more show less

    • Adds --no-trunc flag to crictl ps, crictl images, and crictl sandboxes commands
    • Adds --timestamps and --since flags to crictl logs command
    • Adds verbose output support to crictl status, crictl inspect, and crictl inspects commands

    8 details in Everything

34. v0.2 Sep 29, 2017 · release notes

    crictl v0.2 adds YAML-based sandbox/container creation, authenticated image pull, and stop timeouts

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v0.2 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v0.2

    • crictl adds support for authenticated image pull (new protocol support for auth-protected registries)
    • crictl adds timeout support for container stop (new argument/flag capability to control operation duration)

    2 details in Everything

35. v0.1 Jun 28, 2017 · release notes

    First release of cri-tools providing CRI validation, crictl CLI for container debugging, and benchmarking frameworks.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v0.1 https://github.com/kubernetes-sigs/cri-tools.git
    # already have the repo? check out this version:
    $ git checkout v0.1

    • Adds crictl CLI to manage CRI-compatible container runtimes (sandbox/container/image lifecycle and streaming) without Kubernetes components
    • Adds CRI validation testing framework with tests for sandbox, container, image, networking, streaming, security context, execSync/version/status operations
    • Adds CRI performance benchmarking framework supporting parallel execution of sandbox, container, and image lifecycle operations

    3 details in Everything