Installare ed eseguire Visione artificiale contenitoriInstall and run Computer Vision containers

I contenitori consentono di eseguire le API Visione artificiale nell'ambiente in uso.Containers enable you to run the Computer Vision APIs in your own environment. I contenitori sono ottimi per requisiti specifici di sicurezza e governance dei dati.Containers are great for specific security and data governance requirements. In questo articolo si apprenderà come scaricare, installare ed eseguire un contenitore Visione artificiale.In this article you'll learn how to download, install, and run a Computer Vision container.

Per Visione artificiale sono disponibili due contenitori docker: Riconoscimento del testo e Read.There are two Docker containers available for Computer Vision: Recognize Text and Read. Il contenitore riconoscimento del testo consente di rilevare ed estrarre il testo stampato da immagini di vari oggetti con diverse superfici e sfondi, ad esempio ricevute, poster e biglietti da visita.The Recognize Text container allows you to detect and extract printed text from images of various objects with different surfaces and backgrounds, such as receipts, posters, and business cards. Il contenitore Read , tuttavia; rileva inoltre il testo scritto a mano nelle immagini e fornisce il supporto per PDF/TIFF/più pagine.The Read container, however; also detects handwritten text in images and provides PDF/TIFF/multi-page support. Per ulteriori informazioni, vedere la documentazione relativa all' API di lettura .For more information, see the Read API documentation.

Importante

Il contenitore riconoscimento del testo verrà deprecato a favore del contenitore di lettura.The Recognize Text container is being deprecated in favor of the Read container. Il contenitore di lettura è un superset del predecessore del riconoscimento del testo contenitore e i consumer devono eseguire la migrazione a usando il contenitore di lettura.The Read container is a superset of its predecessor the Recognize Text container, and consumers should migrate to using the Read container. Entrambi i contenitori funzionano solo con la lingua inglese.Both containers work only with English.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

PrerequisitiPrerequisites

Prima di usare i contenitori, è necessario soddisfare i prerequisiti seguenti:You must meet the following prerequisites before using the containers:

RichiestoRequired ScopoPurpose
Motore DockerDocker Engine È necessario il motore Docker installato in un computer host.You need the Docker Engine installed on a host computer. Docker offre pacchetti per la configurazione dell'ambiente Docker in macOS, Windows e Linux.Docker provides packages that configure the Docker environment on macOS, Windows, and Linux. 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.

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.

In Windows Docker deve essere configurato anche per supportare i contenitori Linux.On Windows, Docker must also be configured to support Linux containers.

Familiarità con DockerFamiliarity with Docker È opportuno avere una conoscenza di base dei concetti relativi a Docker, tra cui registri, repository, contenitori e immagini dei contenitori, nonché dei comandi docker di base.You should have a basic understanding of Docker concepts, like registries, repositories, containers, and container images, as well as knowledge of basic docker commands.
Risorsa Visione artificialeComputer Vision resource Per usare il contenitore, è necessario disporre di:In order to use the container, you must have:

Una risorsa visione artificiale di Azure e la chiave API associata l'URI dell'endpoint.An Azure Computer Vision resource and the associated API key the endpoint URI. Entrambi i valori sono disponibili nelle pagine Panoramica e chiavi per la risorsa e sono necessari per avviare il contenitore.Both values are available on the Overview and Keys pages for the resource and are required to start the container.

{API_KEY} : Una delle due chiavi di risorsa disponibili nella pagina chiavi{API_KEY}: One of the two available resource keys on the Keys page

{ENDPOINT_URI} : Endpoint fornito nella pagina Panoramica{ENDPOINT_URI}: The endpoint as provided on the Overview page

Raccolta dei parametri obbligatoriGathering required parameters

Sono disponibili tre parametri primari per tutti i contenitori di servizi cognitivi richiesti.There are three primary parameters for all Cognitive Services' containers that are required. Il contratto di licenza con l'utente finale deve essere presente con un valore pari accepta.The end-user license agreement (EULA) must be present with a value of accept. Sono inoltre necessari un URL dell'endpoint e una chiave API.Additionally, both an Endpoint URL and API Key are needed.

Nota

L'unica eccezione a questi tre parametri obbligatori è quando i contenitori sono considerati contenitori "offline".The only exception to these three required parameters is when containers are considered "Offline" containers. I contenitori offline non segnalano l'utilizzo, non vengono misurati e seguono una metodologia di fatturazione diversa.Offline containers do not report usage, are not metered and follow a different billing methodology.

URI dell'endpoint{ENDPOINT_URI}Endpoint URI {ENDPOINT_URI}

Il valore dell'URI dell' endpoint è disponibile nella pagina Panoramica portale di Azure della risorsa del servizio cognitiva corrispondente.The Endpoint URI value is available on the Azure portal Overview page of the corresponding Cognitive Service resource. Passare alla pagina Panoramica , posizionare il puntatore del mouse sull'endpoint e Copy to clipboard verrà visualizzata un' icona.Navigate to the Overview page, hover over the Endpoint, and a Copy to clipboard icon will appear. Copiare e usare se necessario.Copy and use where needed.

Raccogliere l'URI dell'endpoint per un uso successivo

Chiavi{API_KEY}Keys {API_KEY}

Questa chiave viene usata per avviare il contenitore ed è disponibile nella pagina chiavi del portale di Azure della risorsa del servizio cognitiva corrispondente.This key is used to start the container, and is available on the Azure portal's Keys page of the corresponding Cognitive Service resource. Passare alla pagina chiavi e fare clic sull' Copy to clipboard icona.Navigate to the Keys page, and click on the Copy to clipboard icon.

Ottenere una delle due chiavi per un uso successivo

Importante

Queste chiavi di sottoscrizione vengono usate per accedere all'API di servizi cognitivi.These subscription keys are used to access your Cognitive Service API. Non condividere le chiavi.Do not share your keys. Archiviarli in modo sicuro, ad esempio usando Azure Key Vault.Store them securely, for example, using Azure Key Vault. Si consiglia inoltre di rigenerare regolarmente queste chiavi.We also recommend regenerating these keys regularly. È necessaria una sola chiave per effettuare una chiamata API.Only one key is necessary to make an API call. Quando si rigenera la prima chiave, è possibile usare la seconda chiave per l'accesso continuo al servizio.When regenerating the first key, you can use the second key for continued access to the service.

Richiedere l'accesso al registro contenitori privatoRequest access to the private container registry

Compilare e inviare il modulo di richiesta di contenitori visione servizi cognitivi per richiedere l'accesso al contenitore.Fill out and submit the Cognitive Services Vision Containers Request form to request access to the container. Il modulo richiede informazioni sull'utente, sull'azienda e sullo scenario utente per cui si userà il contenitore.The form requests information about you, your company, and the user scenario for which you'll use the container. Dopo aver inviato il form, il team di servizi cognitivi di Azure esamina per assicurarsi che siano soddisfatti i criteri di accesso al registro contenitori privato.After you submit the form, the Azure Cognitive Services team reviews it to make sure that you meet the criteria for access to the private container registry.

Importante

È necessario usare un indirizzo di posta elettronica associato con un Account Microsoft (MSA) o un account di Azure Active Directory (Azure AD) nel form.You must use an email address associated with either a Microsoft Account (MSA) or an Azure Active Directory (Azure AD) account in the form.

Se la richiesta viene approvata, si riceverà un messaggio di posta elettronica con istruzioni che descrivono come ottenere le credenziali e accedere al registro contenitori privato.If your request is approved, you receive an email with instructions that describe how to obtain your credentials and access the private container registry.

Accedere al registro contenitori privatoLog in to the private container registry

Esistono diversi modi per eseguire l'autenticazione con registro contenitori privato per i contenitori di servizi cognitivi.There are several ways to authenticate with the private container registry for Cognitive Services containers. È consigliabile usare il metodo della riga di comando usando il CLI di Docker.We recommend that you use the command-line method by using the Docker CLI.

Usare la accesso a docker comando, come illustrato nell'esempio seguente, per accedere a containerpreview.azurecr.io, che è il registro contenitori privato per i contenitori di servizi cognitivi.Use the docker login command, as shown in the following example, to log in to containerpreview.azurecr.io, which is the private container registry for Cognitive Services containers. Sostituire <username> con il nome utente e <password> con la password specificata nelle credenziali ricevute dal team di Servizi cognitivi di Azure.Replace <username> with the user name and <password> with the password provided in the credentials you received from the Azure Cognitive Services team.

docker login containerpreview.azurecr.io -u <username> -p <password>

Se si è protetto le credenziali in un file di testo, è possibile concatenare il contenuto del file di testo per il docker login comando.If you secured your credentials in a text file, you can concatenate the contents of that text file to the docker login command. Usare il cat comando, come illustrato nell'esempio seguente.Use the cat command, as shown in the following example. Sostituire <passwordFile> con il percorso e nome del file di testo che contiene la password.Replace <passwordFile> with the path and name of the text file that contains the password. Sostituire <username> con il nome utente fornito le credenziali.Replace <username> with the user name provided in your credentials.

cat <passwordFile> | docker login containerpreview.azurecr.io -u <username> --password-stdin

Computer hostThe host computer

L'host è un computer basato su x64 che esegue il contenitore Docker.The host is a x64-based computer that runs the Docker container. Può essere un computer dell'ambiente locale o un servizio di hosting Docker in Azure, tra cui:It can be a computer on your premises or a Docker hosting service in Azure, such as:

Indicazioni e requisiti per i contenitoriContainer requirements and recommendations

Nota

I requisiti e le indicazioni sono basati sui benchmark con una singola richiesta al secondo, usando un'immagine di 8 MB di una lettera di business scansionata che contiene 29 righe e un totale di 803 caratteri.The requirements and recommendations are based on benchmarks with a single request per second, using an 8-MB image of a scanned business letter that contains 29 lines and a total of 803 characters.

La tabella seguente descrive l'allocazione minima e consigliata delle risorse per ogni contenitore di lettura.The following table describes the minimum and recommended allocation of resources for each Read container.

ContenitoreContainer MinimaMinimum ConsigliatoRecommended TPSTPS
(Minimo, massimo)(Minimum, Maximum)
LeggiRead 1 core, 8 GB di memoria, 0,24 TPS1 cores, 8-GB memory, 0.24 TPS 8 core, 16 GB di memoria, 1,17 TPS8 cores, 16-GB memory, 1.17 TPS 0,24, 1,170.24, 1.17
  • Ogni core deve essere di almeno 2,6 gigahertz (GHz) o superiore.Each core must be at least 2.6 gigahertz (GHz) or faster.
  • TPS-transazioni al secondo.TPS - transactions per second.

Core e memoria corrispondono alle impostazioni --cpus e --memory che vengono usate come parte del comando docker run.Core and memory correspond to the --cpus and --memory settings, which are used as part of the docker run command.

Ottenere l'immagine del contenitore con docker pullGet the container image with docker pull

Sono disponibili le immagini del contenitore per la lettura.Container images for Read are available.

ContenitoreContainer Container Registry/repository/nome dell'immagineContainer Registry / Repository / Image Name
LeggiRead containerpreview.azurecr.io/microsoft/cognitive-services-read:latest

Usare il comando docker pull per scaricare un'immagine del contenitore.Use the docker pull command to download a container image.

Pull Docker per il contenitore di letturaDocker pull for the Read container

docker pull containerpreview.azurecr.io/microsoft/cognitive-services-read:latest

Suggerimento

È possibile usare il comando docker images per visualizzare l'elenco delle immagini dei contenitori scaricate.You can use the docker images command to list your downloaded container images. Ad esempio, il comando seguente visualizza l'ID, il repository e il tag di ogni immagine del contenitore scaricata, in formato tabella:For example, the following command lists the ID, repository, and tag of each downloaded container image, formatted as a table:

docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"

IMAGE ID         REPOSITORY                TAG
<image-id>       <repository-path/name>    <tag-name>

Come usare il contenitoreHow to use the container

Dopo aver aggiunto il contenitore nel computer host, seguire questa procedura per usare il contenitore.Once the container is on the host computer, use the following process to work with the container.

  1. Eseguire il contenitore, con le impostazioni di fatturazione necessarie.Run the container, with the required billing settings. Sono disponibili altri esempi del comando docker run.More examples of the docker run command are available.
  2. Eseguire le query sull'endpoint di stima del contenitore.Query the container's prediction endpoint.

Eseguire il contenitore con docker runRun the container with docker run

Usare il comando docker run per eseguire il contenitore.Use the docker run command to run the container. Per informazioni dettagliate su come ottenere i {ENDPOINT_URI} valori e {API_KEY} , vedere raccolta dei parametri obbligatori .Refer to gathering required parameters for details on how to get the {ENDPOINT_URI} and {API_KEY} values.

Sono disponibili esempi di comando docker run.Examples of the docker run command are available.

docker run --rm -it -p 5000:5000 --memory 16g --cpus 8 \
containerpreview.azurecr.io/microsoft/cognitive-services-read \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

Questo comando:This command:

  • Esegue il contenitore di lettura dall'immagine del contenitore.Runs the Read container from the container image.
  • Alloca 8 core CPU e 16 gigabyte (GB) di memoria.Allocates 8 CPU core and 16 gigabytes (GB) of memory.
  • Espone la porta TCP 5000 e alloca un pseudo terminale TTY per il contenitore.Exposes TCP port 5000 and allocates a pseudo-TTY for the container.
  • Rimuove automaticamente il contenitore dopo la chiusura.Automatically removes the container after it exits. L'immagine del contenitore rimane disponibile nel computer host.The container image is still available on the host computer.

Sono disponibili altri esempi del comando docker run.More examples of the docker run command are available.

Importante

È necessario specificare le opzioni Eula, Billing e ApiKey per eseguire il contenitore. In caso contrario, il contenitore non si avvia.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. Per altre informazioni, vedereFatturazione.For more information, see Billing.

Eseguire più contenitori nello stesso hostRun multiple containers on the same host

Se si intende eseguire più contenitori con porte esposte, assicurarsi di eseguire ogni contenitore con una porta esposta diversa.If you intend to run multiple containers with exposed ports, make sure to run each container with a different exposed port. Eseguire ad esempio il primo contenitore sulla porta 5000 e il secondo sulla porta 5001.For example, run the first container on port 5000 and the second container on port 5001.

Questo contenitore e un contenitore di Servizi cognitivi diverso sono in esecuzione contemporaneamente sull'HOST.You can have this container and a different Azure Cognitive Services container running on the HOST together. Sono inoltre in esecuzione più contenitori dello stesso contenitore di Servizi cognitivi.You also can have multiple containers of the same Cognitive Services container running.

Verificare che il contenitore sia in esecuzioneValidate that a container is running

Per verificare se il contenitore è in esecuzione, sono disponibili diverse opzioni.There are several ways to validate that the container is running. Individuare l'indirizzo IP esterno e la porta esposta del contenitore in questione e aprire il Web browser preferito.Locate the External IP address and exposed port of the container in question, and open your favorite web browser. Usare i vari URL di richiesta indicati di seguito per verificare che il contenitore sia in esecuzione.Use the various request URLs below to validate the container is running. Gli URL di richiesta di esempio elencati http://localhost:5000di seguito sono, ma il contenitore specifico può variare.The example request URLs listed below are http://localhost:5000, but your specific container may vary. Tenere presente che si sta per fare affidamento sull'indirizzo IP esterno del contenitore e sulla porta esposta.Keep in mind that you're to rely on your container's External IP address and exposed port.

URL richiestaRequest URL ScopoPurpose
http://localhost:5000/ Il contenitore fornisce una home page.The container provides a home page.
http://localhost:5000/status Richiesta con HTTP GET, per verificare che il contenitore sia in esecuzione senza causare una query dell'endpoint.Requested with an HTTP GET, to validate that the container is running without causing an endpoint query. Questa richiesta può essere usata per i probe di attività e di idoneità di Kubernetes.This request can be used for Kubernetes liveness and readiness probes.
http://localhost:5000/swagger Il contenitore fornisce un set completo di documentazione per gli endpoint e una funzionalità di prova .The container provides a full set of documentation for the endpoints and a Try it out feature. Con questa funzionalità, è possibile immettere le impostazioni in un modulo HTML basato sul Web ed eseguire la query senza scrivere codice.With this feature, you can enter your settings into a web-based HTML form and make the query without having to write any code. Dopo che la query restituisce il risultato, viene fornito un comando CURL di esempio per illustrare il formato richiesto per il corpo e le intestazioni HTTP.After the query returns, an example CURL command is provided to demonstrate the HTTP headers and body format that's required.

Home page del contenitore

Eseguire query sull'endpoint di stima del contenitoreQuery the container's prediction endpoint

Il contenitore fornisce API dell'endpoint di stima di query basate su REST.The container provides REST-based query prediction endpoint APIs.

Usare l'host, http://localhost:5000, per le API del contenitore.Use the host, http://localhost:5000, for container APIs.

Lettura asincronaAsynchronous read

È possibile usare le POST /vision/v2.0/read/core/asyncBatchAnalyze operazioni GET /vision/v2.0/read/operations/{operationId} e in Concert per leggere in modo asincrono un'immagine, in modo analogo a come il servizio visione artificiale usa le operazioni REST corrispondenti.You can use the POST /vision/v2.0/read/core/asyncBatchAnalyze and GET /vision/v2.0/read/operations/{operationId} operations in concert to asynchronously read an image, similar to how the Computer Vision service uses those corresponding REST operations. Il metodo post asincrono restituirà un operationId oggetto che viene usato come identificatore per la richiesta HTTP Get.The asynchronous POST method will return an operationId that is used as the identifer to the HTTP GET request.

Dall'interfaccia utente di spavalderia selezionare il asyncBatchAnalyze per espanderlo nel browser.From the swagger UI, select the asyncBatchAnalyze to expand it in the browser. Quindi selezionare try it out > Choose file.Then select Try it out > Choose file. In questo esempio si userà l'immagine seguente:In this example, we'll use the following image:

tabulazioni e spazi

Quando il POST asincrono viene eseguito correttamente, restituisce un codice di stato HTTP 202 .When the asynchronous POST has run successfully, it returns an HTTP 202 status code. Come parte della risposta, è presente un' operation-location intestazione che contiene l'endpoint di risultato per la richiesta.As part of the response, there is an operation-location header that holds the result endpoint for the request.

 content-length: 0
 date: Fri, 13 Sep 2019 16:23:01 GMT
 operation-location: http://localhost:5000/vision/v2.0/read/operations/a527d445-8a74-4482-8cb3-c98a65ec7ef9
 server: Kestrel

operation-location È l'URL completo a cui è possibile accedere tramite HTTP Get.The operation-location is the fully qualified URL and is accessed via an HTTP GET. Ecco la risposta JSON dall'esecuzione dell' operation-location URL dall'immagine precedente:Here is the JSON response from executing the operation-location URL from the preceding image:

{
  "status": "Succeeded",
  "recognitionResults": [
    {
      "page": 1,
      "clockwiseOrientation": 2.42,
      "width": 502,
      "height": 252,
      "unit": "pixel",
      "lines": [
        {
          "boundingBox": [
            56,
            39,
            317,
            50,
            313,
            134,
            53,
            123
          ],
          "text": "Tabs VS",
          "words": [
            {
              "boundingBox": [
                90,
                43,
                243,
                53,
                243,
                123,
                94,
                125
              ],
              "text": "Tabs",
              "confidence": "Low"
            },
            {
              "boundingBox": [
                259,
                55,
                313,
                62,
                313,
                122,
                259,
                123
              ],
              "text": "VS"
            }
          ]
        },
        {
          "boundingBox": [
            221,
            148,
            417,
            146,
            417,
            206,
            227,
            218
          ],
          "text": "Spaces",
          "words": [
            {
              "boundingBox": [
                230,
                148,
                416,
                141,
                419,
                211,
                232,
                218
              ],
              "text": "Spaces"
            }
          ]
        }
      ]
    }
  ]
}

Lettura sincronaSynchronous read

È possibile usare l' POST /vision/v2.0/read/core/Analyze operazione per leggere in modo sincrono un'immagine.You can use the POST /vision/v2.0/read/core/Analyze operation to synchronously read an image. Quando l'immagine viene letta completamente, solo l'API restituisce una risposta JSON.When the image is read in its entirety, then and only then does the API return a JSON response. L'unica eccezione è rappresentata dal caso in cui si verifichi un errore.The only exception to this is if an error occurs. Quando si verifica un errore, viene restituito il codice JSON seguente:When an error occurs the following JSON is returned:

{
    status: "Failed"
}

L'oggetto di risposta JSON ha lo stesso oggetto grafico della versione asincrona.The JSON response object has the same object graph as the asynchronous version. Se si è un utente JavaScript e si vuole l'indipendenza dai tipi, è possibile usare i tipi seguenti per eseguire il cast AnalyzeResult della risposta JSON come oggetto.If you're a JavaScript user and want type safety, the following types could be used to cast the JSON response as an AnalyzeResult object.

export interface AnalyzeResult {
    status: Status;
    recognitionResults?: RecognitionResult[] | null;
}

export enum Status {
    NotStarted = 0,
    Running = 1,
    Failed = 2,
    Succeeded = 3
}

export enum Unit {
    Pixel = 0,
    Inch = 1
}

export interface RecognitionResult {
    page?: number | null;
    clockwiseOrientation?: number | null;
    width?: number | null;
    height?: number | null;
    unit?: Unit | null;
    lines?: Line[] | null;
}

export interface Line {
    boundingBox?: number[] | null;
    text: string;
    words?: Word[] | null;
}

export interface Word {
  boundingBox?: number[] | null;
  text: string;
  confidence?: string | null;
}

Per un esempio di utilizzo, vedere il sandbox typescript qui e selezionare "Run" (Esegui) per visualizzarne la semplicità d'uso.For an example use-case, see the TypeScript sandbox here and select "Run" to visualize its ease-of-use.

Arrestare il contenitoreStop the container

Per arrestare il contenitore, nell'ambiente della riga di comando in cui è in esecuzione il contenitore, selezionare Ctrl + C.To shut down the container, in the command-line environment where the container is running, select Ctrl+C.

risoluzione dei problemiTroubleshooting

Se si esegue il contenitore con un punto di montaggio di output e la registrazione attivata, il contenitore genera file di log utili per risolvere i problemi che si verificano durante l'avvio o l'esecuzione del contenitore.If you run the container with an output mount and logging enabled, the container generates log files that are helpful to troubleshoot issues that happen while starting or running the container.

Suggerimento

Per ulteriori informazioni e indicazioni sulla risoluzione dei problemi, vedere la pagina relativa alle domande frequenti sui contenitori di servizi cognitivi.For more troubleshooting information and guidance, see Cognitive Services containers frequently asked questions (FAQ).

FatturazioneBilling

I contenitori di servizi cognitivi inviano informazioni di fatturazione ad Azure, usando la risorsa corrispondente nell'account Azure.The Cognitive Services containers send billing information to Azure, using the corresponding resource on your Azure account.

Le query sul contenitore vengono fatturate secondo il piano tariffario della risorsa di Azure usata per <ApiKey>.Queries to the container are billed at the pricing tier of the Azure resource that's used for the <ApiKey>.

I contenitori di Servizi cognitivi di Azure non vengono concessi in licenza per l'esecuzione senza connessione all'endpoint di fatturazione per la misurazione.Azure Cognitive Services containers aren't licensed to run without being connected to the billing endpoint for metering. È necessario consentire ai contenitori di comunicare sempre le informazioni di fatturazione all'endpoint di fatturazione.You must enable the containers to communicate billing information with the billing endpoint at all times. I contenitori di Servizi cognitivi non inviano a Microsoft i dati dei clienti, ad esempio l'immagine o il testo analizzato.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.

Connect to AzureConnect to Azure

Per eseguire il contenitore, sono necessari i valori dell'argomento di fatturazione.The container needs the billing argument values to run. Questi valori consentono al contenitore di connettersi all'endpoint di fatturazione.These values allow the container to connect to the billing endpoint. Il contenitore segnala l'utilizzo ogni 10-15 minuti.The container reports usage about every 10 to 15 minutes. Se il contenitore non si connette ad Azure entro la finestra temporale consentita, continuerà a essere eseguito ma non fornirà query finché l'endpoint di fatturazione non verrà ripristinato.If the container doesn't connect to Azure within the allowed time window, the container continues to run but doesn't serve queries until the billing endpoint is restored. Il tentativo di connessione viene effettuato 10 volte nello stesso intervallo di tempo di 10-15 minuti.The connection is attempted 10 times at the same time interval of 10 to 15 minutes. Se non è possibile stabilire la connessione con l'endpoint di fatturazione entro i 10 tentativi, l'esecuzione del contenitore verrà arrestata.If it can't connect to the billing endpoint within the 10 tries, the container stops running.

Argomenti di fatturazioneBilling arguments

Per avviare il contenitore con il comando docker run, è necessario che vengano specificate tutte e tre le opzioni seguenti con valori validi:For the docker run command to start the container, all three of the following options must be specified with valid values:

OpzioneOption DescrizioneDescription
ApiKey Chiave API della risorsa di Servizi cognitivi usata per tenere traccia delle informazioni di fatturazione.The API key of the Cognitive Services resource that's used to track billing information.
Il valore di questa opzione deve essere impostato su una chiave API per la risorsa di cui è stato effettuato il provisioning specificata in Billing.The value of this option must be set to an API key for the provisioned resource that's specified in Billing.
Billing Endpoint della risorsa di Servizi cognitivi usata per tenere traccia delle informazioni di fatturazione.The endpoint of the Cognitive Services resource that's used to track billing information.
Il valore di questa opzione deve essere impostato sull'URI dell'endpoint di una risorsa di Azure di cui è stato effettuato il provisioning.The value of this option must be set to the endpoint URI of a provisioned Azure resource.
Eula Indica che è la licenza per il contenitore è stata accettata.Indicates that you accepted the license for the container.
Il valore di questa opzione deve essere impostato su accept.The value of this option must be set to accept.

Per altre informazioni su queste opzioni, vedere Configurare i contenitori.For more information about these options, see Configure containers.

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

RiepilogoSummary

In questo articolo sono stati descritti i concetti e il flusso di lavoro per scaricare, installare ed eseguire i contenitori Visione artificiale.In this article, you learned concepts and workflow for downloading, installing, and running Computer Vision containers. In sintesi:In summary:

  • Visione artificiale fornisce un contenitore Linux per Docker, incapsulando sia riconoscimento del testo che Read.Computer Vision provides a Linux container for Docker, encapsulating both Recognize Text and Read.
  • Le immagini del contenitore vengono scaricate dal registro contenitori "anteprima contenitore" in Azure.Container images are downloaded from the "Container Preview" container registry in Azure.
  • Le immagini dei contenitori vengono eseguite in Docker.Container images run in Docker.
  • È possibile usare l'API REST o l'SDK per chiamare le operazioni in riconoscimento del testo o leggere i contenitori specificando l'URI host del contenitore.You can use either the REST API or SDK to call operations in Recognize Text or Read containers by specifying the host URI of the container.
  • Quando si crea un'istanza di un contenitore, è necessario specificare le informazioni di fatturazione.You must specify billing information when instantiating a container.

Importante

I contenitori di Servizi cognitivi non sono concessi in licenza per l'esecuzione senza essere connessi ad Azure per la misurazione.Cognitive Services containers are not licensed to run without being connected to Azure for metering. I clienti devono consentire ai contenitori di comunicare sempre le informazioni di fatturazione al servizio di misurazione.Customers need to enable the containers to communicate billing information with the metering service at all times. I contenitori di Servizi cognitivi non inviano a Microsoft i dati dei clienti, ad esempio l'immagine o il testo analizzato.Cognitive Services containers do not send customer data (for example, the image or text that is being analyzed) to Microsoft.

Passaggi successiviNext steps