{"action":"created","comment":{"url":"https://api.github.com/repos/openshift/openshift-docs/pulls/comments/31953885","id":31953885,"diff_hunk":"@@ -11,11 +11,79 @@ toc::[]\n \n == Overview\n A link:../architecture/core_objects/builds.html[build] is a process of creating\n-runnable images to be used on OpenShift. There are three types of builds:\n+runnable images to be used on OpenShift. There are three build strategies:\n \n-- Docker build\n-- STI build\n-- custom build\n+- link:../architecture/core_objects/builds.html#source-build[Source-To-Image]\n+- link:../architecture/core_objects/builds.html#docker-build[Docker]\n+- link:../architecture/core_objects/builds.html#custom-build[Custom]\n+\n+== Defining a buildConfig\n+\n+A `*buildConfig*` describes a single build definition and a\n+set of link:#triggers[triggers] for when a new build should be created.\n+\n+A buildConfig is a REST object, which can be used in a POST to the API server to\n+create a new instance. The following configuration results in a new build\n+every time a Docker image tag or the source code changes:\n+\n+[source.json]\n+----\n+{\n+  \"kind\": \"BuildConfig\",\n+    \"apiVersion\": \"v1\",\n+    \"metadata\": {\n+      \"name\": \"ruby-sample-build <1>\",\n+    },\n+  \"spec\": {\n+    \"triggers\": [ <2>\n+      {\n+        \"type\": \"github\",\n+        \"github\": {\n+          \"secret\": \"secret101\"\n+        }\n+      },\n+      {\n+        \"type\": \"generic\",\n+        \"generic\": {\n+          \"secret\": \"secret101\"\n+        }\n+      },\n+      {\n+        \"type\": \"ImageChange\"\n+      }\n+    ],\n+    \"source\": { <3>\n+      \"type\": \"Git\",\n+      \"git\": {\n+        \"uri\": \"git://github.com/openshift/ruby-hello-world.git\"\n+      }\n+    },\n+    \"strategy\": { <4>\n+      \"type\": \"Source\",\n+      \"sourceStrategy\": {\n+        \"from\": {\n+          \"kind\": \"ImageStreamTag\",\n+          \"name\": \"ruby-20-centos7:latest\"\n+        },\n+        \"incremental\": false","path":"dev_guide/builds.adoc","position":62,"original_position":62,"commit_id":"bf4819926d136cf618e356868e94da3d5556fbde","original_commit_id":"bf4819926d136cf618e356868e94da3d5556fbde","user":{"login":"bparees","id":4974046,"avatar_url":"https://avatars.githubusercontent.com/u/4974046?v=3","gravatar_id":"","url":"https://api.github.com/users/bparees","html_url":"https://github.com/bparees","followers_url":"https://api.github.com/users/bparees/followers","following_url":"https://api.github.com/users/bparees/following{/other_user}","gists_url":"https://api.github.com/users/bparees/gists{/gist_id}","starred_url":"https://api.github.com/users/bparees/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bparees/subscriptions","organizations_url":"https://api.github.com/users/bparees/orgs","repos_url":"https://api.github.com/users/bparees/repos","events_url":"https://api.github.com/users/bparees/events{/privacy}","received_events_url":"https://api.github.com/users/bparees/received_events","type":"User","site_admin":false},"body":"remove.\r\n","created_at":"2015-06-08T20:10:16Z","updated_at":"2015-06-08T20:10:16Z","html_url":"https://github.com/openshift/openshift-docs/pull/444#discussion_r31953885","pull_request_url":"https://api.github.com/repos/openshift/openshift-docs/pulls/444","_links":{"self":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/comments/31953885"},"html":{"href":"https://github.com/openshift/openshift-docs/pull/444#discussion_r31953885"},"pull_request":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/444"}}},"pull_request":{"url":"https://api.github.com/repos/openshift/openshift-docs/pulls/444","id":36917796,"html_url":"https://github.com/openshift/openshift-docs/pull/444","diff_url":"https://github.com/openshift/openshift-docs/pull/444.diff","patch_url":"https://github.com/openshift/openshift-docs/pull/444.patch","issue_url":"https://api.github.com/repos/openshift/openshift-docs/issues/444","number":444,"state":"open","locked":false,"title":"Defining a buildConfig","user":{"login":"mfojtik","id":44136,"avatar_url":"https://avatars.githubusercontent.com/u/44136?v=3","gravatar_id":"","url":"https://api.github.com/users/mfojtik","html_url":"https://github.com/mfojtik","followers_url":"https://api.github.com/users/mfojtik/followers","following_url":"https://api.github.com/users/mfojtik/following{/other_user}","gists_url":"https://api.github.com/users/mfojtik/gists{/gist_id}","starred_url":"https://api.github.com/users/mfojtik/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mfojtik/subscriptions","organizations_url":"https://api.github.com/users/mfojtik/orgs","repos_url":"https://api.github.com/users/mfojtik/repos","events_url":"https://api.github.com/users/mfojtik/events{/privacy}","received_events_url":"https://api.github.com/users/mfojtik/received_events","type":"User","site_admin":false},"body":"","created_at":"2015-06-04T09:42:59Z","updated_at":"2015-06-08T20:10:16Z","closed_at":null,"merged_at":null,"merge_commit_sha":"3bf2b6cd2382185e49b21e15af0d22310216b295","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/openshift/openshift-docs/pulls/444/commits","review_comments_url":"https://api.github.com/repos/openshift/openshift-docs/pulls/444/comments","review_comment_url":"https://api.github.com/repos/openshift/openshift-docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/openshift/openshift-docs/issues/444/comments","statuses_url":"https://api.github.com/repos/openshift/openshift-docs/statuses/bf4819926d136cf618e356868e94da3d5556fbde","head":{"label":"mfojtik:defining-buildconfig","ref":"defining-buildconfig","sha":"bf4819926d136cf618e356868e94da3d5556fbde","user":{"login":"mfojtik","id":44136,"avatar_url":"https://avatars.githubusercontent.com/u/44136?v=3","gravatar_id":"","url":"https://api.github.com/users/mfojtik","html_url":"https://github.com/mfojtik","followers_url":"https://api.github.com/users/mfojtik/followers","following_url":"https://api.github.com/users/mfojtik/following{/other_user}","gists_url":"https://api.github.com/users/mfojtik/gists{/gist_id}","starred_url":"https://api.github.com/users/mfojtik/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mfojtik/subscriptions","organizations_url":"https://api.github.com/users/mfojtik/orgs","repos_url":"https://api.github.com/users/mfojtik/repos","events_url":"https://api.github.com/users/mfojtik/events{/privacy}","received_events_url":"https://api.github.com/users/mfojtik/received_events","type":"User","site_admin":false},"repo":{"id":29957396,"name":"openshift-docs","full_name":"mfojtik/openshift-docs","owner":{"login":"mfojtik","id":44136,"avatar_url":"https://avatars.githubusercontent.com/u/44136?v=3","gravatar_id":"","url":"https://api.github.com/users/mfojtik","html_url":"https://github.com/mfojtik","followers_url":"https://api.github.com/users/mfojtik/followers","following_url":"https://api.github.com/users/mfojtik/following{/other_user}","gists_url":"https://api.github.com/users/mfojtik/gists{/gist_id}","starred_url":"https://api.github.com/users/mfojtik/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mfojtik/subscriptions","organizations_url":"https://api.github.com/users/mfojtik/orgs","repos_url":"https://api.github.com/users/mfojtik/repos","events_url":"https://api.github.com/users/mfojtik/events{/privacy}","received_events_url":"https://api.github.com/users/mfojtik/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/mfojtik/openshift-docs","description":"OpenShift Documentation","fork":true,"url":"https://api.github.com/repos/mfojtik/openshift-docs","forks_url":"https://api.github.com/repos/mfojtik/openshift-docs/forks","keys_url":"https://api.github.com/repos/mfojtik/openshift-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mfojtik/openshift-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mfojtik/openshift-docs/teams","hooks_url":"https://api.github.com/repos/mfojtik/openshift-docs/hooks","issue_events_url":"https://api.github.com/repos/mfojtik/openshift-docs/issues/events{/number}","events_url":"https://api.github.com/repos/mfojtik/openshift-docs/events","assignees_url":"https://api.github.com/repos/mfojtik/openshift-docs/assignees{/user}","branches_url":"https://api.github.com/repos/mfojtik/openshift-docs/branches{/branch}","tags_url":"https://api.github.com/repos/mfojtik/openshift-docs/tags","blobs_url":"https://api.github.com/repos/mfojtik/openshift-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mfojtik/openshift-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mfojtik/openshift-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/mfojtik/openshift-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mfojtik/openshift-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/mfojtik/openshift-docs/languages","stargazers_url":"https://api.github.com/repos/mfojtik/openshift-docs/stargazers","contributors_url":"https://api.github.com/repos/mfojtik/openshift-docs/contributors","subscribers_url":"https://api.github.com/repos/mfojtik/openshift-docs/subscribers","subscription_url":"https://api.github.com/repos/mfojtik/openshift-docs/subscription","commits_url":"https://api.github.com/repos/mfojtik/openshift-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/mfojtik/openshift-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/mfojtik/openshift-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/mfojtik/openshift-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/mfojtik/openshift-docs/contents/{+path}","compare_url":"https://api.github.com/repos/mfojtik/openshift-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mfojtik/openshift-docs/merges","archive_url":"https://api.github.com/repos/mfojtik/openshift-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mfojtik/openshift-docs/downloads","issues_url":"https://api.github.com/repos/mfojtik/openshift-docs/issues{/number}","pulls_url":"https://api.github.com/repos/mfojtik/openshift-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/mfojtik/openshift-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/mfojtik/openshift-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mfojtik/openshift-docs/labels{/name}","releases_url":"https://api.github.com/repos/mfojtik/openshift-docs/releases{/id}","created_at":"2015-01-28T08:17:05Z","updated_at":"2015-05-07T09:04:58Z","pushed_at":"2015-06-08T19:54:54Z","git_url":"git://github.com/mfojtik/openshift-docs.git","ssh_url":"git@github.com:mfojtik/openshift-docs.git","clone_url":"https://github.com/mfojtik/openshift-docs.git","svn_url":"https://github.com/mfojtik/openshift-docs","homepage":null,"size":3654,"stargazers_count":0,"watchers_count":0,"language":"CSS","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"openshift:master","ref":"master","sha":"fe8a788024b91ac7637be68249e18b4d119ec0d0","user":{"login":"openshift","id":792337,"avatar_url":"https://avatars.githubusercontent.com/u/792337?v=3","gravatar_id":"","url":"https://api.github.com/users/openshift","html_url":"https://github.com/openshift","followers_url":"https://api.github.com/users/openshift/followers","following_url":"https://api.github.com/users/openshift/following{/other_user}","gists_url":"https://api.github.com/users/openshift/gists{/gist_id}","starred_url":"https://api.github.com/users/openshift/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/openshift/subscriptions","organizations_url":"https://api.github.com/users/openshift/orgs","repos_url":"https://api.github.com/users/openshift/repos","events_url":"https://api.github.com/users/openshift/events{/privacy}","received_events_url":"https://api.github.com/users/openshift/received_events","type":"Organization","site_admin":false},"repo":{"id":21740844,"name":"openshift-docs","full_name":"openshift/openshift-docs","owner":{"login":"openshift","id":792337,"avatar_url":"https://avatars.githubusercontent.com/u/792337?v=3","gravatar_id":"","url":"https://api.github.com/users/openshift","html_url":"https://github.com/openshift","followers_url":"https://api.github.com/users/openshift/followers","following_url":"https://api.github.com/users/openshift/following{/other_user}","gists_url":"https://api.github.com/users/openshift/gists{/gist_id}","starred_url":"https://api.github.com/users/openshift/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/openshift/subscriptions","organizations_url":"https://api.github.com/users/openshift/orgs","repos_url":"https://api.github.com/users/openshift/repos","events_url":"https://api.github.com/users/openshift/events{/privacy}","received_events_url":"https://api.github.com/users/openshift/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/openshift/openshift-docs","description":"OpenShift Documentation","fork":false,"url":"https://api.github.com/repos/openshift/openshift-docs","forks_url":"https://api.github.com/repos/openshift/openshift-docs/forks","keys_url":"https://api.github.com/repos/openshift/openshift-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/openshift/openshift-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/openshift/openshift-docs/teams","hooks_url":"https://api.github.com/repos/openshift/openshift-docs/hooks","issue_events_url":"https://api.github.com/repos/openshift/openshift-docs/issues/events{/number}","events_url":"https://api.github.com/repos/openshift/openshift-docs/events","assignees_url":"https://api.github.com/repos/openshift/openshift-docs/assignees{/user}","branches_url":"https://api.github.com/repos/openshift/openshift-docs/branches{/branch}","tags_url":"https://api.github.com/repos/openshift/openshift-docs/tags","blobs_url":"https://api.github.com/repos/openshift/openshift-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/openshift/openshift-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/openshift/openshift-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/openshift/openshift-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/openshift/openshift-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/openshift/openshift-docs/languages","stargazers_url":"https://api.github.com/repos/openshift/openshift-docs/stargazers","contributors_url":"https://api.github.com/repos/openshift/openshift-docs/contributors","subscribers_url":"https://api.github.com/repos/openshift/openshift-docs/subscribers","subscription_url":"https://api.github.com/repos/openshift/openshift-docs/subscription","commits_url":"https://api.github.com/repos/openshift/openshift-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/openshift/openshift-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/openshift/openshift-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/openshift/openshift-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/openshift/openshift-docs/contents/{+path}","compare_url":"https://api.github.com/repos/openshift/openshift-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/openshift/openshift-docs/merges","archive_url":"https://api.github.com/repos/openshift/openshift-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/openshift/openshift-docs/downloads","issues_url":"https://api.github.com/repos/openshift/openshift-docs/issues{/number}","pulls_url":"https://api.github.com/repos/openshift/openshift-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/openshift/openshift-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/openshift/openshift-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/openshift/openshift-docs/labels{/name}","releases_url":"https://api.github.com/repos/openshift/openshift-docs/releases{/id}","created_at":"2014-07-11T15:14:42Z","updated_at":"2015-05-30T11:02:54Z","pushed_at":"2015-06-08T19:54:55Z","git_url":"git://github.com/openshift/openshift-docs.git","ssh_url":"git@github.com:openshift/openshift-docs.git","clone_url":"https://github.com/openshift/openshift-docs.git","svn_url":"https://github.com/openshift/openshift-docs","homepage":null,"size":54277,"stargazers_count":16,"watchers_count":16,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":81,"mirror_url":null,"open_issues_count":32,"forks":81,"open_issues":32,"watchers":16,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/444"},"html":{"href":"https://github.com/openshift/openshift-docs/pull/444"},"issue":{"href":"https://api.github.com/repos/openshift/openshift-docs/issues/444"},"comments":{"href":"https://api.github.com/repos/openshift/openshift-docs/issues/444/comments"},"review_comments":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/444/comments"},"review_comment":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/openshift/openshift-docs/pulls/444/commits"},"statuses":{"href":"https://api.github.com/repos/openshift/openshift-docs/statuses/bf4819926d136cf618e356868e94da3d5556fbde"}}}}