Install¶

IDVoice Server Docker image is distributed via Amazon ECR. You need to login to the registry and download the required image using the credentials recevied from ID R&D.

Install Docker¶

Follow the Docker's instruction to install Docker Engine on Ubuntu, CentOS or other supported platform. For Windows you can use Docker Desktop.

Note that by default you need to run docker with sudo. You can disable it if you want.

Install AWS management utility¶

To login to Amazon ECR you need to install and configure the AWS management utility.

AWS CLIAWS Tools for PowerShell

The AWS Command Line Interface is a stand-alone utility that works on both Linux and Windows. To install it follow the Amazon's instruction. Afterwards configure it with:

aws configure --profile idrnd

It will prompt you for four pieces of information. Fill the Access Key ID and the Secret Access Key with the values from the email. For the region specify eu-central-1 and leave the output format empty:

AWS Access Key ID [None]: AKIAI44QH8DHBEXAMPLE
AWS Secret Access Key [None]: je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY
Default region name [None]: eu-central-1
Default output format [None]:

The configuration will be saved to the idrnd profile. You will need to explicitly specify it every time you use AWS CLI.

The AWS Tools for PowerShell manage AWS services and resources in the PowerShell scripting environment, in both Windows and Linux. To install them run:

Install-Module -Name AWS.Tools.Installer
Install-AWSToolsModule AWS.Tools.ECR

On Windows you may need to first change the default execution policy. For that run this command as administrator:

Set-ExecutionPolicy RemoteSigned

Afterwards create the idrnd profile with access and secret keys from the email:

Set-AWSCredential -StoreAs idrnd -AccessKey AKIAI44QH8DHBEXAMPLE -SecretKey je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY

You will need to explicitly specify the profile every time you use AWS Tools.

Download image¶

AWS CLIAWS Tools for PowerShell

Use aws ecr to generate a password for docker login:

aws ecr get-login-password --profile idrnd |
    docker login --username AWS --password-stdin 367672406076.dkr.ecr.eu-central-1.amazonaws.com

Use Get-ECRLoginCommand cmdlet to login to ECR:

Get-ECRLoginCommand -ProfileName idrnd -Region eu-central-1 | select Command | Invoke-Expression

Once you're logged in you will see a Login Succeeded message. Now you can pull the IDVoice Server image:

docker pull 367672406076.dkr.ecr.eu-central-1.amazonaws.com/voicesdk-server-eval:#.##.#