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