Yükleme ve metin analizi kapsayıcıları çalıştırmaInstall and run Text Analytics containers
Metin analizi kapsayıcılar sağlar ham metin üzerinde Gelişmiş doğal dil işleme ve üç ana işlev içerir: yaklaşım analizi, anahtar ifade ayıklama ve dil algılama.The Text Analytics containers provide advanced natural language processing over raw text, and includes three main functions: sentiment analysis, key phrase extraction, and language detection. Varlık bağlama, bir kapsayıcıda şu anda desteklenmiyor.Entity linking is not currently supported in a container.
ÖnkoşullarPrerequisites
Herhangi bir metin analizi kapsayıcıları çalıştırmak için ana bilgisayar ve kapsayıcı ortamlarını olması gerekir.In order to run any of the Text Analytics containers, you must have the host computer and container environments.
HazırlıkPreparation
Metin analizi kapsayıcıları kullanmadan önce aşağıdaki gereksinimleri karşılaması gerekir:You must meet the following prerequisites before using Text Analytics containers:
|GerekliRequired||AmaçPurpose|
|Docker altyapısıDocker Engine||Docker Altyapısı'nın kurulu ihtiyacınız bir ana bilgisayar.You need the Docker Engine installed on a host computer. Docker üzerinde Docker ortamını yapılandıran paketler sağlar macOS, Windows, ve Linux.Docker provides packages that configure the Docker environment on macOS, Windows, and Linux. Docker ve kapsayıcı temelleri hakkında bilgi için bkz: Docker'a genel bakış.For a primer on Docker and container basics, see the Docker overview.


Docker, kapsayıcılar ile bağlanma ve faturalama verileri Azure'a göndermek izin verecek şekilde yapılandırılmalıdır.Docker must be configured to allow the containers to connect with and send billing data to Azure.
Windows üzerinde, Docker de Linux kapsayıcıları destekler şekilde yapılandırılmalıdır.On Windows, Docker must also be configured to support Linux containers.
|Docker ile aşinalıkFamiliarity with Docker||Bir temel kavramlarını Docker kayıt defterleri, havuzları, kapsayıcılar ve kapsayıcı görüntülerinin yanı sıra temel bilgi gibi olmalıdır


||Kapsayıcı kullanabilmeniz için şunlara sahip olmalısınız:In order to use the container, you must have:


A Bilişsel Hizmetler fatura uç noktası URI'si ve ilişkili faturalandırma anahtarı almak için Azure kaynak.A Cognitive Services Azure resource to get the associated billing key and billing endpoint URI. Her iki değeri de Azure portalında Bilişsel hizmetleri genel bakış ve anahtarları sayfalarında kullanılabilir ve kapsayıcı başlatma için gereklidir.Both values are available on the Azure portal's Cognitive Services Overview and Keys pages and are required to start the container. Eklemenize gerek
{BILLING_KEY} : kaynak anahtarı{BILLING_KEY}: resource key
{BILLING_ENDPOINT_URI} : uç nokta URI'si örnektir:
Ana bilgisayarThe host computer
Konak, Docker kapsayıcısı çalıştıran bir x64 tabanlı bir bilgisayardır.The host is a x64-based computer that runs the Docker container. Bir bilgisayarda şirket içinde veya azure'da Docker barındırma hizmeti gibi olabilir:It can be a computer on your premises or a Docker hosting service in Azure, such as:
- Azure Kubernetes hizmeti.Azure Kubernetes Service.
- Azure Container Instances.Azure Container Instances.
- A Kubernetes kümesi dağıtıldı için Azure Stack.A Kubernetes cluster deployed to Azure Stack. Daha fazla bilgi için Azure Stack dağıtma Kubernetes.For more information, see Deploy Kubernetes to Azure Stack.
Kapsayıcı gereksinimleri ve önerileriContainer requirements and recommendations
Aşağıdaki tabloda açıklanmıştır en düşük ve önerilen CPU çekirdekleri, en az 2.6 gigahertz (GHz) veya daha hızlı ve her bir metin analizi kapsayıcısı için ayrılacak gigabayt (GB) bellek.The following table describes the minimum and recommended CPU cores, at least 2.6 gigahertz (GHz) or faster, and memory, in gigabytes (GB), to allocate for each Text Analytics container.
|KapsayıcıContainer||MinimumMinimum||ÖnerilenRecommended||TPSTPS


(Minimum, maksimum)(Minimum, Maximum)
|Anahtar İfade AyıklamaKey Phrase Extraction||1 çekirdek, 2 GB bellek1 core, 2 GB memory||1 çekirdek, 4 GB bellek1 core, 4 GB memory||15, 3015, 30|
|Dil AlgılamaLanguage Detection||1 çekirdek, 2 GB bellek1 core, 2 GB memory||1 çekirdek, 4 GB bellek1 core, 4 GB memory||15, 3015, 30|
|Duygu AnaliziSentiment Analysis||1 çekirdek, 2 GB bellek1 core, 2 GB memory||1 çekirdek, 4 GB bellek1 core, 4 GB memory||15, 3015, 30|
- Her çekirdeğe en az 2.6 gigahertz (GHz) olması ya da daha hızlı.Each core must be at least 2.6 gigahertz (GHz) or faster.
- TPS - saniye başına işlemTPS - transactions per second
Çekirdek ve bellek karşılık
--cpus ve
--memory parçası olarak kullanılan ayarları
docker run komutu.Core and memory correspond to the
--cpus and
--memory settings, which are used as part of the
docker run command.
İle kapsayıcı görüntüsünü Al
docker pullGet the container image with
docker pull
Microsoft kapsayıcı kayıt defterinden kapsayıcı görüntülerini metin analizi için kullanılabilir.Container images for Text Analytics are available from Microsoft Container Registry.
|KapsayıcıContainer||HavuzRepository|
|Anahtar İfade AyıklamaKey Phrase Extraction||


|Dil AlgılamaLanguage Detection||


|Duygu AnaliziSentiment Analysis||


Metin analizi kapsayıcılar için kullanılabilir etiketler tam bir açıklaması için aşağıdaki kapsayıcıların Docker Hub bakın:For a full description of available tags for the Text Analytics containers, see the following containers on the Docker Hub:
- Anahtar ifade ayıklamaKey Phrase Extraction
- Dil algılamaLanguage Detection
- Yaklaşım analiziSentiment Analysis
Docker isteği için anahtar tümcecik ayıklama kapsayıcısıDocker pull for the Key phrase extraction container
docker pull mcr.microsoft.com/azure-cognitive-services/keyphrase:latest
Dil algılama kapsayıcısı için docker isteğiDocker pull for the language detection container
docker pull mcr.microsoft.com/azure-cognitive-services/language:latest
Docker isteği yaklaşım kapsayıcısı içinDocker pull for the sentiment container
docker pull mcr.microsoft.com/azure-cognitive-services/sentiment:latest
İpucu
Kullanabileceğiniz docker görüntüleri indirilen kapsayıcı görüntülerinizi listelemek için komutu.You can use the docker images command to list your downloaded container images. Örneğin, aşağıdaki komut kimliği, havuz ve tablo olarak biçimlendirilmiş her indirilen kapsayıcı görüntüsünün etiketi listeler:For example, the following command lists the ID, repository, and tag of each downloaded container image, formatted as a table:
docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}" IMAGE ID REPOSITORY TAG <image-id> <repository-path/name> <tag-name>
Kapsayıcı kullanmaHow to use the container
- Kapsayıcıyı çalıştırmak, gerekli faturalama ayarları.Run the container, with the required billing settings. Daha fazla örnekler ,
docker runkomutu kullanılabilir.More examples of the
docker runcommand are available.
- Kapsayıcının tahmini uç nokta sorgu.Query the container's prediction endpoint.
Kapsayıcı ile çalıştırma
docker runRun the container with
docker run
Kullanım docker run üç kapsayıcı birini çalıştırmak için komutu.Use the docker run command to run any of the three containers. Komutu şu parametreleri kullanır:The command uses the following parameters:
|Yer tutucuPlaceholder||DeğerValue|
|{BILLING_KEY}{BILLING_KEY}||Bu anahtar kapsayıcısı başlatmak için kullanılır ve Azure portal üzerinde kullanılabilir


|{BILLING_ENDPOINT_URI}{BILLING_ENDPOINT_URI}||Azure'da faturalandırma uç noktası URI değeri kullanılabilir


Örnek:Example:
Eklemenize gerek
text/analytics/v2.0 önceki BILLING_ENDPOINT_URI örnekte gösterildiği gibi uç nokta URI'si yönlendirme.You need to add the
text/analytics/v2.0 routing to the endpoint URI as shown in the preceding BILLING_ENDPOINT_URI example.
Bu parametreleri aşağıdaki örnekte kendi değerlerinizle değiştirin
docker run komutu.Replace these parameters with your own values in the following example
docker run command.
docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \ mcr.microsoft.com/azure-cognitive-services/keyphrase \ Eula=accept \ Billing={BILLING_ENDPOINT_URI} \ ApiKey={BILLING_KEY}
Bu komut:This command:
- Bir anahtar tümcecik kapsayıcı kapsayıcı görüntüsünü çalıştırır.Runs a key phrase container from the container image
- Bir CPU Çekirdeği ve 4 gigabayt (GB) bellek ayırır.Allocates one CPU core and 4 gigabytes (GB) of memory
- 5000 numaralı TCP bağlantı noktasını kullanıma sunar ve sahte TTY için kapsayıcı ayırır.Exposes TCP port 5000 and allocates a pseudo-TTY for the container
- Bunu çıktıktan sonra kapsayıcı otomatik olarak kaldırır.Automatically removes the container after it exits. Kapsayıcı görüntüsü ana bilgisayarda kullanılabilir durumda kalır.The container image is still available on the host computer.
Önemli
Eula,
Billing, Ve
ApiKey kapsayıcıyı çalıştırmak için seçenekler belirtilmelidir; Aksi takdirde, kapsayıcı başlatılamıyor.The
Eula,
Billing, and
ApiKey options must be specified to run the container; otherwise, the container won't start. Daha fazla bilgi için faturalama.For more information, see Billing.
Aynı ana bilgisayarda birden çok kapsayıcı çalıştırmaRun multiple containers on the same host
Kullanıma sunulan bağlantı noktası olan birden çok kapsayıcı çalıştırmak istiyorsanız, her kapsayıcı farklı bir kullanıma sunulan bağlantı noktası ile çalıştırmak emin olun.If you intend to run multiple containers with exposed ports, make sure to run each container with a different exposed port. Örneğin, ilk kapsayıcı bağlantı noktası 5000 ve ikinci kapsayıcıyı 5001 bağlantı noktası üzerinde çalıştırın.For example, run the first container on port 5000 and the second container on port 5001.
Bu kapsayıcı ve KONAKTA birlikte çalışan farklı Azure Bilişsel hizmetler kapsayıcı olabilir.You can have this container and a different Azure Cognitive Services container running on the HOST together. Aynı Bilişsel hizmetler kapsayıcıyı, birden çok kapsayıcı da olabilir.You also can have multiple containers of the same Cognitive Services container running.
Sorgu kapsayıcının tahmini uç noktasıQuery the container's prediction endpoint
Kapsayıcı, REST tabanlı sorgu tahmin uç nokta API'leri sağlar.The container provides REST-based query prediction endpoint APIs.
Ana bilgisayarını kullanmak
https://localhost:5000, kapsayıcı API'leri için.Use the host,
https://localhost:5000, for container APIs.
Bir kapsayıcının çalıştırıldığını doğrulaValidate that a container is running
Kapsayıcının çalışır durumda olduğunu doğrulamak için birkaç yolu vardır.There are several ways to validate that the container is running.
|İstekRequest||AmaçPurpose|


||Kapsayıcı, bir giriş sayfası sağlar.The container provides a home page.|


||Bir uç nokta sorgu neden olmadan kapsayıcının çalışır durumda olduğunu doğrulamak için GET ile istedi.Requested with GET, to validate that the container is running without causing an endpoint query. Bu istek için Kubernetes kullanılabilir canlılık ve hazırlık araştırmaları.This request can be used for Kubernetes liveness and readiness probes.|


||Kapsayıcı uç noktaları için tam kümesi sağlar ve bir


Kapsayıcı DurdurStop the container
Burada kapsayıcı çalışıyor, komut satırı ortamında kapsayıcı kapatmaya seçin Ctrl + C.To shut down the container, in the command-line environment where the container is running, select Ctrl+C.
Sorun gidermeTroubleshooting
Kapsayıcı içeren bir çıktı çalıştırırsanız bağlama ve günlüğe kaydetme etkin, kapsayıcı başlatma veya kapsayıcı çalıştırma sırasında gerçekleşen sorunları gidermek yararlı olan günlük dosyalarını oluşturur.If you run the container with an output mount and logging enabled, the container generates log files that are helpful to troubleshoot issues that happen while starting or running the container.
FaturalandırmaBilling
Azure için fatura, kullanarak metin analizi kapsayıcıları Gönder bir Bilişsel Hizmetler Azure hesabınız kaynaktaki.The Text Analytics containers send billing information to Azure, using a Cognitive Services resource on your Azure account.
Kapsayıcıya sorguları için kullanılan bir Azure kaynak fiyatlandırma katmanını faturalandırılır
<ApiKey>.Queries to the container are billed at the pricing tier of the Azure resource that's used for the
<ApiKey>.
Azure Bilişsel hizmetler kapsayıcıları, kullanım ölçümü için fatura uç noktasına bağlı olmadan çalıştırmak için lisanslı değil.Azure Cognitive Services containers aren't licensed to run without being connected to the billing endpoint for metering. Kapsayıcılar, her zaman faturalandırma bilgileri fatura uç noktası ile iletişim kurmak etkinleştirmeniz gerekir.You must enable the containers to communicate billing information with the billing endpoint at all times. Bilişsel hizmetler kapsayıcıları analiz ediliyor, metin ve görüntü gibi müşteri verilerini Microsoft'a gönderme.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.
Azure'a BağlanmaConnect to Azure
Kapsayıcıyı çalıştırmak için fatura bağımsız değişken değerlerini gerekir.The container needs the billing argument values to run. Bu değerler, fatura uç noktaya bağlanmak kapsayıcı sağlar.These values allow the container to connect to the billing endpoint. Kapsayıcı yaklaşık her 10 ila 15 dakika kullanım raporları.The container reports usage about every 10 to 15 minutes. Kapsayıcı izin verilen zaman penceresi içinde Azure'a bağlanamazsa kapsayıcı çalışmaya devam eder, ancak fatura uç noktayı geri yüklenene kadar sorgular görmese.If the container doesn't connect to Azure within the allowed time window, the container continues to run but doesn't serve queries until the billing endpoint is restored. Bağlantı 10 kez aynı zaman aralığında 10-15 dakika denenir.The connection is attempted 10 times at the same time interval of 10 to 15 minutes. Bağlantı kurulamıyor fatura uç nokta 10 içinde çalışır, kapsayıcı çalışmayı durdurur.If it can't connect to the billing endpoint within the 10 tries, the container stops running.
Faturalandırma bağımsız değişkenleriBilling arguments
İçin
docker run kapsayıcı başlatmak için komut geçerli değerlerle şunlardan üçünü belirtilmesi gerekir:For the
docker run command to start the container, all three of the following options must be specified with valid values:
|SeçenekOption||AçıklamaDescription|


||Fatura bilgileri izlemek için kullanılan Bilişsel hizmetler kaynağı API anahtarı.The API key of the Cognitive Services resource that's used to track billing information.


Bu seçeneğin değeri, belirtilen sağlanan kaynak için bir API anahtarı ayarlanmalıdır


||Bilişsel hizmetler kaynağın faturalandırma bilgileri izlemek için kullanılan uç nokta.The endpoint of the Cognitive Services resource that's used to track billing information.


Bu seçeneğin değeri, sağlanan bir Azure kaynak URI'sini uç noktasına ayarlamanız gerekir.The value of this option must be set to the endpoint URI of a provisioned Azure resource.


||Kapsayıcı lisansını kabul gösterir.Indicates that you accepted the license for the container.


Bu seçenek değeri ayarlanmalıdır kabul.The value of this option must be set to accept.
Blog yazılarıBlog posts
- Çalışan kapsayıcılar Bilişsel hizmetlerRunning Cognitive Services Containers
- Bilişsel hizmetler Language Understanding kapsayıcısı ile çalışmaya başlamaGetting started with Cognitive Services Language Understanding container
Geliştirici örnekleriDeveloper samples
Web seminerini izleyinView webinar
- Bilişsel hizmetler, Docker kullanan herhangi bir makineye dağıtmaHow to deploy Cognitive Services to any machine using Docker
- Bilişsel hizmetler AKS'ye dağıtmaHow to deploy Cognitive Services to AKS
ÖzetSummary
Bu makalede, kavramlar ve indirme, yükleme ve metin analizi kapsayıcıları çalıştırmak için iş akışı öğrendiniz.In this article, you learned concepts and workflow for downloading, installing, and running Text Analytics containers. Özet:In summary:
- Metin analizi, anahtar ifade ayıklama, dil algılama ve yaklaşım analizi Kapsüllenen üç Linux kapsayıcıları için Docker, sağlar.Text Analytics provides three Linux containers for Docker, encapsulating key phrase extraction, language detection, and sentiment analysis.
- Kapsayıcı görüntülerini azure'da Microsoft kapsayıcı kayıt defteri (MCR) alanından indirilir.Container images are downloaded from the Microsoft Container Registry (MCR) in Azure.
- Docker kapsayıcı görüntüleri çalıştırın.Container images run in Docker.
- Metin analizi-kapsayıcılarında işlemleri ana kapsayıcısının URI belirterek çağırmak için REST API veya SDK'sını kullanabilirsiniz.You can use either the REST API or SDK to call operations in Text Analytics containers by specifying the host URI of the container.
- Bir kapsayıcı örneği oluşturulurken, fatura bilgilerini belirtmeniz gerekir.You must specify billing information when instantiating a container.
Önemli
Bilişsel hizmetler kapsayıcıları, kullanım ölçümü için Azure'a bağlanmadan çalıştırmak için lisanslanmaz.Cognitive Services containers are not licensed to run without being connected to Azure for metering. Müşteriler, her zaman faturalandırma bilgileri ölçüm hizmeti ile iletişim kurmak kapsayıcıları etkinleştirmeniz gerekiyor.Customers need to enable the containers to communicate billing information with the metering service at all times. Bilişsel hizmetler kapsayıcılar, Microsoft müşteri verilerini (örneğin, görüntü veya metin analiz edilen) göndermeyin.Cognitive Services containers do not send customer data (e.g., the image or text that is being analyzed) to Microsoft.
Sonraki adımlarNext steps
Geri Bildirim
Geri bildirim yükleniyor...