diff --git a/cli/command/plugin/push.go b/cli/command/plugin/push.go index 4e176bea3e..e37a0483a6 100644 --- a/cli/command/plugin/push.go +++ b/cli/command/plugin/push.go @@ -14,8 +14,8 @@ import ( func newPushCommand(dockerCli *command.DockerCli) *cobra.Command { cmd := &cobra.Command{ - Use: "push PLUGIN", - Short: "Push a plugin", + Use: "push NAME[:TAG]", + Short: "Push a plugin to a registry", Args: cli.ExactArgs(1), RunE: func(cmd *cobra.Command, args []string) error { return runPush(dockerCli, args[0]) diff --git a/docs/reference/commandline/plugin_create.md b/docs/reference/commandline/plugin_create.md index 10b3e12138..f35d73c605 100644 --- a/docs/reference/commandline/plugin_create.md +++ b/docs/reference/commandline/plugin_create.md @@ -49,10 +49,11 @@ The plugin can subsequently be enabled for local use or pushed to the public reg ## Related information -* [plugin ls](plugin_ls.md) -* [plugin enable](plugin_enable.md) * [plugin disable](plugin_disable.md) +* [plugin enable](plugin_enable.md) * [plugin inspect](plugin_inspect.md) * [plugin install](plugin_install.md) +* [plugin ls](plugin_ls.md) +* [plugin push](plugin_push.md) * [plugin rm](plugin_rm.md) * [plugin set](plugin_set.md) diff --git a/docs/reference/commandline/plugin_disable.md b/docs/reference/commandline/plugin_disable.md index 4e4412c01a..4bffb2cecf 100644 --- a/docs/reference/commandline/plugin_disable.md +++ b/docs/reference/commandline/plugin_disable.md @@ -53,10 +53,11 @@ tiborvass/no-remove latest A test plugin for Docker false ## Related information -* [plugin ls](plugin_ls.md) * [plugin create](plugin_create.md) * [plugin enable](plugin_enable.md) * [plugin inspect](plugin_inspect.md) * [plugin install](plugin_install.md) +* [plugin ls](plugin_ls.md) +* [plugin push](plugin_push.md) * [plugin rm](plugin_rm.md) * [plugin set](plugin_set.md) diff --git a/docs/reference/commandline/plugin_enable.md b/docs/reference/commandline/plugin_enable.md index fdebf5b276..15a07e6f70 100644 --- a/docs/reference/commandline/plugin_enable.md +++ b/docs/reference/commandline/plugin_enable.md @@ -54,9 +54,10 @@ tiborvass/no-remove latest A test plugin for Docker true ## Related information * [plugin create](plugin_create.md) -* [plugin ls](plugin_ls.md) * [plugin disable](plugin_disable.md) * [plugin inspect](plugin_inspect.md) * [plugin install](plugin_install.md) +* [plugin ls](plugin_ls.md) +* [plugin push](plugin_push.md) * [plugin rm](plugin_rm.md) * [plugin set](plugin_set.md) diff --git a/docs/reference/commandline/plugin_inspect.md b/docs/reference/commandline/plugin_inspect.md index 4ba484b513..80b8e8c881 100644 --- a/docs/reference/commandline/plugin_inspect.md +++ b/docs/reference/commandline/plugin_inspect.md @@ -154,9 +154,10 @@ $ docker plugin inspect -f '{{.Id}}' tiborvass/no-remove:latest ## Related information * [plugin create](plugin_create.md) -* [plugin ls](plugin_ls.md) * [plugin enable](plugin_enable.md) * [plugin disable](plugin_disable.md) * [plugin install](plugin_install.md) +* [plugin ls](plugin_ls.md) +* [plugin push](plugin_push.md) * [plugin rm](plugin_rm.md) * [plugin set](plugin_set.md) diff --git a/docs/reference/commandline/plugin_install.md b/docs/reference/commandline/plugin_install.md index 259a1d4444..f33fc55a56 100644 --- a/docs/reference/commandline/plugin_install.md +++ b/docs/reference/commandline/plugin_install.md @@ -60,9 +60,10 @@ tiborvass/no-remove latest A test plugin for Docker true ## Related information * [plugin create](plugin_create.md) -* [plugin ls](plugin_ls.md) -* [plugin enable](plugin_enable.md) * [plugin disable](plugin_disable.md) +* [plugin enable](plugin_enable.md) * [plugin inspect](plugin_inspect.md) +* [plugin ls](plugin_ls.md) +* [plugin push](plugin_push.md) * [plugin rm](plugin_rm.md) * [plugin set](plugin_set.md) diff --git a/docs/reference/commandline/plugin_ls.md b/docs/reference/commandline/plugin_ls.md index bb2e0bbe53..3ea4c2585c 100644 --- a/docs/reference/commandline/plugin_ls.md +++ b/docs/reference/commandline/plugin_ls.md @@ -43,9 +43,10 @@ tiborvass/no-remove latest A test plugin for Docker true ## Related information * [plugin create](plugin_create.md) -* [plugin enable](plugin_enable.md) * [plugin disable](plugin_disable.md) +* [plugin enable](plugin_enable.md) * [plugin inspect](plugin_inspect.md) * [plugin install](plugin_install.md) +* [plugin push](plugin_push.md) * [plugin rm](plugin_rm.md) * [plugin set](plugin_set.md) diff --git a/docs/reference/commandline/plugin_push.md b/docs/reference/commandline/plugin_push.md new file mode 100644 index 0000000000..54022dcee1 --- /dev/null +++ b/docs/reference/commandline/plugin_push.md @@ -0,0 +1,50 @@ +--- +title: "plugin push" +description: "the plugin push command description and usage" +keywords: "plugin, push" +--- + +<!-- This file is maintained within the docker/docker Github + repository at https://github.com/docker/docker/. Make all + pull requests against that repo. If you see this file in + another repository, consider it read-only there, as it will + periodically be overwritten by the definitive file. Pull + requests which include edits to this file in other repositories + will be rejected. +--> + +```markdown +Usage: docker plugin push NAME[:TAG] + +Push a plugin to a registry + +Options: + --help Print usage +``` + +Use `docker plugin create` to create the plugin. Once the plugin is ready for distribution, +use `docker plugin push` to share your images to the Docker Hub registry or to a self-hosted one. + +Registry credentials are managed by [docker login](login.md). + +The following example shows how to push a sample `user/plugin`. + +```bash + +$ docker plugin ls +NAME TAG DESCRIPTION ENABLED +user/plugin latest A sample plugin for Docker false + +$ docker plugin push user/plugin +``` + +## Related information + +* [plugin create](plugin_create.md) +* [plugin disable](plugin_disable.md) +* [plugin enable](plugin_enable.md) +* [plugin inspect](plugin_inspect.md) +* [plugin install](plugin_install.md) +* [plugin ls](plugin_ls.md) +* [plugin rm](plugin_rm.md) +* [plugin set](plugin_set.md) diff --git a/docs/reference/commandline/plugin_rm.md b/docs/reference/commandline/plugin_rm.md index 29840455a9..5a01dcaa1e 100644 --- a/docs/reference/commandline/plugin_rm.md +++ b/docs/reference/commandline/plugin_rm.md @@ -46,9 +46,10 @@ tiborvass/no-remove ## Related information * [plugin create](plugin_create.md) -* [plugin ls](plugin_ls.md) -* [plugin enable](plugin_enable.md) * [plugin disable](plugin_disable.md) +* [plugin enable](plugin_enable.md) * [plugin inspect](plugin_inspect.md) * [plugin install](plugin_install.md) +* [plugin ls](plugin_ls.md) +* [plugin push](plugin_push.md) * [plugin set](plugin_set.md) diff --git a/docs/reference/commandline/plugin_set.md b/docs/reference/commandline/plugin_set.md index 3873f47c76..9ea93aecf9 100644 --- a/docs/reference/commandline/plugin_set.md +++ b/docs/reference/commandline/plugin_set.md @@ -90,9 +90,10 @@ $ docker plugin inspect -f '{{.Settings.Args}}' myplugin ## Related information * [plugin create](plugin_create.md) -* [plugin ls](plugin_ls.md) -* [plugin enable](plugin_enable.md) * [plugin disable](plugin_disable.md) +* [plugin enable](plugin_enable.md) * [plugin inspect](plugin_inspect.md) * [plugin install](plugin_install.md) +* [plugin ls](plugin_ls.md) +* [plugin push](plugin_push.md) * [plugin rm](plugin_rm.md)