Distribuire un contenitore Rilevamento anomalie in Istanze di Container di Azure
Importante
A partire dal 20 settembre 2023 non sarà possibile creare nuove risorse di Rilevamento anomalie. Il servizio Rilevamento anomalie verrà ritirato il 1° ottobre 2026.
Informazioni su come distribuire il contenitore Rilevamento anomalie dei Servizi di Azure AI in Istanze di Azure Container. Questa procedura illustra la creazione di una risorsa Rilevamento anomalie. Verrà quindi illustrato il pull dell'immagine del contenitore associata. Infine, viene sottolineata la possibilità di esercitare l'orchestrazione di entrambi da un browser. L'uso dei contenitori consente di spostare l'attenzione degli sviluppatori dalla gestione dell'infrastruttura, in modo da concentrarsi sullo sviluppo di applicazioni.
Prerequisiti
- Usare una sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
- Installare l'interfaccia della riga di comando di Azure (az).
- Motore Docker e verificare che l'interfaccia della riga di comando di Docker funzioni in una finestra della console.
Creare una risorsa Rilevamento anomalie
Accedere al portale di Azure.
Selezionare Creare una risorsa di Rilevamento anomalie.
Immettere tutte le impostazioni richieste:
Impostazione valore Nome Il nome desiderato (2-64 caratteri) Abbonamento Selezionare la sottoscrizione appropriata Ufficio Selezionare una località vicina e disponibile Piano tariffario F0
- 10 chiamate al secondo, 20.000 transazioni al mese.
Oppure:
S0
- 80 chiamate al secondoGruppo di risorse Selezionare un gruppo di risorse disponibile Fare clic su Crea e attendere che venga creata la risorsa. Una volta creata, passare alla pagina della risorsa
Raccogliere una
endpoint
configurata e una chiave API:Scheda Chiavi ed endpoint nel portale Impostazione Valore Sintesi Endpoint Copiare l'endpoint. Sarà simile a https://<your-resource-name>.cognitiveservices.azure.com/
Chiavi Chiave API Copiare 1 delle due chiavi. Si tratta di una stringa di 32 caratteri alfanumerici senza spazi o trattini, xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
.
Creare una risorsa Istanza di Container di Azure Container dall'interfaccia della riga di comando di Azure
Il codice YAML seguente definisce la risorsa Istanza di Container di Azure. Copiare e incollare il contenuto in un nuovo file denominato my-aci.yaml
e sostituire i valori commentati con i propri. Fare riferimento al formato del modello per YAML valido. Fare riferimento ai repository e alle immagini del contenitore per i nomi delle immagini disponibili e il repository corrispondente. Per altre informazioni sul riferimento YAML per le istanze di Container, vedere Riferimento YAML: Istanze di Container di Azure.
apiVersion: 2018-10-01
location: # < Valid location >
name: # < Container Group name >
properties:
imageRegistryCredentials: # This is only required if you are pulling a non-public image that requires authentication to access. For example Text Analytics for health.
- server: containerpreview.azurecr.io
username: # < The username for the preview container registry >
password: # < The password for the preview container registry >
containers:
- name: # < Container name >
properties:
image: # < Repository/Image name >
environmentVariables: # These env vars are required
- name: eula
value: accept
- name: billing
value: # < Service specific Endpoint URL >
- name: apikey
value: # < Service specific API key >
resources:
requests:
cpu: 4 # Always refer to recommended minimal resources
memoryInGb: 8 # Always refer to recommended minimal resources
ports:
- port: 5000
osType: Linux
volumes: # This node, is only required for container instances that pull their model in at runtime, such as LUIS.
- name: aci-file-share
azureFile:
shareName: # < File share name >
storageAccountName: # < Storage account name>
storageAccountKey: # < Storage account key >
restartPolicy: OnFailure
ipAddress:
type: Public
ports:
- protocol: tcp
port: 5000
tags: null
type: Microsoft.ContainerInstance/containerGroups
Nota
Non tutte le posizioni hanno la stessa disponibilità di CPU e memoria. Fare riferimento alla tabella posizioni e risorse per l'elenco delle risorse disponibili per i contenitori in base alla posizione e al sistema operativo.
Il comando az container create
si baserà sul file YAML creato. Dall'interfaccia della riga di comando di Azure, eseguire il comando az container create
sostituendo il <resource-group>
con il proprio. Inoltre, per proteggere i valori all'interno di una distribuzione YAML, vedere i valori protetti.
az container create -g <resource-group> -f my-aci.yaml
Se valido, l'output del comando è Running...
e dopo qualche tempo l'output si converte in una stringa JSON che rappresenta la risorsa ACI appena creata. L'immagine del contenitore è probabile che non sia disponibile per un po' di tempo, ma la risorsa viene ora distribuita.
Suggerimento
Prestare particolare attenzione alle posizioni dei Servizi di Azure AI in anteprima pubblica, poiché è necessario modificare YAML di conseguenza in modo che corrisponda alla posizione.
Verificare che il contenitore sia in esecuzione
Per verificare se il contenitore è in esecuzione, sono disponibili diverse opzioni. Individuare l'indirizzo IP esterno e la porta esposta del contenitore in questione, quindi aprire il Web browser di scelta. Usare i vari URL di richiesta seguenti per verificare che il contenitore sia in esecuzione. Gli URL di richiesta di esempio elencati di seguito sono http://localhost:5000
, ma il proprio contenitore specifico potrebbe variare. Assicurarsi di usare l'indirizzo IP esterno e la porta esposta del contenitore.
Richiesta URL | Scopo |
---|---|
http://localhost:5000/ |
Il contenitore fornisce un home page. |
http://localhost:5000/ready |
Questo URL, richiesto con un'operazione GET, verifica che il contenitore sia pronto per accettare una query sul modello. Questa richiesta può essere usata per i probe di attività e di idoneità di Kubernetes. |
http://localhost:5000/status |
Questo URL, anch'esso richiesto con un'operazione GET, verifica se la chiave API usata per avviare il contenitore sia valida senza che sia necessaria una query sull'endpoint. Questa richiesta può essere usata per i probe di attività e di idoneità di Kubernetes. |
http://localhost:5000/swagger |
Il contenitore fornisce un set completo di documentazione per gli endpoint e una funzionalità Prova. Con questa funzionalità, è possibile immettere le impostazioni in un modulo HTML basato sul Web ed eseguire la query senza scrivere codice. 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. |
Passaggi successivi
- Esaminare Installa ed esegui contenitori per eseguire il pull dell'immagine del contenitore ed eseguire il contenitore
- Rivedere Configurare i contenitori per informazioni sulle impostazioni di configurazione.
- Altre informazioni sul servizio API Rilevamento anomalie