Desplegar una instancia
La página de despliegue es el paso 2 de 2: llega con una máquina ya elegida y decide qué se ejecuta en ella. Su encabezado dice Configurar y desplegar, y Volver a las GPU lo devuelve al mercado sin perder nada.
El formulario, campo por campo
Oferta
La oferta no es un campo del formulario —llega desde el mercado y se muestra como una tarjeta de resumen en la parte superior: modelo de GPU, tamaño del bloque, VRAM por tarjeta, ubicación y precio por hora. Es fija para este despliegue. Para cambiar de máquina, vuelva atrás y elija otra tarjeta.
Hay dos estados que sustituyen al formulario en lugar de mostrarlo:
| Qué ve | Por qué |
|---|---|
| "Ninguna GPU seleccionada" | Abrió la página sin pasar por el mercado |
| "Esa oferta ya no está" | La oferta se retiró del catálogo entre la selección y ahora |
Plantilla
Una cuadrícula de tarjetas de plantilla, cada una comprobada contra la máquina que eligió. Las plantillas incompatibles se atenúan y no se pueden pulsar, y la primera compatible viene preseleccionada. El selector lista las plantillas curadas y, si llegó pulsando Lanzar en la galería, esa plantilla fijada al principio. Consulte Elegir una plantilla.
Disco
Un deslizante, con el valor actual mostrado encima en GB o TB.
| Mínimo | 10 GB |
| Máximo | El disco de la máquina host, mostrado bajo el deslizante como "Máx. N en esta máquina" |
| Paso | 10 GB |
| Predeterminado | 50 GB |
La API acepta disk_gb desde 10 hasta 20,000, pero la solicitud se rechaza si pide más de lo que la máquina elegida tiene físicamente, y el error le indica el límite de esa máquina.
Dimensione esto de forma deliberada. El disco es lo que paga mientras la instancia está detenida, a la tarifa por GB al mes impresa bajo el deslizante, y no se puede redimensionar después: un disco más grande significa una instancia nueva.
Clave SSH
Un menú desplegable con las claves SSH de su cuenta, con Sin clave (solo terminal web) como valor predeterminado. Agregar clave, al lado, abre el mismo diálogo que la página de claves SSH, así que puede pegar una clave pública sin salir del formulario.
Las claves SSH le pertenecen a usted, no a su organización: los miembros del equipo que despliegan desde la misma organización adjuntan cada uno la suya. La clave se instala en el lanzamiento, así que agregar una clave después no llega a una instancia que ya está en ejecución: el comando de conexión de la página de la instancia se autentica con lo que haya adjuntado aquí.
Dejarlo en Sin clave lanza la instancia sin ninguna clave autorizada, lo que significa que no hay sesión ssh. Elíjalo solo cuando la plantilla ofrezca un punto de entrada por navegador, como una plantilla jupyter.
Etiqueta
Texto libre opcional, de hasta 64 caracteres, para distinguir instancias más adelante: llama-finetune en lugar de un prefijo UUID. Sin ella, la consola recurre a los primeros ocho caracteres del id de la instancia. La etiqueta es solo metadatos; nada dentro del contenedor la ve.
Sobrescrituras de entorno
El formulario de la consola no las expone. La API sí: env_overrides en POST /v1/instances acepta una lista de pares {key, value} que sobrescriben por clave el entorno declarado por la plantilla, que es la forma de rellenar el secreto en blanco de una plantilla sin editar la plantilla.
Se aplican tres reglas:
- Su valor gana sobre el valor de la plantilla para la misma clave.
- Una entrada sin valor se descarta en lugar de establecerse como cadena vacía.
- Las variables propias de la plataforma siempre ganan sobre las suyas. No puede ocultar
JUPYTER_TOKENniGPU_COUNT.
Consulte Variables de entorno y API de instancias.
La solicitud
Todo lo anterior llega en una sola llamada:
{
"offer_id": "e1c0…",
"template_id": "9b74…",
"disk_gb": 100,
"label": "llama-finetune",
"ssh_key_id": "3f21…",
"env_overrides": [{ "key": "HF_TOKEN", "value": "hf_…" }]
}
label, ssh_key_id y env_overrides son opcionales; los tres primeros campos no.
Antes de que el botón funcione
El botón Desplegar instancia permanece deshabilitado mientras se cumpla cualquiera de estas condiciones:
| Condición | Qué hacer |
|---|---|
| El saldo es cero o menor | Agregue créditos. Los administradores tienen un acceso directo Agregar créditos en el panel; a los miembros se les indica que pidan a un administrador |
| La plantilla seleccionada es incompatible con la máquina | Elija otra plantilla, u otra GPU |
| No hay ninguna plantilla seleccionada | Elija una |
| Ya hay un despliegue en curso | Espere: el botón dice "Desplegando…" |
Después de presionar desplegar
- La oferta se bloquea y se vuelve a comprobar. Si ya no está disponible, el despliegue falla aquí y no se ejecuta nada más.
- Se validan el disco, la plantilla y la clave SSH, y luego se comprueba su saldo. Tiene que cubrir una hora de la instancia —GPU más el disco que eligió—, no solo estar por encima de cero.
- Solo entonces se resta su unidad de cada forma de esa máquina que la solape, y la instancia se crea en
creating. Nadie puede tomar sus GPU; la misma oferta sigue alquilable si a la máquina le quedan libres. La consola lo lleva a su página con el mensaje "Desplegando: su instancia se está iniciando". - La página se consulta a sí misma cada tres segundos mientras la instancia está en un estado transitorio, y la indicación en pantalla dice "Aprovisionando su máquina: normalmente menos de 20 segundos".
- Cuando la instancia llega a
running, aparecen los detalles de conexión: el comandossh -p <port> <user>@<host>ya preparado y, para las plantillasjupyter, un botón Abrir JupyterLab. Hasta entonces, la pestaña indica que los detalles de conexión aparecen una vez que la instancia esté en ejecución.
La facturación no empieza cuando presiona el botón. El medidor arranca cuando la carga de trabajo informa running, así que la ventana de aprovisionamiento no cuesta nada, y tampoco un despliegue que nunca llega ahí.
Cuando un despliegue falla
| Error | Significado | Qué hace la consola |
|---|---|---|
| Oferta no disponible | Alguien reclamó ese bloque primero | Lo devuelve al mercado |
| Saldo insuficiente | El saldo no cubre una hora de esta instancia | Actualiza el saldo y solicita créditos |
| Disco demasiado grande | disk_gb supera el disco de la máquina host | Informa el límite de la máquina |
| Plantilla no encontrada | El id de la plantilla es desconocido o ya no está activo | Muestra el mensaje en línea |
| Clave SSH no encontrada | El id de la clave no es de las suyas | Muestra el mensaje en línea |
| Máquina sin capacidad de VM | Una plantilla vm en una máquina que no puede ejecutar VM | Muestra el mensaje en línea |
| Máquina en mantenimiento | La máquina está reservada para quedar fuera de línea demasiado pronto como para arrancar en ella | Indica la fecha y lo devuelve al mercado |
Un despliegue rechazado en cualquiera de los pasos anteriores no crea nada ni cobra nada. Un despliegue que supera esos pasos y luego falla durante el aprovisionamiento es distinto: la fila de la instancia existe, acaba en error y se limpia automáticamente — nunca factura, porque el medidor arranca cuando la carga de trabajo informa running y esta nunca lo hizo. Lista completa en Códigos de error.
No hay paso de confirmación después de esta página. Desde el momento en que la instancia llega a running se le factura por segundo, y detenerla más tarde sigue facturando el disco. Lea Detener frente a destruir antes de dejar una instancia desatendida.