Belge Yönetim Bilgileri kapsayıcılarını yapılandırma
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:
- REST API
2022-08-31 (GA)
- REST API
2023-07-31 (GA)
- İstemci kitaplıklarını hedefleme
REST API 2022-08-31 (GA)
- İstemci kitaplıklarını hedefleme
REST API 2023-07-31 (GA)
✔️ Desteklenen kapsayıcı belgeleri için bkz . Belge Yönetim Bilgileri v3.0 kapsayıcılarını yapılandırma.
Bu içerik şunlar için geçerlidir: v3.0 (GA) v3.1 (GA)
Belge Yönetim Bilgileri kapsayıcılarıyla, hem güçlü bulut özelliklerinden hem de uç yerelliğinden yararlanmak için iyileştirilmiş bir uygulama mimarisi oluşturabilirsiniz. Kapsayıcılar, şirket içinde ve bulutta kolayca dağıtabileceğiniz minimalist, yalıtılmış bir ortam sağlar. Bu makalede, komut bağımsız değişkenlerini kullanarak Belge Yönetim Bilgileri kapsayıcısı çalışma zamanı ortamını yapılandırmayı docker compose
göstereceğiz. Belge Yönetim Bilgileri özellikleri yedi Belge Yönetim Bilgileri özellik kapsayıcısı tarafından desteklenir: Okuma, Düzen, Kartvizit,Kimlik Belgesi, Makbuz, Fatura, Özel. Bu kapsayıcıların hem gerekli hem de isteğe bağlı ayarları vardır. Birkaç örnek için Örnek docker-compose.yml dosyası bölümüne bakın.
Yapılandırma ayarları
Her kapsayıcı aşağıdaki yapılandırma ayarlarına sahiptir:
Zorunlu | Ayar | Purpose |
---|---|---|
Yes | Anahtar | Fatura bilgilerini izler. |
Yes | Faturalandırma | Azure'daki hizmet kaynağının uç nokta URI'sini belirtir. Daha fazla bilgi için bkz. Faturalama. Daha fazla bilgi ve bölgesel uç noktaların tam listesi için bkz. Azure AI hizmetleri için özel alt etki alanı adları. |
Yes | Eula | Kapsayıcının lisansını kabul ettiğinizi gösterir. |
Hayır | ApplicationInsights | Kapsayıcınız için Azure Uygulaması Lication Insights müşteri desteği eklenmesini sağlar. |
Hayır | Fluentd | Günlük ve isteğe bağlı olarak ölçüm verilerini Fluentd sunucusuna yazar. |
Hayır | HTTP Ara Sunucusu | Giden istekler yapmak için bir HTTP ara sunucusu yapılandırılır. |
Hayır | Günlüğe kaydetme | Kapsayıcınız için ASP.NET Core günlük kaydı desteği sağlar. |
Önemli
Key
, Billing
ve Eula
ayarları birlikte kullanılır. Üç ayar için de geçerli değerler sağlamanız gerekir; aksi takdirde kapsayıcılarınız başlatılmaz. Kapsayıcı örneği oluşturmak için bu yapılandırma ayarlarını kullanma hakkında daha fazla bilgi için bkz . Faturalama.
Anahtar ve Faturalama yapılandırma ayarı
ayarı, Key
kapsayıcının faturalama bilgilerini izlemek için kullanılan Azure kaynak anahtarını belirtir. Anahtar değeri, "Faturalama yapılandırma ayarı" bölümünde belirtilen kaynak için Billing
geçerli bir anahtar olmalıdır.
ayarı, Billing
Azure'daki kaynağın kapsayıcının faturalama bilgilerini ölçerken kullanılan uç nokta URI'sini belirtir. Bu yapılandırma ayarının değeri, Azure'daki bir kaynak için geçerli bir uç nokta URI'si olmalıdır. Kapsayıcı yaklaşık 10-15 dakikada bir kullanımı bildirir.
Bu ayarları Azure portalında Anahtarlar ve Uç Nokta sayfasında bulabilirsiniz.
EULA
ayar
Eula
ayarı, kapsayıcının lisansını kabul ettiğinizi gösterir. Bu yapılandırma ayarı için bir değer belirtmelisiniz ve değeri olarak ayarlanmalıdır accept
.
Zorunlu | Veri Akışı Adı | Veri türü | Açıklama |
---|---|---|---|
Yes | Eula |
String | Lisans kabulü Örnek: Eula=accept |
Azure yapay zeka hizmetleri kapsayıcıları, Azure kullanımınızı yöneten sözleşmeniz kapsamında lisanslandırılır. Azure kullanımınızı yöneten mevcut bir sözleşmeniz yoksa, Azure kullanımını düzenleyen sözleşmenizin, Çevrimiçi Hizmetler Koşulları'nı içeren Microsoft Çevrimiçi Abonelik Sözleşmesi olduğunu kabul edersiniz. Önizlemeler için Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları'nı da kabul edersiniz. Kapsayıcıyı kullanarak bu koşulları kabul etmiş olursunuz.
ApplicationInsights ayarı
Bu ApplicationInsights
ayar kapsayıcınıza Azure Uygulaması lication Insights telemetri desteği eklemenize olanak tanır. Application Insights kapsayıcınızın derinlemesine izlenmesini sağlar. Kullanılabilirlik, performans ve kullanım için kapsayıcınızı kolayca izleyebilirsiniz. Ayrıca kapsayıcınızdaki hataları hızla belirleyebilir ve tanılayabilirsiniz.
Aşağıdaki tabloda, bölümü altında ApplicationInsights
desteklenen yapılandırma ayarları açıklanmaktadır.
Zorunlu | Veri Akışı Adı | Veri türü | Açıklama |
---|---|---|---|
Hayır | InstrumentationKey |
String | Kapsayıcı için telemetri verilerinin gönderildiği Application Insights örneğinin izleme anahtarı. Daha fazla bilgi için bkz . ASP.NET Core için Application Insights. Örnek: InstrumentationKey=123456789 |
Fluentd ayarları
Fluentd, birleşik günlük kaydı için açık kaynak bir veri toplayıcıdır. Ayarlar kapsayıcının Fluentd
Fluentd sunucusuyla bağlantısını yönetir. Kapsayıcı, kapsayıcınızın fluentd sunucusuna günlükleri ve isteğe bağlı olarak ölçüm verilerini yazmasına olanak tanıyan bir Fluentd günlük sağlayıcısı içerir.
Aşağıdaki tabloda, bölümü altında Fluentd
desteklenen yapılandırma ayarları açıklanmaktadır.
Veri Akışı Adı | Veri türü | Açıklama |
---|---|---|
Host |
String | Fluentd sunucusunun IP adresi veya DNS ana bilgisayar adı. |
Port |
Tamsayı | Fluentd sunucusunun bağlantı noktası. Varsayılan değer 24224'dür. |
HeartbeatMs |
Tamsayı | Milisaniye cinsinden sinyal aralığı. Bu süre dolmadan önce hiçbir olay trafiği gönderilmediyse Fluentd sunucusuna bir sinyal gönderilir. Varsayılan değer 60000 milisaniyedir (1 dakika). |
SendBufferSize |
Tamsayı | Gönderme işlemleri için ayrılan bayt cinsinden ağ arabelleği alanı. Varsayılan değer 32768 bayttır (32 kilobayt). |
TlsConnectionEstablishmentTimeoutMs |
Tamsayı | Fluentd sunucusuyla SSL/TLS bağlantısı kurmak için milisaniye cinsinden zaman aşımı. Varsayılan değer 10000 milisaniyedir (10 saniye). false olarak ayarlanırsa UseTLS , bu değer yoksayılır. |
UseTLS |
Boolean | Kapsayıcının Fluentd sunucusuyla iletişim kurmak için SSL/TLS kullanıp kullanmayacağını gösterir. Varsayılan değer olarak yanlış kullanılır. |
HTTP proxy kimlik bilgileri ayarları
Giden istekler yapmak için bir HTTP ara sunucusu yapılandırmanız gerekiyorsa, şu iki bağımsız değişkeni kullanın:
Veri Akışı Adı | Veri türü | Açıklama |
---|---|---|
HTTP_PROXY | Dize | Kullanılacak ara sunucu, örneğin, http://proxy:8888 <proxy-url> |
HTTP_PROXY_CREDS | Dize | Proxy'de kimlik doğrulaması yapmak için gereken tüm kimlik bilgileri, örneğin, username:password . Bu değer küçük harfle yazılmalıdır. |
<proxy-user> |
Dize | Ara sunucu için kullanıcı. |
<proxy-password> |
Dize | Ara sunucu için ile <proxy-user> ilişkilendirilmiş parola. |
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
HTTP_PROXY=<proxy-url> \
HTTP_PROXY_CREDS=<proxy-user>:<proxy-password> \
Günlüğe kaydetme ayarları
Ayarlar Logging
, kapsayıcınız için ASP.NET Core günlük desteğini yönetir. Kapsayıcınız için bir ASP.NET Core uygulaması için kullandığınız yapılandırma ayarlarını ve değerlerini kullanabilirsiniz.
Aşağıdaki günlük sağlayıcıları kapsayıcı tarafından desteklenir:
Provider | Purpose |
---|---|
Konsol | ASP.NET Core Console günlük sağlayıcısı. Bu günlük sağlayıcısı için tüm ASP.NET Core yapılandırma ayarları ve varsayılan değerler desteklenir. |
Hata Ayıklama | ASP.NET Core Debug günlük sağlayıcısı. Bu günlük sağlayıcısı için tüm ASP.NET Core yapılandırma ayarları ve varsayılan değerler desteklenir. |
Disk | JSON günlük sağlayıcısı. Bu günlük sağlayıcısı günlük verilerini çıkış bağlamasına yazar. |
Bu kapsayıcı komutu, günlük bilgilerini JSON biçiminde çıkış bağlamasına depolar:
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Disk:Format=json \
Mounts:Output=/output
Bu kapsayıcı komutu, kapsayıcı çalışırken ile ön ekli dbug
hata ayıklama bilgilerini gösterir:
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Console:LogLevel:Default=Debug
Disk günlüğü
Günlük Disk
sağlayıcısı aşağıdaki yapılandırma ayarlarını destekler:
Veri Akışı Adı | Veri türü | Açıklama |
---|---|---|
Format |
String | Günlük dosyalarının çıkış biçimi. Not: Günlük sağlayıcısını json etkinleştirmek için bu değer olarak ayarlanmalıdır. Bu değer kapsayıcı örneği oluşturulurken çıkış bağlaması belirtilmeden belirtilirse bir hata oluşur. |
MaxFileSize |
Tamsayı | Günlük dosyasının megabayt (MB) cinsinden en büyük boyutu. Geçerli günlük dosyasının boyutu bu değeri karşıladığında veya aştığında, günlük sağlayıcısı tarafından yeni bir günlük dosyası başlatılır. -1 belirtilirse, günlük dosyasının boyutu yalnızca çıktı bağlaması için en büyük dosya boyutuyla (varsa) sınırlıdır. Varsayılan değer 1 şeklindedir. |
ASP.NET Core günlük kaydını yapılandırma hakkında daha fazla bilgi için bkz . Ayarlar dosya yapılandırması.
Ses düzeyi ayarları
Kapsayıcıya ve kapsayıcıdan veri okumak ve yazmak için birimleri kullanın. Birimler, Docker kapsayıcıları tarafından oluşturulan ve kullanılan verileri kalıcı hale getirmede tercih edilir. seçeneğini ve belirterek volumes
(bağlama), (klasörün yolu) source
ve type
target
(dosya yolu parametresi) bir giriş bağlaması veya çıkış bağlaması belirtebilirsiniz.
Belge Yönetim Bilgileri kapsayıcısı bir giriş birimi ve bir çıkış birimi gerektirir. Giriş birimi salt okunur olabilir ()ro
ve eğitim ve puanlama için kullanılan verilere erişmek için gereklidir. Çıkış biriminin yazılabilir olması gerekir ve modelleri ve geçici verileri depolamak için bunu kullanırsınız.
Konak birimi konumunun tam söz dizimi, konak işletim sistemine bağlı olarak değişir. Ayrıca, Docker hizmet hesabı izinleri ile konak bağlama konumu izinleri arasındaki çakışma nedeniyle ana bilgisayarın birim konumuna erişilemiyor olabilir.
Örnek docker-compose.yml dosyası
Docker compose yöntemi üç adımdan oluşturulur:
- Dockerfile oluşturun.
- Yalıtılmış bir ortamda birlikte çalıştırılabilmeleri için hizmetleri bir docker-compose.yml tanımlayın.
- Hizmetlerinizi başlatmak ve çalıştırmak için komutunu çalıştırın
docker-compose up
.
Tek kapsayıcı örneği
Bu örnekte, Düzen kapsayıcı örneğiniz için {FORM_RECOGNIZER_ENDPOINT_URI} ve {FORM_RECOGNIZER_KEY} değerlerini girin.
Düzen kapsayıcısı
version: "3.9"
services:
azure-cognitive-service-layout:
container_name: azure-cognitive-service-layout
image: mcr.microsoft.com/azure-cognitive-services/form-recognizer/layout
environment:
- EULA=accept
- billing={FORM_RECOGNIZER_ENDPOINT_URI}
- key={FORM_RECOGNIZER_KEY}
ports:
- "5000"
networks:
- ocrvnet
networks:
ocrvnet:
driver: bridge
Birden çok kapsayıcı örneği
Makbuz ve OCR Okuma kapsayıcıları
Bu örnekte, Alındı kapsayıcınız için {FORM_RECOGNIZER_ENDPOINT_URI} ve {FORM_RECOGNIZER_KEY} değerlerini ve Azure AI Vision Okuma kapsayıcınız için {COMPUTER_VISION_ENDPOINT_URI} ve {COMPUTER_VISION_KEY} değerlerini girin.
version: "3"
services:
azure-cognitive-service-receipt:
container_name: azure-cognitive-service-receipt
image: cognitiveservicespreview.azurecr.io/microsoft/cognitive-services-form-recognizer-receipt:2.1
environment:
- EULA=accept
- billing={FORM_RECOGNIZER_ENDPOINT_URI}
- key={FORM_RECOGNIZER_KEY}
- AzureCognitiveServiceReadHost=http://azure-cognitive-service-read:5000
ports:
- "5000:5050"
networks:
- ocrvnet
azure-cognitive-service-read:
container_name: azure-cognitive-service-read
image: mcr.microsoft.com/azure-cognitive-services/vision/read:3.2
environment:
- EULA=accept
- billing={COMPUTER_VISION_ENDPOINT_URI}
- key={COMPUTER_VISION_KEY}
networks:
- ocrvnet
networks:
ocrvnet:
driver: bridge