Distribuera och köra container på Azure Container-instans

Med följande steg kan du enkelt skala Azure Cognitive Services program i molnet med Azure Container Instances. Med containerisering kan du fokusera på att skapa program i stället för att hantera infrastrukturen. Mer information om hur du använder containrar finns i funktioner och fördelar.

Förutsättningar

Receptet fungerar med alla Cognitive Services container. Cognitive Service-resursen måste skapas innan receptet används. Varje Cognitive Service som har stöd för containrar innehåller en artikel om hur du installerar och konfigurerar tjänsten för en container. Vissa tjänster kräver en fil eller en uppsättning filer som indata för containern. Det är viktigt att du förstår och har använt containern korrekt innan du använder den här lösningen.

  • En Azure-resurs för den Azure Cognitive Service som du använder.

  • Slutpunkts-URL för Cognitive Service – granska din specifika tjänsts "Så här installerar du" för containern för att ta reda på var slutpunkts-URL:en är inifrån Azure Portal och hur ett korrekt exempel på URL:en ser ut. Det exakta formatet kan ändras från tjänst till tjänst.

  • Cognitive Service-nyckel – nycklarna finns på sidan Nycklar för Azure-resursen. Du behöver bara en av de två nycklarna. Nyckeln är en sträng med 32 alfanumeriska tecken.

  • En enskild Cognitive Services container på din lokala värd (datorn). Kontrollera att du kan:

    • Hämta avbildningen med ett docker pull kommando.
    • Kör den lokala containern med alla nödvändiga konfigurationsinställningar med ett docker run kommando.
    • Anropa containerns slutpunkt och få ett svar på HTTP 2xx och ett JSON-svar tillbaka.

Alla variabler i vinkelparenteser, <> , måste ersättas med dina egna värden. Den här ersättningen omfattar vinkelparenteserna.

Viktigt

LUIS-containern kräver .gz en modellfil som hämtas vid körning. Containern måste kunna komma åt den här modellfilen via en volymmontering från containerinstansen. Följ dessa steg om du vill ladda upp en modellfil:

  1. Skapa en Azure-filresurs. Anteckna namnet Azure Storage konto, nyckel och filresursnamn eftersom du behöver dem senare.
  2. exportera din LUIS-modell (paketerad app) från LUIS-portalen.
  3. I Azure Portal du till sidan Översikt för lagringskontoresursen och väljer Filresurser.
  4. Välj det filresursnamn som du nyligen skapade och välj sedan Ladda upp. Ladda sedan upp den paketerade appen.

Skapa en Azure Container instance-resurs med hjälp av Azure Portal

  1. Gå till sidan skapa för container instances.

  2. På fliken grundläggande anger du följande information:

    Inställning Värde
    Prenumeration Välj din prenumeration.
    Resursgrupp Välj en tillgänglig resurs grupp eller skapa en ny, till exempel cognitive-services .
    Containerns namn Ange ett namn som cognitive-container-instance . Namnet måste innehålla nedre CAPS.
    Location Välj en region för distribution.
    Avbildningstyp Om behållar avbildningen lagras i ett behållar register som inte kräver autentiseringsuppgifter väljer du Public . Om åtkomsten till behållar avbildningen kräver autentiseringsuppgifter väljer du Private . Se behållar databaser och avbildningar för information om huruvida behållar avbildningen är Public eller Private ("offentlig för hands version).
    Avbildningens namn Ange plats för Cognitive Services behållare. Platsen är det som används som argument till docker pull kommandot. Referera till behållar databaserna och avbildningarna för de tillgängliga avbildnings namnen och deras motsvarande lagrings plats.

    Avbildningens namn måste vara fullständigt kvalificerade och ange tre delar. Först, behållar registret, sedan databasen, sist avbildningens namn: <container-registry>/<repository>/<image-name> .

    Här är ett exempel som mcr.microsoft.com/azure-cognitive-services/keyphrase representerar extrahering av diskussionsämne avbildningen i Microsoft container Registry under Azure Cognitive Services-lagringsplatsen. Ett annat exempel är, containerpreview.azurecr.io/microsoft/cognitive-services-speech-to-text som representerar tal till text bild i Microsoft-lagringsplatsen för för hands versionen av container-registret.
    OS-typ Linux
    Storlek Ändra storlek till föreslagna rekommendationer för din speciella kognitiva tjänst behållare:
    2 CPU-kärnor
    4 GB
  3. På fliken nätverk anger du följande information:

    Inställning Värde
    Portar Ange TCP-port till 5000 . Exponerar behållaren på port 5000.
  4. På fliken Avancerat anger du de miljövariabler som krävs för behållarens fakturerings inställningar för Azure Container instance-resursen:

    Tangent Värde
    ApiKey Kopierat från sidan nycklar och slut punkt för resursen. Det är en sträng med 32 alfanumeriska tecken utan blank steg eller bindestreck xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx .
    Billing Slut punkts-URL: en kopierad från sidan nycklar och slut punkt för resursen.
    Eula accept
  5. Klicka på Granska och skapa

  6. När verifieringen är klar klickar du på skapa för att slutföra processen som skapas

  7. När resursen har distribuerats är den klar

Använda containerinstansen

  1. Välj Översikt och kopiera IP-adressen. Det är en numerisk IP-adress, till exempel 55.55.55.55 .

  2. Öppna en ny webbläsarflik och använd IP-adressen, till exempel http://<IP-address>:5000 (http://55.55.55.55:5000 ). Du ser containerns startsida så att du vet att containern körs.

    Containerns startsida

  3. Välj Beskrivning av tjänst-API för att visa swagger-sidan för containern.

  4. Välj något av POST-API:erna och välj Prova. Parametrarna visas inklusive indata. Fyll i parametrarna.

  5. Välj Kör för att skicka begäran till din containerinstans.

    Du har skapat och använt Cognitive Services i Azure Container Instance.