Esta referencia centraliza las reglas de nomenclatura usadas en los playbooks y módulos operativos.
Servidores
Servidores
Módulo fuente: Nomenclatura de servidores
Nomenclatura de servidores
🎯 Objetivo: Definir nombres consistentes para los servidores.
Formato obligatorio
[cliente]-[proyecto]-[ambiente]-[tipo][número]
| Componente | Obligatorio | Descripción | Opciones válidas | Ejemplo |
|---|---|---|---|---|
| cliente | ✅ | Nombre del cliente | Nombre corto del cliente, máximo 4 caracteres. En el caso de servidores multiclientes, debe ser multi | agro, cnc, multi |
| proyecto | ⚠️ | Nombre del proyecto | Nombre corto descriptivo del proyecto | crm, japon, intranet |
| ambiente | ✅ | Ambiente del servidor | prd, stg, dev, qa | prd, stg, dev, qa |
| tipo | ✅ | Tipo de servidor | Tecnología abreviada del servidor | dk (dokku), lv (laravel), wp, yii |
| número | ✅ | Número de servidor | 2 dígitos con cero inicial | 01, 02, 03 |
Reglas
- Todo en minúsculas.
- Solo letras, números y guión medio (
-). - Sin espacios, tildes,
ñ, guión bajo (_) ni caracteres especiales. - Todos los campos deben ser cortos y claros. Usar acrónimos y abreviaturas cuando sea posible.
ambientedebe ser uno de:prd,stg,dev,qa.- En el caso de plataformas, usar
tdcomo cliente y el nombre de la plataforma como proyecto. Ejemplo:td-mono-dev-yii01
Ejemplos válidos
multi-prd-dk01td-mono-prd-yii01agro-japon-prd-wp01cnc-prd-lv01
Ejemplos inválidos
multi-prd-dk 01(espacio)multi-prd-dk_01(guión bajo)multicliente-produccion-dokku01(nombres largos)
Apps
Apps
Módulo fuente: Nomenclatura de aplicaciones
Nomenclatura de aplicaciones
🎯 Objetivo: Definir nombres consistentes para las aplicaciones.
Formato obligatorio
[cliente]-[app]-[ambiente]
Reglas
- Todo en minúsculas.
- Solo letras, números y guión medio (
-). - Sin espacios, tildes,
ñ, guión bajo (_) ni caracteres especiales. clienteyappdeben ser cortos y claros.ambientedebe ser uno de:prod,staging,dev,test.- No repetir palabras entre
clienteyapp.
Ejemplos válidos
trantor-form990-prodagrosuper-intranet-stagingtallerdigital-crm-prodluksic-portal-dev
Ejemplos inválidos
Trantor-Form990-Prod(mayúsculas)trantor_form990_prod(guión bajo)trantor-form 990-prod(espacio)trantor-form990-production(ambiente no estándar)trantor--form990-prod(doble guión)