prune commands : make sure label filters are considered by aduermael · Pull Request #21 · docker/cli

aduermael · 2017-05-02T23:51:09Z

Fixes #17

Checking server API version is at least 1.29 to accept prune commands with label filters.

Signed-off-by: Adrien Duermael adrien@duermael.com

vdemeester · 2017-05-03T10:32:10Z

 		pruneFilters.Add(parts[0], parts[1])
 	}

+	// Server APIs older than 1.29 will just ignore label filters.


I feel we should do that server side though (the cli should be as dumb as possible)
cc @thaJeztah @dnephin

Yes, that would be more correct, but the problem is that the issue is with old servers, so it's hard to fix now.

The server should actually already error with it receives invalid filters. I'm not sure why it isn't.

We already do something like this on the client to hide flags based on version. This is just a little more fine grained. If we do need this we should find a way to do that is easily extend as more fields are added to labels.

@vdemeester @dnephin is right. This client-side fix fixes it for older daemons. I have a moby/moby PR that is almost ready, fixing it server side (returning error for unknown prune filters).
It is gonna be part of 17.06 as 17.05 is about to get released, and we still have to design and discuss a part of this server-side fix. I am having troubles with docker system prune --filter ... as the CLI, for system prune, calls container prune, volume prune, image prune and network prune passing the same filters to all of them... so my to-be PR is currently braking because of this.
Thanks for reading.

@gdevillele yep, I did mis-understand the fix at first 😅.

We might (or should have) validates filters by version (for any api endpoint that supports them) in docker/moby 😓

dnephin · 2017-05-03T15:34:51Z


 import (
 	"bufio"
+	"context"


I think we are still using golang.org/x/net/context

Depending on if we support go 1.6 for docker/cli or not, it's no big deal in the usage of it (as the interface is the same)

dnephin · 2017-05-03T15:35:31Z

+	// would just remove all stopped containers without considering the label
+	// The remote API should reject requests using unknown filters.
+	if pruneFilters.Get("label") != nil {
+		serverVersion, err := dockerCli.Client().ServerVersion(context.Background())


The API version should already be available as dockerCli.Client().ClientVersion() which is set by querying the server API version.

@dnephin

// ClientVersion returns the version string associated with this instance of the Client

Are you sure? What's important is to detect the version server side.

Yup,

cli/cli/command/cli.go

Lines 200 to 203 in 0a61397

// if server version is lower than the current cli, downgrade

if versions.LessThan(ping.APIVersion, cli.client.ClientVersion()) {

cli.client.UpdateClientVersion(ping.APIVersion)

}

sets the client version to the server version if the server version is lower.

@dnephin oh! good to know! thanks, I'll update this part

gdevillele

LGTM

thaJeztah · 2017-05-16T15:02:44Z

Do we still want this change? Daemon side validation was added in moby/moby#33023. "label" filtering was added in docker 17.05 through moby/moby#30740 (which is an edge release, so not supported after 17.06 is released), and the --filter option for until was added in 17.04 (moby/moby#29226), also an edge release, and now EOL. So situations where the filter would be ignored would only be if someone ran an 17.04 or 17.05 client against an older daemon

aduermael · 2017-05-16T15:34:39Z

So situations where the filter would be ignored would only be if someone ran an 17.04 or 17.05 client against an older daemon

That happens to me sometimes, I still have a few older daemons here and there... I guess it won't happen very often, and I would be ok to drop this if the command was not prune. But in that case consequences can be quite bad...

thaJeztah · 2017-05-16T15:47:30Z

Actually (we were discussing on slack); it looks like the --filter flag itself does not have an API version annotation. That should added, so that when talking to an older (17.03, which is "stable") daemon version, an error is shown

Hold on, I'll add an example

thaJeztah

left an example (double check, but I think docker 17.04 was API version 1.28)

thaJeztah · 2017-05-16T15:51:52Z

 	flags.BoolVarP(&opts.force, "force", "f", false, "Do not prompt for confirmation")
 	flags.BoolVarP(&opts.all, "all", "a", false, "Remove all unused images not just dangling ones")
-	flags.Var(&opts.filter, "filter", "Provide filter values (e.g. 'until=<timestamp>')")
+	flags.Var(&opts.filter, "filter", "Provide filter values (e.g. 'label=<key>=<value>')")


This should have an annotation (like in cli/command/stack/deploy.go#L46)

flags.SetAnnotation("filter", "version", []string{"1.28"})

Same for the other prune --filter flags

Oh! I did't know about this!
I'll update the PR then, it's much simpler this way.

Also see see moby/moby#30187 and moby/moby#30186 for some more info about that :)

thaJeztah · 2017-05-17T12:07:41Z

ping @aduermael looks like this needs a rebase (also can you address my comment, so that we can get this in for 17.06?)

thaJeztah

changes LGTM; can you squash the commits?

…i v1.28) and newer Signed-off-by: Gaetan de Villele <gdevillele@gmail.com>

tiborvass · 2017-05-17T23:23:21Z

LGTM

Vendoring libnetwork b54433f6459b84eae77892d0d359c1bafb133529

* Prefixes documentation files per component Signed-off-by: Eli Uriegas <eli.uriegas@docker.com> * Remove reliance on basename Signed-off-by: Eli Uriegas <eli.uriegas@docker.com> (cherry picked from commit 24e443c109ae5e133f1b20e6c4f9a17126767c71) Signed-off-by: Andrew Hsu <andrewhsu@docker.com>

vdemeester reviewed May 3, 2017

View reviewed changes

dnephin reviewed May 3, 2017

View reviewed changes

gdevillele force-pushed the prune-security branch from 29b1d62 to 9f2c431 Compare May 4, 2017 18:57

aduermael force-pushed the prune-security branch from 9f2c431 to e8aef0d Compare May 4, 2017 19:15

gdevillele approved these changes May 8, 2017

View reviewed changes

thaJeztah requested changes May 16, 2017

View reviewed changes

thaJeztah added this to the 17.06.0 milestone May 16, 2017

gdevillele force-pushed the prune-security branch 2 times, most recently from dfa4003 to 86d9eac Compare May 17, 2017 19:06

thaJeztah approved these changes May 17, 2017

View reviewed changes

make system prune “--filter” flag available only for docker 17.04 (ap…

1cc1f54

…i v1.28) and newer Signed-off-by: Gaetan de Villele <gdevillele@gmail.com>

gdevillele force-pushed the prune-security branch from 86d9eac to 1cc1f54 Compare May 17, 2017 19:36

tiborvass merged commit 63ecaf1 into docker:master May 17, 2017

nobiit pushed a commit to nobidev/docker-cli that referenced this pull request Nov 19, 2025

Merge pull request docker#21 from mavenugo/17.06

8cf591e

Vendoring libnetwork b54433f6459b84eae77892d0d359c1bafb133529

	// if server version is lower than the current cli, downgrade
	if versions.LessThan(ping.APIVersion, cli.client.ClientVersion()) {
	cli.client.UpdateClientVersion(ping.APIVersion)
	}

Conversation

aduermael commented May 2, 2017 • edited by gdevillele Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

dnephin May 3, 2017 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

gdevillele left a comment

Choose a reason for hiding this comment

Uh oh!

thaJeztah commented May 16, 2017

Uh oh!

aduermael commented May 16, 2017

Uh oh!

thaJeztah commented May 16, 2017

Uh oh!

thaJeztah left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

thaJeztah commented May 17, 2017

Uh oh!

thaJeztah left a comment

Choose a reason for hiding this comment

Uh oh!

tiborvass commented May 17, 2017

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

aduermael commented May 2, 2017 •

edited by gdevillele

Loading

dnephin May 3, 2017 •

edited

Loading