{"action":"created","comment":{"url":"https://api.github.com/repos/weaveworks/flux/pulls/comments/198794121","pull_request_review_id":132774756,"id":198794121,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDE5ODc5NDEyMQ==","diff_hunk":"@@ -0,0 +1,169 @@\n+---\n+title: Installing Weave Flux using Helm\n+menu_order: 20\n+---\n+\n+# Get started with Flux using Helm\n+\n+If you are using Helm already, this guide is for you. By the end\n+you will have Helm installing Flux in the cluster and deploying\n+any code changes for you.\n+\n+## Prerequisites\n+\n+You will need to have Kubernetes set up. To get up and running fast,\n+you might want to use `minikube` or `kubeadm`. Any other Kubernetes\n+setup will work as well though.\n+\n+*Note:* If you are using `minikube`, be sure to start the\n+cluster with `--bootstrapper=kubeadm` so you are using RBAC.\n+\n+Download Helm:\n+\n+- On MacOS:\n+\n+  ```sh\n+  brew install kubernetes-helm\n+  ```\n+\n+- On Linux:\n+  - Download the [latest release](https://github.com/kubernetes/helm/releases/latest), unpack the\n+    tarball and put the binary in your `$PATH`.\n+\n+Now create a service account and a cluster role binding for Tiller:\n+\n+```sh\n+kubectl -n kube-system create sa tiller\n+\n+kubectl create clusterrolebinding tiller-cluster-rule \\\n+    --clusterrole=cluster-admin \\\n+    --serviceaccount=kube-system:tiller\n+```\n+\n+Deploy Tiller in `kube-system` namespace:\n+\n+```sh\n+helm init --skip-refresh --upgrade --service-account tiller\n+```\n+\n+## Install Weave Flux\n+\n+Add the Flux repository of Weaveworks:\n+\n+```sh\n+helm repo add weaveworks https://weaveworks.github.io/flux\n+```\n+\n+In this next step you install Weave Flux using `helm`. All you need\n+to do is specify your fork of\n+[flux-helm-test](https://github.com/weaveworks/flux-helm-test).\n+\n+ 1. Fork [flux-helm-test](https://github.com/weaveworks/flux-helm-test)\n+    on Github and\n+ 1. install Weave Flux and its Helm Operator by specifying your fork\n+    URL.\n+\n+*Just make sure you replace `YOURUSER` with your GitHub username in\n+the command below:*\n+\n+```sh\n+helm install --name flux \\\n+--set helmOperator.create=true \\\n+--set git.url=git@github.com:YOURUSER/flux-helm-test \\\n+--set git.chartsPath=charts \\\n+--namespace flux \\\n+weaveworks/flux\n+```\n+\n+Allow some time for all containers to get up and running. If you're\n+impatient, run the following command and see the pod creation\n+process.\n+\n+```sh\n+watch kubectl get pods --all-namespaces\n+```\n+\n+You will notice that `flux` and `flux-helm-operator` will start\n+turning up in the `flux` namespace.\n+\n+## Giving write access\n+\n+For the real benefits of GitOps, Flux will need acccess to your\n+git repository to update configuration if necessary. To facilitate\n+that you will need to add a deploy key to your fork of the\n+repository.\n+\n+This is pretty straight-forward as Flux generates a SSH key and\n+logs the public key at startup. Find the SSH public key with:\n+\n+```sh\n+export FLUX_POD=$(kubectl get pods --namespace flux -l \"app=flux,release=flux\" -o jsonpath=\"{.items[0].metadata.name}\")","path":"site/helm/installing.md","position":100,"original_position":100,"commit_id":"a0e4ec3f42a39f2193bb8abdb10290a6ac67a152","original_commit_id":"a0e4ec3f42a39f2193bb8abdb10290a6ac67a152","user":{"login":"squaremo","id":62033,"node_id":"MDQ6VXNlcjYyMDMz","avatar_url":"https://avatars3.githubusercontent.com/u/62033?v=4","gravatar_id":"","url":"https://api.github.com/users/squaremo","html_url":"https://github.com/squaremo","followers_url":"https://api.github.com/users/squaremo/followers","following_url":"https://api.github.com/users/squaremo/following{/other_user}","gists_url":"https://api.github.com/users/squaremo/gists{/gist_id}","starred_url":"https://api.github.com/users/squaremo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/squaremo/subscriptions","organizations_url":"https://api.github.com/users/squaremo/orgs","repos_url":"https://api.github.com/users/squaremo/repos","events_url":"https://api.github.com/users/squaremo/events{/privacy}","received_events_url":"https://api.github.com/users/squaremo/received_events","type":"User","site_admin":false},"body":"Does it need to be exported?","created_at":"2018-06-28T10:33:01Z","updated_at":"2018-06-28T11:00:09Z","html_url":"https://github.com/weaveworks/flux/pull/1130#discussion_r198794121","pull_request_url":"https://api.github.com/repos/weaveworks/flux/pulls/1130","author_association":"MEMBER","_links":{"self":{"href":"https://api.github.com/repos/weaveworks/flux/pulls/comments/198794121"},"html":{"href":"https://github.com/weaveworks/flux/pull/1130#discussion_r198794121"},"pull_request":{"href":"https://api.github.com/repos/weaveworks/flux/pulls/1130"}}},"pull_request":{"url":"https://api.github.com/repos/weaveworks/flux/pulls/1130","id":193665864,"node_id":"MDExOlB1bGxSZXF1ZXN0MTkzNjY1ODY0","html_url":"https://github.com/weaveworks/flux/pull/1130","diff_url":"https://github.com/weaveworks/flux/pull/1130.diff","patch_url":"https://github.com/weaveworks/flux/pull/1130.patch","issue_url":"https://api.github.com/repos/weaveworks/flux/issues/1130","number":1130,"state":"open","locked":false,"title":"update get started docs for flux","user":{"login":"dholbach","id":1346979,"node_id":"MDQ6VXNlcjEzNDY5Nzk=","avatar_url":"https://avatars1.githubusercontent.com/u/1346979?v=4","gravatar_id":"","url":"https://api.github.com/users/dholbach","html_url":"https://github.com/dholbach","followers_url":"https://api.github.com/users/dholbach/followers","following_url":"https://api.github.com/users/dholbach/following{/other_user}","gists_url":"https://api.github.com/users/dholbach/gists{/gist_id}","starred_url":"https://api.github.com/users/dholbach/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dholbach/subscriptions","organizations_url":"https://api.github.com/users/dholbach/orgs","repos_url":"https://api.github.com/users/dholbach/repos","events_url":"https://api.github.com/users/dholbach/events{/privacy}","received_events_url":"https://api.github.com/users/dholbach/received_events","type":"User","site_admin":false},"body":"This is not done yet, but I'd like to get feedback anyway.\r\n\r\nI wanted to add self-contained examples for getting started with Flux and provide a more straight-forward navigation for this. Right now I'd go from the main page to site/installing.md to site/standalone/installing.md which would get me flux with flux-example, it refers to helm in places, expects minikube in others, takes me to setup.md and explains more sophisticated bits. All in all, the current navigation is not straight-forward.\r\n\r\nI hope to make this a bit clearer with the following:\r\n\r\n - README.md: doc nav is a more categorised and directly links to \"get started with standalone flux\" and \"get started with flux using helm\" docs\r\n - site/standalone/installing.md: is a self-contained, minimal example which shows me in 5-10 minutes that flux is actually working\r\n - site/helm/installing.md: will do the same as above, this is still WIP - collect all helm bits here as well\r\n - site/standalone/setup.md: collects notes about more sophisticated setups\r\n - site/using.md: collects all information about controlling flux, e.g. `fluxctl` use and more\r\n\r\nAs I said, the content is not 100% done yet (particularly the helm bits), but I'd appreciate a review if the general structure and direction is making sense.","created_at":"2018-06-08T16:34:43Z","updated_at":"2018-06-28T11:00:09Z","closed_at":null,"merged_at":null,"merge_commit_sha":"c2e2dbe05c369f80b7f1b7bac49575e413ac670f","assignee":null,"assignees":[],"requested_reviewers":[],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/weaveworks/flux/pulls/1130/commits","review_comments_url":"https://api.github.com/repos/weaveworks/flux/pulls/1130/comments","review_comment_url":"https://api.github.com/repos/weaveworks/flux/pulls/comments{/number}","comments_url":"https://api.github.com/repos/weaveworks/flux/issues/1130/comments","statuses_url":"https://api.github.com/repos/weaveworks/flux/statuses/a0e4ec3f42a39f2193bb8abdb10290a6ac67a152","head":{"label":"dholbach:improve-install-docs","ref":"improve-install-docs","sha":"a0e4ec3f42a39f2193bb8abdb10290a6ac67a152","user":{"login":"dholbach","id":1346979,"node_id":"MDQ6VXNlcjEzNDY5Nzk=","avatar_url":"https://avatars1.githubusercontent.com/u/1346979?v=4","gravatar_id":"","url":"https://api.github.com/users/dholbach","html_url":"https://github.com/dholbach","followers_url":"https://api.github.com/users/dholbach/followers","following_url":"https://api.github.com/users/dholbach/following{/other_user}","gists_url":"https://api.github.com/users/dholbach/gists{/gist_id}","starred_url":"https://api.github.com/users/dholbach/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dholbach/subscriptions","organizations_url":"https://api.github.com/users/dholbach/orgs","repos_url":"https://api.github.com/users/dholbach/repos","events_url":"https://api.github.com/users/dholbach/events{/privacy}","received_events_url":"https://api.github.com/users/dholbach/received_events","type":"User","site_admin":false},"repo":{"id":133357765,"node_id":"MDEwOlJlcG9zaXRvcnkxMzMzNTc3NjU=","name":"flux","full_name":"dholbach/flux","owner":{"login":"dholbach","id":1346979,"node_id":"MDQ6VXNlcjEzNDY5Nzk=","avatar_url":"https://avatars1.githubusercontent.com/u/1346979?v=4","gravatar_id":"","url":"https://api.github.com/users/dholbach","html_url":"https://github.com/dholbach","followers_url":"https://api.github.com/users/dholbach/followers","following_url":"https://api.github.com/users/dholbach/following{/other_user}","gists_url":"https://api.github.com/users/dholbach/gists{/gist_id}","starred_url":"https://api.github.com/users/dholbach/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dholbach/subscriptions","organizations_url":"https://api.github.com/users/dholbach/orgs","repos_url":"https://api.github.com/users/dholbach/repos","events_url":"https://api.github.com/users/dholbach/events{/privacy}","received_events_url":"https://api.github.com/users/dholbach/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/dholbach/flux","description":"A tool for deploying container images to Kubernetes services","fork":true,"url":"https://api.github.com/repos/dholbach/flux","forks_url":"https://api.github.com/repos/dholbach/flux/forks","keys_url":"https://api.github.com/repos/dholbach/flux/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dholbach/flux/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dholbach/flux/teams","hooks_url":"https://api.github.com/repos/dholbach/flux/hooks","issue_events_url":"https://api.github.com/repos/dholbach/flux/issues/events{/number}","events_url":"https://api.github.com/repos/dholbach/flux/events","assignees_url":"https://api.github.com/repos/dholbach/flux/assignees{/user}","branches_url":"https://api.github.com/repos/dholbach/flux/branches{/branch}","tags_url":"https://api.github.com/repos/dholbach/flux/tags","blobs_url":"https://api.github.com/repos/dholbach/flux/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dholbach/flux/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dholbach/flux/git/refs{/sha}","trees_url":"https://api.github.com/repos/dholbach/flux/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dholbach/flux/statuses/{sha}","languages_url":"https://api.github.com/repos/dholbach/flux/languages","stargazers_url":"https://api.github.com/repos/dholbach/flux/stargazers","contributors_url":"https://api.github.com/repos/dholbach/flux/contributors","subscribers_url":"https://api.github.com/repos/dholbach/flux/subscribers","subscription_url":"https://api.github.com/repos/dholbach/flux/subscription","commits_url":"https://api.github.com/repos/dholbach/flux/commits{/sha}","git_commits_url":"https://api.github.com/repos/dholbach/flux/git/commits{/sha}","comments_url":"https://api.github.com/repos/dholbach/flux/comments{/number}","issue_comment_url":"https://api.github.com/repos/dholbach/flux/issues/comments{/number}","contents_url":"https://api.github.com/repos/dholbach/flux/contents/{+path}","compare_url":"https://api.github.com/repos/dholbach/flux/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dholbach/flux/merges","archive_url":"https://api.github.com/repos/dholbach/flux/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dholbach/flux/downloads","issues_url":"https://api.github.com/repos/dholbach/flux/issues{/number}","pulls_url":"https://api.github.com/repos/dholbach/flux/pulls{/number}","milestones_url":"https://api.github.com/repos/dholbach/flux/milestones{/number}","notifications_url":"https://api.github.com/repos/dholbach/flux/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dholbach/flux/labels{/name}","releases_url":"https://api.github.com/repos/dholbach/flux/releases{/id}","deployments_url":"https://api.github.com/repos/dholbach/flux/deployments","created_at":"2018-05-14T12:32:15Z","updated_at":"2018-06-26T07:35:04Z","pushed_at":"2018-06-26T07:35:02Z","git_url":"git://github.com/dholbach/flux.git","ssh_url":"git@github.com:dholbach/flux.git","clone_url":"https://github.com/dholbach/flux.git","svn_url":"https://github.com/dholbach/flux","homepage":"","size":6382,"stargazers_count":0,"watchers_count":0,"language":"Go","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":1,"mirror_url":null,"archived":false,"open_issues_count":0,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0","node_id":"MDc6TGljZW5zZTI="},"forks":1,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"weaveworks:master","ref":"master","sha":"b10e0bbd5348505f06a518c26ddc1a4beaacb068","user":{"login":"weaveworks","id":9976052,"node_id":"MDEyOk9yZ2FuaXphdGlvbjk5NzYwNTI=","avatar_url":"https://avatars1.githubusercontent.com/u/9976052?v=4","gravatar_id":"","url":"https://api.github.com/users/weaveworks","html_url":"https://github.com/weaveworks","followers_url":"https://api.github.com/users/weaveworks/followers","following_url":"https://api.github.com/users/weaveworks/following{/other_user}","gists_url":"https://api.github.com/users/weaveworks/gists{/gist_id}","starred_url":"https://api.github.com/users/weaveworks/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/weaveworks/subscriptions","organizations_url":"https://api.github.com/users/weaveworks/orgs","repos_url":"https://api.github.com/users/weaveworks/repos","events_url":"https://api.github.com/users/weaveworks/events{/privacy}","received_events_url":"https://api.github.com/users/weaveworks/received_events","type":"Organization","site_admin":false},"repo":{"id":62799996,"node_id":"MDEwOlJlcG9zaXRvcnk2Mjc5OTk5Ng==","name":"flux","full_name":"weaveworks/flux","owner":{"login":"weaveworks","id":9976052,"node_id":"MDEyOk9yZ2FuaXphdGlvbjk5NzYwNTI=","avatar_url":"https://avatars1.githubusercontent.com/u/9976052?v=4","gravatar_id":"","url":"https://api.github.com/users/weaveworks","html_url":"https://github.com/weaveworks","followers_url":"https://api.github.com/users/weaveworks/followers","following_url":"https://api.github.com/users/weaveworks/following{/other_user}","gists_url":"https://api.github.com/users/weaveworks/gists{/gist_id}","starred_url":"https://api.github.com/users/weaveworks/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/weaveworks/subscriptions","organizations_url":"https://api.github.com/users/weaveworks/orgs","repos_url":"https://api.github.com/users/weaveworks/repos","events_url":"https://api.github.com/users/weaveworks/events{/privacy}","received_events_url":"https://api.github.com/users/weaveworks/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/weaveworks/flux","description":"The GitOps Kubernetes operator","fork":false,"url":"https://api.github.com/repos/weaveworks/flux","forks_url":"https://api.github.com/repos/weaveworks/flux/forks","keys_url":"https://api.github.com/repos/weaveworks/flux/keys{/key_id}","collaborators_url":"https://api.github.com/repos/weaveworks/flux/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/weaveworks/flux/teams","hooks_url":"https://api.github.com/repos/weaveworks/flux/hooks","issue_events_url":"https://api.github.com/repos/weaveworks/flux/issues/events{/number}","events_url":"https://api.github.com/repos/weaveworks/flux/events","assignees_url":"https://api.github.com/repos/weaveworks/flux/assignees{/user}","branches_url":"https://api.github.com/repos/weaveworks/flux/branches{/branch}","tags_url":"https://api.github.com/repos/weaveworks/flux/tags","blobs_url":"https://api.github.com/repos/weaveworks/flux/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/weaveworks/flux/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/weaveworks/flux/git/refs{/sha}","trees_url":"https://api.github.com/repos/weaveworks/flux/git/trees{/sha}","statuses_url":"https://api.github.com/repos/weaveworks/flux/statuses/{sha}","languages_url":"https://api.github.com/repos/weaveworks/flux/languages","stargazers_url":"https://api.github.com/repos/weaveworks/flux/stargazers","contributors_url":"https://api.github.com/repos/weaveworks/flux/contributors","subscribers_url":"https://api.github.com/repos/weaveworks/flux/subscribers","subscription_url":"https://api.github.com/repos/weaveworks/flux/subscription","commits_url":"https://api.github.com/repos/weaveworks/flux/commits{/sha}","git_commits_url":"https://api.github.com/repos/weaveworks/flux/git/commits{/sha}","comments_url":"https://api.github.com/repos/weaveworks/flux/comments{/number}","issue_comment_url":"https://api.github.com/repos/weaveworks/flux/issues/comments{/number}","contents_url":"https://api.github.com/repos/weaveworks/flux/contents/{+path}","compare_url":"https://api.github.com/repos/weaveworks/flux/compare/{base}...{head}","merges_url":"https://api.github.com/repos/weaveworks/flux/merges","archive_url":"https://api.github.com/repos/weaveworks/flux/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/weaveworks/flux/downloads","issues_url":"https://api.github.com/repos/weaveworks/flux/issues{/number}","pulls_url":"https://api.github.com/repos/weaveworks/flux/pulls{/number}","milestones_url":"https://api.github.com/repos/weaveworks/flux/milestones{/number}","notifications_url":"https://api.github.com/repos/weaveworks/flux/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/weaveworks/flux/labels{/name}","releases_url":"https://api.github.com/repos/weaveworks/flux/releases{/id}","deployments_url":"https://api.github.com/repos/weaveworks/flux/deployments","created_at":"2016-07-07T10:55:13Z","updated_at":"2018-06-28T10:51:33Z","pushed_at":"2018-06-28T10:38:44Z","git_url":"git://github.com/weaveworks/flux.git","ssh_url":"git@github.com:weaveworks/flux.git","clone_url":"https://github.com/weaveworks/flux.git","svn_url":"https://github.com/weaveworks/flux","homepage":"","size":6144,"stargazers_count":592,"watchers_count":592,"language":"Go","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":77,"mirror_url":null,"archived":false,"open_issues_count":148,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0","node_id":"MDc6TGljZW5zZTI="},"forks":77,"open_issues":148,"watchers":592,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/weaveworks/flux/pulls/1130"},"html":{"href":"https://github.com/weaveworks/flux/pull/1130"},"issue":{"href":"https://api.github.com/repos/weaveworks/flux/issues/1130"},"comments":{"href":"https://api.github.com/repos/weaveworks/flux/issues/1130/comments"},"review_comments":{"href":"https://api.github.com/repos/weaveworks/flux/pulls/1130/comments"},"review_comment":{"href":"https://api.github.com/repos/weaveworks/flux/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/weaveworks/flux/pulls/1130/commits"},"statuses":{"href":"https://api.github.com/repos/weaveworks/flux/statuses/a0e4ec3f42a39f2193bb8abdb10290a6ac67a152"}},"author_association":"CONTRIBUTOR"}}
{"actor":{"display_login":"squaremo"}}