Bağlantısı kesilmiş (çevrimdışı) ortamlardaki kapsayıcılar

Makale
09/01/2024

Kapsayıcılar için destek şu anda tüm modeller ve Okuma, Düzen, Fatura, Makbuz ve 2023-07-31 (GA) Kimlik Belgesi modelleri için Belge Yönetim Bilgileri sürümüyle 2022-08-31 (GA) kullanılabilir:

✔️ Desteklenen kapsayıcı belgeleri için bağlantısız ortamlardaKi Belge Zekası v3.0 kapsayıcıları bölümüne bakın.

Bu içerik şunlar için geçerlidir: v3.0 (GA) v3.1 (GA)

Bağlantısı kesilmiş kapsayıcılar nelerdir?

Azure AI kapsayıcıları , bazı Belge Zekası hizmetlerini kapsayıcılarda yerel olarak çalıştırma esnekliği sağlar. Bağlı kapsayıcılar ortamınızda yerel olarak çalışır ve kullanım bilgilerini faturalama için buluta gönderir. Bağlantısı kesilmiş kapsayıcılar, kapsayıcıların çalışması için bulutla bağlantının gerekli olmadığı senaryolara yöneliktir.

Azure AI Belge Zekası kapsayıcıları, Belge Zekası API'lerini kapsayıcılaştırmanın avantajlarıyla kullanmanıza olanak sağlar. Bağlantısız kapsayıcılar, kullandıkça öde fiyatlandırmasına kıyasla indirimli fiyatla sunulan taahhüt katmanı fiyatlandırması aracılığıyla sunulur. Taahhüt katmanı fiyatlandırmasıyla, iş yükünüzün gereksinimlerine göre tahmin edilebilir bir toplam maliyetle sabit bir ücret karşılığında Belge Yönetim Bilgileri özelliklerini kullanmayı taahhüt edebilirsiniz.

Kullanmaya başlayın

Docker kapsayıcısını çevrimdışı bir ortamda çalıştırmayı denemeden önce, kapsayıcıyı başarıyla indirmek ve kullanmak için aşağıdaki gereksinimleri bildiğinizden emin olun:

Bilgisayar gereksinimlerini ve önerilerini barındır.
Kapsayıcıyı indirmek için Docker pull komutu.
Kapsayıcının çalıştığını doğrulama.
Çalıştırıldıktan sonra kapsayıcının uç noktasına sorgu gönderme.

Bağlantısız ortamlarda kapsayıcıları kullanmak için erişim isteme

Bağlantısız ortamlarda Belge Yönetim Bilgileri kapsayıcılarını kullanabilmeniz için önce bir istek formu doldurup göndermeniz ve bir taahhüt planı satın almalısınız.

Azure portalında yeni kaynak oluşturma

Portalda yeni bir kaynak sağlayarak başlayın.

Fiyatlandırma katmanı seçeneğini belirlediğinizden Commitment tier disconnected containers DC0 emin olun
En az bir özel, okuma veya önceden oluşturulmuş taahhüt katmanından uygun fiyatlandırma katmanını seçin

Kapsayıcı	En Küçük	Önerilen	Taahhüt planı
`Read`	`8` çekirdekler, 10 GB bellek	`8` çekirdekler, 24 GB bellek	`OCR` (Okuma)
`Layout`	`8` çekirdekler, 16 GB bellek	`8` çekirdekler, 24 GB bellek	Önceden oluşturulmuş
`Business Card`	`8` çekirdekler, 16 GB bellek	`8` çekirdekler, 24 GB bellek	Önceden oluşturulmuş
`General Document`	`8` çekirdekler, 12 GB bellek	`8` çekirdekler, 24 GB bellek	Önceden oluşturulmuş
`ID Document`	`8` çekirdekler, 8 GB bellek	`8` çekirdekler, 24 GB bellek	Önceden oluşturulmuş
`Invoice`	`8` çekirdekler, 16 GB bellek	`8` çekirdekler, 24 GB bellek	Önceden oluşturulmuş
`Receipt`	`8` çekirdekler, 11 GB bellek	`8` çekirdekler, 24 GB bellek	Önceden oluşturulmuş
`Custom Template`	`8` çekirdekler, 16 GB bellek	`8` çekirdekler, 24 GB bellek	Özel API

Gerekli parametreleri toplama

Tüm Azure AI hizmetlerinin kapsayıcıları için üç gerekli parametre vardır:

Son kullanıcı lisans sözleşmesi (EULA) kabul değeriyle mevcut olmalıdır.
Azure portalından kaynağınızın uç nokta URL'si.
Azure portalından kaynağınızın API anahtarı.

Bağlantı kesilen kullanım için yapılandırmak üzere kapsayıcıyı ilk kez çalıştırdığınızda hem uç nokta URL'si hem de API anahtarı gerekir. Anahtarı ve uç noktayı Azure portalında kaynağınızın Anahtar ve uç nokta sayfasında bulabilirsiniz:

Azure portalı anahtarları ve uç nokta sayfasının ekran görüntüsü.

Önemli

Anahtarınızı ve uç noktanızı yalnızca kapsayıcıyı bağlantısız bir ortamda çalışacak şekilde yapılandırmak için kullanırsınız. Kapsayıcıyı yapılandırdıktan sonra API istekleri göndermek için anahtar ve uç nokta değerlerine ihtiyacınız olmaz. Bunları, örneğin Azure Key Vault kullanarak güvenli bir şekilde depolayın. Bu işlem için yalnızca bir anahtar gereklidir.

ile Docker kapsayıcısı indirme `docker pull`

Bağlantısı kesilmiş bir ortamda çalışması onaylanan Docker kapsayıcısını indirin. Örneğin:

Docker çekme komutu	Değer	Biçimlendir
● ● `docker pull [image]` ● `docker pull [image]latest`	En son kapsayıcı görüntüsü.	● ● `mcr.microsoft.com/azure-cognitive-services/form-recognizer/layout-3.0:latest` ● `mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice-3.0:latest`

Örnek Docker çekme komutu

docker pull mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice:latest

Kapsayıcıyı bağlantısız bir ortamda çalıştırılacak şekilde yapılandırma

Bağlantısı kesilmiş kapsayıcı görüntüleri, bağlı kapsayıcılar ile aynıdır. Bağlantısı kesilmiş kapsayıcıların bir lisans dosyası gerektirmesi temel farktır. Bu lisans dosyası, kapsayıcı bağlı modda başlatılarak indirilir ve downloadLicense parametresi true olarak ayarlanır.

Kapsayıcınız indirildiğinden docker run , komutunu aşağıdaki parametreyle yürütmeniz gerekir:

DownloadLicense=True. Bu parametre, Docker kapsayıcınızın İnternet'e bağlı olmadığında çalışmasını sağlayan bir lisans dosyası indirir. Ayrıca, lisans dosyasının kapsayıcıyı çalıştırmak için geçersiz olduğu bir son kullanma tarihi de içerir. Lisans dosyasını yalnızca ilgili onaylanan kapsayıcıda kullanabilirsiniz.

Önemli

komutu, docker run kapsayıcıyı çalıştırmak için kullanabileceğiniz bir şablon oluşturur. Şablon, indirilen modeller ve yapılandırma dosyası için ihtiyacınız olan parametreleri içerir. Bu şablonu kaydettiğinizden emin olun.

Aşağıdaki örnekte, komutun yer tutucu değerlerle kullanılacak biçimlendirmesi docker run gösterilmektedir. Bu yer tutucu değerlerini kendi değerlerinizle değiştirin.

Yer tutucu	Değer	Biçim veya örnek
`{IMAGE}`	Kullanmak istediğiniz kapsayıcı görüntüsü.	`mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice`
`{LICENSE_MOUNT}`	Lisansın indirildiği ve bağlandığı yol.	`/host/license:/path/to/license/directory`
`{ENDPOINT_URI}`	Hizmet isteğinizin kimliğini doğrulamak için uç nokta. Kaynağınızın Anahtar ve uç nokta sayfasında, Azure portalında bulabilirsiniz.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{API_KEY}`	Belge Yönetim Bilgileri kaynağınızın anahtarı. Kaynağınızın Anahtar ve uç nokta sayfasında, Azure portalında bulabilirsiniz.	`{string}`
`{CONTAINER_LICENSE_DIRECTORY}`	Kapsayıcının yerel dosya sistemindeki lisans klasörünün konumu.	`/path/to/license/directory`

Örnek docker run komut


docker run --rm -it -p 5000:5050 \

-v {LICENSE_MOUNT} \

{IMAGE} \

eula=accept \

billing={ENDPOINT_URI} \

apikey={API_KEY} \

DownloadLicense=True \

Mounts:License={CONTAINER_LICENSE_DIRECTORY}

Aşağıdaki komutta, düzen kapsayıcısının lisans dosyasını indirmek için klasör yolu, faturalama uç noktası ve API anahtarı yer tutucularını değiştirin.

docker run -v {folder path}:/license --env Mounts:License=/license --env DownloadLicense=True --env Eula=accept --env Billing={billing endpoint} --env ApiKey={api key} mcr.microsoft.com/azure-cognitive-services/form-recognizer/layout-3.0:latest

Kapsayıcı yapılandırıldıktan sonra, kapsayıcıyı ortamınızda lisans ve uygun bellek ve CPU ayırmalarıyla çalıştırmak için sonraki bölümü kullanın.

Belge Yönetim Bilgileri kapsayıcı modelleri ve yapılandırması

Kapsayıcıyı yapılandırdıktan sonra, indirilen Belge Yönetim Bilgileri modelleri ve kapsayıcı yapılandırması değerleri oluşturulur ve kapsayıcı çıkışında görüntülenir.

Kapsayıcıyı bağlantısız bir ortamda çalıştırma

Lisans dosyasını indirdikten sonra lisansınız, uygun belleğiniz ve uygun CPU ayırmalarınızla kapsayıcıyı bağlantısı kesilmiş bir ortamda çalıştırabilirsiniz. Aşağıdaki örnekte, komutun yer tutucu değerleriyle biçimlendirmesi docker run gösterilmektedir. Bu yer tutucu değerlerini kendi değerlerinizle değiştirin.

Kapsayıcı her çalıştırıldığında, lisans dosyası kapsayıcıya bağlanmalıdır ve kapsayıcının yerel dosya sistemindeki lisans klasörünün konumu ile Mounts:License=belirtilmelidir. Ayrıca, faturalama kullanım kayıtlarının yazılabilmesi için bir çıkış bağlaması belirtilmelidir.

Yer tutucu	Değer	Biçim veya örnek
`{IMAGE}`	Kullanmak istediğiniz kapsayıcı görüntüsü.	`mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice`
`{MEMORY_SIZE}`	Kapsayıcınız için ayrılacak uygun bellek boyutu.	`4g`
`{NUMBER_CPUS}`	Kapsayıcınız için ayrılacak uygun CPU sayısı.	`4`
`{LICENSE_MOUNT}`	Lisansın bulunduğu ve bağlandığı yol.	`/host/license:/path/to/license/directory`
`{OUTPUT_PATH}`	Kullanım kayıtlarını günlüğe kaydetmek için çıkış yolu.	`/host/output:/path/to/output/directory`
`{CONTAINER_LICENSE_DIRECTORY}`	Kapsayıcının yerel dosya sistemindeki lisans klasörünün konumu.	`/path/to/license/directory`
`{CONTAINER_OUTPUT_DIRECTORY}`	Kapsayıcının yerel dosya sistemindeki çıkış klasörünün konumu.	`/path/to/output/directory`

Örnek docker run komut

docker run --rm -it -p 5000:5050 --memory {MEMORY_SIZE} --cpus {NUMBER_CPUS} \

-v {LICENSE_MOUNT} \

-v {OUTPUT_PATH} \

{IMAGE} \

eula=accept \

Mounts:License={CONTAINER_LICENSE_DIRECTORY}

Mounts:Output={CONTAINER_OUTPUT_DIRECTORY}

Bağlantısı kesilmiş bir kapsayıcıyı başlatmak, bağlı kapsayıcı başlatmaya benzer. Bağlantısı kesilmiş kapsayıcılar için ek lisans parametresi gerekir. Özel kapsayıcıyı bağlantısız modda başlatmak için örnek bir docker-compose.yml dosyası aşağıda verilmiştır. İndirilen lisans dosyasını içeren klasöre bir değere sahip CUSTOM_LICENSE_MOUNT_PATH ortam değişkenini ve OUTPUT_MOUNT_PATH kullanım günlüklerini barındıran klasöre ayarlanmış bir değere sahip ortam değişkenini ekleyin.

version: '3.3'
services:
 nginx:
  image: nginx:alpine
  container_name: reverseproxy
  volumes:
    - ${NGINX_CONF_FILE}:/etc/nginx/nginx.conf
  ports:
    - "5000:5050"
 layout:
  container_name: azure-cognitive-service-layout
  image: mcr.microsoft.com/azure-cognitive-services/form-recognizer/layout-3.0:latest
  environment:
    eula: accept
    apikey: ${FORM_RECOGNIZER_KEY}
    billing: ${FORM_RECOGNIZER_ENDPOINT_URI}
    Logging:Console:LogLevel:Default: Information
    SharedRootFolder: /shared
    Mounts:Shared: /shared
    Mounts:Output: /logs
    Mounts:License: /license
  volumes:
    - type: bind
      source: ${SHARED_MOUNT_PATH}
      target: /shared
    - type: bind
      source: ${OUTPUT_MOUNT_PATH}
      target: /logs
    - type: bind
      source: ${LAYOUT_LICENSE_MOUNT_PATH}
      target: /license
  expose:
    - "5000"

 custom-template:
  container_name: azure-cognitive-service-custom-template
  image: mcr.microsoft.com/azure-cognitive-services/form-recognizer/custom-template-3.0:latest
  restart: always
  depends_on:
    - layout
  environment:
    AzureCognitiveServiceLayoutHost: http://azure-cognitive-service-layout:5000
    eula: accept
    apikey: ${FORM_RECOGNIZER_KEY}
    billing: ${FORM_RECOGNIZER_ENDPOINT_URI}
    Logging:Console:LogLevel:Default: Information
    SharedRootFolder: /shared
    Mounts:Shared: /shared
    Mounts:Output: /logs
    Mounts:License: /license
  volumes:
    - type: bind
      source: ${SHARED_MOUNT_PATH}
      target: /shared
    - type: bind
      source: ${OUTPUT_MOUNT_PATH}
      target: /logs
    - type: bind
      source: ${CUSTOM_LICENSE_MOUNT_PATH}
      target: /license
  expose:
    - "5000"

 studio:
  container_name: form-recognizer-studio
  image: mcr.microsoft.com/azure-cognitive-services/form-recognizer/studio:3.0
  environment:
    ONPREM_LOCALFILE_BASEPATH: /onprem_folder
    STORAGE_DATABASE_CONNECTION_STRING: /onprem_db/Application.db
  volumes:
    - type: bind
      source: ${FILE_MOUNT_PATH} # path to your local folder
      target: /onprem_folder
    - type: bind
      source: ${DB_MOUNT_PATH} # path to your local folder
      target: /onprem_db
  ports:
    - "5001:5001"
  user: "1000:1000" # echo $(id -u):$(id -g)

Diğer parametreler ve komutlar

Kapsayıcıyı çalıştırmak için ihtiyacınız olan birkaç parametre ve komut daha aşağıdadır.

Kullanım kayıtları

Docker kapsayıcılarını bağlantısız bir ortamda çalıştırırken, kapsayıcı kullanım kayıtlarını zaman içinde toplandıkları bir birime yazar. Hizmet kullanımı hakkında bir rapor oluşturmak için rest API uç noktasını da çağırabilirsiniz.

Günlükleri depolamaya yönelik bağımsız değişkenler

Bağlantısı kesilmiş bir ortamda çalıştırıldığında, kullanım günlüklerini depolamak için kapsayıcıya bir çıkış bağlaması kullanılabilir olmalıdır. Örneğin, aşağıdaki örnekte ve Mounts:Output={OUTPUT_PATH} değerini günlüklerin depolandığı yol ile değiştirerek {OUTPUT_PATH} eklersiniz-v /host/output:{OUTPUT_PATH}:

docker run -v /host/output:{OUTPUT_PATH} ... <image> ... Mounts:Output={OUTPUT_PATH}

Kapsayıcı uç noktalarını kullanarak kayıtları alma

Kapsayıcı, kullanımıyla ilgili kayıtları döndürmek için iki uç nokta sağlar.

Tüm kayıtları alma

Aşağıdaki uç nokta, bağlı faturalama kaydı dizininde toplanan tüm kullanımı özetleyen bir rapor sağlar.

https://<service>/records/usage-logs/

Örnek HTTPS uç noktası

http://localhost:5000/records/usage-logs

Kullanım günlüğü uç noktası aşağıdaki örneğe benzer bir JSON yanıtı döndürür:

{
  "apiType": "string",
  "serviceName": "string",
  "meters": [
    {
      "name": "string",
      "quantity": 256345435
    }
  ]
}

Belirli bir ayın kayıtlarını alma

Aşağıdaki uç nokta, belirli bir ay ve yıl içindeki kullanımı özetleyen bir rapor sağlar.

https://<service>/records/usage-logs/{MONTH}/{YEAR}

Bu kullanım günlükleri uç noktası, aşağıdaki örneğe benzer bir JSON yanıtı döndürür:

{
  "apiType": "string",
  "serviceName": "string",
  "meters": [
    {
      "name": "string",
      "quantity": 56097
    }
  ]
}

Sorun giderme

Kapsayıcıyı bir çıkış bağlaması ve günlüğe kaydetme etkin olarak çalıştırın. Bu ayarlar kapsayıcının, kapsayıcıyı başlatırken veya çalıştırırken oluşan sorunları gidermeye yardımcı olan günlük dosyaları oluşturmasını sağlar.

İpucu

Daha fazla sorun giderme bilgisi ve kılavuzu için bkz . Bağlantısı kesilmiş kapsayıcılar Sık sorulan sorular (SSS).

Aracılığıyla paylaş

Bağlantısı kesilmiş (çevrimdışı) ortamlardaki kapsayıcılar

Bağlantısı kesilmiş kapsayıcılar nelerdir?

Kullanmaya başlayın

Bağlantısız ortamlarda kapsayıcıları kullanmak için erişim isteme

Azure portalında yeni kaynak oluşturma

Gerekli parametreleri toplama

ile Docker kapsayıcısı indirme `docker pull`

Kapsayıcıyı bağlantısız bir ortamda çalıştırılacak şekilde yapılandırma

Belge Yönetim Bilgileri kapsayıcı modelleri ve yapılandırması

Kapsayıcıyı bağlantısız bir ortamda çalıştırma

Diğer parametreler ve komutlar

Kullanım kayıtları

Günlükleri depolamaya yönelik bağımsız değişkenler

Kapsayıcı uç noktalarını kullanarak kayıtları alma

Tüm kayıtları alma

Belirli bir ayın kayıtlarını alma

Sorun giderme

Sonraki adımlar

Geri Bildirim

Ek kaynaklar

Aracılığıyla paylaş

Bağlantısı kesilmiş (çevrimdışı) ortamlardaki kapsayıcılar

Bağlantısı kesilmiş kapsayıcılar nelerdir?

Kullanmaya başlayın

Bağlantısız ortamlarda kapsayıcıları kullanmak için erişim isteme

Azure portalında yeni kaynak oluşturma

Gerekli parametreleri toplama

ile Docker kapsayıcısı indirme docker pull

Kapsayıcıyı bağlantısız bir ortamda çalıştırılacak şekilde yapılandırma

Belge Yönetim Bilgileri kapsayıcı modelleri ve yapılandırması

Kapsayıcıyı bağlantısız bir ortamda çalıştırma

Diğer parametreler ve komutlar

Kullanım kayıtları

Günlükleri depolamaya yönelik bağımsız değişkenler

Kapsayıcı uç noktalarını kullanarak kayıtları alma

Tüm kayıtları alma

Belirli bir ayın kayıtlarını alma

Sorun giderme

Sonraki adımlar

Geri Bildirim

Ek kaynaklar

ile Docker kapsayıcısı indirme `docker pull`