{"action":"created","comment":{"url":"https://api.github.com/repos/istio/istio.github.io/pulls/comments/169000686","pull_request_review_id":97455654,"id":169000686,"diff_hunk":"@@ -0,0 +1,121 @@\n+---\n+title: Installing with Ansible\n+overview: Instructions on using the included Ansible playbook to perform installation.\n+\n+order: 40\n+\n+layout: docs\n+type: markdown\n+---\n+{% include home.html %}\n+\n+The Ansible scenario defined within this project will allow you to : \n+\n+- Install `Istio` Distribution and set the path of the `istioctl` go client (if you execute the command manually)\n+- Deploy Istio on Openshift or Kubernetes by specifying different parameters (version, enable auth, deploy bookinfo, ...)\n+- Specify the addons to be deployed such as `Grafana`, `Prometheus`, `Servicegraph`, `Zipkin` or `Jaeger`\n+\n+## Prerequisites\n+\n+- [Ansible 2.4](http://docs.ansible.com/ansible/latest/intro_installation.html)\n+\n+Refer to the Ansible Installation Doc on how to install Ansible on your machine.\n+To use [Minishift](https://docs.openshift.org/latest/minishift/command-ref/minishift_start.html) or [Minikube](https://kubernetes.io/docs/getting-started-guides/minikube/) for local clusters, please refer to their respective documentation. \n+\n+## Execution\n+\n+The role assumes that the user :\n+- Can access a Kubernetes or Openshift cluster via `kubectl` or `oc` respectively and is authenticated against the cluster. \n+- Has the `admin` role on the OpenShift platform\n+\n+Remark : Furthermore the minimum Kubernetes version that is compatible is `1.7.0` (`3.7.0` is the corresponding OpenShift version).   \n+\n+**Important**: All invocations of the Ansible playbooks need to take place at the `install/ansible` path of the project.\n+Failing to do so will result in unexpected errors \n+\n+The simplest execution command looks like the following:\n+ \n+```bash\n+ansible-playbook main.yml\n+```\n+\n+Remarks:\n+- The role tries it's best to be idempotent, so running the playbook multiple times should be have the same effect as running it a single time.   \n+- The default parameters that apply to this role can be found in `istio/defaults/main.yml`.\n+\n+The full list of configurable parameters is as follows:\n+\n+| Parameter | Description | Values |\n+| --- | --- | --- |\n+| `cluster_flavour` | Defines whether the target cluster is a Kubernetes or an Openshift cluster. | Valid values are `k8s` and `ocp` (default) |\n+| `github_api_token` | The API token used for authentication when calling the GitHub API | Any valid GitHub API token or empty (default) |\n+| `cmd_path` | Can be used when the user does not have the `oc` or `kubectl` binary on the PATH | Defaults to expecting the binary is on the path | \n+| `istio.release_tag_name` | Should be a valid Istio release version. If left empty, the latest Istio release will be installed | `0.2.12`, `0.3.0`, `0.4.0` (default) |\n+| `istio.dest` | Destination folder you want to install on your machine istio distribution | `~/.istio` (default) |\n+| `istio.auth` | Boolean value to install istio using MUTUAL_TLS | `true` and `false` (default) |\n+| `istio.namespace` | The namespace where istio will be installed | `istio-system` (default) |\n+| `istio.addon` | Which Istio addons should be installed as well | This field is an array field, which by default contains `grafana`, `prometheus`, `zipkin` and `servicegraph` |\n+| `istio.jaeger` | Whether or not Jaeger tracing should also be installed | `true` and `false` (default)|","path":"_docs/setup/kubernetes/ansible-install.md","position":58,"original_position":58,"commit_id":"049cc7f1bc91fe293cb1af6b50f39f8d3933cde4","original_commit_id":"049cc7f1bc91fe293cb1af6b50f39f8d3933cde4","user":{"login":"geoand","id":4374975,"avatar_url":"https://avatars2.githubusercontent.com/u/4374975?v=4","gravatar_id":"","url":"https://api.github.com/users/geoand","html_url":"https://github.com/geoand","followers_url":"https://api.github.com/users/geoand/followers","following_url":"https://api.github.com/users/geoand/following{/other_user}","gists_url":"https://api.github.com/users/geoand/gists{/gist_id}","starred_url":"https://api.github.com/users/geoand/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/geoand/subscriptions","organizations_url":"https://api.github.com/users/geoand/orgs","repos_url":"https://api.github.com/users/geoand/repos","events_url":"https://api.github.com/users/geoand/events{/privacy}","received_events_url":"https://api.github.com/users/geoand/received_events","type":"User","site_admin":false},"body":"I will do that in a separate PR :)\r\nShould that be merged before the docs are merged?","created_at":"2018-02-19T07:30:44Z","updated_at":"2018-02-19T07:30:44Z","html_url":"https://github.com/istio/istio.github.io/pull/896#discussion_r169000686","pull_request_url":"https://api.github.com/repos/istio/istio.github.io/pulls/896","author_association":"CONTRIBUTOR","_links":{"self":{"href":"https://api.github.com/repos/istio/istio.github.io/pulls/comments/169000686"},"html":{"href":"https://github.com/istio/istio.github.io/pull/896#discussion_r169000686"},"pull_request":{"href":"https://api.github.com/repos/istio/istio.github.io/pulls/896"}},"in_reply_to_id":168927306},"pull_request":{"url":"https://api.github.com/repos/istio/istio.github.io/pulls/896","id":165947461,"html_url":"https://github.com/istio/istio.github.io/pull/896","diff_url":"https://github.com/istio/istio.github.io/pull/896.diff","patch_url":"https://github.com/istio/istio.github.io/pull/896.patch","issue_url":"https://api.github.com/repos/istio/istio.github.io/issues/896","number":896,"state":"open","locked":false,"title":"Add section that points to Ansible installation","user":{"login":"geoand","id":4374975,"avatar_url":"https://avatars2.githubusercontent.com/u/4374975?v=4","gravatar_id":"","url":"https://api.github.com/users/geoand","html_url":"https://github.com/geoand","followers_url":"https://api.github.com/users/geoand/followers","following_url":"https://api.github.com/users/geoand/following{/other_user}","gists_url":"https://api.github.com/users/geoand/gists{/gist_id}","starred_url":"https://api.github.com/users/geoand/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/geoand/subscriptions","organizations_url":"https://api.github.com/users/geoand/orgs","repos_url":"https://api.github.com/users/geoand/repos","events_url":"https://api.github.com/users/geoand/events{/privacy}","received_events_url":"https://api.github.com/users/geoand/received_events","type":"User","site_admin":false},"body":"@rshriram This PR simply adds a small section the Ansible playbook added by the [relevant](https://github.com/istio/istio/pull/2794) PR.\r\nIs this how we should proceed or should I add the bulk of the instruction (perhaps in a new page)?\r\n","created_at":"2018-01-30T10:55:27Z","updated_at":"2018-02-19T07:30:44Z","closed_at":null,"merged_at":null,"merge_commit_sha":"16db3f58e0885fe5b6d8a3ab13533c4b45afb192","assignee":null,"assignees":[],"requested_reviewers":[{"login":"costinm","id":84202,"avatar_url":"https://avatars1.githubusercontent.com/u/84202?v=4","gravatar_id":"","url":"https://api.github.com/users/costinm","html_url":"https://github.com/costinm","followers_url":"https://api.github.com/users/costinm/followers","following_url":"https://api.github.com/users/costinm/following{/other_user}","gists_url":"https://api.github.com/users/costinm/gists{/gist_id}","starred_url":"https://api.github.com/users/costinm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/costinm/subscriptions","organizations_url":"https://api.github.com/users/costinm/orgs","repos_url":"https://api.github.com/users/costinm/repos","events_url":"https://api.github.com/users/costinm/events{/privacy}","received_events_url":"https://api.github.com/users/costinm/received_events","type":"User","site_admin":false},{"login":"yusuoh","id":30157432,"avatar_url":"https://avatars1.githubusercontent.com/u/30157432?v=4","gravatar_id":"","url":"https://api.github.com/users/yusuoh","html_url":"https://github.com/yusuoh","followers_url":"https://api.github.com/users/yusuoh/followers","following_url":"https://api.github.com/users/yusuoh/following{/other_user}","gists_url":"https://api.github.com/users/yusuoh/gists{/gist_id}","starred_url":"https://api.github.com/users/yusuoh/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/yusuoh/subscriptions","organizations_url":"https://api.github.com/users/yusuoh/orgs","repos_url":"https://api.github.com/users/yusuoh/repos","events_url":"https://api.github.com/users/yusuoh/events{/privacy}","received_events_url":"https://api.github.com/users/yusuoh/received_events","type":"User","site_admin":false}],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/istio/istio.github.io/pulls/896/commits","review_comments_url":"https://api.github.com/repos/istio/istio.github.io/pulls/896/comments","review_comment_url":"https://api.github.com/repos/istio/istio.github.io/pulls/comments{/number}","comments_url":"https://api.github.com/repos/istio/istio.github.io/issues/896/comments","statuses_url":"https://api.github.com/repos/istio/istio.github.io/statuses/049cc7f1bc91fe293cb1af6b50f39f8d3933cde4","head":{"label":"geoand:ansible","ref":"ansible","sha":"049cc7f1bc91fe293cb1af6b50f39f8d3933cde4","user":{"login":"geoand","id":4374975,"avatar_url":"https://avatars2.githubusercontent.com/u/4374975?v=4","gravatar_id":"","url":"https://api.github.com/users/geoand","html_url":"https://github.com/geoand","followers_url":"https://api.github.com/users/geoand/followers","following_url":"https://api.github.com/users/geoand/following{/other_user}","gists_url":"https://api.github.com/users/geoand/gists{/gist_id}","starred_url":"https://api.github.com/users/geoand/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/geoand/subscriptions","organizations_url":"https://api.github.com/users/geoand/orgs","repos_url":"https://api.github.com/users/geoand/repos","events_url":"https://api.github.com/users/geoand/events{/privacy}","received_events_url":"https://api.github.com/users/geoand/received_events","type":"User","site_admin":false},"repo":{"id":116659715,"name":"istio.github.io","full_name":"geoand/istio.github.io","owner":{"login":"geoand","id":4374975,"avatar_url":"https://avatars2.githubusercontent.com/u/4374975?v=4","gravatar_id":"","url":"https://api.github.com/users/geoand","html_url":"https://github.com/geoand","followers_url":"https://api.github.com/users/geoand/followers","following_url":"https://api.github.com/users/geoand/following{/other_user}","gists_url":"https://api.github.com/users/geoand/gists{/gist_id}","starred_url":"https://api.github.com/users/geoand/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/geoand/subscriptions","organizations_url":"https://api.github.com/users/geoand/orgs","repos_url":"https://api.github.com/users/geoand/repos","events_url":"https://api.github.com/users/geoand/events{/privacy}","received_events_url":"https://api.github.com/users/geoand/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/geoand/istio.github.io","description":"Source for the istio.io site","fork":true,"url":"https://api.github.com/repos/geoand/istio.github.io","forks_url":"https://api.github.com/repos/geoand/istio.github.io/forks","keys_url":"https://api.github.com/repos/geoand/istio.github.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/geoand/istio.github.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/geoand/istio.github.io/teams","hooks_url":"https://api.github.com/repos/geoand/istio.github.io/hooks","issue_events_url":"https://api.github.com/repos/geoand/istio.github.io/issues/events{/number}","events_url":"https://api.github.com/repos/geoand/istio.github.io/events","assignees_url":"https://api.github.com/repos/geoand/istio.github.io/assignees{/user}","branches_url":"https://api.github.com/repos/geoand/istio.github.io/branches{/branch}","tags_url":"https://api.github.com/repos/geoand/istio.github.io/tags","blobs_url":"https://api.github.com/repos/geoand/istio.github.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/geoand/istio.github.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/geoand/istio.github.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/geoand/istio.github.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/geoand/istio.github.io/statuses/{sha}","languages_url":"https://api.github.com/repos/geoand/istio.github.io/languages","stargazers_url":"https://api.github.com/repos/geoand/istio.github.io/stargazers","contributors_url":"https://api.github.com/repos/geoand/istio.github.io/contributors","subscribers_url":"https://api.github.com/repos/geoand/istio.github.io/subscribers","subscription_url":"https://api.github.com/repos/geoand/istio.github.io/subscription","commits_url":"https://api.github.com/repos/geoand/istio.github.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/geoand/istio.github.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/geoand/istio.github.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/geoand/istio.github.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/geoand/istio.github.io/contents/{+path}","compare_url":"https://api.github.com/repos/geoand/istio.github.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/geoand/istio.github.io/merges","archive_url":"https://api.github.com/repos/geoand/istio.github.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/geoand/istio.github.io/downloads","issues_url":"https://api.github.com/repos/geoand/istio.github.io/issues{/number}","pulls_url":"https://api.github.com/repos/geoand/istio.github.io/pulls{/number}","milestones_url":"https://api.github.com/repos/geoand/istio.github.io/milestones{/number}","notifications_url":"https://api.github.com/repos/geoand/istio.github.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/geoand/istio.github.io/labels{/name}","releases_url":"https://api.github.com/repos/geoand/istio.github.io/releases{/id}","deployments_url":"https://api.github.com/repos/geoand/istio.github.io/deployments","created_at":"2018-01-08T09:58:37Z","updated_at":"2018-01-08T09:58:39Z","pushed_at":"2018-02-15T08:38:43Z","git_url":"git://github.com/geoand/istio.github.io.git","ssh_url":"git@github.com:geoand/istio.github.io.git","clone_url":"https://github.com/geoand/istio.github.io.git","svn_url":"https://github.com/geoand/istio.github.io","homepage":"https://istio.io/","size":21138,"stargazers_count":0,"watchers_count":0,"language":"HTML","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"archived":false,"open_issues_count":0,"license":null,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"istio:master","ref":"master","sha":"51d41c2494c3a39d5b86c0e8afc2c93bb2d2851b","user":{"login":"istio","id":23534644,"avatar_url":"https://avatars1.githubusercontent.com/u/23534644?v=4","gravatar_id":"","url":"https://api.github.com/users/istio","html_url":"https://github.com/istio","followers_url":"https://api.github.com/users/istio/followers","following_url":"https://api.github.com/users/istio/following{/other_user}","gists_url":"https://api.github.com/users/istio/gists{/gist_id}","starred_url":"https://api.github.com/users/istio/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/istio/subscriptions","organizations_url":"https://api.github.com/users/istio/orgs","repos_url":"https://api.github.com/users/istio/repos","events_url":"https://api.github.com/users/istio/events{/privacy}","received_events_url":"https://api.github.com/users/istio/received_events","type":"Organization","site_admin":false},"repo":{"id":82706976,"name":"istio.github.io","full_name":"istio/istio.github.io","owner":{"login":"istio","id":23534644,"avatar_url":"https://avatars1.githubusercontent.com/u/23534644?v=4","gravatar_id":"","url":"https://api.github.com/users/istio","html_url":"https://github.com/istio","followers_url":"https://api.github.com/users/istio/followers","following_url":"https://api.github.com/users/istio/following{/other_user}","gists_url":"https://api.github.com/users/istio/gists{/gist_id}","starred_url":"https://api.github.com/users/istio/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/istio/subscriptions","organizations_url":"https://api.github.com/users/istio/orgs","repos_url":"https://api.github.com/users/istio/repos","events_url":"https://api.github.com/users/istio/events{/privacy}","received_events_url":"https://api.github.com/users/istio/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/istio/istio.github.io","description":"Source for the istio.io site","fork":false,"url":"https://api.github.com/repos/istio/istio.github.io","forks_url":"https://api.github.com/repos/istio/istio.github.io/forks","keys_url":"https://api.github.com/repos/istio/istio.github.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/istio/istio.github.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/istio/istio.github.io/teams","hooks_url":"https://api.github.com/repos/istio/istio.github.io/hooks","issue_events_url":"https://api.github.com/repos/istio/istio.github.io/issues/events{/number}","events_url":"https://api.github.com/repos/istio/istio.github.io/events","assignees_url":"https://api.github.com/repos/istio/istio.github.io/assignees{/user}","branches_url":"https://api.github.com/repos/istio/istio.github.io/branches{/branch}","tags_url":"https://api.github.com/repos/istio/istio.github.io/tags","blobs_url":"https://api.github.com/repos/istio/istio.github.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/istio/istio.github.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/istio/istio.github.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/istio/istio.github.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/istio/istio.github.io/statuses/{sha}","languages_url":"https://api.github.com/repos/istio/istio.github.io/languages","stargazers_url":"https://api.github.com/repos/istio/istio.github.io/stargazers","contributors_url":"https://api.github.com/repos/istio/istio.github.io/contributors","subscribers_url":"https://api.github.com/repos/istio/istio.github.io/subscribers","subscription_url":"https://api.github.com/repos/istio/istio.github.io/subscription","commits_url":"https://api.github.com/repos/istio/istio.github.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/istio/istio.github.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/istio/istio.github.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/istio/istio.github.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/istio/istio.github.io/contents/{+path}","compare_url":"https://api.github.com/repos/istio/istio.github.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/istio/istio.github.io/merges","archive_url":"https://api.github.com/repos/istio/istio.github.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/istio/istio.github.io/downloads","issues_url":"https://api.github.com/repos/istio/istio.github.io/issues{/number}","pulls_url":"https://api.github.com/repos/istio/istio.github.io/pulls{/number}","milestones_url":"https://api.github.com/repos/istio/istio.github.io/milestones{/number}","notifications_url":"https://api.github.com/repos/istio/istio.github.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/istio/istio.github.io/labels{/name}","releases_url":"https://api.github.com/repos/istio/istio.github.io/releases{/id}","deployments_url":"https://api.github.com/repos/istio/istio.github.io/deployments","created_at":"2017-02-21T17:19:49Z","updated_at":"2018-02-18T20:41:41Z","pushed_at":"2018-02-18T20:48:50Z","git_url":"git://github.com/istio/istio.github.io.git","ssh_url":"git@github.com:istio/istio.github.io.git","clone_url":"https://github.com/istio/istio.github.io.git","svn_url":"https://github.com/istio/istio.github.io","homepage":"https://istio.io/","size":21169,"stargazers_count":46,"watchers_count":46,"language":"HTML","has_issues":true,"has_projects":false,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":149,"mirror_url":null,"archived":false,"open_issues_count":53,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0"},"forks":149,"open_issues":53,"watchers":46,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/istio/istio.github.io/pulls/896"},"html":{"href":"https://github.com/istio/istio.github.io/pull/896"},"issue":{"href":"https://api.github.com/repos/istio/istio.github.io/issues/896"},"comments":{"href":"https://api.github.com/repos/istio/istio.github.io/issues/896/comments"},"review_comments":{"href":"https://api.github.com/repos/istio/istio.github.io/pulls/896/comments"},"review_comment":{"href":"https://api.github.com/repos/istio/istio.github.io/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/istio/istio.github.io/pulls/896/commits"},"statuses":{"href":"https://api.github.com/repos/istio/istio.github.io/statuses/049cc7f1bc91fe293cb1af6b50f39f8d3933cde4"}},"author_association":"CONTRIBUTOR"}}
{"actor":{"display_login":"geoand"}}