Docker Compose kullanarak birden çok kapsayıcı dağıtma

Bu makalede birden çok Azure Bilişsel Hizmetler kapsayıcısını dağıtma adımları gösterilmektedir. Özellikle, birden çok Docker kapsayıcı görüntüsünü düzenlemek için Docker Compose'u kullanmayı öğreneceksiniz.

Docker Compose , çok kapsayıcılı Docker uygulamalarını tanımlamaya ve çalıştırmaya yönelik bir araçtır. Oluştur'da, uygulamanızın hizmetlerini yapılandırmak için bir YAML dosyası kullanırsınız. Ardından, tek bir komut çalıştırarak yapılandırmanızdan tüm hizmetleri oluşturup başlatırsınız.

Tek bir konak bilgisayarda birden çok kapsayıcı görüntüsü düzenlemek yararlı olabilir. Bu makalede, Okuma ve Form Tanıma kapsayıcılarını bir araya getireceğiz.

Önkoşullar

Bu yordam, yerel olarak yüklenmesi ve çalıştırılması gereken birkaç araç gerektirir:

  • Azure aboneliği. Aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
  • Docker Altyapısı. Docker CLI'nın bir konsol penceresinde çalıştığını onaylayın.
  • Doğru fiyatlandırma katmanına sahip bir Azure kaynağı. Bu kapsayıcıyla yalnızca aşağıdaki fiyatlandırma katmanları çalışır:
    • Kaynağı yalnızca F0 veya Standart fiyatlandırma katmanıyla Görüntü İşleme.
    • Kaynağı yalnızca F0 veya Standart fiyatlandırma katmanıyla Form Tanıma.
    • S0 fiyatlandırma katmanına sahip Bilişsel Hizmetler kaynağı.
  • Geçitli önizleme kapsayıcısı kullanıyorsanız, kullanmak için çevrimiçi istek formunu tamamlamanız gerekir.

Docker Compose dosyası

YAML dosyası dağıtılacak tüm hizmetleri tanımlar. Bu hizmetler bir veya var olan bir DockerFile kapsayıcı görüntüsünü kullanır. Bu örnekte iki önizleme görüntüsü kullanacağız. Aşağıdaki YAML dosyasını kopyalayıp yapıştırın ve docker-compose.yaml olarak kaydedin. Dosyada uygun apikey, faturalama ve EndpointUri değerlerini sağlayın.

version: '3.7'
services:
  forms:
    image: "mcr.microsoft.com/azure-cognitive-services/form-recognizer/layout"
    environment:
       eula: accept
       billing: # < Your form recognizer billing URL >
       apikey: # < Your form recognizer API key >
       FormRecognizer__ComputerVisionApiKey: # < Your form recognizer API key >
       FormRecognizer__ComputerVisionEndpointUri: # < Your form recognizer URI >
    volumes:
       - type: bind
         source: E:\publicpreview\output
         target: /output
       - type: bind
         source: E:\publicpreview\input
         target: /input
    ports:
      - "5010:5000"

  ocr:
    image: "mcr.microsoft.com/azure-cognitive-services/vision/read:3.1-preview"
    environment:
      eula: accept
      apikey: # < Your computer vision API key >
      billing: # < Your computer vision billing URL >
    ports:
      - "5021:5000"

Önemli

Konak makinede birimler düğümü altında belirtilen dizinleri oluşturun. Birim bağlamalarını kullanarak bir görüntüyü bağlamayı denemeden önce dizinlerin mevcut olması gerektiğinden bu yaklaşım gereklidir.

Yapılandırılmış Docker Compose hizmetlerini başlatma

Docker Compose dosyası, tanımlı bir hizmetin yaşam döngüsündeki tüm aşamaların yönetilmesini sağlar: hizmetleri başlatma, durdurma ve yeniden oluşturma; hizmet durumunu görüntüleme; ve günlük akışı. Proje dizininden (docker-compose.yaml dosyasının bulunduğu) bir komut satırı arabirimi açın.

Not

Hataları önlemek için ana makinenin Docker Altyapısı ile sürücüleri doğru paylaştığından emin olun. Örneğin, docker-compose.yaml dosyasında dizin olarak E:\publicpreview kullanılıyorsa, E sürücüsünü Docker ile paylaşın.

Komut satırı arabiriminden aşağıdaki komutu yürüterek docker-compose.yaml dosyasında tanımlanan tüm hizmetleri başlatın (veya yeniden başlatın):

docker-compose up

Docker bu yapılandırmayı kullanarak docker-compose up komutunu ilk kez yürüttüğünde , hizmetler düğümü altında yapılandırılan görüntüleri çeker ve ardından bunları indirip bağlar:

Pulling forms (mcr.microsoft.com/azure-cognitive-services/form-recognizer/layout:)...
latest: Pulling from azure-cognitive-services/form-recognizer/layout
743f2d6c1f65: Pull complete
72befba99561: Pull complete
2a40b9192d02: Pull complete
c7715c9d5c33: Pull complete
f0b33959f1c4: Pull complete
b8ab86c6ab26: Pull complete
41940c21ed3c: Pull complete
e3d37dd258d4: Pull complete
cdb5eb761109: Pull complete
fd93b5f95865: Pull complete
ef41dcbc5857: Pull complete
4d05c86a4178: Pull complete
34e811d37201: Pull complete
Pulling ocr (mcr.microsoft.com/azure-cognitive-services/vision/read:3.1-preview:)...
latest: Pulling from /azure-cognitive-services/vision/read:3.1-preview
f476d66f5408: Already exists
8882c27f669e: Already exists
d9af21273955: Already exists
f5029279ec12: Already exists
1a578849dcd1: Pull complete
45064b1ab0bf: Download complete
4bb846705268: Downloading [=========================================>         ]  187.1MB/222.8MB
c56511552241: Waiting
e91d2aa0f1ad: Downloading [==============================================>    ]  162.2MB/176.1MB

Görüntüler indirildikten sonra görüntü hizmetleri başlatılır:

Starting docker_ocr_1   ... done
Starting docker_forms_1 ... doneAttaching to docker_ocr_1, docker_forms_1forms_1  | forms_1  | forms_1  | Notice: This Preview is made available to you on the condition that you agree to the Supplemental Terms of Use for Microsoft Azure Previews [https://go.microsoft.com/fwlink/?linkid=2018815], which supplement your agreement [https://go.microsoft.com/fwlink/?linkid=2018657] governing your use of Azure. If you do not have an existing agreement governing your use of Azure, you agree that your agreement governing use of Azure is the Microsoft Online Subscription Agreement [https://go.microsoft.com/fwlink/?linkid=2018755] (which incorporates the Online Services Terms [https://go.microsoft.com/fwlink/?linkid=2018760]). By using the Preview you agree to these terms.
forms_1  | 
forms_1  | 
forms_1  | Using '/input' for reading models and other read-only data.
forms_1  | Using '/output/forms/812d811d1bcc' for writing logs and other output data.
forms_1  | Logging to console.
forms_1  | Submitting metering to 'https://westus2.api.cognitive.microsoft.com/'.
forms_1  | WARNING: No access control enabled!
forms_1  | warn: Microsoft.AspNetCore.Server.Kestrel[0]
forms_1  |       Overriding address(es) 'http://+:80'. Binding to endpoints defined in UseKestrel() instead.
forms_1  | Hosting environment: Production
forms_1  | Content root path: /app/forms
forms_1  | Now listening on: http://0.0.0.0:5000
forms_1  | Application started. Press Ctrl+C to shut down.
ocr_1    | 
ocr_1    | 
ocr_1    | Notice: This Preview is made available to you on the condition that you agree to the Supplemental Terms of Use for Microsoft Azure Previews [https://go.microsoft.com/fwlink/?linkid=2018815], which supplement your agreement [https://go.microsoft.com/fwlink/?linkid=2018657] governing your use of Azure. If you do not have an existing agreement governing your use of Azure, you agree that your agreement governing use of Azure is the Microsoft Online Subscription Agreement [https://go.microsoft.com/fwlink/?linkid=2018755] (which incorporates the Online Services Terms [https://go.microsoft.com/fwlink/?linkid=2018760]). By using the Preview you agree to these terms.
ocr_1    |
ocr_1    | 
ocr_1    | Logging to console.
ocr_1    | Submitting metering to 'https://westcentralus.api.cognitive.microsoft.com/'.
ocr_1    | WARNING: No access control enabled!
ocr_1    | Hosting environment: Production
ocr_1    | Content root path: /
ocr_1    | Now listening on: http://0.0.0.0:5000
ocr_1    | Application started. Press Ctrl+C to shut down.

Hizmet kullanılabilirliğini doğrulama

İpucu

İndirilen kapsayıcı görüntülerinizi listelemek için docker images komutunu kullanabilirsiniz. Örneğin, aşağıdaki komut indirilen her kapsayıcı görüntüsünün kimliğini, deposunu ve etiketini tablo olarak biçimlendirilmiş olarak listeler:

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

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

Aşağıda bazı örnek çıktılar verilmiştir:

IMAGE ID            REPOSITORY                                                                 TAG
2ce533f88e80        mcr.microsoft.com/azure-cognitive-services/form-recognizer/layout          latest
4be104c126c5        mcr.microsoft.com/azure-cognitive-services/vision/read:3.1-preview         latest

Test kapsayıcıları

Ana bilgisayar makinesinde bir tarayıcı açın ve docker-compose.yaml dosyasından belirtilen bağlantı noktasını kullanarak localhost'a gidin, örneğinhttp://localhost:5021/swagger/index.html. Örneğin, Form Tanıma uç noktasını test etmek için API'deki Deneyin özelliğini kullanabilirsiniz. Her iki kapsayıcı swagger sayfası da kullanılabilir ve test edilebilir olmalıdır.

Form Recognizer Container

Sonraki adımlar

Bilişsel Hizmetler kapsayıcıları