Skip to content

Commit 7b07ef3

Browse files
Merge pull request #209004 from laujan/patch-140
Update translator-how-to-install-container.md
2 parents a705864 + 0f25687 commit 7b07ef3

File tree

1 file changed

+14
-12
lines changed

1 file changed

+14
-12
lines changed

articles/cognitive-services/Translator/containers/translator-how-to-install-container.md

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ manager: nitinme
88
ms.service: cognitive-services
99
ms.subservice: translator-text
1010
ms.topic: how-to
11-
ms.date: 10/14/2021
11+
ms.date: 08/24/2022
1212
ms.author: lajanuar
1313
recommendations: false
1414
keywords: on-premises, Docker, container, identify
@@ -24,28 +24,27 @@ See the list of [languages supported](../language-support.md) when using Transla
2424

2525
> [!IMPORTANT]
2626
>
27-
> * Translator container is in gated preview and to use it you must submit an online request, and have it approved. See [Request approval to run container](#request-approval-to-run-container) below for more information.
28-
> * Translator container supports limited features compared to the cloud offerings. *See* [**Container translate methods**](translator-container-supported-parameters.md) for more details.
27+
> * Translator container is in gated preview and to use it you must submit an online request, and have it approved. For more information, _see_ [Request approval to run container](#request-approval-to-run-container) below.
28+
> * Translator container supports limited features compared to the cloud offerings. Form more information, _see_ [**Container translate methods**](translator-container-supported-parameters.md).
2929
3030
<!-- markdownlint-disable MD033 -->
3131

3232
## Prerequisites
3333

3434
To get started, you'll need an active [**Azure account**](https://azure.microsoft.com/free/cognitive-services/). If you don't have one, you can [**create a free account**](https://azure.microsoft.com/free/).
3535

36-
You'll also need the following:
36+
You'll also need to have:
3737

3838
| Required | Purpose |
3939
|--|--|
4040
| Familiarity with Docker | <ul><li>You should have a basic understanding of Docker concepts, like registries, repositories, containers, and container images, as well as knowledge of basic `docker` [terminology and commands](/dotnet/architecture/microservices/container-docker-introduction/docker-terminology).</li></ul> |
4141
| Docker Engine | <ul><li>You need the Docker Engine installed on a [host computer](#host-computer). Docker provides packages that configure the Docker environment on [macOS](https://docs.docker.com/docker-for-mac/), [Windows](https://docs.docker.com/docker-for-windows/), and [Linux](https://docs.docker.com/engine/installation/#supported-platforms). For a primer on Docker and container basics, see the [Docker overview](https://docs.docker.com/engine/docker-overview/).</li><li> Docker must be configured to allow the containers to connect with and send billing data to Azure. </li><li> On **Windows**, Docker must also be configured to support **Linux** containers.</li></ul> |
4242
| Translator resource | <ul><li>An Azure [Translator](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) resource with region other than 'global', associated API key and endpoint URI. Both values are required to start the container and can be found on the resource overview page.</li></ul>|
43-
|||
4443

4544
|Optional|Purpose|
4645
|---------|----------|
47-
|Azure CLI (command-line interface) |<ul><li> The [Azure CLI](/cli/azure/install-azure-cli) enables you to use a set of online commands to create and manage Azure resources. It is available to install in Windows, macOS, and Linux environments and can be run in a Docker container and Azure Cloud Shell.</li></ul> |
48-
|||
46+
|Azure CLI (command-line interface) |<ul><li> The [Azure CLI](/cli/azure/install-azure-cli) enables you to use a set of online commands to create and manage Azure resources. It's available to install in Windows, macOS, and Linux environments and can be run in a Docker container and Azure Cloud Shell.</li></ul> |
47+
4948

5049
## Required elements
5150

@@ -65,14 +64,17 @@ All Cognitive Services containers require three primary elements:
6564

6665
## Container requirements and recommendations
6766

68-
The following table describes the minimum and recommended specifications for Translator containers. At least 2 gigabytes (GB) of memory are required and each CPU must be at least 2.6 gigahertz (GHz) or faster. and memory, in gigabytes (GB), to allocate for each Translator. The following table describes the minimum and recommended allocation of resources for each Translator container.
67+
The following table describes the minimum and recommended CPU cores and memory to allocate for the Translator container.
6968

7069
| Container | Minimum |Recommended | Language Pair |
7170
|-----------|---------|---------------|----------------------|
7271
| Translator connected |2 core, 2-GB memory |4 core, 8-GB memory | 4 |
73-
|||
7472

75-
For every language pair, it's recommended to have 2 GB of memory. By default, the Translator offline container has four language pairs. The core and memory correspond to the `--cpus` and `--memory` settings, which are used as part of the `docker run` command.
73+
* Each core must be at least 2.6 gigahertz (GHz) or faster.
74+
75+
* For every language pair, it's recommended to have 2 GB of memory. By default, the Translator offline container has four language pairs.
76+
77+
* The core and memory correspond to the `--cpus` and `--memory` settings, which are used as part of the `docker run` command.
7678

7779
> [!NOTE]
7880
>
@@ -124,7 +126,7 @@ You can have this container and a different Azure Cognitive Services container r
124126

125127
## Query the container's Translator endpoint
126128

127-
The container provides a REST-based Translator endpoint API. Here is an example request:
129+
The container provides a REST-based Translator endpoint API. Here's an example request:
128130

129131
```curl
130132
curl -X POST "http://localhost:5000/translate?api-version=3.0&from=en&to=zh-HANS"
@@ -217,7 +219,7 @@ print(json.dumps(
217219

218220
Launch Visual Studio, and create a new console application. Edit the `*.csproj` file to add the `<LangVersion>7.1</LangVersion>` node—specifies C# 7.1. Add the [Newtoonsoft.Json](https://www.nuget.org/packages/Newtonsoft.Json/) NuGet package, version 11.0.2.
219221

220-
In the `Program.cs` replace all the existing code with the following:
222+
In the `Program.cs` replace all the existing code with the following script:
221223

222224
```csharp
223225
using Newtonsoft.Json;

0 commit comments

Comments
 (0)