Cómo descargar imágenes de productos de CertiSur S.A.

Cómo descargar imágenes de productos de CertiSur S.A.

CertiSur distribuye sus soluciones como container Docker que deben ser instalados en las instalaciones de sus clientes.

Dependiendo de la solución, servicio o aplicación, CertiSur genera una licencia para cada una de sus distribuciones.

A continuación se encuentra detallada la manera de acceder a dichas distribuciones.

Plataforma de distribución

Los container docker que encuentran disponibles dentro del servicio de Amazon Web Services (AWS ECR) correspondiente. Por tal motivo es necesario que usted descargue e instale el paquete de linea de comandos de dicha plataforma antes de proceder.

INSTALACION CLI
Installing or updating to the latest version of the AWS CLI - AWS Command Line Interface

En https://docs.aws.amazon.com/cli/ puede encontrar un instructivo de cómo utilizar los comandos de AWS.

Usuario y API-Key

Una vez adquirido el producto usted recibirá un usuario y api-key que le permitirá descargar cada una de las imágenes de los productos adquiridos.

Las instrucciones que aparecen a continuación hacen referencia a dicho CS-USER y CS-API-KEY en las instrucciones. Debe reemplazarlo por su usuario.

Antes de avanzar verifique que tiene las últimas versiones de AWS CLI y Docker.

Agregar Usuario y API-key a un profile propio

Para poder usar las claves recibidas usted debe agregarlas dentro de de la configuración local de AWS CLI.

En Configuration and credential file settings in the AWS CLI - AWS Command Line Interface puede encontrar un instructivo de cómo realizar esta acción.

Una manera sencilla es ejecutando el comando:

aws configure --profile CertiSurECR

que le permite ingresar los datos de un perfil nuevo.

O también puede editar el archivo de configuración (.aws/config y .aws/credentials) y agregar los datos del nuevo perfil dentro de los mismos. Si decide seguir este mecanismo, en https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html#cli-configure-files-format-profile encontrará información detallada del formato que debe seguir.

Instrucciones de cómo descargar una imagen en MAC\LINUX

Utilice las siguientes instrucciones para autenticarse y descargar una imagen.

Use el siguiente comando para autentircarse con sus credenciales:

aws ecr get-login-password --region us-east-1 --profile CertiSurECR | docker login --username AWS --password-stdin 445679587111.dkr.ecr.us-east-1.amazonaws.com

el resultado debe ser:

Login Succeeded

Descargue la imagen reemplezando el nombre del producto <PRODUCT-ID> en el siguiente comando:

docker pull 445679587111.dkr.ecr.us-east-1.amazonaws.com/production/<PRODUCT-ID>:latest

Si desea descargar una versión específica del producto puede hacerlo reemplazando la palabra latest del comando por el número de versión que desea.

Cuando decida descargar una versión específica, recuerde que las mismas se encuentra referenciadas con un tag de la forma rX.Y.Z.W, donde .W puede llegar ser opcional.

Instrucciones de cómo descargar una imagen en WINDOWS


Debe utilizar AWS TOOLS para PowerShell para realizar esta tarea.

(Get-ECRLoginCommand).Password --profile CertiSurECR | docker login --username AWS --password-stdin 445679587111.dkr.ecr.us-east-1.amazonaws.com

Descargue la imagen reemplezando el nombre del producto <PRODUCT-ID> en el siguiente comando:

docker pull 445679587111.dkr.ecr.us-east-1.amazonaws.com/production/<PRODUCT-ID>:latest

Si desea descagar una versión específica del producto puede hacerlo reemplazando la palabra latest del comando por el número de versión que desea.

Ejemplo

Si usted desea descargar el producto debbie en su última versión, podrá realizar los siguientes pasos:

# docker pull 445679587111.dkr.ecr.us-east-1.amazonaws.com/production/debbie:latest latest: Pulling from production/debbie 4a665eb63bc8: Pull complete  2d5030c76019: Pull complete  7fd9c22eeb6b: Pull complete  98961c857aa4: Pull complete  4f4fb700ef54: Pull complete  Digest: sha256:3699b3c45f03a2c3e856b25e6991c105f5bfbf31bfddfa6437355a5a1a2d333e Status: Downloaded newer image for 445679587111.dkr.ecr.us-east-1.amazonaws.com/production/debbie:latest 445679587111.dkr.ecr.us-east-1.amazonaws.com/production/debbie:latest

Para ver que la imagen ha sido instalada en el equipo puede ejecutar el comando:

docker image ls

# docker image ls                                                                   REPOSITORY                                                       TAG                   IMAGE ID       CREATED         SIZE 445679587111.dkr.ecr.us-east-1.amazonaws.com/production/debbie   latest                66ed34013c56   6 days ago      497MB