Guida rapida: eseguire query sull'API

Prerequisiti

  1. Completa tutti i passaggi richiesti nella guida rapida prima di iniziare.
  2. Distribuisci l'API .

Panoramica

Puoi eseguire query sull'API utilizzando gli stessi metodi, indipendentemente dal metodo di installazione utilizzato. La modalità di query dell'API dipende dalla configurazione o meno di un endpoint pubblico. Se l'endpoint non è pubblico, dovrai determinare autonomamente come esporre l'API. Esistono molte opzioni per farlo, ad esempio creare un elemento Ingress se il cluster lo supporta, pubblicare il servizio creato, eseguire Istio e così via.

I passaggi descritti di seguito illustrano come eseguire query su un endpoint. Esistono due metodi:

  1. Esegui una query sull'endpoint dall'interno del cluster (non è richiesto un IP pubblico).
  2. Esegui una query su un IP pubblico.

Esegui una query sul nome DNS interno (non è richiesto un IP pubblico)

Questo esempio esegue una query dall'interno del cluster utilizzando il nome DNS (Domain Name Service) assegnato al servizio: $NAME.$NAMESPACE, ad esempio speech.speech. Puoi impostare le variabili di ambiente o sostituirle con un valore effettivo nei comandi.

  1. Crea un nuovo job all'interno del cluster da cui eseguire query sull'API. Se questo job esiste già nel cluster, devi prima rimuoverlo.

    kubectl delete jobs.batch -n $NAMESPACE query-api

echo "apiVersion: batch/v1
kind: Job
metadata:
  name: query-api
  namespace: $NAMESPACE
spec:
  template:
    metadata:
      annotations:
        sidecar.istio.io/inject: 'false'
      labels:
        app: query
    spec:
      containers:
      - name: entrypoint
        image: gcr.io/cloud-marketplace/speech-onprem/speech-to-text-on-prem:$VERSION
        command: ["/bin/sh", "-c"]
        args:
        - curl https://raw.githubusercontent.com/GoogleCloudPlatform/python-docs-samples/master/speech/snippets/resources/commercial_mono.wav --output /tmp/audio.wav;
          /bin/onprem_client --address=$NAME.$NAMESPACE:443 --file_paths /tmp/audio.wav
      restartPolicy: Never
" | kubectl apply -f -

  2. Controlla i log per vedere la trascrizione:

    kubectl logs -n $NAMESPACE --follow $(kubectl get po -n $NAMESPACE -l
app=query -o=jsonpath='{.items[0].metadata.name}') -c entrypoint

Esegui una query su un IP pubblico

Se hai installato Istio nel tuo cluster, assicurati che il gateway Istio Ingress sia in esecuzione con un IP pubblico. Se non hai installato Istio, puoi impostare il valore per $PUBLIC_IP. Dopodiché puoi inviare query di trascrizione a un endpoint pubblico.

  1. Se hai installato Istio, segui le instructions per ottenere l'IP pubblico Ingress e impostalo su PUBLIC_IP.

  2. Se non hai installato Istio, verifica che l'indirizzo IP sia stato associato. Dovrebbe essere visualizzato in EXTERNAL-IP di seguito. Se non viene visualizzato dopo alcuni minuti, vai al cluster nella console per la risoluzione dei problemi.

    kubectl get service $NAME --namespace $NAMESPACE

    1. Copia il programma binario onprem_client dall'immagine Docker:

      kubectl cp -n $NAMESPACE $(kubectl get pod -n $NAMESPACE -l
app.kubernetes.io/name=$NAME -o=jsonpath='{.items[0].metadata.name}'
):/bin/onprem_client ./onprem_client

kubectl cp -n $NAMESPACE $(kubectl get pod -n $NAMESPACE -l
app.kubernetes.io/name=$NAME -o=jsonpath='{.items[0].metadata.name}'
):/usr/grte.tar ./grte.tar

sudo tar -xvf grte.tar -C /

chmod a+x ./onprem_client

    2. Utilizza il programma binario onprem_client per inviare una query:

      ./onprem_client --address ${PUBLIC_IP}:443
--file_paths /path/to/audio.wav

Passaggi successivi

Scopri come inviare una richiesta di trascrizione all'API Speech-to-Text on-prem.