Update documentations for Kubeflow Pipelines marketplace (#2125)

* fix

* update documentations

* update documentations

* update documentations

* small fixes

manifests/gcp_marketplace/chart/kubeflow-pipelines/templates/application.yaml

@@ -6,18 +6,18 @@ metadata:
   annotations:
     kubernetes-engine.cloud.google.com/icon: >-
       data:image/png;base64,{{ .Files.Get "logo.png" | b64enc }}
-    marketplace.cloud.google.com/deploy-info: '{"partner_id": "click-to-deploy-containers", "product_id": "kubeflow-pipelines", "partner_name": "Google Click to Deploy"}'
+    marketplace.cloud.google.com/deploy-info: '{"partner_id": "google-cloud-ai-platform", "product_id": "kubeflow-pipelines", "partner_name": "Google Cloud AI Platform"}'
   labels:
     app.kubernetes.io/name: "{{ .Release.Name }}"
 spec:
   descriptor:
     type: Kubeflow Pipelines
     version: '0.2'
     description: |-
-      Machine Learning Pipeline on Kubernetes
+      Reusable end-to-end ML workflow
     maintainers:
-      - name: Google Click to Deploy
-        url: https://cloud.google.com/solutions/#click-to-deploy
+      - name: Google Cloud AI Platform
+        url: https://cloud.google.com/ai-platform/
       - name: Kubeflow Pipelines
         url: https://github.com/kubeflow/pipelines
     links:

manifests/gcp_marketplace/schema.yaml

@@ -101,33 +101,59 @@ properties:
     x-google-marketplace:
       type: NAMESPACE
   serviceAccountCredential:
-    title: Service Account credentials used to call other GCP services.
+    title: |-
+     GCP Service Account credentials used to call other GCP services.
     description: |-
-      To be able to call other GCP services, we need to be
-      authenticated. This field is used to store the content of the service account
+      To be able to call other GCP services from the pipeline, we need to be authenticated.
+      This field is used to store the content of the service account
       JSON file. It can be encoded using base64 instead of messing with JSON format.
+      To get the encoded credential, run
+      $ gcloud iam service-accounts keys create application_default_credentials.json --iam-account [your-service-account] && cat application_default_credentials.json | base64
     type: string
     default: ""
     x-google-marketplace:
       type: STRING
   managedstorage.enabled:
     type: boolean
     title: Use managed storage
-    description: Use Cloud SQL and GCS for storing the data
+    description: |-
+      Use Cloud SQL and GCS for storing the data.
+      Using CloudSQL and GCS provides better reliability and performance,
+      as well as features such as data backup and usage monitoring.
+      This is the recommended option especially for production scenarios.
+      If false, the data will be stored in GCE Persistent Disk.
     default: false
   managedstorage.cloudsqlInstanceConnectionName:
     type: string
-    title: CloudSQL instance connection name. Format projectId:zone:instanceName
+    title: CloudSQL instance connection name. Required if use managed storage.
+    description: |-
+      Provide a pre-created CloudSQL for MySQL instance.
+      The instance connection name can be found in the instance detail page.
+      For example myproject:us-central1:myinstance.
+      For more details on how to create a new instance, visit https://cloud.google.com/sql/docs/mysql/quickstart
   managedstorage.dbUsername:
     type: string
-    title: database username
+    title: Database username. (Managed storage only)
+    description: |-
+      The database username to connect to the CloudSQL instance.
+      If leaveing this field empty, the deployment will use the default 'root' user account.
+      For more details about mysql username, visit https://cloud.google.com/sql/docs/mysql/users
   managedstorage.dbPassword:
     type: string
-    title: database password
+    title: Database password. (Managed storage only)
+    description: |-
+      The database password to connect to the CloudSQL instance.
+      If leaveing this field empty, the deployment will use no password.
   managedstorage.databaseNamePrefix:
     type: string
-    title: database name prefix
-
+    title: Database name prefix. (Managed storage only)
+    description: |-
+      The prefix of the database name. Kubeflow Pipelines will create two databases,
+      [prefix]_pipeline and [prefix]_metadata.
+      Use lowercase letters, numbers, and hyphens. Start with a letter.
+      If the prefix specified is same as an old deployment in the past,
+      the deployment will recover from an old deployment.
+      If this not specified, the app instance name will be used.
 required:
   - name
   - namespace