Supporto dei contenitori in Servizi cognitivi di AzureContainer support in Azure Cognitive Services

Il supporto dei contenitori nei servizi cognitivi di Azure consente agli sviluppatori di usare le stesse API avanzate disponibili in Azure e offre la flessibilità necessaria per distribuire e ospitare i servizi inclusi nei contenitori Docker.Container support in Azure Cognitive Services allows developers to use the same rich APIs that are available in Azure, and enables flexibility in where to deploy and host the services that come with Docker containers. Il supporto dei contenitori è attualmente disponibile per un sottoinsieme di servizi cognitivi di Azure, incluse le parti di:Container support is currently available for a subset of Azure Cognitive Services, including parts of:

La containerizzazione è un approccio alla distribuzione del software in cui un'applicazione o un servizio, incluse le relative dipendenze e configurazione, viene compresso come immagine del contenitore.Containerization is an approach to software distribution in which an application or service, including its dependencies & configuration, is packaged together as a container image. L'immagine del contenitore può essere distribuita in un host contenitore senza alcuna variazione o con modifiche minime.With little or no modification, a container image can be deployed on a container host. I contenitori sono isolati fra loro e dal sistema operativo sottostante, con un footprint inferiore a quello di una macchina virtuale.Containers are isolated from each other and the underlying operating system, with a smaller footprint than a virtual machine. È possibile creare istanze dei contenitori dalle immagini per attività a breve termine. Tali istanze possono essere rimosse quando non sono più necessarie.Containers can be instantiated from container images for short-term tasks, and removed when no longer needed.

Le risorse di servizi cognitivi sono disponibili in Microsoft Azure.Cognitive Services resources are available on Microsoft Azure. Accedere al portale di Azure per creare ed esplorare le risorse di Azure per questi servizi.Sign into the Azure portal to create and explore Azure resources for these services.

Funzionalità e vantaggiFeatures and benefits

  • Infrastruttura non modificabile: abilitare i team DevOps per sfruttare un set coerente e affidabile di parametri di sistema noti, pur essendo in grado di adattarsi alle modifiche.Immutable infrastructure: Enable DevOps teams' to leverage a consistent and reliable set of known system parameters, while being able to adapt to change. I contenitori offrono la flessibilità necessaria per passare all'interno di un ecosistema prevedibile ed evitare deviazioni della configurazione.Containers provide the flexibility to pivot within a predictable ecosystem and avoid configuration drift.
  • Controllo dei dati: consente ai clienti di scegliere il punto in cui questi servizi cognitivi elaborano i dati.Control over data: Allow customers to choose where these Cognitive Services process their data. Questo aspetto è fondamentale per i clienti che non possono inviare dati al cloud, ma che richiedono l'accesso alla tecnologia offerta da Servizi cognitivi.This is essential for customers that cannot send data to the cloud but need access to Cognitive Services technology. È supportata la coerenza in ambienti ibridi, tra i dati e le funzionalità di gestione, identità e sicurezza.Support consistency in hybrid environments – across data, management, identity, and security.
  • Controllo sugli aggiornamenti dei modelli: ai clienti viene offerta la flessibilità necessaria per il controllo delle versioni e l'aggiornamento dei modelli distribuiti nelle soluzioni.Control over model updates: Provide customers flexibility in versioning and updating of models deployed in their solutions.
  • Architetturaportabile: consente la creazione di un'architettura di applicazione portabile che può essere distribuita in Azure, in locale e nei dispositivi perimetrali.Portable architecture: Enable the creation of a portable application architecture that can be deployed on Azure, on-premises and the edge. I contenitori possono essere distribuiti direttamente nel servizio Azure Kubernetes, in Istanze di Azure Container o in un cluster Kubernetes distribuito in Azure Stack.Containers can be deployed directly to Azure Kubernetes Service, Azure Container Instances, or to a Kubernetes cluster deployed to Azure Stack. Per altre informazioni, vedere Deploy Kubernetes to Azure Stack (Distribuire Kubernetes in Azure Stack).For more information, see Deploy Kubernetes to Azure Stack.
  • Velocità effettiva elevata/bassa latenza: offrire ai clienti la possibilità di scalare i requisiti di velocità effettiva elevata e bassa latenza, abilitando i servizi cognitivi a funzionare fisicamente vicino alla logica e ai dati dell'applicazione.High throughput / low latency: Provide customers the ability to scale for high throughput and low latency requirements by enabling Cognitive Services to run physically close to their application logic and data. I contenitori non raggiungono il limite di transazioni al secondo e possono offrire scalabilità sia orizzontale che verticale per gestire la domanda, se si forniscono le risorse hardware necessarie.Containers do not cap transactions per second (TPS) and can be made to scale both up and out to handle demand if you provide the necessary hardware resources.
  • Scalabilità: con la popolarità sempre crescente di contenitori e software di orchestrazione dei contenitori, ad esempio Kubernetes; la scalabilità è all'avanguardia dei progressi tecnologici.Scalability: With the ever growing popularity of containerization and container orchestration software, such as Kubernetes; scalability is at the forefront of technological advancements. Basandosi su una base cluster scalabile, lo sviluppo di applicazioni soddisfa la disponibilità elevata.Building on a scalable cluster foundation, application development caters to high availability.

Contenitori in Servizi cognitivi di AzureContainers in Azure Cognitive Services

I contenitori di Servizi cognitivi di Azure offrono il set seguente di contenitori Docker, ognuno dei quali contiene un subset di funzionalità dei servizi disponibili in Servizi cognitivi di Azure:Azure Cognitive Services containers provide the following set of Docker containers, each of which contains a subset of functionality from services in Azure Cognitive Services:

ServizioService Piano tariffario supportatoSupported Pricing Tier ContenitoreContainer DescriptionDescription
Rilevamento anomalieAnomaly detector F0, S0F0, S0 Rilevamento anomalieAnomaly-Detector L'API Rilevamento anomalie permette di monitorare e rilevare le anomalie nei dati di serie temporali con l'apprendimento automatico.The Anomaly Detector API enables you to monitor and detect abnormalities in your time series data with machine learning.
Richiedere l'accessoRequest access
Visione artificialeComputer Vision F0, S1F0, S1 LetturaRead Estre testo stampato dalle immagini di diversi oggetti con superfici e sfondi diversi, ad esempio ricette, poster e biglietti da visita.Extracts printed text from images of various objects with different surfaces and backgrounds, such as receipts, posters, and business cards. Il contenitore di lettura rileva anche il testo scritto a mano nelle immagini e fornisce il supporto per PDF/TIFF/più pagine.The Read container also detects handwritten text in images and provides PDF/TIFF/multi-page support.

Importante: Il contenitore di lettura attualmente funziona solo con l'inglese.Important: The Read container currently works only with English.
VisoFace F0, S0F0, S0 VisoFace Rileva i visi umani nelle immagini e identifica gli attributi, ad esempio i punti di riferimento del viso (come naso e occhi), il sesso, l'età e altre caratteristiche facciali con previsioni basate su computer.Detects human faces in images, and identifies attributes, including face landmarks (such as noses and eyes), gender, age, and other machine-predicted facial features. Oltre al rilevamento, Viso può verificare se due volti nella stessa immagine o in immagini diverse sono uguali mediante un punteggio di attendibilità oppure può confrontare i visi con un database per verificare se esistono già visi simili o identici.In addition to detection, Face can check if two faces in the same image or different images are the same by using a confidence score, or compare faces against a database to see if a similar-looking or identical face already exists. È anche possibile organizzare i visi simili in gruppi mediante caratteristiche condivise.It can also organize similar faces into groups, using shared visual traits.
Richiedere l'accessoRequest access
Riconoscimento moduliForm recognizer F0, S0F0, S0 Riconoscimento moduloForm Recognizer La comprensione dei moduli applica la tecnologia di machine learning per identificare ed estrarre le coppie chiave-valore e le tabelle dai moduli.Form Understanding applies machine learning technology to identify and extract key-value pairs and tables from forms.
Richiedere l'accessoRequest access
LUISLUIS F0, S0F0, S0 LUIS (immagine)LUIS (image) Carica un modello Language Understanding sottoposto a training o pubblicato, noto anche come app LUIS, in un contenitore Docker e fornisce l'accesso alle stime di query dagli endpoint dell'API del contenitore.Loads a trained or published Language Understanding model, also known as a LUIS app, into a docker container and provides access to the query predictions from the container's API endpoints. È possibile raccogliere i log di query dal contenitore e caricarli nel portale LUIS per migliorare l'accuratezza delle stime dell'app.You can collect query logs from the container and upload these back to the LUIS portal to improve the app's prediction accuracy.
API servizio VoceSpeech Service API F0, S0F0, S0 Riconoscimento vocaleSpeech-to-text Esegue la trascrizione del parlato continuo in tempo reale in testo.Transcribes continuous real-time speech into text.
API servizio VoceSpeech Service API F0, S0F0, S0 Da Riconoscimento vocale personalizzato a testoCustom Speech-to-text Trascrive il discorso continuo in tempo reale nel testo usando un modello personalizzato.Transcribes continuous real-time speech into text using a custom model.
API servizio VoceSpeech Service API F0, S0F0, S0 Sintesi vocaleText-to-speech Converte il testo scritto in un audio che suona naturale.Converts text to natural-sounding speech.
API servizio VoceSpeech Service API F0, S0F0, S0 Sintesi vocale personalizzataCustom Text-to-speech Converte il testo in un riconoscimento vocale naturale usando un modello personalizzato.Converts text to natural-sounding speech using a custom model.
Analisi del testoText Analytics F0, SF0, S Estrazione frasi chiave (immagine)Key Phrase Extraction (image) Estrae le frasi chiave per identificare i punti principali.Extracts key phrases to identify the main points. Ad esempio, per il testo di input "Il cibo era delizioso e il personale era meraviglioso", l'API restituisce i punti rilevanti del discorso, ovvero "cibo" e "personale meraviglioso".For example, for the input text "The food was delicious and there were wonderful staff", the API returns the main talking points: "food" and "wonderful staff".
Analisi del testoText Analytics F0, SF0, S Rilevamento lingua (immagine)Language Detection (image) Per un massimo di 120 lingue, rileva la lingua in cui è scritto il testo di input e crea un report relativo a un codice lingua singolo per ogni documento inviato nella richiesta.For up to 120 languages, detects which language the input text is written in and report a single language code for every document submitted on the request. Il codice lingua è associato a un punteggio che indica il livello di attendibilità.The language code is paired with a score indicating the strength of the score.
Analisi del testoText Analytics F0, SF0, S Analisi del sentiment V3 (immagine)Sentiment Analysis v3 (image) Analizza testo non elaborato per indicazioni su una valutazione positiva o negativa.Analyzes raw text for clues about positive or negative sentiment. Questa versione dell'analisi dei sentimenti restituisce le etichette del sentimento, ad esempio positivo o negativo, per ogni documento e frase al suo interno.This version of sentiment analysis returns sentiment labels (for example positive or negative) for each document and sentence within it.
Analisi del testoText Analytics F0, SF0, S Analisi del testo per l'integritàText Analytics for health Estrarre ed etichettare le informazioni mediche da testo clinico non strutturato.Extract and label medical information from unstructured clinical text.

Inoltre, alcuni contenitori sono supportati in Servizi cognitivi All-in-One che offrono chiavi di risorsa.In addition, some containers are supported in Cognitive Services All-In-One offering resource keys. È possibile creare una sola risorsa all-in-One di servizi cognitivi e usare la stessa chiave di fatturazione tra i servizi supportati per i servizi seguenti:You can create one single Cognitive Services All-In-One resource and use the same billing key across supported services for the following services:

  • Visione artificialeComputer Vision
  • VisoFace
  • LUISLUIS
  • Analisi del testoText Analytics

Disponibilità dei contenitori in Servizi cognitivi di AzureContainer availability in Azure Cognitive Services

I contenitori di Servizi cognitivi di Azure sono disponibili pubblicamente attraverso la sottoscrizione di Azure e le immagini dei contenitori Docker possono essere estratte da Registro contenitori di Microsoft o dall'hub Docker.Azure Cognitive Services containers are publicly available through your Azure subscription, and Docker container images can be pulled from either the Microsoft Container Registry or Docker Hub. È possibile usare il comando docker pull per scaricare un'immagine del contenitore dal registro appropriato.You can use the docker pull command to download a container image from the appropriate registry.

Repository e immagini del contenitoreContainer repositories and images

Le tabelle seguenti sono un elenco delle immagini di contenitori disponibili offerte da servizi cognitivi di Azure.The tables below are a listing of the available container images offered by Azure Cognitive Services. Per un elenco completo di tutti i nomi delle immagini del contenitore disponibili e dei relativi tag disponibili, vedere tag dell'immagine del contenitore di servizi cognitivi.For a complete list of all the available container image names and their available tags, see Cognitive Services container image tags.

Disponibile a livello generaleGenerally available

Microsoft Container Registry (il Consorzio Microsoft) pubblica tutti i contenitori disponibili a livello generale per servizi cognitivi.The Microsoft Container Registry (MCR) syndicates all of the generally available containers for Cognitive Services. I contenitori sono anche disponibili direttamente dall' Hub Docker.The containers are also available directly from the Docker hub.

Contenitore LUISLUIS Container Container Registry/repository/nome dell'immagineContainer Registry / Repository / Image Name
LUISLUIS mcr.microsoft.com/azure-cognitive-services/luis

Per ulteriori informazioni , vedere come eseguire e installare i contenitori Luis .See How to run and install LUIS containers for more information.

Anteprima pubblica "ungated" (registro contenitori: mcr.microsoft.com )Public "Ungated" preview (container registry: mcr.microsoft.com)

I contenitori di anteprima seguenti sono disponibili pubblicamente.The following preview containers are available publicly. Microsoft Container Registry (il Consorzio) ha tutti i contenitori non gated disponibili pubblicamente per servizi cognitivi.The Microsoft Container Registry (MCR) syndicates all of the publicly available ungated containers for Cognitive Services. I contenitori sono anche disponibili direttamente dall' Hub Docker.The containers are also available directly from the Docker hub.

ServizioService ContenitoreContainer Container Registry/repository/nome dell'immagineContainer Registry / Repository / Image Name
Analisi del testoText Analytics Estrazione frasi chiaveKey Phrase Extraction mcr.microsoft.com/azure-cognitive-services/keyphrase
Analisi del testoText Analytics Rilevamento linguaLanguage Detection mcr.microsoft.com/azure-cognitive-services/language
Rilevamento anomalieAnomaly detector Rilevamento anomalieAnomaly Detector mcr.microsoft.com/azure-cognitive-services/anomaly-detector

Anteprima pubblica "gestita" (registro contenitori: containerpreview.azurecr.io )Public "Gated" preview (container registry: containerpreview.azurecr.io)

I seguenti contenitori di anteprima gestita sono ospitati nel registro di anteprima del contenitore e richiedono l'accesso a un'applicazione.The following gated preview containers are hosted on the Container Preview registry, and require an application to access. Per ulteriori informazioni, vedere gli articoli sui contenitori seguenti.See the following container articles for more information.

ServizioService ContenitoreContainer Container Registry/repository/nome dell'immagineContainer Registry / Repository / Image Name
Visione artificialeComputer Vision LetturaRead containerpreview.azurecr.io/microsoft/cognitive-services-read
VisoFace VisoFace containerpreview.azurecr.io/microsoft/cognitive-services-face
Riconoscimento moduliForm recognizer Riconoscimento moduloForm Recognizer containerpreview.azurecr.io/microsoft/cognitive-services-form-recognizer
API servizio VoceSpeech Service API Riconoscimento vocaleSpeech-to-text containerpreview.azurecr.io/microsoft/cognitive-services-speech-to-text
API servizio VoceSpeech Service API Da Riconoscimento vocale personalizzato a testoCustom Speech-to-text containerpreview.azurecr.io/microsoft/cognitive-services-custom-speech-to-text
API servizio VoceSpeech Service API Sintesi vocaleText-to-speech containerpreview.azurecr.io/microsoft/cognitive-services-text-to-speech
API servizio VoceSpeech Service API Sintesi vocale personalizzataCustom Text-to-speech containerpreview.azurecr.io/microsoft/cognitive-services-custom-text-to-speech
Analisi del testo per l'integritàText Analytics for health Analisi del testo per l'integritàText Analytics for health containerpreview.azurecr.io/microsoft/cognitive-services-healthcare

PrerequisitiPrerequisites

Per usare i contenitori di Servizi cognitivi di Azure, è necessario soddisfare i prerequisiti seguenti:You must satisfy the following prerequisites before using Azure Cognitive Services containers:

Motore Docker: il motore Docker deve essere installato localmente.Docker Engine: You must have Docker Engine installed locally. Docker offre pacchetti per la configurazione dell'ambiente in macOS, Linux e Windows.Docker provides packages that configure the Docker environment on macOS, Linux, and Windows. In Windows Docker deve essere configurato per supportare i contenitori Linux.On Windows, Docker must be configured to support Linux containers. I contenitori Docker possono anche essere distribuiti direttamente nel servizio Azure Kubernetes o in Istanze di Azure Container.Docker containers can also be deployed directly to Azure Kubernetes Service or Azure Container Instances.

Docker deve essere configurato per consentire ai contenitori di connettersi ai dati di fatturazione e inviarli ad Azure.Docker must be configured to allow the containers to connect with and send billing data to Azure.

Familiarità con Registro contenitori di Microsoft e Docker: è opportuno avere una conoscenza di base dei concetti relativi a Registro contenitori di Microsoft e Docker, tra cui registri, repository, contenitori e immagini dei contenitori, nonché dei comandi docker di base.Familiarity with Microsoft Container Registry and Docker: You should have a basic understanding of both Microsoft Container Registry and Docker concepts, like registries, repositories, containers, and container images, as well as knowledge of basic docker commands.

Per una panoramica dei concetti fondamentali relativi a Docker e ai contenitori, vedere Docker overview (Panoramica di Docker).For a primer on Docker and container basics, see the Docker overview.

Singoli contenitori possono prevedere anche requisiti specifici, tra cui quelli relativi a server e allocazione di memoria.Individual containers can have their own requirements, as well, including server and memory allocation requirements.

Sicurezza del contenitore dei servizi cognitivi di AzureAzure Cognitive Services container security

La protezione deve essere un obiettivo principale quando si sviluppano applicazioni.Security should be a primary focus whenever you're developing applications. L'importanza della sicurezza è una metrica per il successo.The importance of security is a metric for success. Quando si progetta una soluzione software che include contenitori di servizi cognitivi, è fondamentale comprendere le limitazioni e le funzionalità disponibili.When you're architecting a software solution that includes Cognitive Services containers, it's vital to understand the limitations and capabilities available to you. Per altre informazioni sulla sicurezza di rete, vedere configurare le reti virtuali dei servizi cognitivi di Azure.For more information about network security, see Configure Azure Cognitive Services virtual networks.

Importante

Per impostazione predefinita, non esiste alcuna sicurezza sull'API del contenitore di servizi cognitivi.By default there is no security on the Cognitive Services container API. Il motivo è che la maggior parte delle volte il contenitore verrà eseguito come parte di un pod protetto dall'esterno da un Bridge di rete.The reason for this is that most often the container will run as part of a pod which is protected from the outside by a network bridge. Tuttavia, è possibile abilitare l'autenticazione che funziona in modo identico all'autenticazione usata quando si accede ai Servizi cognitivi basati sul cloud.However, it is possible to enable authentication which works identically to the authentication used when accessing the cloud-based Cognitive Services.

Il diagramma seguente illustra l'approccio predefinito e non sicuro :The diagram below illustrates the default and non-secure approach:

Sicurezza del contenitore

Come approccio alternativo e sicuro , i consumer di contenitori di servizi cognitivi possono aumentare un contenitore con un componente front-end, mantenendo privato l'endpoint contenitore.As an alternative and secure approach, consumers of Cognitive Services containers could augment a container with a front-facing component, keeping the container endpoint private. Si prenda in considerazione uno scenario in cui si usa Istio come gateway di ingresso.Let's consider a scenario where we use Istio as an ingress gateway. Istio supporta HTTPS/TLS e l'autenticazione del certificato client.Istio supports HTTPS/TLS and client-certificate authentication. In questo scenario, il front-end Istio espone l'accesso al contenitore, presentando il certificato client inserito nell'elenco elementi consentiti in anticipo con Istio.In this scenario, the Istio frontend exposes the container access, presenting the client certificate that is whitelisted beforehand with Istio.

Nginx è un'altra scelta comune nella stessa categoria.Nginx is another popular choice in the same category. Sia Istio che Nginx fungono da mesh del servizio e offrono funzionalità aggiuntive, tra cui bilanciamento del carico, routing e controllo delle tariffe.Both Istio and Nginx act as a service mesh and offer additional features including things like load-balancing, routing, and rate-control.

Rete del contenitoreContainer networking

I contenitori di servizi cognitivi sono necessari per inviare le informazioni di misurazione per scopi di fatturazione.The Cognitive Services containers are required to submit metering information for billing purposes. L'unica eccezione è che i contenitori non in linea seguono una metodologia di fatturazione diversa.The only exception, is Offline containers as they follow a different billing methodology. Se non è possibile consentire l'elenco di diversi canali di rete su cui si basano i contenitori di servizi cognitivi, il contenitore non funzionerà.Failure to allow list various network channels that the Cognitive Services containers rely on will prevent the container from working.

Consenti elenco di domini e porte di servizi cognitiviAllow list Cognitive Services domains and ports

L'host deve consentire la porta elenco 443 e i domini seguenti:The host should allow list port 443 and the following domains:

  • *.cognitive.microsoft.com
  • *.cognitiveservices.azure.com

Disabilitare l'ispezione approfondita dei pacchettiDisable deep packet inspection

L' ispezione approfondita dei pacchetti (dpi) è un tipo di elaborazione dei dati che esamina in dettaglio i dati inviati su una rete di computer e in genere esegue operazioni bloccando, reindirizzando o registrando di conseguenza.Deep packet inspection (DPI) is a type of data processing that inspects in detail the data being sent over a computer network, and usually takes action by blocking, re-routing, or logging it accordingly.

Disabilitare DPI nei canali protetti creati dai contenitori di servizi cognitivi nei server Microsoft.Disable DPI on the secure channels that the Cognitive Services containers create to Microsoft servers. In caso contrario, il contenitore non funzionerà correttamente.Failure to do so will prevent the container from functioning correctly.

Post di BLOGBlog posts

Esempi per gli sviluppatoriDeveloper samples

Gli esempi per gli sviluppatori sono disponibili nel repository GitHub.Developer samples are available at our GitHub repository.

Visualizza il webinarView webinar

Partecipare al webinar per saperne di più sugli argomenti seguenti:Join the webinar to learn about:

  • Come distribuire Servizi cognitivi in qualsiasi computer con DockerHow to deploy Cognitive Services to any machine using Docker
  • Come distribuire Servizi cognitivi nel servizio Azure ContainerHow to deploy Cognitive Services to AKS

Passaggi successiviNext steps

Informazioni sulle ricette del contenitore che è possibile usare con i servizi cognitivi.Learn about container recipes you can use with the Cognitive Services.

Installare ed esplorare le funzionalità fornite dai contenitori in Servizi cognitivi di Azure:Install and explore the functionality provided by containers in Azure Cognitive Services: