Brightmarket Sync Guide

Autenticación pip (CodeArtifact)

Requisitos, uso por plataforma y resolución de problemas para instalar el SDK desde CodeArtifact.

El paquete brightmarket-data-sync se publica en un registry privado de AWS CodeArtifact. Antes de pip install, tenés que autenticar pip con un token de corta duración (~12 h).

Tu proyecto incluye scripts en scripts/ que leen login_aws.env y ejecutan aws codeartifact login --tool pip.

Requisitos

RequisitoDetalle
AWS CLI v2Instalado y disponible en PATH (instalación AWS CLI)
Credenciales readerIAM bgmkt-codeartifact-reader en login_aws.env (copiá desde login_aws.env.example)
Entorno virtualPython venv activo antes de instalar dependencias

Sin este paso no podés instalar el SDK en el venv del cliente.

Qué hace el script

  1. Carga login_aws.env (o usa AWS_* ya exportadas en el entorno).
  2. Ejecuta aws codeartifact login --tool pip contra el dominio brightmarket.
  3. Deja pip configurado para descargar desde CodeArtifact durante ~12 h.

Después podés correr:

pip install -r requirements.txt

Uso por plataforma

Primero completá las credenciales:

cp login_aws.env.example login_aws.env   # credenciales reader IAM

Linux / macOS / Git Bash:

chmod +x scripts/auth-pip.sh   # solo la primera vez
./scripts/auth-pip.sh
pip install -r requirements.txt

Windows PowerShell:

.\scripts\auth-pip-win.ps1
pip install -r requirements.txt

Windows CMD:

scripts\auth-pip-win.cmd
pip install -r requirements.txt

En Git Bash o WSL podés usar ./scripts/auth-pip.sh igual que en Linux.

Solo imprimir el token / instalar pasando el token

Si preferís no dejar el login en pip (o querés pasar el token a otra máquina), imprimilo y usalo en pip install --index-url:

TOKEN=$(./scripts/print-codeartifact-token.sh)
pip install -r requirements.txt \
  --index-url "https://aws:${TOKEN}@brightmarket-373271235117.d.codeartifact.us-east-1.amazonaws.com/pypi/pypi-internal/simple/"

Windows PowerShell:

$TOKEN = .\scripts\print-codeartifact-token-win.ps1
pip install -r requirements.txt `
  --index-url "https://aws:${TOKEN}@brightmarket-373271235117.d.codeartifact.us-east-1.amazonaws.com/pypi/pypi-internal/simple/"

Los scripts leen login_aws.env igual que auth-pip. El token dura hasta ~12 h.

Resolución de problemas

SíntomaQué hacer
pip install devuelve 401Volvé a ejecutar el script de auth; el token expiró
Missing login_aws.envCopiá login_aws.env.examplelogin_aws.env y completá las keys
aws: command not foundInstalá AWS CLI v2 y reiniciá la terminal
PowerShell bloquea el scriptUsá auth-pip-win.cmd o ejecutá con -ExecutionPolicy Bypass

CI y Docker

En pipelines, las credenciales reader suelen inyectarse como secrets de entorno y el workflow ejecuta el mismo aws codeartifact login --tool pip antes de pip install. Ver CI / PyInstaller.

Referencia

On this page