{"action":"created","comment":{"url":"https://api.github.com/repos/kubernetes/deployment-manager/pulls/comments/52680682","id":52680682,"diff_hunk":"@@ -0,0 +1,664 @@\n+﻿# Helm-DM Charts Proposal\n+\n+\n+This document contains a proposal for a new Chart format that both Helm and DM would standardize upon as Helm becomes a DM client.\n+\n+\n+* [Changes](#changes)\n+* [tl;dr: Summary](#tldr-summary)\n+* [Goals](#goals)\n+  * [Non-Goals](#non-goals)\n+* [The Chart Format](#the-chart-format)\n+  * [Directory Layout](#directory-layout)\n+  * [Generators and Templates](#generators-and-templates)\n+    * [The Generator Header](#the-generator-header)\n+    * [Python/Jinja Templates (aka DM Templates)](#pythonjinja-templates-aka-dm-templates)\n+    * [Go Templates (formerly Helm Templates)](#go-templates-formerly-helm-templates)\n+  * [The Chart File](#the-chart-file)\n+    * [Dependency Information](#dependency-information)\n+  * [Releasing a Chart](#releasing-a-chart)\n+* [The Chart Repository](#the-chart-repository)\n+  * [The Provenance File](#the-provenance-file)\n+  * [Repository Protocol](#repository-protocol)\n+  * [Aside: Why a Flat Repository Namespace?](#aside-why-a-flat-repository-namespace)\n+  * [Aside: Why Not Git(Hub) or VCS?](#aside-why-not-github-or-vcs)\n+* [Chart References: Long form, short form, and local reference](#chart-references-long-form-short-form-and-local-reference)\n+  * [Long Form](#long-form)\n+  * [Short Form](#short-form)\n+  * [Local References](#local-references)\n+* [Appendix A: User Stories for Charts](#appendix-a-user-stories-for-charts)\n+* [Appendix B: The Standard Chart Repository](#appendix-b-the-standard-chart-repository)\n+* [Appendix C: EBNF for Generate Header](#appendix-c-ebnf-for-generate-header)\n+* [Appendix D: References](#appendix-d-references)\n+\n+\n+## Changes\n+\n+| Date        | Author        | Changes                                                |\n+| ------------|:-------------:|:-------------------------------------------------------|\n+| 2016-01-21  | mbutcher@deis | Added manifests/ to chart.                             |\n+| 2016-01-25  | mbutcher@deis | Added clarifications based on comments.                |\n+| 2016-01-26  | mbutcher@deis | Added hook/, removed manifests/. Added generate header.|\n+\n+\n+## tl;dr: Summary\n+* A **Chart** is a folder or archive containing a _Chart.yaml_ file, a _templates/_ directory with one or more template files and supporting files, such as schemas and UI directives, and optionally a _README.md_ and _LICENSE_ file.\n+* When a chart is **released**, it is tested, versioned, provenanced, and loaded into a chart repository.\n+* A **Chart Repository** is organized according to the conventions of object storage. It is accessible by combining a domain with a repository ID (bucket), and can be browsed. A chart repository contains one or more versioned charts.","path":"docs/design/chart_format.md","position":47,"original_position":47,"commit_id":"cf43dcf44ad8bb98fc1914150503a9c4cb1f5855","original_commit_id":"cf43dcf44ad8bb98fc1914150503a9c4cb1f5855","user":{"login":"jackgr","id":5607565,"avatar_url":"https://avatars.githubusercontent.com/u/5607565?v=3","gravatar_id":"","url":"https://api.github.com/users/jackgr","html_url":"https://github.com/jackgr","followers_url":"https://api.github.com/users/jackgr/followers","following_url":"https://api.github.com/users/jackgr/following{/other_user}","gists_url":"https://api.github.com/users/jackgr/gists{/gist_id}","starred_url":"https://api.github.com/users/jackgr/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jackgr/subscriptions","organizations_url":"https://api.github.com/users/jackgr/orgs","repos_url":"https://api.github.com/users/jackgr/repos","events_url":"https://api.github.com/users/jackgr/events{/privacy}","received_events_url":"https://api.github.com/users/jackgr/received_events","type":"User","site_admin":false},"body":"If I recall correctly, we've agreed to go on supporting Github as a repository technology to ease Chart development work flows. Not a show stopper to getting this document in, but something we should address soon.","created_at":"2016-02-11T22:47:50Z","updated_at":"2016-02-11T22:47:50Z","html_url":"https://github.com/kubernetes/deployment-manager/pull/250#discussion_r52680682","pull_request_url":"https://api.github.com/repos/kubernetes/deployment-manager/pulls/250","_links":{"self":{"href":"https://api.github.com/repos/kubernetes/deployment-manager/pulls/comments/52680682"},"html":{"href":"https://github.com/kubernetes/deployment-manager/pull/250#discussion_r52680682"},"pull_request":{"href":"https://api.github.com/repos/kubernetes/deployment-manager/pulls/250"}}},"pull_request":{"url":"https://api.github.com/repos/kubernetes/deployment-manager/pulls/250","id":58844793,"html_url":"https://github.com/kubernetes/deployment-manager/pull/250","diff_url":"https://github.com/kubernetes/deployment-manager/pull/250.diff","patch_url":"https://github.com/kubernetes/deployment-manager/pull/250.patch","issue_url":"https://api.github.com/repos/kubernetes/deployment-manager/issues/250","number":250,"state":"open","locked":false,"title":"add helm-dm charts proposal to dm docs","user":{"login":"michelleN","id":1497123,"avatar_url":"https://avatars.githubusercontent.com/u/1497123?v=3","gravatar_id":"","url":"https://api.github.com/users/michelleN","html_url":"https://github.com/michelleN","followers_url":"https://api.github.com/users/michelleN/followers","following_url":"https://api.github.com/users/michelleN/following{/other_user}","gists_url":"https://api.github.com/users/michelleN/gists{/gist_id}","starred_url":"https://api.github.com/users/michelleN/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/michelleN/subscriptions","organizations_url":"https://api.github.com/users/michelleN/orgs","repos_url":"https://api.github.com/users/michelleN/repos","events_url":"https://api.github.com/users/michelleN/events{/privacy}","received_events_url":"https://api.github.com/users/michelleN/received_events","type":"User","site_admin":false},"body":"The is the markdown version of the helm-dm chart proposal.","created_at":"2016-02-10T03:50:46Z","updated_at":"2016-02-11T22:47:50Z","closed_at":null,"merged_at":null,"merge_commit_sha":"af9352a2fb87edeaaf562417e2271b6e010a0198","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/kubernetes/deployment-manager/pulls/250/commits","review_comments_url":"https://api.github.com/repos/kubernetes/deployment-manager/pulls/250/comments","review_comment_url":"https://api.github.com/repos/kubernetes/deployment-manager/pulls/comments{/number}","comments_url":"https://api.github.com/repos/kubernetes/deployment-manager/issues/250/comments","statuses_url":"https://api.github.com/repos/kubernetes/deployment-manager/statuses/cf43dcf44ad8bb98fc1914150503a9c4cb1f5855","head":{"label":"michelleN:chartdoc","ref":"chartdoc","sha":"cf43dcf44ad8bb98fc1914150503a9c4cb1f5855","user":{"login":"michelleN","id":1497123,"avatar_url":"https://avatars.githubusercontent.com/u/1497123?v=3","gravatar_id":"","url":"https://api.github.com/users/michelleN","html_url":"https://github.com/michelleN","followers_url":"https://api.github.com/users/michelleN/followers","following_url":"https://api.github.com/users/michelleN/following{/other_user}","gists_url":"https://api.github.com/users/michelleN/gists{/gist_id}","starred_url":"https://api.github.com/users/michelleN/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/michelleN/subscriptions","organizations_url":"https://api.github.com/users/michelleN/orgs","repos_url":"https://api.github.com/users/michelleN/repos","events_url":"https://api.github.com/users/michelleN/events{/privacy}","received_events_url":"https://api.github.com/users/michelleN/received_events","type":"User","site_admin":false},"repo":{"id":50368543,"name":"deployment-manager","full_name":"michelleN/deployment-manager","owner":{"login":"michelleN","id":1497123,"avatar_url":"https://avatars.githubusercontent.com/u/1497123?v=3","gravatar_id":"","url":"https://api.github.com/users/michelleN","html_url":"https://github.com/michelleN","followers_url":"https://api.github.com/users/michelleN/followers","following_url":"https://api.github.com/users/michelleN/following{/other_user}","gists_url":"https://api.github.com/users/michelleN/gists{/gist_id}","starred_url":"https://api.github.com/users/michelleN/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/michelleN/subscriptions","organizations_url":"https://api.github.com/users/michelleN/orgs","repos_url":"https://api.github.com/users/michelleN/repos","events_url":"https://api.github.com/users/michelleN/events{/privacy}","received_events_url":"https://api.github.com/users/michelleN/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/michelleN/deployment-manager","description":"Deployment Manager on Kubernetes","fork":true,"url":"https://api.github.com/repos/michelleN/deployment-manager","forks_url":"https://api.github.com/repos/michelleN/deployment-manager/forks","keys_url":"https://api.github.com/repos/michelleN/deployment-manager/keys{/key_id}","collaborators_url":"https://api.github.com/repos/michelleN/deployment-manager/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/michelleN/deployment-manager/teams","hooks_url":"https://api.github.com/repos/michelleN/deployment-manager/hooks","issue_events_url":"https://api.github.com/repos/michelleN/deployment-manager/issues/events{/number}","events_url":"https://api.github.com/repos/michelleN/deployment-manager/events","assignees_url":"https://api.github.com/repos/michelleN/deployment-manager/assignees{/user}","branches_url":"https://api.github.com/repos/michelleN/deployment-manager/branches{/branch}","tags_url":"https://api.github.com/repos/michelleN/deployment-manager/tags","blobs_url":"https://api.github.com/repos/michelleN/deployment-manager/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/michelleN/deployment-manager/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/michelleN/deployment-manager/git/refs{/sha}","trees_url":"https://api.github.com/repos/michelleN/deployment-manager/git/trees{/sha}","statuses_url":"https://api.github.com/repos/michelleN/deployment-manager/statuses/{sha}","languages_url":"https://api.github.com/repos/michelleN/deployment-manager/languages","stargazers_url":"https://api.github.com/repos/michelleN/deployment-manager/stargazers","contributors_url":"https://api.github.com/repos/michelleN/deployment-manager/contributors","subscribers_url":"https://api.github.com/repos/michelleN/deployment-manager/subscribers","subscription_url":"https://api.github.com/repos/michelleN/deployment-manager/subscription","commits_url":"https://api.github.com/repos/michelleN/deployment-manager/commits{/sha}","git_commits_url":"https://api.github.com/repos/michelleN/deployment-manager/git/commits{/sha}","comments_url":"https://api.github.com/repos/michelleN/deployment-manager/comments{/number}","issue_comment_url":"https://api.github.com/repos/michelleN/deployment-manager/issues/comments{/number}","contents_url":"https://api.github.com/repos/michelleN/deployment-manager/contents/{+path}","compare_url":"https://api.github.com/repos/michelleN/deployment-manager/compare/{base}...{head}","merges_url":"https://api.github.com/repos/michelleN/deployment-manager/merges","archive_url":"https://api.github.com/repos/michelleN/deployment-manager/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/michelleN/deployment-manager/downloads","issues_url":"https://api.github.com/repos/michelleN/deployment-manager/issues{/number}","pulls_url":"https://api.github.com/repos/michelleN/deployment-manager/pulls{/number}","milestones_url":"https://api.github.com/repos/michelleN/deployment-manager/milestones{/number}","notifications_url":"https://api.github.com/repos/michelleN/deployment-manager/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/michelleN/deployment-manager/labels{/name}","releases_url":"https://api.github.com/repos/michelleN/deployment-manager/releases{/id}","deployments_url":"https://api.github.com/repos/michelleN/deployment-manager/deployments","created_at":"2016-01-25T17:39:42Z","updated_at":"2016-01-25T17:39:43Z","pushed_at":"2016-02-10T03:48:56Z","git_url":"git://github.com/michelleN/deployment-manager.git","ssh_url":"git@github.com:michelleN/deployment-manager.git","clone_url":"https://github.com/michelleN/deployment-manager.git","svn_url":"https://github.com/michelleN/deployment-manager","homepage":null,"size":604,"stargazers_count":0,"watchers_count":0,"language":"Go","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":"kubernetes:master","ref":"master","sha":"476e71f5d349fce3ff703057dea511f7c568865c","user":{"login":"kubernetes","id":13629408,"avatar_url":"https://avatars.githubusercontent.com/u/13629408?v=3","gravatar_id":"","url":"https://api.github.com/users/kubernetes","html_url":"https://github.com/kubernetes","followers_url":"https://api.github.com/users/kubernetes/followers","following_url":"https://api.github.com/users/kubernetes/following{/other_user}","gists_url":"https://api.github.com/users/kubernetes/gists{/gist_id}","starred_url":"https://api.github.com/users/kubernetes/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kubernetes/subscriptions","organizations_url":"https://api.github.com/users/kubernetes/orgs","repos_url":"https://api.github.com/users/kubernetes/repos","events_url":"https://api.github.com/users/kubernetes/events{/privacy}","received_events_url":"https://api.github.com/users/kubernetes/received_events","type":"Organization","site_admin":false},"repo":{"id":43723161,"name":"deployment-manager","full_name":"kubernetes/deployment-manager","owner":{"login":"kubernetes","id":13629408,"avatar_url":"https://avatars.githubusercontent.com/u/13629408?v=3","gravatar_id":"","url":"https://api.github.com/users/kubernetes","html_url":"https://github.com/kubernetes","followers_url":"https://api.github.com/users/kubernetes/followers","following_url":"https://api.github.com/users/kubernetes/following{/other_user}","gists_url":"https://api.github.com/users/kubernetes/gists{/gist_id}","starred_url":"https://api.github.com/users/kubernetes/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kubernetes/subscriptions","organizations_url":"https://api.github.com/users/kubernetes/orgs","repos_url":"https://api.github.com/users/kubernetes/repos","events_url":"https://api.github.com/users/kubernetes/events{/privacy}","received_events_url":"https://api.github.com/users/kubernetes/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/kubernetes/deployment-manager","description":"Deployment Manager on Kubernetes","fork":false,"url":"https://api.github.com/repos/kubernetes/deployment-manager","forks_url":"https://api.github.com/repos/kubernetes/deployment-manager/forks","keys_url":"https://api.github.com/repos/kubernetes/deployment-manager/keys{/key_id}","collaborators_url":"https://api.github.com/repos/kubernetes/deployment-manager/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/kubernetes/deployment-manager/teams","hooks_url":"https://api.github.com/repos/kubernetes/deployment-manager/hooks","issue_events_url":"https://api.github.com/repos/kubernetes/deployment-manager/issues/events{/number}","events_url":"https://api.github.com/repos/kubernetes/deployment-manager/events","assignees_url":"https://api.github.com/repos/kubernetes/deployment-manager/assignees{/user}","branches_url":"https://api.github.com/repos/kubernetes/deployment-manager/branches{/branch}","tags_url":"https://api.github.com/repos/kubernetes/deployment-manager/tags","blobs_url":"https://api.github.com/repos/kubernetes/deployment-manager/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/kubernetes/deployment-manager/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/kubernetes/deployment-manager/git/refs{/sha}","trees_url":"https://api.github.com/repos/kubernetes/deployment-manager/git/trees{/sha}","statuses_url":"https://api.github.com/repos/kubernetes/deployment-manager/statuses/{sha}","languages_url":"https://api.github.com/repos/kubernetes/deployment-manager/languages","stargazers_url":"https://api.github.com/repos/kubernetes/deployment-manager/stargazers","contributors_url":"https://api.github.com/repos/kubernetes/deployment-manager/contributors","subscribers_url":"https://api.github.com/repos/kubernetes/deployment-manager/subscribers","subscription_url":"https://api.github.com/repos/kubernetes/deployment-manager/subscription","commits_url":"https://api.github.com/repos/kubernetes/deployment-manager/commits{/sha}","git_commits_url":"https://api.github.com/repos/kubernetes/deployment-manager/git/commits{/sha}","comments_url":"https://api.github.com/repos/kubernetes/deployment-manager/comments{/number}","issue_comment_url":"https://api.github.com/repos/kubernetes/deployment-manager/issues/comments{/number}","contents_url":"https://api.github.com/repos/kubernetes/deployment-manager/contents/{+path}","compare_url":"https://api.github.com/repos/kubernetes/deployment-manager/compare/{base}...{head}","merges_url":"https://api.github.com/repos/kubernetes/deployment-manager/merges","archive_url":"https://api.github.com/repos/kubernetes/deployment-manager/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/kubernetes/deployment-manager/downloads","issues_url":"https://api.github.com/repos/kubernetes/deployment-manager/issues{/number}","pulls_url":"https://api.github.com/repos/kubernetes/deployment-manager/pulls{/number}","milestones_url":"https://api.github.com/repos/kubernetes/deployment-manager/milestones{/number}","notifications_url":"https://api.github.com/repos/kubernetes/deployment-manager/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/kubernetes/deployment-manager/labels{/name}","releases_url":"https://api.github.com/repos/kubernetes/deployment-manager/releases{/id}","deployments_url":"https://api.github.com/repos/kubernetes/deployment-manager/deployments","created_at":"2015-10-06T01:07:32Z","updated_at":"2016-02-03T18:11:00Z","pushed_at":"2016-02-11T22:45:32Z","git_url":"git://github.com/kubernetes/deployment-manager.git","ssh_url":"git@github.com:kubernetes/deployment-manager.git","clone_url":"https://github.com/kubernetes/deployment-manager.git","svn_url":"https://github.com/kubernetes/deployment-manager","homepage":null,"size":5896,"stargazers_count":78,"watchers_count":78,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":26,"mirror_url":null,"open_issues_count":65,"forks":26,"open_issues":65,"watchers":78,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/kubernetes/deployment-manager/pulls/250"},"html":{"href":"https://github.com/kubernetes/deployment-manager/pull/250"},"issue":{"href":"https://api.github.com/repos/kubernetes/deployment-manager/issues/250"},"comments":{"href":"https://api.github.com/repos/kubernetes/deployment-manager/issues/250/comments"},"review_comments":{"href":"https://api.github.com/repos/kubernetes/deployment-manager/pulls/250/comments"},"review_comment":{"href":"https://api.github.com/repos/kubernetes/deployment-manager/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/kubernetes/deployment-manager/pulls/250/commits"},"statuses":{"href":"https://api.github.com/repos/kubernetes/deployment-manager/statuses/cf43dcf44ad8bb98fc1914150503a9c4cb1f5855"}}}}