Synopsis
The list command prints a table with the artifact tags and their digests. By default, the last 100 tags in descending lexical order are listed, use ‘—limit 0’ to list all tags.timoni artifact list ARTIFACT_URL [flags]
Examples
# Print the last 100 tags and their digests
timoni artifact ls oci://docker.io/org/app
# Print the last 10 tags
timoni artifact list oci://docker.io/org/app --limit 10
# Print all the tags without digests
timoni artifact list oci://ghcr.io/org/bundles/app --limit 0 --with-digest=false
# Print the tags matching a regular expression
timoni artifact list oci://docker.io/org/app --filter-regex '^1\.'
# Print the tags matching a semver range
timoni artifact list oci://docker.io/org/app --filter-semver '>=1.0.0 <2.0.0'
# Print the tags and digests of an artifact stored in a private repository
echo $DOCKER_TOKEN | timoni registry login docker.io -u timoni --password-stdin
timoni artifact list oci://docker.io/org/app
# Check if a tag is published using the JSON output
timoni artifact list oci://ghcr.io/org/bundles/app --limit 0 -o json | \
jq -e --arg t "latest" 'any(.[]; .tag == $t)'
Options
--creds creds The credentials for the container registry in the format '<username>[:<password>]'.
--filter-regex string Filter tags returned from the OCI repository using regular expressions.
--filter-semver string Filter tags returned from the OCI repository using semantic version ranges.
-h, --help help for list
--limit int Limit the number of tags listed in descending lexical order (0 for all). (default 100)
-o, --output string The format in which the tags should be printed, can be 'yaml' or 'json'.
--with-digest Resolve the digest of each tag. (default true)
Options inherited from parent commands
--cache-dir string Artifacts cache dir, can be disable with 'TIMONI_CACHING=false' env var. (defaults to "$HOME/.timoni/cache")
--kube-as string Username to impersonate for the operation. User could be a regular user or a service account in a namespace.
--kube-as-group stringArray Group to impersonate for the operation, this flag can be repeated to specify multiple groups.
--kube-as-uid string UID to impersonate for the operation.
--kube-certificate-authority string Path to a cert file for the certificate authority.
--kube-client-certificate string Path to a client certificate file for TLS.
--kube-client-key string Path to a client key file for TLS.
--kube-context string The name of the kubeconfig context to use.
--kube-insecure-skip-tls-verify if true, the Kubernetes API server's certificate will not be checked for validity. This will make your HTTPS connections insecure.
--kube-server string The address and port of the Kubernetes API server.
--kube-tls-server-name string Server name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used.
--kube-token string Bearer token for authentication to the API server.
--kubeconfig string Path to the kubeconfig file.
--log-color Adds colorized output to the logs. (defaults to false when no tty)
--log-pretty Adds timestamps to the logs. (default true)
-n, --namespace string The the namespace scope for the operation. (default "default")
--registry-insecure If true, allows connecting to a container registry without TLS or with a self-signed certificate.
--timeout duration The length of time to wait before giving up on the current operation. (default 5m0s)
See also
- timoni artifact - Commands for managing Open Container Initiative (OCI) artifacts