221 lines
6.2 KiB
Markdown
221 lines
6.2 KiB
Markdown
# Scripts y Comandos
|
|
|
|
Los scripts CLI estan en `scripts/` y son la ruta avanzada para automatizacion o troubleshooting. Ejecutalos desde la raiz del proyecto con el ambiente virtual activo.
|
|
|
|
## Resumen
|
|
|
|
| Script | Objetivo | Entrada principal | Salida principal |
|
|
| --- | --- | --- | --- |
|
|
| `scripts/aws_fetch_offer.py` | Descargar offer AWS EC2. | Internet AWS Pricing. | `data/raw/aws/index.json`. |
|
|
| `scripts/aws_eda.py` | Transformar offer AWS y generar EDA. | `data/raw/aws/index.json`. | `data/catalog/aws/aws_ec2_catalog.csv`, `data/eda/aws/aws_eda_*.md`. |
|
|
| `scripts/aws_match.py` | Recomendar shapes AWS por inventario. | Inventario CSV/XLS/XLSX y catalogo AWS. | `data/match/aws/MATCH-AWS-*.csv`. |
|
|
| `scripts/oci_fetch_offer.py` | Descargar precios OCI y catalogo plano. | API Oracle products. | `data/raw/oci/products.json`, `data/catalog/oci/oci_price_list.csv`. |
|
|
| `scripts/oci_match.py` | Generar BOM OCI agregada. | Inventario CSV/XLS/XLSX y catalogo OCI. | `data/match/oci/MATCH-OCI-*.csv`. |
|
|
| `scripts/cloud-chat.py` | Consultar catalogo cloud por CLI. | Pregunta natural y catalogo AWS. | Respuesta en consola y log. |
|
|
| `scripts/cloud_chat_runtime.py` | Adaptador importable para Cloud Chat. | Variables de entorno. | Respuesta segura para WhatsApp/Flask. |
|
|
| `scripts/whatsapp_send.py` | Enviar mensaje WhatsApp por Twilio. | `.env` y `--body`. | Mensaje Twilio o dry-run. |
|
|
| `scripts/whatsapp_chatbot.py` | Webhook Flask para WhatsApp Cloud Chat. | Twilio webhook. | TwiML sync o respuesta diferida. |
|
|
| `scripts/whatsapp_logging.py` | Sanitizar logs WhatsApp. | Eventos webhook. | Log diario. |
|
|
| `scripts/match_shared.py` | Utilidades comunes AWS/OCI. | DataFrames e inventarios. | Mapping, normalizacion y movimiento a done. |
|
|
| `scripts/cloud_conversion_logging.py` | Logging comun. | Prefijo y mensaje. | `logs/log_cloud_conversion_YYYYMMDD.txt`. |
|
|
|
|
## Pipeline AWS
|
|
|
|
### Descargar offer
|
|
|
|
```bash
|
|
python scripts/aws_fetch_offer.py
|
|
```
|
|
|
|
Descarga:
|
|
|
|
```text
|
|
data/raw/aws/index.json
|
|
```
|
|
|
|
Efectos:
|
|
|
|
- Crea directorio destino si no existe.
|
|
- Escribe de forma atomica usando archivo temporal.
|
|
- Registra mensajes con prefijo `>> AWS_fetch_offer>>`.
|
|
|
|
### Generar EDA y catalogo
|
|
|
|
```bash
|
|
python scripts/aws_eda.py
|
|
```
|
|
|
|
Con rutas explicitas:
|
|
|
|
```bash
|
|
python scripts/aws_eda.py \
|
|
--input data/raw/aws/index.json \
|
|
--eda-output data/eda/aws/aws_eda_manual.md \
|
|
--catalog-output data/catalog/aws/aws_ec2_catalog.csv
|
|
```
|
|
|
|
Salidas:
|
|
|
|
- Catalogo plano AWS EC2.
|
|
- Reporte Markdown EDA.
|
|
|
|
### AWS Match
|
|
|
|
```bash
|
|
python scripts/aws_match.py --inventory input/inventario.xlsx --skip-llm
|
|
```
|
|
|
|
Parametros frecuentes:
|
|
|
|
| Parametro | Uso |
|
|
| --- | --- |
|
|
| `--inventory` | Archivo CSV/XLS/XLSX de inventario. |
|
|
| `--aws-catalog` | Catalogo AWS alterno. |
|
|
| `--output` | CSV de salida. |
|
|
| `--skip-llm` | Usa reglas deterministicas, sin Ollama. |
|
|
| `--force-llm` | Fuerza mapeo por LLM. |
|
|
| `--region-code` | Region AWS, default `us-east-1`. |
|
|
| `--operating-system` | OS global opcional, por ejemplo `Linux` o `Windows`. |
|
|
| `--include-previous-generation` | Incluye generaciones anteriores. |
|
|
| `--include-unused-capacity` | Incluye capacidad distinta de `Used`. |
|
|
| `--preferred-m-family` | Familia M preferida, default `m7a`. |
|
|
|
|
Efectos:
|
|
|
|
- Genera `data/match/aws/MATCH-AWS-<inventario>.csv` si no se pasa `--output`.
|
|
- En CLI puede mover inventario exitoso a `input/done/`.
|
|
- Registra mensajes con prefijo `>> AWS_match>>`.
|
|
|
|
## Pipeline OCI
|
|
|
|
### Descargar offer y catalogo OCI
|
|
|
|
```bash
|
|
python scripts/oci_fetch_offer.py
|
|
```
|
|
|
|
Salidas:
|
|
|
|
```text
|
|
data/raw/oci/products.json
|
|
data/catalog/oci/oci_price_list.csv
|
|
```
|
|
|
|
Efectos:
|
|
|
|
- Descarga productos desde API Oracle.
|
|
- Aplana precios localizados a CSV.
|
|
- Registra mensajes con prefijo `>> OCI_fetch_offer>>`.
|
|
|
|
### OCI Match
|
|
|
|
```bash
|
|
python scripts/oci_match.py --inventory input/inventario.xlsx --skip-llm
|
|
```
|
|
|
|
Parametros frecuentes:
|
|
|
|
| Parametro | Uso |
|
|
| --- | --- |
|
|
| `--inventory` | Archivo CSV/XLS/XLSX de inventario. |
|
|
| `--oci-catalog` | Catalogo OCI alterno. |
|
|
| `--output` | CSV de salida. |
|
|
| `--skip-llm` | Usa reglas deterministicas, sin Ollama. |
|
|
| `--force-llm` | Fuerza mapeo por LLM. |
|
|
| `--compute-series` | Serie OCI Standard, default `E`. |
|
|
| `--compute-generation` | Generacion fija, por ejemplo `E6`. |
|
|
| `--hours-per-month` | Horas mensuales, default `730`. |
|
|
| `--no-move-to-done` | Evita archivar inventario al finalizar. |
|
|
|
|
Efectos:
|
|
|
|
- Genera `data/match/oci/MATCH-OCI-<inventario>.csv`.
|
|
- En CLI mueve inventario exitoso a `input/done/` salvo `--no-move-to-done`.
|
|
- Registra mensajes con prefijo `>> OCI_match>>`.
|
|
|
|
## Cloud Chat CLI
|
|
|
|
Modo interactivo:
|
|
|
|
```bash
|
|
python scripts/cloud-chat.py
|
|
```
|
|
|
|
Modo one-shot:
|
|
|
|
```bash
|
|
python scripts/cloud-chat.py --ask "Cuanto cuesta m7a.xlarge en virginia?"
|
|
```
|
|
|
|
Opciones:
|
|
|
|
```bash
|
|
python scripts/cloud-chat.py \
|
|
--provider aws \
|
|
--catalog data/catalog/aws/aws_ec2_catalog.csv \
|
|
--model llama3.1:8b \
|
|
--ask "Que shapes tienen 8 vCPU y al menos 16 GB?"
|
|
```
|
|
|
|
Defaults:
|
|
|
|
- Provider: `aws`.
|
|
- Catalogo: `data/catalog/aws/aws_ec2_catalog.csv`.
|
|
- Modelo: `llama3.1:8b`.
|
|
- Region default: `us-east-1`.
|
|
- OS default: `Linux`.
|
|
- Horas mensuales: `730`.
|
|
|
|
## WhatsApp
|
|
|
|
### Envio
|
|
|
|
```bash
|
|
python scripts/whatsapp_send.py --body "Prueba Cloud Conversion" --dry-run
|
|
```
|
|
|
|
Envio real:
|
|
|
|
```bash
|
|
python scripts/whatsapp_send.py --to whatsapp:+52XXXXXXXXXX --body "Hola"
|
|
```
|
|
|
|
Requiere:
|
|
|
|
- `TWILIO_ACCOUNT_SID`
|
|
- `TWILIO_AUTH_TOKEN`
|
|
- `TWILIO_WHATSAPP_FROM`
|
|
- `MY_WHATSAPP_TO` si no se pasa `--to`
|
|
|
|
### Webhook Cloud Chat
|
|
|
|
```bash
|
|
python scripts/whatsapp_chatbot.py
|
|
```
|
|
|
|
Requiere:
|
|
|
|
- `TWILIO_AUTH_TOKEN`
|
|
- `PUBLIC_WEBHOOK_URL`
|
|
- Variables de Cloud Chat si quieres cambiar modelo/catalogo.
|
|
|
|
El webhook responde sincronamente si la respuesta llega dentro de `WHATSAPP_SYNC_TIMEOUT_SECONDS`. Si tarda mas, devuelve un acuse y manda respuesta diferida por Twilio.
|
|
|
|
## Demos legacy
|
|
|
|
| Archivo | Estado |
|
|
| --- | --- |
|
|
| `server.py` | Demo Flask simple que valida firma Twilio y responde eco. No es el webhook recomendado. |
|
|
| `send.py` | Demo simple de envio WhatsApp con mensaje fijo. Usa `scripts/whatsapp_send.py` para operacion. |
|
|
|
|
## Validar argumentos
|
|
|
|
```bash
|
|
python scripts/aws_match.py --help
|
|
python scripts/oci_match.py --help
|
|
python scripts/aws_eda.py --help
|
|
python scripts/cloud-chat.py --help
|
|
python scripts/whatsapp_send.py --help
|
|
```
|
|
|