Container implementeren en uitvoeren in Azure Container Instance

Artikel
05/13/2021
7 minuten om te lezen

Met de volgende stappen kunt u eenvoudig Azure Cognitive Services in de cloud schalen met Azure Container Instances. Containerisatie helpt u om u te richten op het bouwen van uw toepassingen in plaats van op het beheren van de infrastructuur. Zie functies en voordelen voor meer informatie over het gebruik van containers.

Vereisten

Het recept werkt met elke Cognitive Services container. De Cognitive Service-resource moet worden gemaakt voordat u het recept gebruikt. Elke Cognitive Service die ondersteuning biedt voor containers, heeft een artikel 'Installeren' voor het installeren en configureren van de service voor een container. Voor sommige services is een bestand of set bestanden als invoer voor de container vereist. Het is belangrijk dat u begrijpt en de container goed hebt gebruikt voordat u deze oplossing gebruikt.

Een Azure-resource voor de Azure Cognitive Service die u gebruikt.
Eindpunt-URL van Cognitive Service: controleer de 'Hoe te installeren' van uw specifieke service voor de container om te zien waar de eindpunt-URL vandaan komt in de Azure Portal en hoe een correct voorbeeld van de URL eruitziet. De exacte indeling kan van service naar service veranderen.
Cognitive Service-sleutel: de sleutels staan op de pagina Sleutels voor de Azure-resource. U hebt slechts één van de twee sleutels nodig. De sleutel is een tekenreeks van 32 alfanumerieke tekens.
Eén container Cognitive Services op uw lokale host (uw computer). Zorg ervoor dat u het volgende kunt doen:
- Haal de afbeelding op met een docker pull opdracht.
- Voer de lokale container met alle vereiste configuratie-instellingen uit met een docker run opdracht.
- Roep het eindpunt van de container aan en krijg een antwoord van HTTP 2xx en een JSON-antwoord terug.

Alle variabelen tussen vierkante haken, <> , moeten worden vervangen door uw eigen waarden. Deze vervanging omvat de hoekhaken.

Belangrijk

Voor de LUIS-container is .gz een modelbestand vereist dat tijdens runtime wordt binnengehaald. De container moet toegang hebben tot dit modelbestand via een volume-mount van de container-instantie. Volg deze stappen om een modelbestand te uploaden:

Maak een Azure-bestands share. Noteer de Azure Storage, sleutel en bestands sharenaam, aangezien u deze later nodig hebt.
exporteert u uw LUIS-model (verpakte app) vanuit de LUIS-portal.
Ga in Azure Portal naar de pagina Overzicht van uw opslagaccountresource en selecteer Bestands shares.
Selecteer de naam van de bestands share die u onlangs hebt gemaakt en selecteer vervolgens Uploaden. Upload vervolgens uw verpakte app.

Azure-portal
CLI

Een Azure container Instance-bron maken met behulp van de Azure Portal

Ga naar de pagina maken voor container instances.

Voer op het tabblad basis beginselen de volgende gegevens in:

Instelling	Waarde
Abonnement	Selecteer uw abonnement.
Resourcegroep	Selecteer de beschik bare resource groep of maak een nieuwe, zoals `cognitive-services` .
Containernaam	Voer een naam in zoals `cognitive-container-instance` . De naam moet in kleine letters worden gereduceerd.
Locatie	Selecteer een regio voor de implementatie.
Type installatiekopie	Als uw container installatie kopie is opgeslagen in een container register waarvoor geen referenties zijn vereist, kiest u `Public` . Als u toegang hebt tot de container installatie kopie, moet u de optie referenties kiezen `Private` . Raadpleeg container opslagplaatsen en installatie kopieën voor meer informatie over of de container installatie kopie al dan niet is `Public` `Private` (' open bare preview ').
Naam van installatiekopie	Voer de locatie van de Cognitive Services-container in. De locatie is wat wordt gebruikt als argument voor de `docker pull` opdracht. Raadpleeg de container opslagplaatsen en installatie kopieën voor de beschik bare afbeeldings namen en de bijbehorende opslag plaats. De naam van de installatie kopie moet volledig gekwalificeerd zijn om drie delen op te geven. Ten eerste, het container register en vervolgens de naam van de installatie kopie: `<container-registry>/<repository>/<image-name>` . Hier ziet u een voor beeld `mcr.microsoft.com/azure-cognitive-services/keyphrase` van de Sleuteltermextractie installatie kopie in de micro soft-container Registry onder de Azure Cognitive Services-opslag plaats. Een ander voor beeld is `containerpreview.azurecr.io/microsoft/cognitive-services-speech-to-text` dat de spraak-naar-tekst afbeelding wordt weer gegeven in de micro soft-opslag plaats van het container voorbeeld container register.
Type besturings systeem	`Linux`
Grootte	Wijzig grootte in de voorgestelde aanbevelingen voor uw specifieke cognitieve service-container: twee CPU-kernen 4 GB

Voer op het tabblad netwerken de volgende gegevens in:

Instelling Waarde

Poorten Stel de TCP-poort in op 5000 . Beschrijft de container op poort 5000.

Instelling	Waarde
Poorten	Stel de TCP-poort in op `5000` . Beschrijft de container op poort 5000.

Voer op het tabblad Geavanceerd de vereiste omgevings variabelen in voor de instellingen van de container facturering van de Azure container Instance-bron:

Sleutel	Waarde
`ApiKey`	Wordt gekopieerd van de pagina sleutels en het eind punt van de resource. Het is een teken reeks van 32 alfanumerieke tekens zonder spaties of streepjes `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` .
`Billing`	De eind punt-URL is gekopieerd van de pagina sleutels en het eind punt van de resource.
`Eula`	`accept`

Klik op controleren en maken
Nadat de validatie is geslaagd, klikt u op maken om het aanmaak proces te volt ooien
Wanneer de resource is geïmplementeerd, is deze gereed

Een Azure Container Instance-resource maken vanuit de Azure CLI

De yaml hieronder definieert de Azure Container Instance-resource. Kopieer en plak de inhoud in een nieuw bestand met de naam en my-aci.yaml vervang de opmerkingen door uw eigen waarden. Raadpleeg de sjabloonindeling voor geldige YAML. Raadpleeg de containeropslagplaats en -afbeeldingen voor de beschikbare namen van afbeeldingen en de bijbehorende opslagplaats. Zie YAML-verwijzing: Azure Container Instances voor meer informatie over de YAML-verwijzing voor container Azure Container Instances.

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

Notitie

Niet alle locaties hebben dezelfde CPU- en geheugenbeschikbaarheid. Raadpleeg de tabel locatie en resources voor de lijst met beschikbare resources voor containers per locatie en besturingssysteem.

We vertrouwen op het YAML-bestand dat we voor de opdracht hebben az container create gemaakt. Voer vanuit de Azure CLI de opdracht az container create uit en vervang de door uw eigen <resource-group> opdracht. Voor het beveiligen van waarden binnen een YAML-implementatie raadpleegt u bovendien beveiligde waarden.

az container create -g <resource-group> -f my-aci.yaml

De uitvoer van de opdracht is indien geldig, nadat de uitvoer enige tijd is gewijzigd in een JSON-tekenreeks die de zojuist gemaakte Running... ACI-resource vertegenwoordigt. De containerafbeelding is waarschijnlijk een tijdje niet beschikbaar, maar de resource is nu geïmplementeerd.

Tip

Let goed op de locaties van de openbare preview-versie van Azure Cognitive Service, omdat de YAML dienovereenkomstig moet worden aangepast om overeen te komen met de locatie.

Selecteer overzicht en kopieer het IP-adres. Dit is een numeriek IP-adres, zoals 55.55.55.55 .
Open een nieuw browsertabblad en gebruik het IP-adres, bijvoorbeeld http://<IP-address>:5000 (http://55.55.55.55:5000 ). U ziet de startpagina van de container, zodat u weet dat de container wordt uitgevoerd.
Selecteer Beschrijving service-API om de swagger-pagina voor de container weer te geven.
Selecteer een van de POST-API's en selecteer Uitproberen. De parameters worden weergegeven, inclusief de invoer. Vul de parameters in.
Selecteer Uitvoeren om de aanvraag naar uw Container Instance te verzenden.

U hebt de containers in Azure Container Instance Cognitive Services en gebruikt.

Controleren of een container wordt uitgevoerd

Er zijn verschillende manieren om te controleren of de container wordt uitgevoerd. Zoek het externe IP- adres en de weer gegeven poort van de betreffende container en open uw favoriete webbrowser. Gebruik de onderstaande aanvraag-Url's om te controleren of de container wordt uitgevoerd. De onderstaande voorbeeld aanvraag-Url's zijn http://localhost:5000 , maar uw specifieke container kan variëren. Houd er rekening mee dat u afhankelijk bent van het externe IP- adres van uw container en de weer gegeven poort.

Aanvraag-URL	Doel
`http://localhost:5000/`	De container bevat een startpagina.
`http://localhost:5000/ready`	Met GET heeft dit een verificatie dat de container gereed is voor het accepteren van een query op het model. Deze aanvraag kan worden gebruikt voor Kubernetes- en gereedheids tests.
`http://localhost:5000/status`	Daarnaast wordt met GET gevraagd of de API-sleutel die wordt gebruikt om de container te starten, geldig is zonder dat dit een eindpunt query veroorzaakt. Deze aanvraag kan worden gebruikt voor Kubernetes- en gereedheids tests.
`http://localhost:5000/swagger`	De container bevat een volledige set met documentatie voor de eindpunten en een functie Uitproberen. Met deze functie kunt u uw instellingen invoeren in een HTML-formulier op het web en de query maken zonder dat u code hoeft te schrijven. Nadat de query is geretourneerd, wordt een voor beeld van een krul opdracht weer gegeven om te demonstreren welke HTTP-headers en hoofdtekst indeling vereist zijn.

Start pagina van container

Notitie

Als u de statuscontainer Text Analytics, gebruikt u de volgende URL om query's in te dienen: http://localhost:5000/text/analytics/v3.2-preview.1/entities/health

Container implementeren en uitvoeren in Azure Container Instance

Beoordeel uw ervaring

Vereisten

Een Azure container Instance-bron maken met behulp van de Azure Portal

De container-instantie gebruiken