# Describe a cluster
chainctl cluster describe my-cluster
# Display just the records of images that have been seen in the past 6 hours.
chainctl cluster describe --active-within 6h
# Display just policy information about a cluster
chainctl cluster describe my-cluster --policies
# Display package and image information, and include all records
chainctl cluster describe my-cluster --images --packages --all
# Including all three flags is the same as the default behavior with no flags.
chainctl cluster describe my-cluster --images --packages --policies
--active-within duration How recently a cluster must have been active to be listed. Zero will return all clusters. (default 24h0m0s)
--all Whether to include all records in the output, even for large collections.
-h, --help help for describe
--images Include images data in output. Use with --packages and/or --policies to filter output. If all three are omitted, all categories are included by default.
--packages Include package data in output. Use with --images and/or --policies to filter output. If all three are omitted, all categories are included by default.
--policies Include policy data in output. Use with --packages and/or --images to filter output. If all three are omitted, all categories are included by default.
--api string The url of the Chainguard platform API. (default "http://api.api-system.svc")
--audience string The Chainguard token audience to request. (default "http://api.api-system.svc")
--config string A specific chainctl config file.
--console string The url of the Chainguard platform Console. (default "http://console-ui.api-system.svc")
--issuer string The url of the Chainguard STS endpoint. (default "http://issuer.oidc-system.svc")
-o, --output string Output format. One of: ["", "table", "tree", "json", "id", "wide"]
--timestamp-authority string The url of the Chainguard Timestamp Authority endpoint. (default "http://tsa.timestamp-authority.svc")
-v, --v int Set the log verbosity level.