{"action":"created","comment":{"url":"https://api.github.com/repos/heptio/ark/pulls/comments/171891244","pull_request_review_id":100825504,"id":171891244,"diff_hunk":"@@ -1,53 +1,17 @@\n-# Use Cases\n+# Why Ark?\n \n-This doc provides sample Ark commands for the following common scenarios:\n-* [Disaster recovery][0]\n-* [Cluster migration][1]\n+Kubernetes workloads are ephemeral. You describe your cluster's state, and Kubernetes makes it so. So why do you still need to worry about backups and restores? Ark addresses these use cases:\n \n-## Disaster recovery\n+* Disaster recovery for your persistent volumes\n \n-*Using Schedules and Restore-Only Mode*\n+* If you don't start with your Kubernetes manifests in source control, you can run Ark to download the entire cluster and then put the manifests in source control.\n \n-If you periodically back up your cluster's resources, you are able to return to a previous state in case of some unexpected mishap, such as a service outage. Doing so with Heptio Ark looks like the following:\n+* Copy your environment by cloning a cluster, or a portion of a cluster, to another cluster or to the same cluster. You can use the copy for scale testing, reproducing bugs, and more.\n \n-1. After you first run the Ark server on your cluster, set up a daily backup (replacing `<SCHEDULE NAME>` in the command as desired):\n+  * If you specify CPU and memory requests and limits for a pod, you can test these settings with a clone.\n \n-    ```\n-    ark schedule create <SCHEDULE NAME> --schedule \"0 7 * * *\"\n-    ```\n-    This creates a Backup object with the name `<SCHEDULE NAME>-<TIMESTAMP>`.\n+* Support for backing up any directory in any container's file system is planned for a future release. This feature will let you migrate your data across cloud providers more easily.","path":"docs/use-cases.md","position":25,"original_position":25,"commit_id":"b0f6dabbe189c488e97b55b3419f1fc7db997323","original_commit_id":"b0f6dabbe189c488e97b55b3419f1fc7db997323","user":{"login":"ncdc","id":354,"avatar_url":"https://avatars2.githubusercontent.com/u/354?v=4","gravatar_id":"","url":"https://api.github.com/users/ncdc","html_url":"https://github.com/ncdc","followers_url":"https://api.github.com/users/ncdc/followers","following_url":"https://api.github.com/users/ncdc/following{/other_user}","gists_url":"https://api.github.com/users/ncdc/gists{/gist_id}","starred_url":"https://api.github.com/users/ncdc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ncdc/subscriptions","organizations_url":"https://api.github.com/users/ncdc/orgs","repos_url":"https://api.github.com/users/ncdc/repos","events_url":"https://api.github.com/users/ncdc/events{/privacy}","received_events_url":"https://api.github.com/users/ncdc/received_events","type":"User","site_admin":false},"body":"Should we include this here, now?","created_at":"2018-03-02T16:17:40Z","updated_at":"2018-03-02T16:17:46Z","html_url":"https://github.com/heptio/ark/pull/346#discussion_r171891244","pull_request_url":"https://api.github.com/repos/heptio/ark/pulls/346","author_association":"OWNER","_links":{"self":{"href":"https://api.github.com/repos/heptio/ark/pulls/comments/171891244"},"html":{"href":"https://github.com/heptio/ark/pull/346#discussion_r171891244"},"pull_request":{"href":"https://api.github.com/repos/heptio/ark/pulls/346"}}},"pull_request":{"url":"https://api.github.com/repos/heptio/ark/pulls/346","id":172534009,"html_url":"https://github.com/heptio/ark/pull/346","diff_url":"https://github.com/heptio/ark/pull/346.diff","patch_url":"https://github.com/heptio/ark/pull/346.patch","issue_url":"https://api.github.com/repos/heptio/ark/issues/346","number":346,"state":"open","locked":false,"title":"document use cases in more detail","user":{"login":"Bradamant3","id":6934230,"avatar_url":"https://avatars2.githubusercontent.com/u/6934230?v=4","gravatar_id":"","url":"https://api.github.com/users/Bradamant3","html_url":"https://github.com/Bradamant3","followers_url":"https://api.github.com/users/Bradamant3/followers","following_url":"https://api.github.com/users/Bradamant3/following{/other_user}","gists_url":"https://api.github.com/users/Bradamant3/gists{/gist_id}","starred_url":"https://api.github.com/users/Bradamant3/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Bradamant3/subscriptions","organizations_url":"https://api.github.com/users/Bradamant3/orgs","repos_url":"https://api.github.com/users/Bradamant3/repos","events_url":"https://api.github.com/users/Bradamant3/events{/privacy}","received_events_url":"https://api.github.com/users/Bradamant3/received_events","type":"User","site_admin":false},"body":"Signed-off-by: JENNIFER RONDEAU <jrondeau@heptio.com>\r\n\r\nPer discussion in #ark-dr on K8s Slack. Plus a couple of links to encourage attention/reading. n.b. this PR is for `master` -- will update `gh-pages` and site separately, probably next week. Process is still a bit manual and fiddly.\r\n\r\n@ncdc PTAL","created_at":"2018-03-02T15:42:12Z","updated_at":"2018-03-02T16:17:46Z","closed_at":null,"merged_at":null,"merge_commit_sha":"07861d59f147d192c930030269458845f61692e6","assignee":null,"assignees":[],"requested_reviewers":[],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/heptio/ark/pulls/346/commits","review_comments_url":"https://api.github.com/repos/heptio/ark/pulls/346/comments","review_comment_url":"https://api.github.com/repos/heptio/ark/pulls/comments{/number}","comments_url":"https://api.github.com/repos/heptio/ark/issues/346/comments","statuses_url":"https://api.github.com/repos/heptio/ark/statuses/b0f6dabbe189c488e97b55b3419f1fc7db997323","head":{"label":"Bradamant3:doc-use-cases","ref":"doc-use-cases","sha":"b0f6dabbe189c488e97b55b3419f1fc7db997323","user":{"login":"Bradamant3","id":6934230,"avatar_url":"https://avatars2.githubusercontent.com/u/6934230?v=4","gravatar_id":"","url":"https://api.github.com/users/Bradamant3","html_url":"https://github.com/Bradamant3","followers_url":"https://api.github.com/users/Bradamant3/followers","following_url":"https://api.github.com/users/Bradamant3/following{/other_user}","gists_url":"https://api.github.com/users/Bradamant3/gists{/gist_id}","starred_url":"https://api.github.com/users/Bradamant3/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Bradamant3/subscriptions","organizations_url":"https://api.github.com/users/Bradamant3/orgs","repos_url":"https://api.github.com/users/Bradamant3/repos","events_url":"https://api.github.com/users/Bradamant3/events{/privacy}","received_events_url":"https://api.github.com/users/Bradamant3/received_events","type":"User","site_admin":false},"repo":{"id":120502479,"name":"ark","full_name":"Bradamant3/ark","owner":{"login":"Bradamant3","id":6934230,"avatar_url":"https://avatars2.githubusercontent.com/u/6934230?v=4","gravatar_id":"","url":"https://api.github.com/users/Bradamant3","html_url":"https://github.com/Bradamant3","followers_url":"https://api.github.com/users/Bradamant3/followers","following_url":"https://api.github.com/users/Bradamant3/following{/other_user}","gists_url":"https://api.github.com/users/Bradamant3/gists{/gist_id}","starred_url":"https://api.github.com/users/Bradamant3/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Bradamant3/subscriptions","organizations_url":"https://api.github.com/users/Bradamant3/orgs","repos_url":"https://api.github.com/users/Bradamant3/repos","events_url":"https://api.github.com/users/Bradamant3/events{/privacy}","received_events_url":"https://api.github.com/users/Bradamant3/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/Bradamant3/ark","description":"Heptio Ark is a utility for managing disaster recovery, specifically for your Kubernetes cluster resources and persistent volumes. Brought to you by Heptio.","fork":true,"url":"https://api.github.com/repos/Bradamant3/ark","forks_url":"https://api.github.com/repos/Bradamant3/ark/forks","keys_url":"https://api.github.com/repos/Bradamant3/ark/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Bradamant3/ark/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Bradamant3/ark/teams","hooks_url":"https://api.github.com/repos/Bradamant3/ark/hooks","issue_events_url":"https://api.github.com/repos/Bradamant3/ark/issues/events{/number}","events_url":"https://api.github.com/repos/Bradamant3/ark/events","assignees_url":"https://api.github.com/repos/Bradamant3/ark/assignees{/user}","branches_url":"https://api.github.com/repos/Bradamant3/ark/branches{/branch}","tags_url":"https://api.github.com/repos/Bradamant3/ark/tags","blobs_url":"https://api.github.com/repos/Bradamant3/ark/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Bradamant3/ark/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Bradamant3/ark/git/refs{/sha}","trees_url":"https://api.github.com/repos/Bradamant3/ark/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Bradamant3/ark/statuses/{sha}","languages_url":"https://api.github.com/repos/Bradamant3/ark/languages","stargazers_url":"https://api.github.com/repos/Bradamant3/ark/stargazers","contributors_url":"https://api.github.com/repos/Bradamant3/ark/contributors","subscribers_url":"https://api.github.com/repos/Bradamant3/ark/subscribers","subscription_url":"https://api.github.com/repos/Bradamant3/ark/subscription","commits_url":"https://api.github.com/repos/Bradamant3/ark/commits{/sha}","git_commits_url":"https://api.github.com/repos/Bradamant3/ark/git/commits{/sha}","comments_url":"https://api.github.com/repos/Bradamant3/ark/comments{/number}","issue_comment_url":"https://api.github.com/repos/Bradamant3/ark/issues/comments{/number}","contents_url":"https://api.github.com/repos/Bradamant3/ark/contents/{+path}","compare_url":"https://api.github.com/repos/Bradamant3/ark/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Bradamant3/ark/merges","archive_url":"https://api.github.com/repos/Bradamant3/ark/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Bradamant3/ark/downloads","issues_url":"https://api.github.com/repos/Bradamant3/ark/issues{/number}","pulls_url":"https://api.github.com/repos/Bradamant3/ark/pulls{/number}","milestones_url":"https://api.github.com/repos/Bradamant3/ark/milestones{/number}","notifications_url":"https://api.github.com/repos/Bradamant3/ark/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Bradamant3/ark/labels{/name}","releases_url":"https://api.github.com/repos/Bradamant3/ark/releases{/id}","deployments_url":"https://api.github.com/repos/Bradamant3/ark/deployments","created_at":"2018-02-06T18:13:47Z","updated_at":"2018-02-06T18:13:50Z","pushed_at":"2018-03-02T15:40:34Z","git_url":"git://github.com/Bradamant3/ark.git","ssh_url":"git@github.com:Bradamant3/ark.git","clone_url":"https://github.com/Bradamant3/ark.git","svn_url":"https://github.com/Bradamant3/ark","homepage":"https://www.heptio.com","size":8156,"stargazers_count":0,"watchers_count":0,"language":"Go","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"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":"heptio:master","ref":"master","sha":"975dce929c5f570b376d4af2aef4919dc18e6073","user":{"login":"heptio","id":22035492,"avatar_url":"https://avatars0.githubusercontent.com/u/22035492?v=4","gravatar_id":"","url":"https://api.github.com/users/heptio","html_url":"https://github.com/heptio","followers_url":"https://api.github.com/users/heptio/followers","following_url":"https://api.github.com/users/heptio/following{/other_user}","gists_url":"https://api.github.com/users/heptio/gists{/gist_id}","starred_url":"https://api.github.com/users/heptio/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/heptio/subscriptions","organizations_url":"https://api.github.com/users/heptio/orgs","repos_url":"https://api.github.com/users/heptio/repos","events_url":"https://api.github.com/users/heptio/events{/privacy}","received_events_url":"https://api.github.com/users/heptio/received_events","type":"Organization","site_admin":false},"repo":{"id":99143276,"name":"ark","full_name":"heptio/ark","owner":{"login":"heptio","id":22035492,"avatar_url":"https://avatars0.githubusercontent.com/u/22035492?v=4","gravatar_id":"","url":"https://api.github.com/users/heptio","html_url":"https://github.com/heptio","followers_url":"https://api.github.com/users/heptio/followers","following_url":"https://api.github.com/users/heptio/following{/other_user}","gists_url":"https://api.github.com/users/heptio/gists{/gist_id}","starred_url":"https://api.github.com/users/heptio/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/heptio/subscriptions","organizations_url":"https://api.github.com/users/heptio/orgs","repos_url":"https://api.github.com/users/heptio/repos","events_url":"https://api.github.com/users/heptio/events{/privacy}","received_events_url":"https://api.github.com/users/heptio/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/heptio/ark","description":"Heptio Ark is a utility for managing disaster recovery, specifically for your Kubernetes cluster resources and persistent volumes. Brought to you by Heptio.","fork":false,"url":"https://api.github.com/repos/heptio/ark","forks_url":"https://api.github.com/repos/heptio/ark/forks","keys_url":"https://api.github.com/repos/heptio/ark/keys{/key_id}","collaborators_url":"https://api.github.com/repos/heptio/ark/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/heptio/ark/teams","hooks_url":"https://api.github.com/repos/heptio/ark/hooks","issue_events_url":"https://api.github.com/repos/heptio/ark/issues/events{/number}","events_url":"https://api.github.com/repos/heptio/ark/events","assignees_url":"https://api.github.com/repos/heptio/ark/assignees{/user}","branches_url":"https://api.github.com/repos/heptio/ark/branches{/branch}","tags_url":"https://api.github.com/repos/heptio/ark/tags","blobs_url":"https://api.github.com/repos/heptio/ark/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/heptio/ark/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/heptio/ark/git/refs{/sha}","trees_url":"https://api.github.com/repos/heptio/ark/git/trees{/sha}","statuses_url":"https://api.github.com/repos/heptio/ark/statuses/{sha}","languages_url":"https://api.github.com/repos/heptio/ark/languages","stargazers_url":"https://api.github.com/repos/heptio/ark/stargazers","contributors_url":"https://api.github.com/repos/heptio/ark/contributors","subscribers_url":"https://api.github.com/repos/heptio/ark/subscribers","subscription_url":"https://api.github.com/repos/heptio/ark/subscription","commits_url":"https://api.github.com/repos/heptio/ark/commits{/sha}","git_commits_url":"https://api.github.com/repos/heptio/ark/git/commits{/sha}","comments_url":"https://api.github.com/repos/heptio/ark/comments{/number}","issue_comment_url":"https://api.github.com/repos/heptio/ark/issues/comments{/number}","contents_url":"https://api.github.com/repos/heptio/ark/contents/{+path}","compare_url":"https://api.github.com/repos/heptio/ark/compare/{base}...{head}","merges_url":"https://api.github.com/repos/heptio/ark/merges","archive_url":"https://api.github.com/repos/heptio/ark/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/heptio/ark/downloads","issues_url":"https://api.github.com/repos/heptio/ark/issues{/number}","pulls_url":"https://api.github.com/repos/heptio/ark/pulls{/number}","milestones_url":"https://api.github.com/repos/heptio/ark/milestones{/number}","notifications_url":"https://api.github.com/repos/heptio/ark/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/heptio/ark/labels{/name}","releases_url":"https://api.github.com/repos/heptio/ark/releases{/id}","deployments_url":"https://api.github.com/repos/heptio/ark/deployments","created_at":"2017-08-02T17:22:11Z","updated_at":"2018-03-02T11:06:37Z","pushed_at":"2018-03-02T15:42:13Z","git_url":"git://github.com/heptio/ark.git","ssh_url":"git@github.com:heptio/ark.git","clone_url":"https://github.com/heptio/ark.git","svn_url":"https://github.com/heptio/ark","homepage":"https://www.heptio.com","size":8199,"stargazers_count":862,"watchers_count":862,"language":"Go","has_issues":true,"has_projects":false,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":93,"mirror_url":null,"archived":false,"open_issues_count":92,"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":93,"open_issues":92,"watchers":862,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/heptio/ark/pulls/346"},"html":{"href":"https://github.com/heptio/ark/pull/346"},"issue":{"href":"https://api.github.com/repos/heptio/ark/issues/346"},"comments":{"href":"https://api.github.com/repos/heptio/ark/issues/346/comments"},"review_comments":{"href":"https://api.github.com/repos/heptio/ark/pulls/346/comments"},"review_comment":{"href":"https://api.github.com/repos/heptio/ark/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/heptio/ark/pulls/346/commits"},"statuses":{"href":"https://api.github.com/repos/heptio/ark/statuses/b0f6dabbe189c488e97b55b3419f1fc7db997323"}},"author_association":"COLLABORATOR"}}
{"actor":{"display_login":"ncdc"}}