mirror of
https://github.com/moby/moby.git
synced 2026-01-11 10:41:43 +00:00
74 lines
2.0 KiB
Go
74 lines
2.0 KiB
Go
package client
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"net/url"
|
|
|
|
"github.com/moby/moby/api/types/filters"
|
|
"github.com/moby/moby/api/types/image"
|
|
"github.com/moby/moby/api/types/versions"
|
|
)
|
|
|
|
// ImageList returns a list of images in the docker host.
|
|
//
|
|
// Experimental: Set the [image.ListOptions.Manifest] option
|
|
// to include [image.Summary.Manifests] with information about image manifests.
|
|
// This is experimental and might change in the future without any backward
|
|
// compatibility.
|
|
func (cli *Client) ImageList(ctx context.Context, options ImageListOptions) ([]image.Summary, error) {
|
|
var images []image.Summary
|
|
|
|
// Make sure we negotiated (if the client is configured to do so),
|
|
// as code below contains API-version specific handling of options.
|
|
//
|
|
// Normally, version-negotiation (if enabled) would not happen until
|
|
// the API request is made.
|
|
if err := cli.checkVersion(ctx); err != nil {
|
|
return images, err
|
|
}
|
|
|
|
query := url.Values{}
|
|
|
|
optionFilters := options.Filters
|
|
referenceFilters := optionFilters.Get("reference")
|
|
if versions.LessThan(cli.version, "1.25") && len(referenceFilters) > 0 {
|
|
query.Set("filter", referenceFilters[0])
|
|
for _, filterValue := range referenceFilters {
|
|
optionFilters.Del("reference", filterValue)
|
|
}
|
|
}
|
|
if optionFilters.Len() > 0 {
|
|
filterJSON, err := filters.ToJSON(optionFilters)
|
|
if err != nil {
|
|
return images, err
|
|
}
|
|
if cli.version != "" && versions.LessThan(cli.version, "1.22") {
|
|
legacyFormat, err := encodeLegacyFilters(filterJSON)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
filterJSON = legacyFormat
|
|
}
|
|
query.Set("filters", filterJSON)
|
|
}
|
|
if options.All {
|
|
query.Set("all", "1")
|
|
}
|
|
if options.SharedSize && versions.GreaterThanOrEqualTo(cli.version, "1.42") {
|
|
query.Set("shared-size", "1")
|
|
}
|
|
if options.Manifests && versions.GreaterThanOrEqualTo(cli.version, "1.47") {
|
|
query.Set("manifests", "1")
|
|
}
|
|
|
|
resp, err := cli.get(ctx, "/images/json", query, nil)
|
|
defer ensureReaderClosed(resp)
|
|
if err != nil {
|
|
return images, err
|
|
}
|
|
|
|
err = json.NewDecoder(resp.Body).Decode(&images)
|
|
return images, err
|
|
}
|