Quickstart: Deploy the API

Prerequisites

  1. Complete all required steps in the before you begin quickstart.

Deploy the API using the marketplace app UI

  1. Navigate to the on-prem solution and enter your chosen configuration values:

  2. You can either use an existing namespace, or create a new one:

Deploy the marketplace app using the command line

  1. You can either set the configuration payload with customized parameter values or use a set of default values for easy copy-pasting. If you would like to use customized parameter values choose Option A, below. Otherwise, use the default values in Option B.

    1. Option A: Configuration payload with customized values:

      PARAMETERS='{
        "name": "'$NAME'",
        "namespace": "'$NAMESPACE'",
        "asr.publicIP": "'$PUBLIC_IP'",
        "asr.cpu": '$CPU',
        "asr.memory": "'$MEMORY'",
        "reportingSecret": "reporting-secret",
        "asr.image": "gcr.io/cloud-marketplace/speech-onprem/speech-to-text-on-prem:'$VERSION'",
        "configure.image": "gcr.io/cloud-marketplace/speech-onprem/speech-to-text-on-prem/configure:'$VERSION'",
        "asr.metric_project_id": "'$METRIC_PROJECT'",
        "asr.gsa_secret": "'$GSA_SECRET'",
        "istio.enabled": "'$ENABLE_ISTIO'",
        "configure.model1": "'$MODEL1'",
        "configure.model2": "'$MODEL2'",
        "configure.model3": "'$MODEL3'"
      }'
      
    2. Option B: Default configuration payload:

      PARAMETERS='{
        "name": "speech",
        "namespace": "speech",
        "reportingSecret": "reporting-secret",
        "asr.image": "gcr.io/cloud-marketplace/speech-onprem/speech-to-text-on-prem:'$VERSION'",
        "configure.image": "gcr.io/cloud-marketplace/speech-onprem/speech-to-text-on-prem/configure:'$VERSION'",
        "asr.metric_project_id": "$METRIC_PROJECT",
      }'
      
  2. Select a version :

    VERSION=1.0
    
  3. For On-Prem clusters, run the below command($KUBECONFIG is the path of the yaml file of the user cluster):

    export KUBE_CONFIG=${KUBECONFIG}
    
  4. Run the deploy command:

    mpdev /scripts/install --deployer=gcr.io/cloud-marketplace/speech-onprem/speech-to-text-on-prem/deployer:$VERSION
    --parameters="$PARAMETERS"
    
  5. Check to see if the deployment is ready (this can take several minutes the first time it's run). The number of READY pods should match your chosen $REPLICA value.

    kubectl get deployment $NAME --namespace $NAMESPACE
    

    For example:

What's next

Learn how to send a query to the Speech-to-Text On-Prem API.