Kişisel Bilgiler (PII) Algılama kapsayıcılarını yükleme ve çalıştırma

Kapsayıcılar, PII algılama API'sini kendi altyapınızda barındırmanıza olanak tanır. UZAKTAN PII algılaması çağrılarak karşılanamaz güvenlik veya veri idaresi gereksinimleriniz varsa kapsayıcılar iyi bir seçenek olabilir.

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Önkoşullar

PII algılama kapsayıcılarını kullanmadan önce aşağıdaki önkoşulları karşılamanız gerekir.

• Azure aboneliğiniz yoksa ücretsiz hesap oluşturun.
• Docker bir ana bilgisayara yüklendi. Docker, kapsayıcıların Azure'a bağlanmasına ve faturalama verileri göndermesine izin verecek şekilde yapılandırılmalıdır.
  • Windows'da Docker,Linux kapsayıcılarını destekleyecek şekilde de yapılandırılmalıdır.
  • Docker kavramları hakkında temel bilgilere sahip olmanız gerekir.
• Dil kaynağı

Gerekli parametreleri toplama

Tüm Azure AI kapsayıcıları için üç birincil parametre gereklidir. Microsoft Yazılım Lisans Koşulları kabul değeriyle birlikte mevcut olmalıdır. Uç Nokta URI'si ve API anahtarı da gereklidir.

Uç nokta URI'si

Bu {ENDPOINT_URI} değere karşılık gelen Azure AI hizmetleri kaynağının Azure portalı genel bakış sayfasından ulaşabilirsiniz. Genel Bakış sayfasına gidin, uç noktanın üzerine gelin ve Panoya kopyala simgesi görüntülenir. Gerektiğinde uç noktayı kopyalayın ve kullanın.

Anahtarlar

Bu {API_KEY} değer kapsayıcıyı başlatmak için kullanılır ve ilgili Azure AI hizmetleri kaynağının Azure portalının Anahtarlar sayfasında kullanılabilir. Anahtarlar sayfasına gidin ve Panoya kopyala simgesini seçin.

Konak bilgisayar gereksinimleri ve önerileri

Konak, Docker kapsayıcısını çalıştıran x64 tabanlı bir bilgisayardır. Şirket içi bir bilgisayar veya Azure'da Docker barındırma hizmeti olabilir, örneğin:

• Azure Kubernetes Service.
• Azure Container Instances.
• Azure Stack'e dağıtılan bir Kubernetes kümesi. Daha fazla bilgi için bkz . Kubernetes'i Azure Stack'e dağıtma.

Aşağıdaki tabloda, kullanılabilir kapsayıcı için en düşük ve önerilen belirtimler açıklanmaktadır. Her CPU çekirdeği en az 2,6 gigahertz (GHz) veya daha hızlı olmalıdır.

En iyi deneyim (performans ve doğruluk) için AVX-512 yönerge kümesine sahip bir CPU'ya sahip olmanız önerilir.

CPU çekirdeği ve bellek, komutun --cpus bir parçası olarak kullanılan ve --memory ayarlarına docker run karşılık gelir.

ile kapsayıcı görüntüsünü alma docker pull

PII algılama kapsayıcı görüntüsü kapsayıcı kayıt defteri dağıtımında mcr.microsoft.com bulunabilir. Depoda azure-cognitive-services/textanalytics/ bulunur ve olarak adlandırılır pii. Tam kapsayıcı görüntüsü adı şu şekildedir: mcr.microsoft.com/azure-cognitive-services/textanalytics/pii

Kapsayıcının en son sürümünü kullanmak için İngilizce olan etiketini kullanabilirsiniz latest . MCR'de etiketleri kullanarak desteklenen diller için kapsayıcıların tam listesini de bulabilirsiniz.

En son PII algılama kapsayıcısı çeşitli dillerde kullanılabilir. İngilizce kapsayıcısının kapsayıcısını indirmek için aşağıdaki komutu kullanın.

docker pull mcr.microsoft.com/azure-cognitive-services/textanalytics/pii:latest

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

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

Kapsayıcıyı ile çalıştırma docker run

Kapsayıcı konak bilgisayara yüklendikten sonra docker run komutunu kullanarak kapsayıcıları çalıştırın. Kapsayıcı, siz durdurana kadar çalışmaya devam eder. Aşağıdaki yer tutucuları kendi değerlerinizle değiştirin:

PII algılama kapsayıcısını çalıştırmak için aşağıdaki docker run komutu yürütür. Aşağıdaki yer tutucuları kendi değerlerinizle değiştirin:

docker run --rm -it -p 5000:5000 --memory 8g --cpus 1 \
mcr.microsoft.com/azure-cognitive-services/textanalytics/pii:{IMAGE_TAG} \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

Şu komut:

• Kapsayıcı görüntüsünden bir PII algılama kapsayıcısı çalıştırır
• Bir CPU çekirdeği ve 8 gigabayt (GB) bellek ayırır
• TCP bağlantı noktası 5000'i kullanıma sunar ve kapsayıcı için sahte TTY ayırır
• Kapsayıcı çıktıktan sonra otomatik olarak kaldırılır. Kapsayıcı görüntüsü ana bilgisayarda hala kullanılabilir.

Aynı konakta birden çok kapsayıcı çalıştırma

Kullanıma sunulan bağlantı noktalarıyla birden çok kapsayıcı çalıştırmayı planlıyorsanız, her kapsayıcıyı farklı bir kullanıma sunulan bağlantı noktasıyla çalıştırdığınızdan emin olun. Örneğin, ilk kapsayıcıyı 5000 numaralı bağlantı noktasında, ikinci kapsayıcıyı da 5001 numaralı bağlantı noktasında çalıştırın.

Bu kapsayıcıyı ve HOST üzerinde çalışan farklı bir Azure AI hizmetleri kapsayıcısını birlikte kullanabilirsiniz. Aynı Azure AI hizmetleri kapsayıcısının birden çok kapsayıcısını da çalıştırabilirsiniz.

Kapsayıcının tahmin uç noktasını sorgulama

Kapsayıcı REST tabanlı sorgu tahmin uç noktası API’lerini sağlar.

Kapsayıcı API’leri için http://localhost:5000 konağını kullanın.

Kapsayıcının çalıştığını doğrulama

Kapsayıcının çalıştığını doğrulamanın çeşitli yolları vardır. Dış IP adresini ve söz konusu kapsayıcının kullanıma sunulan bağlantı noktasını bulun ve sık kullandığınız web tarayıcısını açın. Kapsayıcının çalıştığını doğrulamak için aşağıdaki çeşitli istek URL'lerini kullanın. Burada listelenen örnek istek URL'leri şunlardır http://localhost:5000; ancak kapsayıcınız farklılık gösterebilir. Kapsayıcınızın Dış IP adresine ve kullanıma sunulan bağlantı noktasına bağlı olduğundan emin olun.

PII'yi çağırma hakkında bilgi için kılavuzumuza bakın.

İnternet bağlantısı kesilmiş kapsayıcıyı çalıştırma

İnternet bağlantısı kesilmiş bu kapsayıcıyı kullanmak için önce bir uygulamayı doldurarak ve bir taahhüt planı satın alarak erişim istemeniz gerekir. Daha fazla bilgi için bkz . Bağlantısız ortamlarda Docker kapsayıcılarını kullanma.

Kapsayıcının İnternet bağlantısı kesilmiş olarak çalıştırılması onaylandıysa, aşağıdaki örnekte kullanacağınız komutun yer tutucu değerleriyle birlikte biçimlendirmesi docker run gösterilir. Bu yer tutucu değerlerini kendi değerlerinizle değiştirin.

DownloadLicense=True Komutunuzdaki docker run parametre, Docker kapsayıcınızın İnternet'e bağlı olmadığında çalışmasını sağlayacak bir lisans dosyası indirir. Ayrıca, lisans dosyasının kapsayıcıyı çalıştırmak için geçersiz olacağı bir son kullanma tarihi de içerir. Lisans dosyasını yalnızca onayladığınız uygun kapsayıcıyla kullanabilirsiniz. Örneğin, Belge Yönetim Bilgileri kapsayıcısı ile metin kapsayıcısına konuşma için lisans dosyası kullanamazsınız.

docker run --rm -it -p 5000:5000 \ 
-v {LICENSE_MOUNT} \
{IMAGE} \
eula=accept \
billing={ENDPOINT_URI} \
apikey={API_KEY} \
DownloadLicense=True \
Mounts:License={CONTAINER_LICENSE_DIRECTORY} 

Lisans dosyası indirildikten sonra, kapsayıcıyı bağlantısı kesilmiş bir ortamda çalıştırabilirsiniz. Aşağıdaki örnek, kullanacağınız komutun docker run yer tutucu değerleriyle biçimlendirmesini gösterir. Bu yer tutucu değerlerini kendi değerlerinizle değiştirin.

Kapsayıcı nerede çalıştırılırsa çalıştırılsın, 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. Faturalama kullanım kayıtlarının yazılabilmesi için bir çıkış bağlaması da belirtilmelidir.

docker run --rm -it -p 5000:5000 --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}

Kapsayıcıyı durdurma

Kapsayıcıyı kapatmak için, kapsayıcının çalıştığı komut satırı ortamında Ctrl+C tuşlarına basın.

Sorun giderme

Kapsayıcıyı bir çıkış bağlaması ve günlüğe kaydetme etkin olarak çalıştırırsanız kapsayıcı, kapsayıcıyı başlatırken veya çalıştırırken karşılaşılan sorunları gidermeye yardımcı olan günlük dosyaları oluşturur.

Faturalandırma

PII algılama kapsayıcıları, Azure hesabınızdaki bir Dil kaynağını kullanarak faturalama bilgilerini Azure'a gönderir.

Kapsayıcıya yönelik sorgular, parametre için kullanılan Azure kaynağının fiyatlandırma katmanında ApiKey faturalandırılır.

Azure AI hizmetleri kapsayıcıları, ölçüm veya faturalama uç noktasına bağlı olmadan çalıştırılma lisansına sahip değildir. Faturalama bilgilerini faturalama uç noktasıyla her zaman iletmek için kapsayıcıları etkinleştirmeniz gerekir. Azure AI hizmetleri kapsayıcıları, analiz edilen görüntü veya metin gibi müşteri verilerini Microsoft'a göndermez.

Azure'a bağlanma

Kapsayıcının çalışması için faturalama bağımsız değişkeni değerleri gerekir. Bu değerler kapsayıcının faturalama uç noktasına bağlanmasına olanak sağlar. Kapsayıcı yaklaşık 10-15 dakikada bir kullanımı bildirir. Kapsayıcı izin verilen zaman penceresinde Azure'a bağlanmazsa, kapsayıcı çalışmaya devam eder ancak faturalama uç noktası geri yüklenene kadar sorgular sunmaz. Bağlantı, 10 ile 15 dakika aynı zaman aralığında 10 kez denenir. 10 denemede faturalama uç noktasına bağlanamazsa kapsayıcı isteklerin sunulmasını durdurur. Faturalama için Microsoft'a gönderilen bilgilerin bir örneği için bkz. Azure AI hizmetleri kapsayıcısı SSS .

Faturalama bağımsız değişkenleri

Komut, docker run aşağıdaki seçeneklerin üçü de geçerli değerlerle sağlandığında kapsayıcıyı başlatır:

Bu seçenekler hakkında daha fazla bilgi için bkz . Kapsayıcıları yapılandırma.

Özet

Bu makalede, PII algılama kapsayıcılarını indirmeye, yüklemeye ve çalıştırmaya yönelik kavramları ve iş akışını öğrendiniz. Özet olarak:

• PII algılama, Docker için Linux kapsayıcıları sağlar
• Kapsayıcı görüntüleri Microsoft Container Registry'den (MCR) indirilir.
• Kapsayıcı görüntüleri Docker'da çalışır.
• Kapsayıcı örneği oluştururken faturalama bilgilerini belirtmeniz gerekir.

Sonraki adımlar

• Bkz . Yapılandırma ayarları için kapsayıcıları yapılandırma.