LinuxCommandLibrary

crane-index-filter

Filter container image indexes

TLDR

Modify remote index

$ crane index filter
copy

Specify the platform(s) to keep from base in the form os/arch{{/variant}}{{:osversion}}{{,}}
$ crane index filter --platform [platform1 platform2 ...]
copy

Tag to apply to resulting image
$ crane index filter [[-t|--tags]] [tag_name]
copy

Display help
$ crane index filter [[-h|--help]]
copy

SYNOPSIS

crane-index-filter [options] filter_expression

PARAMETERS

--help
    Display help message and exit.

--version
    Display version information and exit.

filter_expression
    Logical expression specifying the filtering criteria. The expression can use metadata attributes and boolean operators (e.g., size > 10GB AND date < 2023-01-01).

DESCRIPTION

The `crane-index-filter` command is a tool used to filter indexes within a crane environment. Crane is a system that likely deals with large-scale data processing and indexing. `crane-index-filter` enables you to selectively choose which indexes to process or manage based on specific criteria like size, date, or other metadata. This is useful for tasks such as targeting specific subsets of data for analysis, cleanup, or migration, avoiding processing the entire index set.

It prevents unnecessary operations on irrelevant indexes, improving efficiency. The command allows specifying filters which are logical predicates to apply to the crane indexes metadata and only return those crane indexes for which it is 'True'.

CAVEATS

The exact syntax and available metadata attributes for the filter_expression are specific to the crane implementation and its configuration. Refer to crane documentation for details.

EXAMPLE USAGE

A common use case would be to filter indexes older than a certain date and larger than a certain size:
crane-index-filter 'date < 2022-01-01 AND size > 1TB'

SEE ALSO

find(1), grep(1)

Copied to clipboard