المهارات routeros-app-yaml
📦

routeros-app-yaml

آمن ⚙️ الأوامر الخارجية🌐 الوصول إلى الشبكة

Escribir configuraciones YAML para contenedores RouterOS

Crea y valida configuraciones YAML para aplicaciones de contenedores MikroTik RouterOS. Esta habilidad te ayuda a definir servicios, puertos, volúmenes y redes para el subsistema RouterOS /app sin necesidad de conocimientos de docker-compose.

يدعم: Claude Codex Code(CC)
📊 70 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "routeros-app-yaml". Create a /app YAML for a Home Assistant container with persistent storage on port 8123

النتيجة المتوقعة:

  • Un archivo YAML con secciones de nombre, servicios, volúmenes y redes.
  • El servicio web usa la imagen ghcr.io/home-assistant/home-assistant con el puerto 8123 mapeado.
  • Un volumen nombrado home-assistant-config se monta en /config.
  • La política de reinicio se establece en always para confiabilidad.

استخدام "routeros-app-yaml". Show the difference between old and new port formats in RouterOS YAML

النتيجة المتوقعة:

  • El estilo OCI antiguo usa una barra antes del protocolo: 8080:80/tcp
  • El nuevo estilo de RouterOS 7.23 usa dos puntos: 8080:80:web:tcp
  • Ambos formatos son válidos. Los nuevos despliegues desde 7.23beta2 deben preferir el estilo de dos puntos.
  • La sintaxis de objeto de formato largo con campos target, published y protocol funciona en todas las versiones.

التدقيق الأمني

آمن
v3 • 5/9/2026

This skill is a pure documentation resource containing markdown files explaining RouterOS /app YAML format. The static scanner flagged 159 potential issues, but all are false positives: backtick characters in markdown syntax were misidentified as Ruby/shell execution; YAML example keys were misidentified as cryptographic or reconnaissance patterns; and placeholder URLs were flagged as hardcoded network calls. After manual review, no actual security risks exist in this documentation-only skill.

2
الملفات التي تم فحصها
453
الأسطر التي تم تحليلها
2
النتائج
3
إجمالي عمليات التدقيق

عوامل الخطر

⚙️ الأوامر الخارجية
لم يتم تسجيل أي مواقع محددة
🌐 الوصول إلى الشبكة
لم يتم تسجيل أي مواقع محددة
تم تدقيقه بواسطة: claude عرض سجل التدقيق →

درجة الجودة

41
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
21
المجتمع
100
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

Definir una aplicación de contenedor para RouterOS

Un administrador de red escribe YAML para desplegar un stack de monitoreo con Grafana y Prometheus en un enrutador MikroTik usando el subsistema /app.

Migrar proyectos docker-compose a RouterOS

Un desarrollador adapta una configuración docker-compose existente al formato YAML de RouterOS /app, ajustando la sintaxis de puertos y eliminando propiedades no admitidas.

Crear una tienda de aplicaciones para despliegue en equipo

Un ingeniero de sistemas construye un archivo YAML tikappstore con aplicaciones preconfiguradas para despliegue consistente en múltiples dispositivos RouterOS.

جرّب هذه الموجهات

Crear una definición básica de /app
Write a RouterOS /app YAML file that runs an nginx container on port 8080 with a named volume for persistent data.
Convertir docker-compose a RouterOS YAML
Convert this docker-compose file to RouterOS /app YAML format. Highlight any properties that are not supported or behave differently.
Crear una aplicación de múltiples servicios
Write a RouterOS /app YAML with a web frontend, a PostgreSQL database, and a Redis cache. Include proper volume mounts, network isolation, and health checks.
Construir un archivo de tienda de aplicaciones
Create a RouterOS app store YAML file containing three applications: a web server, a database manager, and a monitoring dashboard. Each should have appropriate categories and metadata.

أفضل الممارسات

  • Siempre usa la extensión de archivo .tikapp.yaml para definiciones de aplicaciones RouterOS personalizadas para distinguirlas de archivos YAML genéricos.
  • Usa la variante de esquema *.editor.json durante el desarrollo para mejor autocompletado, luego valida contra *.latest.json antes del despliegue.
  • Prueba tu YAML en una máquina virtual RouterOS CHR antes de desplegar en hardware de producción para detectar errores de esquema temprano.

تجنب

  • Asumir compatibilidad completa con docker-compose. RouterOS /app solo admite un subconjunto de propiedades de compose y maneja algunas de manera diferente.
  • Usar la clave de nivel superior version. RouterOS ignora esta clave y no sirve ningún propósito en /app YAML.
  • Mezclar estilos de formato de puerto dentro de una sola cadena de puerto. Cada entrada de puerto debe usar exclusivamente el estilo OCI antiguo o el nuevo estilo de dos puntos.

الأسئلة المتكررة

¿Qué versión de RouterOS necesito para /app YAML?
La ruta /app está integrada a partir de RouterOS 7.21. La creación de aplicaciones personalizadas via /app/add requiere RouterOS 7.22 o posterior. El paquete extra de contenedor también debe estar instalado.
¿El YAML de RouterOS /app es igual que docker-compose?
No. El YAML de RouterOS /app se parece a docker-compose pero admite menos propiedades. Algunas propiedades como deploy y resources no están admitidas. La sintaxis de mapeo de puertos también difiere entre ambos.
¿Qué extensión de archivo debo usar para archivos /app YAML?
Usa .tikapp.yaml para definiciones de aplicaciones individuales y .tikappstore.yaml para archivos de tienda de aplicaciones. Estas convenciones ayudan a las herramientas y editores a aplicar el esquema correcto.
¿Cómo funcionan los marcadores de posición en RouterOS YAML?
Los marcadores de posición como [accessIP], [accessPort], [containerIP] y [routerIP] se expanden en tiempo de despliegue por RouterOS. Aparecen en mapeos de puertos, valores de entorno y contenido de configuración.
¿Puedo usar variables de entorno con nombres en minúsculas?
El esquema de validación estricta requiere nombres de variables de entorno en mayúsculas que coincidan con el patrón [A-Z_][A-Z0-9_]*. Usa la variante del esquema editor si necesitas nombres de variables con mayúsculas y minúsculas mezcladas.
¿Cómo agrego una aplicación personalizada a RouterOS?
Usa el comando CLI /app/add con el parámetro yaml-url apuntando a la URL de tu archivo YAML. Alternativamente, usa el endpoint PUT de la API REST en /app con el yaml-url en el cuerpo de la solicitud.

تفاصيل المطور

المؤلف

tikoci

الترخيص

MIT

مرجع

main

بنية الملفات