Wdrażanie i uruchamianie kontenerów na Azure Container Instance

Artykuł
04/03/2025

Poniższe kroki umożliwiają łatwe skalowanie aplikacji usług azure AI w chmurze za pomocą usługi Azure Container Instances. Konteneryzacja pomaga skoncentrować się na tworzeniu aplikacji, zamiast na zarządzaniu infrastrukturą. Aby uzyskać więcej informacji na temat korzystania z kontenerów, zobacz funkcje i korzyści.

Wymagania wstępne

Przepis działa z dowolnym kontenerem usług Azure AI. Przed użyciem przepisu należy utworzyć zasób usług Azure AI. Każda usługa azure AI, która obsługuje kontenery, zawiera artykuł "Jak zainstalować" na potrzeby instalowania i konfigurowania usługi dla kontenera. Niektóre usługi wymagają pliku lub zestawu plików jako danych wejściowych dla kontenera. Ważne jest, aby zrozumieć i pomyślnie użyć kontenera przed użyciem tego rozwiązania.

Zasób platformy Azure dla używanej usługi Azure AI.
Adres URL punktu końcowego zasobu usługi Azure AI — przejrzyj sekcję "Jak zainstalować" dla konkretnej usługi w kontekście kontenera, aby dowiedzieć się, gdzie znajduje się adres URL punktu końcowego w Azure Portal i jak wygląda prawidłowy przykład adresu URL. Dokładny format może ulec zmianie z usługi na usługę.
Klucz zasobu usługi Azure AI — klucze znajdują się na stronie Klucze zasobu platformy Azure. Potrzebujesz tylko jednego z dwóch kluczy. Klucz jest ciągiem składającym się z 84 znaków alfanumerycznych.
Pojedynczy kontener usług AI platformy Azure na hoście lokalnym (komputerze). Upewnij się, że możesz:
- Przeciągnij obraz za pomocą polecenia docker pull.
- Uruchom pomyślnie kontener lokalny ze wszystkimi wymaganymi ustawieniami konfiguracji za pomocą polecenia docker run.
- Wywołaj punkt końcowy kontenera, uzyskując odpowiedź HTTP 2xx i odpowiedź JSON z powrotem.

Wszystkie zmienne w nawiasach kątowych , <>należy zastąpić własnymi wartościami. To zastąpienie obejmuje nawiasy kątowe.

Ważne

Kontener usługi LUIS wymaga pliku modelu .gz, który jest pobierany w czasie działania. Kontener musi mieć dostęp do tego pliku modelu za pośrednictwem zamontowanego woluminu w instancji kontenera. Aby przekazać plik modelu, wykonaj następujące kroki:

Utwórz udział plików platformy Azure. Zanotuj nazwę konta usługi Azure Storage, klucz oraz nazwę udziału plików, ponieważ będą potrzebne później.
wyeksportuj model usługi LUIS (spakowana aplikacja) z portalu usługi LUIS.
W witrynie Azure Portal przejdź do strony Przegląd zasobu konta magazynu i wybierz pozycję Udziały plików.
Wybierz nazwę niedawno utworzonego udziału plików, a następnie wybierz pozycję Przekaż. Następnie prześlij spakowaną aplikację.

Portal Azure
Interfejs wiersza polecenia platformy Azure

Tworzenie zasobu instancji kontenera platformy Azure przy użyciu Azure Portal

Przejdź do strony Tworzenie wystąpień kontenera.

Na zakładce Podstawowe wprowadź następujące szczegóły:

Ustawienie	Wartość
Subskrypcja	Wybierz subskrypcję.
Grupa zasobów	Wybierz dostępną grupę zasobów lub utwórz nową, taką jak `cognitive-services`.
Nazwa kontenera	Wprowadź nazwę, na przykład `cognitive-container-instance`. Nazwa musi być małymi literami.
Lokalizacja	Wybierz region do wdrożenia.
Typ obrazu	Jeśli obraz kontenera jest przechowywany w rejestrze kontenerów, który nie wymaga poświadczeń, wybierz pozycję `Public`. Jeśli uzyskiwanie dostępu do obrazu kontenera wymaga poświadczeń, wybierz opcję `Private`. Zapoznaj się z repozytoriami kontenerów i obrazami, aby uzyskać szczegółowe informacje na temat tego, czy obraz kontenera jest `Public` czy `Private` ("wersja publiczna").
Nazwa obrazu	Wprowadź lokalizację kontenera usług AI platformy Azure. Lokalizacja jest używana jako argument polecenia `docker pull` . Zapoznaj się z repozytoriami kontenerów i obrazami, aby poznać dostępne nazwy obrazów i ich odpowiednie repozytoria. Nazwa obrazu musi być w pełni kwalifikowana, określając trzy części. Najpierw rejestr kontenerów, a następnie repozytorium, na koniec nazwę obrazu: `<container-registry>/<repository>/<image-name>`. Oto przykład: `mcr.microsoft.com/azure-cognitive-services/keyphrase` reprezentuje obraz wyodrębniania kluczowych fraz w rejestrze kontenerów Microsoft w repozytorium usług Azure AI. Kolejnym przykładem jest `containerpreview.azurecr.io/microsoft/cognitive-services-speech-to-text`, który reprezentuje obraz zamiany mowy na tekst w rejestrze kontenerów Microsoft, wersji zapoznawczej kontenera.
Typ systemu operacyjnego	`Linux`
Rozmiar	Zmień rozmiar sugerowanych zaleceń dla określonego kontenera usługi Azure AI: 2 rdzenie CPU 4 GB

Na karcie Sieć wprowadź następujące szczegóły:

Ustawienie Wartość

Porty Ustaw port TCP na 5000. Uwidacznia kontener na porcie 5000.

Ustawienie	Wartość
Porty	Ustaw port TCP na `5000`. Uwidacznia kontener na porcie 5000.

Na karcie Zaawansowane wprowadź wymagane zmienne środowiskowe dla ustawień rozliczeń kontenera zasobu Azure Container Instance:

Klucz	Wartość
`ApiKey`	Skopiowane ze strony Klucze i punkt końcowy zasobu. Jest to ciąg 84 znaków alfanumerycznych bez spacji ani kreski, `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`.
`Billing`	Adres URL punktu końcowego skopiowany ze strony Kluczy i punktów końcowych zasobu.
`Eula`	`accept`

Wybierz Przejrzyj i utwórz
Po zakończeniu weryfikacji kliknij przycisk Utwórz , aby zakończyć proces tworzenia
Po pomyślnym wdrożeniu zasobu jest gotowy

Tworzenie zasobu usługi Azure Container Instance z poziomu interfejsu wiersza polecenia platformy Azure

Przed uruchomieniem poleceń w tym artykule należy najpierw zainstalować interfejs wiersza polecenia platformy Azure.

Poniższy kod YAML definiuje zasób usługi Azure Container Instance. Skopiuj i wklej zawartość do nowego pliku o nazwie my-aci.yaml i zamień wartości w komentarzach na własne. Odwołaj się do formatu szablonu dla prawidłowego YAML. Zapoznaj się z repozytoriami kontenerów i obrazami, aby poznać dostępne nazwy obrazów i ich odpowiednie repozytoria. Aby uzyskać więcej informacji odnośnie odniesienia YAML dla wystąpień kontenerów, zobacz Odniesienie YAML: 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

Uwaga

Nie wszystkie lokalizacje mają taką samą dostępność CPU i pamięci. Zapoznaj się z tabelą lokalizacji i zasobów , aby uzyskać listę dostępnych zasobów dla kontenerów na lokalizację i system operacyjny.

Będziemy polegać na pliku YAML, który utworzyliśmy dla polecenia az container create. W Azure CLI wykonaj polecenie az container create, zastępując <resource-group> własną wartością. Ponadto w przypadku zabezpieczania wartości we wdrożeniu YAML należy zapoznać się z bezpiecznymi wartościami.

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

Dane wyjściowe polecenia to Running..., jeśli są prawidłowe, a po pewnym czasie zmienią się na ciąg JSON reprezentujący nowo utworzony zasób ACI. Obraz kontenera prawdopodobnie będzie niedostępny przez jakiś czas, ale zasób został już wdrożony.

Napiwek

Zwróć szczególną uwagę na lokalizacje usług Azure AI w publicznej wersji zapoznawczej, ponieważ kod YAML będzie musiał odpowiednio dostosować się do lokalizacji.

Wybierz pozycję Przegląd i skopiuj adres IP. Będzie to numeryczny adres IP, taki jak 55.55.55.55.
Otwórz nową kartę przeglądarki i użyj adresu IP, na przykład http://<IP-address>:5000 (http://55.55.55.55:5000). Zostanie wyświetlona strona główna kontenera z informacją, że kontener jest uruchomiony.
Wybierz Opis interfejsu API usługi, aby wyświetlić stronę Swagger dla kontenera.
Wybierz dowolny z interfejsów API POST i wybierz pozycję Wypróbuj. Parametry są wyświetlane wraz z danymi wejściowymi. Wypełnij parametry.
Wybierz opcję Wykonaj, aby wysłać żądanie do wystąpienia kontenera.

Pomyślnie utworzyłeś i użyłeś kontenerów Azure AI w usłudze Azure Container Instance.

Sprawdzanie, czy kontener jest uruchomiony

Istnieje kilka sposobów sprawdzania, czy kontener jest uruchomiony. Znajdź zewnętrzny adres IP i uwidoczniony port danego kontenera i otwórz ulubioną przeglądarkę internetową. Użyj różnych adresów URL żądań poniżej, aby sprawdzić, czy kontener jest uruchomiony. Przykładowe adresy URL żądań wymienione w tym miejscu to http://localhost:5000, ale określony kontener może się różnić. Upewnij się, że korzystasz z zewnętrznego adresu IP kontenera i uwidocznij port.

Adres URL żądania	Cel
`http://localhost:5000/`	Kontener zawiera stronę główną.
`http://localhost:5000/ready`	Żądany przy użyciu polecenia GET ten adres URL zapewnia weryfikację, że kontener jest gotowy do akceptowania zapytania względem modelu. To żądanie może służyć do sond żywotności i gotowości Kubernetes.
`http://localhost:5000/status`	Ten adres URL, żądany również metodą GET, sprawdza, czy klucz API używany do uruchamiania kontenera jest prawidłowy, bez wywoływania zapytania do interfejsu API. To żądanie może służyć do sond żywotności i gotowości platformy Kubernetes.
`http://localhost:5000/swagger`	Kontener zawiera pełen zestaw dokumentacji dla punktów końcowych oraz funkcję Wypróbuj. Dzięki tej funkcji możesz wprowadzić ustawienia w formularzu HTML opartym na sieci Web i utworzyć zapytanie bez konieczności pisania kodu. Po powrocie zapytania zostanie udostępnione przykładowe polecenie CURL, aby zademonstrować wymagane nagłówki HTTP i format treści.

Strona główna kontenera

Uwaga

Jeśli używasz kontenera dla Analizy tekstu dla zdrowia, użyj następującego adresu URL do przesyłania zapytań: http://localhost:5000/text/analytics/v3.2-preview.1/entities/health

Udostępnij za pośrednictwem