PTENES
MÓDULO 4.1

🌐 Por qué lo local no basta

Si la automatización solo se ejecuta cuando abres la laptop, todavía no es una automatización: es una tarea que te espera. En este módulo entiendes la diferencia entre «ejecutarse en tu terminal» y «ejecutarse sola, las 24 horas del día, sin depender de que estés despierto».

6
Temas
28
Minutos
Intermedio
Nivel
Teoría
Tipo
0 de 60%
1

📌 La tarea pendiente

Hasta ahora hiciste que tu agente de código respondiera a solicitudes: abres la terminal (el cuadro de texto que le da órdenes directamente a la computadora), escribes lo que quieres, el agente lo ejecuta y tú ves el resultado. Esto funciona muy bien — pero hay una condición oculta: tienes que estar ahí. Computadora encendida, aplicación abierta, tú presente para presionar Enter.

Piensa en una tarea «pendiente»: es ese recordatorio que espera a que alguien llegue para ejecutarlo. Escribiste una nota adhesiva: «llamar al proveedor a las 9 a. m.» y la pegaste en la pantalla — pero la nota no llama por sí sola. Solo existe hasta que llegas, la ves y actúas. Una automatización que solo se ejecuta en tu terminal es exactamente eso: una nota adhesiva sofisticada. Sofisticada porque, cuando llegas y presionas el botón, hace todo el trabajo por sí sola. Pero todavía depende de que alguien llegue.

Esto cambia todo en la práctica: si la automatización debería ejecutarse todos los días a las 7 de la mañana, pero tu laptop estaba apagada (o cerrada, o sin internet, o estabas de vacaciones), simplemente no se ejecutó. Nadie te avisa. No existe un "lo intentó y falló": hay silencio total, porque no se activó nada.

💡 Concepto principal

"Ejecutar localmente" quiere decir que el código solo se ejecuta mientras tu computadora está encendida y el programa está abierto: la ejecución depende físicamente de tu máquina. Es excelente para probar y aprender (es lo que hiciste en las rutas 1, 2 y 3), pero es demasiado frágil para confiarle el trabajo real.

  • •Local = depende de que estés presente y de que tu computadora esté encendida.
  • •Automatización real = se ejecuta sola, en el momento adecuado, aunque estés durmiendo, de viaje o con la laptop en la mochila.
2

🌙 El empleado que trabaja incluso mientras duermes

Ahora cambia la imagen del post-it por la de un empleado de verdad. Un empleado presencial solo trabaja cuando está en la oficina, junto a ti; si cierras la oficina, se detiene. Un empleado remoto, contratado e instalado en otro lugar, sigue trabajando aunque TU edificio esté cerrado. Tiene su propio espacio, sus propias llaves y cumple el horario acordado, independientemente de dónde estés.

¿Eres nuevo aquí? Nube (cloud) es el nombre común para «una computadora de otra empresa que alquilas por internet, encendida las 24 horas del día, en un centro de datos, que nunca se apaga porque cerraste la laptop». Cuando decimos que una automatización «se ejecuta en la nube», queremos decir que su código está ejecutándose en una de esas máquinas remotas, no en la tuya.

✗ Ejecutar localmente (tu terminal)

  • ✗Solo se ejecuta si la computadora está encendida y tú estás presente
  • ✗Cierras la laptop y viajas sin internet: la automatización simplemente no se ejecuta
  • ✗Ningún aviso de que «debería» haberse ejecutado y no lo hizo

✓ Ejecutándose 24/7 en la nube

  • ✓Ejecuta a la hora programada, mientras duermes, estás sin conexión o en otro país
  • ✓La computadora que ejecuta no es la tuya: es un servidor remoto contratado para eso
  • ✓Genera un registro (más información en el tema 3) que muestra lo que ocurrió, aunque no lo revises en el momento

⚠️ Atención

"Ejecutar en la nube" no es magia ni es caro por defecto: simplemente consiste en publicar el mismo código que ya probaste localmente en un lugar que permanece siempre encendido. El Módulo 4.2 muestra exactamente el proceso técnico, paso a paso.

3

🔍 Por dentro: qué cambia técnicamente

¿Eres nuevo aquí? Código es el conjunto de instrucciones escritas que le dicen a la computadora exactamente qué hacer, paso a paso: es lo que tu agente escribe cuando le pides automatizar algo. Cuando este código se ejecuta localmente, solo queda en la memoria de tu computadora, como una nota que solo existe en tu escritorio. Para que exista «en otro lugar» y esté siempre disponible, hay que llevarlo allí.

Tu laptop apagada 🔒 automatización detenida nada se ejecuta mientras esté así silencio: sin registro, sin aviso publicar (módulo 4.2) Servidor en la nube — 24/7 ⏰ se ejecuta a la hora programada marcado, por su cuenta 📋 genera log de lo que pasó sigue ejecutándose incluso con tu laptop cerrada a un lado

Leyenda: el mismo código, dos destinos distintos. A la izquierda depende de que tu laptop esté encendida; a la derecha vive en un servidor que nunca se apaga y registra todo lo que hace.

🔍 Por dentro

  • Repositorio: una carpeta especial (generalmente en GitHub) donde se guarda el código con un historial de todos los cambios; desde allí la nube «extrae» el código para ejecutarlo. Se profundiza en el módulo 4.2.
  • Entorno de producción: el término técnico para el lugar (servidor en la nube) donde se ejecuta la versión «real» de la automatización, que te atiende a ti o a otras personas de verdad, a diferencia de tu terminal, que es el entorno de prueba (ampliado en el módulo 4.3).
  • Log: la lista de eventos que la automatización fue registrando mientras se ejecutaba — así es como "ves" lo que pasó cuando no estabas presente para verlo en vivo.
4

🚀 El camino del código a la nube, en orden

Pasar del entorno local a la nube no es un solo paso: es una secuencia de estaciones, cada una entregando el trabajo a la siguiente. El Módulo 4.2 detalla cada estación a fondo; aquí ya ves el recorrido completo para entender por qué existe.

1

El agente escribe el código

No necesitas escribir esto a mano. Describes lo que quieres y el agente lo escribe en TypeScript (el lenguaje de programación que se usa en esta ruta — solo una forma estandarizada de escribir instrucciones para la computadora), y tú lees y apruebas antes de continuar.

2

El código va al repositorio

Usando git (la herramienta que guarda el historial de versiones de tu código, como un "guardar" que recuerda todo lo que ya cambió), el código se envía a una copia guardada en GitHub: el repositorio.

3

La plataforma de ejecución trae y ejecuta

Un servicio en la nube (usaremos Trigger.dev en esta ruta) busca este código en el repositorio y lo mantiene en ejecución las 24 horas del día — a eso se le llama deploy: publicar el código en un lugar donde se ejecuta solo.

4

Haces seguimiento desde el panel

Sin necesidad de saber leer TypeScript: miras el registro de ejecuciones para saber si se ejecutó, cuándo y si funcionó. Ese es el enfoque del módulo 4.7.

💡 Concepto principal

Llamamos a esta secuencia pipeline — una línea de montaje donde cada estación hace una parte del trabajo y se la entrega a la siguiente. Tú participas en los extremos (pides y apruebas el código, revisas el panel); el tramo intermedio es automático.

5

🖥️ Siente la diferencia en la práctica: ejecutarla localmente una vez

Antes de que nada pase a la nube, conviene experimentar qué significa «ejecutar en local»: ejecutas el comando, el proceso funciona mientras la terminal (la ventana de comandos) está abierta y desaparece cuando la cierras. No hay magia: eso es exactamente lo que los módulos 4.2 a 4.6 van a reemplazar por algo que siga funcionando sin ti.

Objetivo: ejecutar un script (un archivo de instrucciones sencillo) localmente en tu terminal y observar que solo existe mientras lo mantienes abierto.

cd minha-automacao
node verificar-estoque.js

# saída esperada no terminal:
# [12:04:02] Verificando estoque...
# [12:04:03] 3 produtos abaixo do mínimo. E-mail simulado enviado.
# [12:04:03] Processo encerrado.

Cómo verificar: cierra la terminal (o desconecta el wifi, o apaga la laptop) y espera hasta la hora en que esta automatización "debería" volver a ejecutarse mañana por la mañana. No se ejecutará, porque no hay nada más que tu comando manual que la mantenga activa. Esa es la brecha exacta que una variable de entorno (una "clave secreta" configurada en un servidor, como SUA_CHAVE_AQUI, explicada en detalle en el módulo 4.4) y una plataforma como Trigger.dev se encargan de resolverlo: el mismo código pasa a ejecutarse por su cuenta, en un servidor que nunca cierra la terminal.

✗ Lo que acabas de hacer (local)

  • ✗Se ejecutó una sola vez, en el momento, porque tú lo pediste
  • ✗Si cierras la terminal, el proceso también termina

✓ Lo que construirá el módulo 4.6

  • ✓El mismo script publicado, ejecutándose solo todos los días a la hora programada
  • ✓Sigue funcionando incluso si llevas semanas con la terminal cerrada
6

🗺️ Consolidar el modelo mental

Toda la Trilha 4 existe para cruzar este puente: código en tu computadora → repositorio → plataforma de ejecución en la nube. No te convertirás en programador: el agente escribe el TypeScript, lees, apruebas y supervisas desde el panel. Pero necesitas entender esta conexión para confiar en el resultado y saber dónde mirar cuando algo falle.

📊 Antes de continuar, esto debe quedar claro

  • Local: depende de que tu computador esté encendido: bueno para probar, malo para confiar.
  • Nube: un servidor remoto que nunca se apaga por tu causa: funciona solo.
  • Pipeline: código → repositorio (git) → plataforma de ejecución → panel de logs.
  • Tú: pide, lee, aprueba y supervisa — no necesita escribir ni leer TypeScript línea por línea.

🎯 Concepto principal

  • •La automatización real se mide por tu ausencia — si necesita que estés ahí, sigue siendo una tarea manual disfrazada.
  • •Salir del entorno local no es «demasiado avanzado»: es una secuencia de pasos pequeños, cada uno cubierto en un módulo de esta ruta.

Verificación rápida (opcional): ¿qué es lo que realmente separa "ejecutar en local" de una "automatización de verdad"?

✅ Resumen del módulo

✓
Local × nube: el local depende de que tú estés presente; la nube funciona sola, las 24 horas del día.
✓
La tarea pendiente: una automatización que solo se ejecuta cuando llegas sigue siendo trabajo manual disfrazado.
✓
El pipeline: código → repositorio (git) → plataforma de ejecución → panel de logs.
✓
Tu papel: pedir, leer, aprobar y hacer seguimiento por el log — no escribir TypeScript a mano.

Próximo módulo:

4.2 — El pipeline en 4 estaciones