Browse code

Changed all references from Trusted Builds to Automated Builds

* 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)

James Turnbull authored on 2014/06/03 03:48:58
Showing 12 changed files
... ...
@@ -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")
... ...
@@ -539,7 +539,7 @@ _docker_search()
539 539
 
540 540
 	case "$cur" in
541 541
 		-*)
542
-			COMPREPLY=( $( compgen -W "--no-trunc -t --trusted -s --stars" -- "$cur" ) )
542
+			COMPREPLY=( $( compgen -W "--no-trunc --automated -s --stars" -- "$cur" ) )
543 543
 			;;
544 544
 		*)
545 545
 			;;
... ...
@@ -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