Put some documentation headers in the install/*.sh scripts (#30)

* Documented most of the scripts. Removed one that wasn't used.

* Removed run_local script.

* Updated README-DEV to remove the deleted script.

README-DEV.md

@@ -68,12 +68,8 @@ Note from above: you can only do this on Linux.
 1. First, build the docker image:
 
         export GCP_PROJECT=my-gcp-project
+        export TARGET_DOCKER_IMAGE=gcr.io/my-gcp-project/istio-mixer:some-tag
         $GOPATH/src/github.com/apigee/istio-mixer-adapter/install/build_mixer_docker.sh
 
-2. Next, push to GKE:
-
-        export GCP_PROJECT=my-gcp-project
-        $GOPATH/src/github.com/apigee/istio-mixer-adapter/install/push_docker_to_gke.sh
-
-3. Go to [Pantheon](https://pantheon.corp.google.com/kubernetes/workload), you
-   should see the mixer running there.
+2. Next, use that image in your GKE Istio setup. You can follow the directions
+   in the [README](README.md) to set up Istio.

install/build_mixer_docker.sh

@@ -1,5 +1,20 @@
 #!/bin/bash
 
+# This script will take the compiled mixer, construct a Docker image for it,
+# and upload it to GCR.
+#
+# Prereqs:
+# - run the local_install.sh script to build the mixer.
+# - docker is installed.
+# - gcloud is installed.
+# - GOPATH is set.
+#
+# Variables:
+# - GCLOUD_SERVICE_KEY - auth key for the service account (used in CI to build
+#   nightlies)
+# - GCP_PROJECT - which GCP_PROJECT to upload the image to.
+# - TARGET_DOCKER_IMAGE - the name of the docker image to build.
+
 echo "Checking environment settings..."
 
 if [[ $GCLOUD_SERVICE_KEY == "" ]]; then

install/install_docker.sh

@@ -1,5 +1,8 @@
 #!/bin/bash
 
+# This script will install Docker on the local machine. Not recommended for use
+# on development machines, it is mainly used for containers in CI.
+
 if [[ `command -v docker` != "" ]]; then
   echo "Docker already installed."
   exit 0

install/install_gcloud.sh

@@ -1,5 +1,8 @@
 #!/bin/bash
 
+# This script will install gcloud on the local machine. Not recommended for use
+# on development machines, it is mainly used for containers in CI.
+
 if [[ `command -v gcloud` != "" ]]; then
   echo "gcloud already installed."
   exit 0

install/local_install.sh

@@ -1,5 +1,18 @@
 #!/bin/bash
 
+# This script builds the Mixer with the Apigee adapter on the local machine.
+# It will clone Istio if necessary.
+#
+# Prereqs:
+# - GOPATH is set.
+# - Apigee mixer adapter is checked out to:
+#   $GOPATH/src/github.com/apigee/istio-mixer-adapter
+# - on Mac: dep is installed.
+#
+# Variables:
+# - INSTALL_PROTOC - installs protoc if set to 1. Used for CI.
+
+
 echo "Installing all the things"
 
 if [[ "${GOPATH}" == "" ]]; then