Merge pull request #477 from vaikas-google/master

Add an example for pushing charts with gsutil

docs/pushing_charts.md

@@ -0,0 +1,64 @@
+# Pushing Charts
+
+This details the current requirements and steps for pushing a chart to
+Google Cloud Storage (GCS) using gsutil tool.
+
+## Prerequisites
+
+In order to create and push a Chart, you must:
+* have a bucket in GCS with write permissions
+* have [gsutil](https://cloud.google.com/storage/docs/gsutil) tool configured and installed
+
+## Creating a chart (optional)
+
+If you already have a [chart](./design/chart_format.md) in the file system format, you can
+skip this step.
+./bin/helm chart create mychart
+
+This will create the following directory structure:
+vaikas@vaikas-glaptop:~/projects/dmos/src/github.com/kubernetes/helm$ find mychart
+mychart
+mychart/Chart.yaml
+mychart/hooks
+mychart/templates
+mychart/docs
+
+You can then create your own chart (examples/charts has examples to get you started)
+
+## Serializing the chart
+
+Helm tool can package a chart for you in the correct format and with name that
+matches the version in the Chart.yaml file.
+
+```
+./bin/helm chart package <yourchart>
+```
+
+Using one of the examples [nginx](examples/charts/nginx/Chart.yaml)
+
+```
+./bin/helm chart package examples/charts/nginx
+```
+
+The resulting file will be nginx-0.0.1.tgz
+
+## Pushing the chart
+
+Using gsutil you can copy this file to your bucket with the following command:
+```
+gsutil cp <yourchart> gs://<yourbucket>/
+```
+or if you want to make this chart publicly readable:
+```
+gsutil cp -a public-read <yourchart> gs://<yourbucket>/
+```
+
+To handle more granular permissions, use the 'gsutil help acls' command.
+
+Using the example above, you could make this publicy readable by doing:
+```
+gsutil cp -a public-read nginx-0.0.1.tgz gs://<yourbucket>/
+```
+
+
+