* Updated docker images output
* Deprecated docker images -t/--trusted option and replace with --automated
* Changed *trusted variables to *automated
* Changed added support for is_automated alongside deprecated is_trusted
* Updated man pages, docs and completion
* Updated API documentation
Docker-DCO-1.1-Signed-off-by: James Turnbull <james@lovedthanlost.net> (github: jamtur01)
| ... | ... |
@@ -1724,7 +1724,8 @@ func (cli *DockerCli) CmdAttach(args ...string) error {
|
| 1724 | 1724 |
func (cli *DockerCli) CmdSearch(args ...string) error {
|
| 1725 | 1725 |
cmd := cli.Subcmd("search", "TERM", "Search the docker index for images")
|
| 1726 | 1726 |
noTrunc := cmd.Bool([]string{"#notrunc", "-no-trunc"}, false, "Don't truncate output")
|
| 1727 |
- trusted := cmd.Bool([]string{"t", "#trusted", "-trusted"}, false, "Only show trusted builds")
|
|
| 1727 |
+ trusted := cmd.Bool([]string{"#t", "#trusted", "#-trusted"}, false, "Only show trusted builds")
|
|
| 1728 |
+ automated := cmd.Bool([]string{"-automated"}, false, "Only show automated builds")
|
|
| 1728 | 1729 |
stars := cmd.Int([]string{"s", "#stars", "-stars"}, 0, "Only displays with at least xxx stars")
|
| 1729 | 1730 |
if err := cmd.Parse(args); err != nil {
|
| 1730 | 1731 |
return nil |
| ... | ... |
@@ -1747,9 +1748,9 @@ func (cli *DockerCli) CmdSearch(args ...string) error {
|
| 1747 | 1747 |
return err |
| 1748 | 1748 |
} |
| 1749 | 1749 |
w := tabwriter.NewWriter(cli.out, 10, 1, 3, ' ', 0) |
| 1750 |
- fmt.Fprintf(w, "NAME\tDESCRIPTION\tSTARS\tOFFICIAL\tTRUSTED\n") |
|
| 1750 |
+ fmt.Fprintf(w, "NAME\tDESCRIPTION\tSTARS\tOFFICIAL\tAUTOMATED\n") |
|
| 1751 | 1751 |
for _, out := range outs.Data {
|
| 1752 |
- if (*trusted && !out.GetBool("is_trusted")) || (*stars > out.GetInt("star_count")) {
|
|
| 1752 |
+ if ((*automated || *trusted) && (!out.GetBool("is_trusted") && !out.GetBool("is_automated"))) || (*stars > out.GetInt("star_count")) {
|
|
| 1753 | 1753 |
continue |
| 1754 | 1754 |
} |
| 1755 | 1755 |
desc := strings.Replace(out.Get("description"), "\n", " ", -1)
|
| ... | ... |
@@ -1763,7 +1764,7 @@ func (cli *DockerCli) CmdSearch(args ...string) error {
|
| 1763 | 1763 |
|
| 1764 | 1764 |
} |
| 1765 | 1765 |
fmt.Fprint(w, "\t") |
| 1766 |
- if out.GetBool("is_trusted") {
|
|
| 1766 |
+ if out.GetBool("is_automated") || out.GetBool("is_trusted") {
|
|
| 1767 | 1767 |
fmt.Fprint(w, "[OK]") |
| 1768 | 1768 |
} |
| 1769 | 1769 |
fmt.Fprint(w, "\n") |
| ... | ... |
@@ -229,7 +229,7 @@ complete -c docker -A -f -n '__fish_seen_subcommand_from save' -a '(__fish_print |
| 229 | 229 |
complete -c docker -f -n '__fish_docker_no_subcommand' -a search -d 'Search for an image in the docker index' |
| 230 | 230 |
complete -c docker -A -f -n '__fish_seen_subcommand_from search' -l no-trunc -d "Don't truncate output" |
| 231 | 231 |
complete -c docker -A -f -n '__fish_seen_subcommand_from search' -s s -l stars -d 'Only displays with at least xxx stars' |
| 232 |
-complete -c docker -A -f -n '__fish_seen_subcommand_from search' -s t -l trusted -d 'Only show trusted builds' |
|
| 232 |
+complete -c docker -A -f -n '__fish_seen_subcommand_from search' -l automated -d 'Only show automated builds' |
|
| 233 | 233 |
|
| 234 | 234 |
# start |
| 235 | 235 |
complete -c docker -f -n '__fish_docker_no_subcommand' -a start -d 'Start a stopped container' |
| ... | ... |
@@ -5,7 +5,7 @@ |
| 5 | 5 |
docker-search - Search the docker index for images |
| 6 | 6 |
|
| 7 | 7 |
# SYNOPSIS |
| 8 |
-**docker search** **--no-trunc**[=*false*] **-t**|**--trusted**[=*false*] |
|
| 8 |
+**docker search** **--no-trunc**[=*false*] **--automated**[=*false*] |
|
| 9 | 9 |
**-s**|**--stars**[=*0*] TERM |
| 10 | 10 |
|
| 11 | 11 |
# DESCRIPTION |
| ... | ... |
@@ -13,7 +13,7 @@ docker-search - Search the docker index for images |
| 13 | 13 |
Search an index for an image with that matches the term TERM. The table |
| 14 | 14 |
of images returned displays the name, description (truncated by default), |
| 15 | 15 |
number of stars awarded, whether the image is official, and whether it |
| 16 |
-is trusted. |
|
| 16 |
+is automated. |
|
| 17 | 17 |
|
| 18 | 18 |
# OPTIONS |
| 19 | 19 |
**--no-trunc**=*true*|*false* |
| ... | ... |
@@ -23,8 +23,8 @@ is trusted. |
| 23 | 23 |
Only displays with at least NUM (integer) stars. I.e. only those images |
| 24 | 24 |
ranked >=NUM. |
| 25 | 25 |
|
| 26 |
-**-t**, **--trusted**=*true*|*false* |
|
| 27 |
- When true only show trusted builds. The default is false. |
|
| 26 |
+**--automated**=*true*|*false* |
|
| 27 |
+ When true only show automated builds. The default is false. |
|
| 28 | 28 |
|
| 29 | 29 |
# EXAMPLE |
| 30 | 30 |
|
| ... | ... |
@@ -34,19 +34,19 @@ Search the registry for the term 'fedora' and only display those images |
| 34 | 34 |
ranked 3 or higher: |
| 35 | 35 |
|
| 36 | 36 |
$ sudo docker search -s 3 fedora |
| 37 |
- NAME DESCRIPTION STARS OFFICIAL TRUSTED |
|
| 37 |
+ NAME DESCRIPTION STARS OFFICIAL AUTOMATED |
|
| 38 | 38 |
mattdm/fedora A basic Fedora image corresponding roughly... 50 |
| 39 | 39 |
fedora (Semi) Official Fedora base image. 38 |
| 40 | 40 |
mattdm/fedora-small A small Fedora image on which to build. Co... 8 |
| 41 | 41 |
goldmann/wildfly A WildFly application server running on a ... 3 [OK] |
| 42 | 42 |
|
| 43 |
-## Search the registry for trusted images |
|
| 43 |
+## Search the registry for automated images |
|
| 44 | 44 |
|
| 45 |
-Search the registry for the term 'fedora' and only display trusted images |
|
| 45 |
+Search the registry for the term 'fedora' and only display automated images |
|
| 46 | 46 |
ranked 1 or higher: |
| 47 | 47 |
|
| 48 | 48 |
$ sudo docker search -s 1 -t fedora |
| 49 |
- NAME DESCRIPTION STARS OFFICIAL TRUSTED |
|
| 49 |
+ NAME DESCRIPTION STARS OFFICIAL AUTOMATED |
|
| 50 | 50 |
goldmann/wildfly A WildFly application server running on a ... 3 [OK] |
| 51 | 51 |
tutum/fedora-20 Fedora 20 image with SSH access. For the r... 1 [OK] |
| 52 | 52 |
|
| ... | ... |
@@ -1,6 +1,6 @@ |
| 1 | 1 |
page_title: Automated Builds on Docker.io |
| 2 | 2 |
page_description: Docker.io Automated Builds |
| 3 |
-page_keywords: Docker, docker, registry, accounts, plans, Dockerfile, Docker.io, docs, documentation, trusted, builds, trusted builds, automated builds |
|
| 3 |
+page_keywords: Docker, docker, registry, accounts, plans, Dockerfile, Docker.io, docs, documentation, trusted, builds, trusted builds, automated, automated builds |
|
| 4 | 4 |
# Automated Builds on Docker.io |
| 5 | 5 |
|
| 6 | 6 |
## Automated Builds |
| ... | ... |
@@ -101,10 +101,9 @@ to Docker.io. |
| 101 | 101 |
|
| 102 | 102 |
#### Creating an Automated Build |
| 103 | 103 |
|
| 104 |
-You can [create a Trusted |
|
| 105 |
-Build](https://index.docker.io/builds/bitbucket/select/) |
|
| 106 |
-from any of your public or private BitBucket repositories with a |
|
| 107 |
-`Dockerfile`. |
|
| 104 |
+You can [create an Automated |
|
| 105 |
+Build](https://index.docker.io/builds/bitbucket/select/) from any of |
|
| 106 |
+your public or private BitBucket repositories with a `Dockerfile`. |
|
| 108 | 107 |
|
| 109 | 108 |
### The Dockerfile and Automated Builds |
| 110 | 109 |
|
| ... | ... |
@@ -162,7 +161,7 @@ payload: |
| 162 | 162 |
"repository":{
|
| 163 | 163 |
"status":"Active", |
| 164 | 164 |
"description":"my docker repo that does cool things", |
| 165 |
- "is_trusted":false, |
|
| 165 |
+ "is_automated":false, |
|
| 166 | 166 |
"full_description":"This is my full description", |
| 167 | 167 |
"repo_url":"https://index.docker.io/u/username/reponame/", |
| 168 | 168 |
"owner":"username", |
| ... | ... |
@@ -81,7 +81,7 @@ with a JSON payload similar to the example shown below. |
| 81 | 81 |
"repository":{
|
| 82 | 82 |
"status":"Active", |
| 83 | 83 |
"description":"my docker repo that does cool things", |
| 84 |
- "is_trusted":false, |
|
| 84 |
+ "is_automated":false, |
|
| 85 | 85 |
"full_description":"This is my full description", |
| 86 | 86 |
"repo_url":"https://index.docker.io/u/username/reponame/", |
| 87 | 87 |
"owner":"username", |
| ... | ... |
@@ -151,4 +151,4 @@ as daemon process(es). |
| 151 | 151 |
|
| 152 | 152 |
- [Linking containers](/userguide/dockerlinks) |
| 153 | 153 |
- [Cross-host linking containers](/articles/ambassador_pattern_linking/) |
| 154 |
- - [Creating a Trusted Build](/docker-io/builds/#trusted-builds) |
|
| 154 |
+ - [Creating an Automated Build](/docker-io/builds/#automated-builds) |
| ... | ... |
@@ -47,6 +47,9 @@ Build now has support for the `forcerm` parameter to always remove containers |
| 47 | 47 |
**New!** |
| 48 | 48 |
All the JSON keys are now in CamelCase |
| 49 | 49 |
|
| 50 |
+**New!** |
|
| 51 |
+Trusted builds are now Automated Builds - `is_trusted` is now `is_automated`. |
|
| 52 |
+ |
|
| 50 | 53 |
## v1.11 |
| 51 | 54 |
|
| 52 | 55 |
### Full Documentation |
| ... | ... |
@@ -1002,21 +1002,21 @@ Search for an image on [Docker.io](https://index.docker.io). |
| 1002 | 1002 |
{
|
| 1003 | 1003 |
"description": "", |
| 1004 | 1004 |
"is_official": false, |
| 1005 |
- "is_trusted": false, |
|
| 1005 |
+ "is_automated": false, |
|
| 1006 | 1006 |
"name": "wma55/u1210sshd", |
| 1007 | 1007 |
"star_count": 0 |
| 1008 | 1008 |
}, |
| 1009 | 1009 |
{
|
| 1010 | 1010 |
"description": "", |
| 1011 | 1011 |
"is_official": false, |
| 1012 |
- "is_trusted": false, |
|
| 1012 |
+ "is_automated": false, |
|
| 1013 | 1013 |
"name": "jdswinbank/sshd", |
| 1014 | 1014 |
"star_count": 0 |
| 1015 | 1015 |
}, |
| 1016 | 1016 |
{
|
| 1017 | 1017 |
"description": "", |
| 1018 | 1018 |
"is_official": false, |
| 1019 |
- "is_trusted": false, |
|
| 1019 |
+ "is_automated": false, |
|
| 1020 | 1020 |
"name": "vgauthier/sshd", |
| 1021 | 1021 |
"star_count": 0 |
| 1022 | 1022 |
} |
| ... | ... |
@@ -1124,7 +1124,7 @@ Search [Docker.io](https://index.docker.io) for images |
| 1124 | 1124 |
|
| 1125 | 1125 |
--no-trunc=false Don't truncate output |
| 1126 | 1126 |
-s, --stars=0 Only displays with at least xxx stars |
| 1127 |
- -t, --trusted=false Only show trusted builds |
|
| 1127 |
+ --automated=false Only show automated builds |
|
| 1128 | 1128 |
|
| 1129 | 1129 |
See [*Find Public Images on Docker.io*]( |
| 1130 | 1130 |
/userguide/dockerrepos/#find-public-images-on-dockerio) for |
| ... | ... |
@@ -116,7 +116,7 @@ by using the `docker search` command to find all the images that contain the |
| 116 | 116 |
term `sinatra`. |
| 117 | 117 |
|
| 118 | 118 |
$ sudo docker search sinatra |
| 119 |
- NAME DESCRIPTION STARS OFFICIAL TRUSTED |
|
| 119 |
+ NAME DESCRIPTION STARS OFFICIAL AUTOMATED |
|
| 120 | 120 |
training/sinatra Sinatra training image 0 [OK] |
| 121 | 121 |
marceldegraaf/sinatra Sinatra test app 0 |
| 122 | 122 |
mattwarren/docker-sinatra-demo 0 [OK] |
| ... | ... |
@@ -129,9 +129,11 @@ term `sinatra`. |
| 129 | 129 |
We can see we've returned a lot of images that use the term `sinatra`. We've |
| 130 | 130 |
returned a list of image names, descriptions, Stars (which measure the social |
| 131 | 131 |
popularity of images - if a user likes an image then they can "star" it), and |
| 132 |
-the Official and Trusted statuses. Official repositories are XXX and Trusted |
|
| 133 |
-repositories are [Trusted Build](/userguide/dockerrepos/) that allow you to |
|
| 134 |
-validate the source and content of an image. |
|
| 132 |
+the Official and Automated build statuses. Official repositories are built and |
|
| 133 |
+maintained by the [Stackbrew](https://github.com/dotcloud/stackbrew) project, |
|
| 134 |
+and Automated repositories are [Automated Builds]( |
|
| 135 |
+/userguide/dockerrepos/#automated-builds) that allow you to validate the source |
|
| 136 |
+and content of an image. |
|
| 135 | 137 |
|
| 136 | 138 |
We've reviewed the images available to use and we decided to use the |
| 137 | 139 |
`training/sinatra` image. So far we've seen two types of images repositories, |
| ... | ... |
@@ -76,7 +76,7 @@ Go to [Managing Data in Containers](/userguide/dockervolumes). |
| 76 | 76 |
|
| 77 | 77 |
Now we've learned a bit more about how to use Docker we're going to see |
| 78 | 78 |
how to combine Docker with the services available on Docker.io including |
| 79 |
-Trusted Builds and private repositories. |
|
| 79 |
+Automated Builds and private repositories. |
|
| 80 | 80 |
|
| 81 | 81 |
Go to [Working with Docker.io](/userguide/dockerrepos). |
| 82 | 82 |
|