Fragmentos de comandos (Snippets)

En las operaciones de mantenimiento diarias, a menudo necesitamos introducir comandos complejos y largos (como limpieza de Docker, extracción de logs de K8s, etc.). La función de Fragmentos de comandos (Snippets) te permite guardar estos comandos e inyectarlos con un solo clic en cualquier servidor.

Crear y gestionar fragmentos

En el Modo Normal, presiona la tecla S mayúscula para abrir la ventana emergente del selector de fragmentos (Snippet Picker).

Presiona la tecla o para crear un nuevo fragmento.
En el formulario de creación, puedes especificar: nombre, un comando largo que necesite ser guardado, y etiquetas para una búsqueda rápida (como docker, network).
Puedes usar la tecla / en cualquier momento para hacer una búsqueda global en tu biblioteca de fragmentos.

Marcadores de posición de variables dinámicas

El aspecto más potente de los Snippets es el soporte para el reemplazo de variables dinámicas. Puedes escribir marcadores de posición en letras mayúsculas en tus comandos, con el formato {{VAR_NAME}}.

Por ejemplo:

docker logs -f --tail {{LINE_COUNT}} {{CONTAINER_NAME}}

Cuando seleccionas este fragmento en el selector y te preparas para ejecutarlo, PhanTerm no enviará el comando directamente. En su lugar, desplegará una serie de elegantes campos de entrada que te pedirán introducir los valores específicos de LINE_COUNT y CONTAINER_NAME uno por uno. Una vez que termines de escribir y presiones Enter, el comando compuesto se ejecutará inmediatamente en tu terminal actual.

Generación automática de fragmentos mediante AI Agent

Todos los fragmentos de comando de PhanTerm se almacenan en un archivo de configuración estructurado en formato YAML (snippets.yaml). ¡Esto permite que tu asistente de inteligencia artificial escriba y gestione directamente tu biblioteca de fragmentos!

Puedes copiar con un solo clic la instrucción de Prompt que aparece a continuación, enviársela a tu asistente de IA y reemplazar tus necesidades específicas en los corchetes finales:

Eres un experto en operaciones de servidores y en el terminal PhanTerm.
Por favor, escribe un conjunto de fragmentos de comandos (Snippets) dedicados para PhanTerm según mis necesidades.

### Normas de formato y restricciones
1. Debes generar código YAML válido, con una estructura de nivel superior que contenga `version: 1` y una lista `snippets:`.
2. Solo se permiten los siguientes campos: `name` (obligatorio), `command` (obligatorio), `description` (opcional), `tags` (lista opcional de cadenas).
3. **Bajo ninguna circunstancia** debes generar un campo ficticio llamado `variables:`.
4. Las variables deben declararse utilizando marcadores de posición en mayúsculas dentro de la cadena `command`, con el formato `{{VAR_NAME}}`. Por ejemplo: `docker logs {{CONTAINER_NAME}} --tail {{LINES}}`.
5. Se deben proporcionar `name` y `command`, y el `name` debe ser corto y con una intención clara.

### Ejemplo de referencia
version: 1
snippets:
  - name: Tail service logs
    command: journalctl -u {{SERVICE}} -n {{LINES}} -f
    description: Seguimiento continuo de los registros recientes de servicios del sistema
    tags:
      - logs
      - debug

### Mis necesidades son:
[Reemplaza esto con tu necesidad específica, por ejemplo: Dame un conjunto de fragmentos para limpiar los Evicted Pods de K8s y solucionar problemas de red]