Uso de contenedores del servicio de voz con Kubernetes y HelmUse Speech service containers with Kubernetes and Helm

Una opción para administrar los contenedores de Speech locales es usar Kubernetes y Helm.One option to manage your Speech containers on-premises is to use Kubernetes and Helm. Mediante el empleo de Kubernetes y Helm para definir las imágenes de contenedor de conversión de voz en texto y de texto en voz, se va a crear un paquete de Kubernetes.Using Kubernetes and Helm to define the speech-to-text and text-to-speech container images, we'll create a Kubernetes package. Este paquete se va a implementar en un clúster de Kubernetes en el entorno local.This package will be deployed to a Kubernetes cluster on-premises. Por último, se va a explicar cómo probar los servicios implementados y diversas opciones de configuración.Finally, we'll explore how to test the deployed services and various configuration options. Para más información sobre cómo ejecutar contenedores de Docker sin orquestación de Kubernetes, consulte Instalación y ejecución de contenedores de servicio de voz.For more information about running Docker containers without Kubernetes orchestration, see install and run Speech service containers.

Requisitos previosPrerequisites

Requisitos previos para poder usar los contenedores de Voz en el entorno local:The following prerequisites before using Speech containers on-premises:

ObligatorioRequired PropósitoPurpose
Cuenta de AzureAzure Account Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.If you don't have an Azure subscription, create a free account before you begin.
Acceso a Container RegistryContainer Registry access Para incorporar las imágenes de Docker al clúster, Kubernetes necesita acceso al registro de contenedor.In order for Kubernetes to pull the docker images into the cluster, it will need access to the container registry.
CLI de KubernetesKubernetes CLI La CLI de Kubernetes es necesaria para administrar las credenciales compartidas desde el registro de contenedor.The Kubernetes CLI is required for managing the shared credentials from the container registry. Kubernetes también se necesita antes que Helm, que es el administrador de paquetes de Kubernetes.Kubernetes is also needed before Helm, which is the Kubernetes package manager.
CLI de HelmHelm CLI Instale la CLI de Helm, que se usa para instalar un gráfico de Helm (definición de paquete de contenedor).Install the Helm CLI, which is used to to install a helm chart (container package definition).
Recurso de VozSpeech resource Para usar estos contenedores, debe tener:In order to use these containers, you must have:

Un recurso de Voz de Azure para obtener la clave de facturación asociada y el URI del punto de conexión de facturación.A Speech Azure resource to get the associated billing key and billing endpoint URI. Ambos valores están disponibles en las páginas de claves y de introducción de Voz de Azure Portal y son necesarios para iniciar el contenedor.Both values are available on the Azure portal's Speech Overview and Keys pages and are required to start the container.

{API_KEY} : clave de recurso{API_KEY} : resource key

{ENDPOINT_URI} : el ejemplo de URI de punto de conexión es: https://westus.api.cognitive.microsoft.com/sts/v1.0{ENDPOINT_URI} : endpoint URI example is: https://westus.api.cognitive.microsoft.com/sts/v1.0

Vea los detalles del equipo host del contenedor del servicio de voz como referencia.Refer to the Speech service container host computer details as a reference. En este gráfico de Helm se calculan automáticamente los requisitos de CPU y memoria en función de cuántas descodificaciones (solicitudes simultáneas) especifica el usuario.This helm chart automatically calculates CPU and memory requirements based on how many decodes (concurrent requests) that the user specifies. Además, se ajusta en función de si las optimizaciones de entrada de audio o texto están configuradas como enabled.Additionally, it will adjust based on whether optimizations for audio/text input are configured as enabled. Los valores predeterminados del gráfico de Helm son dos solicitudes simultáneas y la deshabilitación de la optimización.The helm chart defaults to, two concurrent requests and disabling optimization.

ServicioService CPU o contenedorCPU / Container Memoria o contenedorMemory / Container
Voz a textoSpeech-to-Text un descodificador requiere un mínimo de 1150 milésimas de núcleo.one decoder requires a minimum of 1,150 millicores. Si optimizedForAudioFile está habilitado, se requieren 1950 milésimas de núcleo.If the optimizedForAudioFile is enabled, then 1,950 millicores are required. (valor predeterminado: dos descodificadores)(default: two decoders) Requerido: 2 GBRequired: 2 GB
Limitado: 4 GBLimited: 4 GB
Texto a vozText-to-Speech una solicitud simultánea requiere un mínimo de 500 milésimas de núcleo.one concurrent request requires a minimum of 500 millicores. Si optimizeForTurboMode está habilitado, se requieren 1000 milésimas de núcleo.If the optimizeForTurboMode is enabled, then 1,000 millicores are required. (valor predeterminado: dos solicitudes simultáneas)(default: two concurrent requests) Requerido: 1 GBRequired: 1 GB
Limitado: 2 GBLimited: 2 GB

Conectar al clúster de KubernetesConnect to the Kubernetes cluster

Se espera que el equipo host tenga un clúster de Kubernetes disponible.The host computer is expected to have an available Kubernetes cluster. Vea este tutorial sobre la implementación de un clúster de Kubernetes para lograr un reconocimiento conceptual de cómo implementar un clúster de Kubernetes en un equipo host.See this tutorial on deploying a Kubernetes cluster for a conceptual understanding of how to deploy a Kubernetes cluster to a host computer.

Configuración de los valores del gráfico de Helm para la implementaciónConfigure Helm chart values for deployment

Visite Microsoft Helm Hub para ver todos los gráficos de Helm disponibles públicamente que ofrece Microsoft.Visit the Microsoft Helm Hub for all the publicly available helm charts offered by Microsoft. En Microsoft Helm Hub se encuentra el gráfico Cognitive Services Speech On-Premises.From the Microsoft Helm Hub, you'll find the Cognitive Services Speech On-Premises Chart. Cognitive Services Speech On-Premises es el gráfico que se va a instalar, aunque primero se debe crear un archivo config-values.yaml con configuraciones explícitas.The Cognitive Services Speech On-Premises is the chart we'll install, but we must first create an config-values.yaml file with explicit configurations. Vamos a comenzar por agregar el repositorio de Microsoft a la instancia de Helm.Let's start by adding the Microsoft repository to our Helm instance.

helm repo add microsoft https://microsoft.github.io/charts/repo

Luego vamos a configurar los valores del gráfico de Helm.Next, we'll configure our Helm chart values. Copie y pegue el siguiente YAML en un archivo denominado config-values.yaml.Copy and paste the following YAML into a file named config-values.yaml. Para obtener más información sobre la personalización del gráfico de Helm Cognitive Services Speech On-Premises , vea Personalizar gráficos de Helm.For more information on customizing the Cognitive Services Speech On-Premises Helm Chart , see customize helm charts. Reemplace los comentarios # {ENDPOINT_URI} y # {API_KEY} por sus propios valores.Replace the # {ENDPOINT_URI} and # {API_KEY} comments with your own values.

# These settings are deployment specific and users can provide customizations
# speech-to-text configurations
speechToText:
  enabled: true
  numberOfConcurrentRequest: 3
  optimizeForAudioFile: true
  image:
    registry: mcr.microsoft.com
    repository: azure-cognitive-services/speechservices/speech-to-text
    tag: latest
    pullSecrets:
      - mcr # Or an existing secret
    args:
      eula: accept
      billing: # {ENDPOINT_URI}
      apikey: # {API_KEY}

# text-to-speech configurations
textToSpeech:
  enabled: true
  numberOfConcurrentRequest: 3
  optimizeForTurboMode: true
  image:
    registry: mcr.microsoft.com
    repository: azure-cognitive-services/speechservices/speech-to-text
    tag: latest
    pullSecrets:
      - mcr # Or an existing secret
    args:
      eula: accept
      billing: # {ENDPOINT_URI}
      apikey: # {API_KEY}

Importante

Si no se proporcionan los valores billing y apikey, los servicios expiran pasados 15 minutos.If the billing and apikey values are not provided, the services will expire after 15 min. Del mismo modo, se produce un error de comprobación, ya que los servicios no están disponibles.Likewise, verification will fail as the services will not be available.

Paquete de Kubernetes (gráfico de Helm)The Kubernetes package (Helm chart)

El gráfico de Helm contiene la configuración de las imágenes de Docker que se van a extraer del registro de contenedor mcr.microsoft.com.The Helm chart contains the configuration of which docker image(s) to pull from the mcr.microsoft.com container registry.

Un gráfico de Helm es una colección de archivos que describen un conjunto relacionado de recursos de Kubernetes.A Helm chart is a collection of files that describe a related set of Kubernetes resources. Un solo gráfico se podría usar para implementar algo sencillo, como un pod almacenado en memoria, o complejo, como una pila de aplicación web completa con servidores HTTP, bases de datos, memorias caché, etc.A single chart might be used to deploy something simple, like a memcached pod, or something complex, like a full web app stack with HTTP servers, databases, caches, and so on.

Los gráficos de Helm proporcionados extraen las imágenes de Docker del servicio de voz, los servicios de conversión de texto en voz y de voz en texto desde el registro de contenedor mcr.microsoft.com.The provided Helm charts pull the docker images of the Speech service, both text-to-speech and the speech-to-text services from the mcr.microsoft.com container registry.

Instalación del gráfico de Helm en el clúster de KubernetesInstall the Helm chart on the Kubernetes cluster

Para instalar el gráfico de Helm , se debe ejecutar el comando helm install, reemplazando <config-values.yaml> por el argumento de ruta de acceso y nombre de archivo adecuado.To install the helm chart we'll need to execute the helm install command, replacing the <config-values.yaml> with the appropriate path and file name argument. El gráfico de Helm microsoft/cognitive-services-speech-onpremise al que se hace referencia a continuación está disponible en Microsoft Helm Hub aquí.The microsoft/cognitive-services-speech-onpremise Helm chart referenced below is available on the Microsoft Helm Hub here.

helm install onprem-speech microsoft/cognitive-services-speech-onpremise \
    --version 0.1.1 \
    --values <config-values.yaml> 

Este es el resultado de ejemplo que se puede ver tras una ejecución de instalación correcta:Here is an example output you might expect to see from a successful install execution:

NAME:   onprem-speech
LAST DEPLOYED: Tue Jul  2 12:51:42 2019
NAMESPACE: default
STATUS: DEPLOYED

RESOURCES:
==> v1/Pod(related)
NAME                             READY  STATUS             RESTARTS  AGE
speech-to-text-7664f5f465-87w2d  0/1    Pending            0         0s
speech-to-text-7664f5f465-klbr8  0/1    ContainerCreating  0         0s
text-to-speech-56f8fb685b-4jtzh  0/1    ContainerCreating  0         0s
text-to-speech-56f8fb685b-frwxf  0/1    Pending            0         0s

==> v1/Service
NAME            TYPE          CLUSTER-IP    EXTERNAL-IP  PORT(S)       AGE
speech-to-text  LoadBalancer  10.0.252.106  <pending>    80:31811/TCP  1s
text-to-speech  LoadBalancer  10.0.125.187  <pending>    80:31247/TCP  0s

==> v1beta1/PodDisruptionBudget
NAME                                MIN AVAILABLE  MAX UNAVAILABLE  ALLOWED DISRUPTIONS  AGE
speech-to-text-poddisruptionbudget  N/A            20%              0                    1s
text-to-speech-poddisruptionbudget  N/A            20%              0                    1s

==> v1beta2/Deployment
NAME            READY  UP-TO-DATE  AVAILABLE  AGE
speech-to-text  0/2    2           0          0s
text-to-speech  0/2    2           0          0s

==> v2beta2/HorizontalPodAutoscaler
NAME                       REFERENCE                  TARGETS        MINPODS  MAXPODS  REPLICAS  AGE
speech-to-text-autoscaler  Deployment/speech-to-text  <unknown>/50%  2        10       0         0s
text-to-speech-autoscaler  Deployment/text-to-speech  <unknown>/50%  2        10       0         0s


NOTES:
cognitive-services-speech-onpremise has been installed!
Release is named onprem-speech

La implementación de Kubernetes puede tardar varios minutos en completarse.The Kubernetes deployment can take over several minutes to complete. Para confirmar que los pods y los servicios se han implementado correctamente y están disponibles, ejecute el siguiente comando:To confirm that both pods and services are properly deployed and available, execute the following command:

kubectl get all

Debería ver algo parecido al resultado siguiente:You should expect to see something similar to the following output:

NAME                                  READY     STATUS    RESTARTS   AGE
pod/speech-to-text-7664f5f465-87w2d   1/1       Running   0          34m
pod/speech-to-text-7664f5f465-klbr8   1/1       Running   0          34m
pod/text-to-speech-56f8fb685b-4jtzh   1/1       Running   0          34m
pod/text-to-speech-56f8fb685b-frwxf   1/1       Running   0          34m

NAME                     TYPE           CLUSTER-IP     EXTERNAL-IP      PORT(S)        AGE
service/kubernetes       ClusterIP      10.0.0.1       <none>           443/TCP        3h
service/speech-to-text   LoadBalancer   10.0.252.106   52.162.123.151   80:31811/TCP   34m
service/text-to-speech   LoadBalancer   10.0.125.187   65.52.233.162    80:31247/TCP   34m

NAME                             DESIRED   CURRENT   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/speech-to-text   2         2         2            2           34m
deployment.apps/text-to-speech   2         2         2            2           34m

NAME                                        DESIRED   CURRENT   READY     AGE
replicaset.apps/speech-to-text-7664f5f465   2         2         2         34m
replicaset.apps/text-to-speech-56f8fb685b   2         2         2         34m

NAME                                                            REFERENCE                   TARGETS   MINPODS   MAXPODS   REPLICAS   AGE
horizontalpodautoscaler.autoscaling/speech-to-text-autoscaler   Deployment/speech-to-text   1%/50%    2         10        2          34m
horizontalpodautoscaler.autoscaling/text-to-speech-autoscaler   Deployment/text-to-speech   0%/50%    2         10        2          34m

Comprobación de la implementación de Helm con pruebas de HelmVerify Helm deployment with Helm tests

Los gráficos de Helm instalados definen pruebas de Helm , que resultan cómodas para la comprobación.The installed Helm charts define Helm tests , which serve as a convenience for verification. Estas pruebas validan la disponibilidad del servicio.These tests validate service readiness. Para comprobar los servicios de conversión de voz en texto y de texto en voz , se ejecuta el comando Helm test.To verify both speech-to-text and text-to-speech services, we'll execute the Helm test command.

helm test onprem-speech

Importante

Se produce un error en estas pruebas si el estado de POD no es Running o si la implementación no aparece en la columna AVAILABLE.These tests will fail if the POD status is not Running or if the deployment is not listed under the AVAILABLE column. Tenga paciencia, ya que esto puede tardar más de diez minutos en completarse.Be patient as this can take over ten minutes to complete.

Estas pruebas generan distintos resultados de estado:These tests will output various status results:

RUNNING: speech-to-text-readiness-test
PASSED: speech-to-text-readiness-test
RUNNING: text-to-speech-readiness-test
PASSED: text-to-speech-readiness-test

Como alternativa a la ejecución de pruebas de Helm , puede recopilar las direcciones IP externas y los puertos correspondientes desde el comando kubectl get all.As an alternative to executing the helm tests , you could collect the External IP addresses and corresponding ports from the kubectl get all command. Con la dirección IP y el puerto, abra un explorador web y vaya a http://<external-ip>:<port>:/swagger/index.html para ver las páginas de Swagger de API.Using the IP and port, open a web browser and navigate to http://<external-ip>:<port>:/swagger/index.html to view the API swagger page(s).

Personalizar gráficos de HelmCustomize Helm charts

Los gráficos de Helm son jerárquicos.Helm charts are hierarchical. La jerarquía permite la herencia de gráficos y, además, proporciona el concepto de especificidad, que consiste en que los valores más específicos invalidan las reglas heredadas.Being hierarchical allows for chart inheritance, it also caters to the concept of specificity, where settings that are more specific override inherited rules.

Speech (gráfico de nivel superior)Speech (umbrella chart)

Los valores del gráfico de nivel superior reemplazan a los valores de los gráficos secundarios correspondientes.Values in the top-level "umbrella" chart override the corresponding sub-chart values. Por lo tanto, todos los valores locales personalizados se deben agregar aquí.Therefore, all on-premises customized values should be added here.

ParámetroParameter DescripciónDescription Valor predeterminadoDefault
speechToText.enabled Si el servicio speech-to-text está habilitado.Whether the speech-to-text service is enabled. true
speechToText.verification.enabled Si la funcionalidad helm test del servicio speech-to-text está habilitada.Whether the helm test capability for speech-to-text service is enabled. true
speechToText.verification.image.registry El repositorio de imágenes de Docker que helm test usa para probar el servicio speech-to-text.The docker image repository that helm test uses to test speech-to-text service. Helm crea un pod independiente dentro del clúster para realizar pruebas y extrae la imagen test-use de este Registro.Helm creates separate pod inside the cluster for testing and pulls the test-use image from this registry. docker.io
speechToText.verification.image.repository El repositorio de imágenes de Docker que helm test usa para probar el servicio speech-to-text.The docker image repository that helm test uses to test speech-to-text service. El pod de prueba de Helm usa este repositorio para extraer la imagen test-use.Helm test pod uses this repository to pull test-use image. antsu/on-prem-client
speechToText.verification.image.tag La etiqueta de la imagen de Docker usada con helm test para el servicio speech-to-text.The docker image tag used with helm test for speech-to-text service. El pod de prueba de Helm usa esta etiqueta para extraer la imagen test-use.Helm test pod uses this tag to pull test-use image. latest
speechToText.verification.image.pullByHash Si la imagen de Docker test-use se extrae mediante hash.Whether the test-use docker image is pulled by hash. Si true, debería agregarse speechToText.verification.image.hash con un valor de Hash de imagen válido.If true, speechToText.verification.image.hash should be added, with valid image hash value. false
speechToText.verification.image.arguments Los argumentos usados para ejecutar la imagen de Docker test-use.The arguments used to execute the test-use docker image. El pod de prueba de Helm pasa estos argumentos al contenedor cuando se ejecuta helm test.Helm test pod passes these arguments to the container when running helm test. "./speech-to-text-client"
"./audio/whatstheweatherlike.wav"
"--expect=What's the weather like"
"--host=$(SPEECH_TO_TEXT_HOST)"
"--port=$(SPEECH_TO_TEXT_PORT)"
textToSpeech.enabled Si el servicio text-to-speech está habilitado.Whether the text-to-speech service is enabled. true
textToSpeech.verification.enabled Si la funcionalidad helm test del servicio speech-to-text está habilitada.Whether the helm test capability for speech-to-text service is enabled. true
textToSpeech.verification.image.registry El repositorio de imágenes de Docker que helm test usa para probar el servicio speech-to-text.The docker image repository that helm test uses to test speech-to-text service. Helm crea un pod independiente dentro del clúster para realizar pruebas y extrae la imagen test-use de este Registro.Helm creates separate pod inside the cluster for testing and pulls the test-use image from this registry. docker.io
textToSpeech.verification.image.repository El repositorio de imágenes de Docker que helm test usa para probar el servicio speech-to-text.The docker image repository that helm test uses to test speech-to-text service. El pod de prueba de Helm usa este repositorio para extraer la imagen test-use.Helm test pod uses this repository to pull test-use image. antsu/on-prem-client
textToSpeech.verification.image.tag La etiqueta de la imagen de Docker usada con helm test para el servicio speech-to-text.The docker image tag used with helm test for speech-to-text service. El pod de prueba de Helm usa esta etiqueta para extraer la imagen test-use.Helm test pod uses this tag to pull test-use image. latest
textToSpeech.verification.image.pullByHash Si la imagen de Docker test-use se extrae mediante hash.Whether the test-use docker image is pulled by hash. Si true, debería agregarse textToSpeech.verification.image.hash con un valor de Hash de imagen válido.If true, textToSpeech.verification.image.hash should be added, with valid image hash value. false
textToSpeech.verification.image.arguments Los argumentos que se ejecutarán con la imagen de Docker test-use.The arguments to execute with the test-use docker image. El pod de prueba de Helm pasa estos argumentos al contenedor cuando se ejecuta helm test.The helm test pod passes these arguments to container when running helm test. "./text-to-speech-client"
"--input='What's the weather like'"
"--host=$(TEXT_TO_SPEECH_HOST)"
"--port=$(TEXT_TO_SPEECH_PORT)"

Speech-to-Text (gráfico secundario: charts/speechToText)Speech-to-Text (sub-chart: charts/speechToText)

Para reemplazar al gráfico de nivel superior, agregue el prefijo speechToText. a todos los parámetros para que sean más específicos.To override the "umbrella" chart, add the prefix speechToText. on any parameter to make it more specific. Se reemplazará el parámetro correspondiente, por ejemplo speechToText.numberOfConcurrentRequest reemplaza a numberOfConcurrentRequest.For example, it will override the corresponding parameter for example, speechToText.numberOfConcurrentRequest overrides numberOfConcurrentRequest.

ParámetroParameter DescripciónDescription Valor predeterminadoDefault
enabled Si el servicio speech-to-text está habilitado.Whether the speech-to-text service is enabled. false
numberOfConcurrentRequest Número de solicitudes simultáneas del servicio speech-to-text.The number of concurrent requests for the speech-to-text service. Este gráfico calcula automáticamente los recursos de CPU y memoria en función de este valor.This chart automatically calculates CPU and memory resources, based on this value. 2
optimizeForAudioFile Si el servicio necesita optimizar la entrada de audio a través de archivos de audio.Whether the service needs to optimize for audio input via audio files. Si true, este gráfico asignará más recursos de CPU al servicio.If true, this chart will allocate more CPU resource to service. false
image.registry Registro de la imagen de Docker de speech-to-text.The speech-to-text docker image registry. containerpreview.azurecr.io
image.repository Repositorio de la imagen de Docker de speech-to-text.The speech-to-text docker image repository. microsoft/cognitive-services-speech-to-text
image.tag Etiqueta de la imagen de Docker de speech-to-text.The speech-to-text docker image tag. latest
image.pullSecrets Secretos de la imagen para extraer la imagen de Docker de speech-to-text.The image secrets for pulling the speech-to-text docker image.
image.pullByHash Si la imagen de Docker se extrae mediante hash.Whether the docker image is pulled by hash. Si true, image.hash es obligatorio.If true, image.hash is required. false
image.hash Hash de la imagen de Docker de speech-to-text.The speech-to-text docker image hash. Solo se usa con image.pullByHash: true.Only used when image.pullByHash: true.
image.args.eula (obligatorio)image.args.eula (required) Indica que ha aceptado la licencia.Indicates you've accepted the license. El único valor válido es accept.The only valid value is accept
image.args.billing (obligatorio)image.args.billing (required) El valor de URI del punto de conexión de facturación está disponible en Azure Portal, en la página de Información general de Información general del servicio de voz.The billing endpoint URI value is available on the Azure portal's Speech Overview page.
image.args.apikey (obligatorio)image.args.apikey (required) Se usa para realizar un seguimiento de la información de facturación.Used to track billing information.
service.type Tipo de servicio de Kubernetes del servicio speech-to-text.The Kubernetes service type of the speech-to-text service. Consulte las instrucciones de los tipos de servicio de Kubernetes para obtener más información y comprobar la compatibilidad con los proveedores de nube.See the Kubernetes service types instructions for more details and verify cloud provider support. LoadBalancer
service.port Puerto del servicio speech-to-text.The port of the speech-to-text service. 80
service.annotations Anotaciones de conversión de voz a texto para los metadatos del servicio.The speech-to-text annotations for the service metadata. Las anotaciones son pares de clave-valor.Annotations are key value pairs.
annotations:
  some/annotation1: value1
  some/annotation2: value2
service.autoScaler.enabled Si Horizontal Pod Autoscaler está habilitado.Whether the Horizontal Pod Autoscaler is enabled. Si true, speech-to-text-autoscaler se implementará en el clúster de Kubernetes.If true, the speech-to-text-autoscaler will be deployed in the Kubernetes cluster. true
service.podDisruption.enabled Si Pod Disruption Budget está habilitado.Whether the Pod Disruption Budget is enabled. Si true, speech-to-text-poddisruptionbudget se implementará en el clúster de Kubernetes.If true, the speech-to-text-poddisruptionbudget will be deployed in the Kubernetes cluster. true

Análisis de sentimiento (sub-chart: charts/speechToText)Sentiment analysis (sub-chart: charts/speechToText)

A partir de la versión 2.2.0 del contenedor de conversión de voz a texto y la versión 0.2.0 del gráfico de Helm, se usan los siguientes parámetros para el análisis de sentimiento mediante Text Analytics API.Starting with v2.2.0 of the speech-to-text container and v0.2.0 of the Helm chart, the following parameters are used for sentiment analysis using the Text Analytics API.

ParámetroParameter DescripciónDescription ValoresValues Valor predeterminadoDefault
textanalytics.enabled Si está habilitado el servicio text-analytics.Whether the text-analytics service is enabled true/falsetrue/false false
textanalytics.image.registry El registro de la imagen de Docker text-analytics.The text-analytics docker image registry registro de imagen de Docker válidovalid docker image registry
textanalytics.image.repository El repositorio de la imagen de Docker text-analytics.The text-analytics docker image repository repositorio de imágenes de Docker válidovalid docker image repository
textanalytics.image.tag La etiqueta de la imagen de Docker text-analytics.The text-analytics docker image tag etiqueta de imagen de Docker válidavalid docker image tag
textanalytics.image.pullSecrets Los secretos de imagen para extraer la imagen de Docker text-analytics.The image secrets for pulling text-analytics docker image nombre de secreto válidovalid secrets name
textanalytics.image.pullByHash Especifica si se va a extraer la imagen de Docker por hash.Specifies if you are pulling docker image by hash. Si yes, image.hash también se requiere.If yes, image.hash is required to have as well. Si no, establézcalo como "false".If no, set it as 'false'. El valor predeterminado es false.Default is false. true/falsetrue/false false
textanalytics.image.hash El hash de la imagen de Docker text-analytics.The text-analytics docker image hash. Úselo solo con image.pullByHash:true.Only use it with image.pullByHash:true. hash de imagen de Docker válidovalid docker image hash
textanalytics.image.args.eula Uno de los argumentos necesarios en el contenedor text-analytics , que indica que ha aceptado la licencia.One of the required arguments by text-analytics container, which indicates you've accepted the license. El valor de esta opción debe establecerse en accept.The value of this option must be: accept. accept, si desea utilizar el contenedor.accept, if you want to use the container
textanalytics.image.args.billing Uno de los argumentos necesarios en el contenedor text-analytics , que especifica el identificador URI del punto de conexión de facturación.One of the required arguments by text-analytics container, which specifies the billing endpoint URI. El valor de URI del punto de conexión de facturación está disponible en Azure Portal, en la página de Información general de Información general del servicio de voz.The billing endpoint URI value is available on the Azure portal's Speech Overview page. identificador URI del punto de conexión de facturaciónvalid billing endpoint URI
textanalytics.image.args.apikey Uno de los argumentos necesarios en el contenedor text-analytics , que se usa para realizar un seguimiento de la información de facturación.One of the required arguments by text-analytics container, which is used to track billing information. apiKey válidovalid apikey
textanalytics.cpuRequest La CPU solicitada para el contenedor text-analytics.The requested CPU for text-analytics container intint 3000m
textanalytics.cpuLimit La CPU limitada del contenedor text-analytics.The limited CPU for text-analytics container 8000m
textanalytics.memoryRequest La memoria solicitada del contenedor text-analytics.The requested memory for text-analytics container 3Gi
textanalytics.memoryLimit La memoria limitada del contenedor text-analytics.The limited memory for text-analytics container 8Gi
textanalytics.service.sentimentURISuffix El sufijo URI de análisis de sentimiento, el identificador URI completo tiene el formato "http://<service>:<port>/<sentimentURISuffix>".The sentiment analysis URI suffix, the whole URI is in format "http://<service>:<port>/<sentimentURISuffix>". text/analytics/v3.0-preview/sentiment
textanalytics.service.type El tipo de servicio text-analytics de Kubernetes.The type of text-analytics service in Kubernetes. Consulte los tipos de servicio de Kubernetes.See Kubernetes service types tipo de servicio Kubernetes válidovalid Kubernetes service type LoadBalancer
textanalytics.service.port El puerto del servicio text-analytics.The port of the text-analytics service intint 50085
textanalytics.service.annotations Las anotaciones que los usuarios pueden agregar a los metadatos del servicio text-analytics.The annotations users can add to text-analytics service metadata. Por ejemplo:For instance:
anotaciones:annotations:
some/annotation1: value1 some/annotation1: value1
some/annotation2: value2 some/annotation2: value2
anotaciones, una por cada líneaannotations, one per each line
textanalytics.serivce.autoScaler.enabled Si Horizontal Pod Autoscaler está habilitado.Whether Horizontal Pod Autoscaler is enabled. Si está habilitado, text-analytics-autoscaler se implementará en el clúster de Kubernetes.If enabled, text-analytics-autoscaler will be deployed in the Kubernetes cluster true/falsetrue/false true
textanalytics.service.podDisruption.enabled Si Pod Disruption Budget está habilitado.Whether Pod Disruption Budget is enabled. Si está habilitado, text-analytics-poddisruptionbudget se implementará en el clúster de Kubernetes.If enabled, text-analytics-poddisruptionbudget will be deployed in the Kubernetes cluster true/falsetrue/false true

Text-to-Speech (gráfico secundario: charts/textToSpeech)Text-to-Speech (sub-chart: charts/textToSpeech)

Para reemplazar al gráfico de nivel superior, agregue el prefijo textToSpeech. a todos los parámetros para que sean más específicos.To override the "umbrella" chart, add the prefix textToSpeech. on any parameter to make it more specific. Se reemplazará el parámetro correspondiente, por ejemplo textToSpeech.numberOfConcurrentRequest reemplaza a numberOfConcurrentRequest.For example, it will override the corresponding parameter for example, textToSpeech.numberOfConcurrentRequest overrides numberOfConcurrentRequest.

ParámetroParameter DescripciónDescription Valor predeterminadoDefault
enabled Si el servicio text-to-speech está habilitado.Whether the text-to-speech service is enabled. false
numberOfConcurrentRequest Número de solicitudes simultáneas del servicio text-to-speech.The number of concurrent requests for the text-to-speech service. Este gráfico calcula automáticamente los recursos de CPU y memoria en función de este valor.This chart automatically calculates CPU and memory resources, based on this value. 2
optimizeForTurboMode Si el servicio necesita optimizar la entrada de texto a través de archivos de texto.Whether the service needs to optimize for text input via text files. Si true, este gráfico asignará más recursos de CPU al servicio.If true, this chart will allocate more CPU resource to service. false
image.registry Registro de la imagen de Docker de text-to-speech.The text-to-speech docker image registry. containerpreview.azurecr.io
image.repository Repositorio de la imagen de Docker de text-to-speech.The text-to-speech docker image repository. microsoft/cognitive-services-text-to-speech
image.tag Etiqueta de la imagen de Docker de text-to-speech.The text-to-speech docker image tag. latest
image.pullSecrets Secretos de la imagen para extraer la imagen de Docker de text-to-speech.The image secrets for pulling the text-to-speech docker image.
image.pullByHash Si la imagen de Docker se extrae mediante hash.Whether the docker image is pulled by hash. Si true, image.hash es obligatorio.If true, image.hash is required. false
image.hash Hash de la imagen de Docker de text-to-speech.The text-to-speech docker image hash. Solo se usa con image.pullByHash: true.Only used when image.pullByHash: true.
image.args.eula (obligatorio)image.args.eula (required) Indica que ha aceptado la licencia.Indicates you've accepted the license. El único valor válido es accept.The only valid value is accept
image.args.billing (obligatorio)image.args.billing (required) El valor de URI del punto de conexión de facturación está disponible en Azure Portal, en la página de Información general de Información general del servicio de voz.The billing endpoint URI value is available on the Azure portal's Speech Overview page.
image.args.apikey (obligatorio)image.args.apikey (required) Se usa para realizar un seguimiento de la información de facturación.Used to track billing information.
service.type Tipo de servicio de Kubernetes del servicio text-to-speech.The Kubernetes service type of the text-to-speech service. Consulte las instrucciones de los tipos de servicio de Kubernetes para obtener más información y comprobar la compatibilidad con los proveedores de nube.See the Kubernetes service types instructions for more details and verify cloud provider support. LoadBalancer
service.port El puerto del servicio text-to-speech.The port of the text-to-speech service. 80
service.annotations Las anotaciones de text-to-speech para los metadatos del servicio.The text-to-speech annotations for the service metadata. Las anotaciones son pares de clave-valor.Annotations are key value pairs.
annotations:
  some/annotation1: value1
  some/annotation2: value2
service.autoScaler.enabled Si Horizontal Pod Autoscaler está habilitado.Whether the Horizontal Pod Autoscaler is enabled. Si true, text-to-speech-autoscaler se implementará en el clúster de Kubernetes.If true, the text-to-speech-autoscaler will be deployed in the Kubernetes cluster. true
service.podDisruption.enabled Si Pod Disruption Budget está habilitado.Whether the Pod Disruption Budget is enabled. Si true, text-to-speech-poddisruptionbudget se implementará en el clúster de Kubernetes.If true, the text-to-speech-poddisruptionbudget will be deployed in the Kubernetes cluster. true

Pasos siguientesNext steps

Para obtener más información sobre la instalación de aplicaciones con Helm en Azure Kubernetes Service (AKS), visite esta página.For more details on installing applications with Helm in Azure Kubernetes Service (AKS), visit here.