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.
• ambiente debe ser uno de: prd, stg, dev, qa.
• En el caso de plataformas, usar td como cliente y el nombre de la plataforma como proyecto. Ejemplo: td-mono-dev-yii01

Ejemplos válidos

• multi-prd-dk01
• td-mono-prd-yii01
• agro-japon-prd-wp01
• cnc-prd-lv01

Ejemplos inválidos

• multi-prd-dk 01 (espacio)
• multi-prd-dk_01 (guión bajo)
• multicliente-produccion-dokku01 (nombres largos)

Instalación de script base

🎯 Objetivo: Preparar e instalar la última versión del script de configuración base.

Clonar repositorio

El repositorio tdserverscripts contiene todos los scripts y archivos necesarios para la configuración de cada servidor. Este repositorio es privado, por lo que debe ser clonado en tu ordenador local y luego copiado al servidor.

# Clonar repositorio
cd ~/proyectos  # directorio donde guardar el script
git clone git@github.com:tallerdigitalcl/tdserverscripts.git
cd tdserverscripts

# Verificar integridad
ls -lh bin/system/server-base-setup.sh

Copiar archivos al servidor

Copia la carpeta de scripts al servidor usando SCP.

scp -r tdserverscripts root@SERVER_IP:/root/

Reemplaza SERVER_IP con la dirección IP del servidor.

Ejecutar script de configuración

Una vez copiados los archivos, conéctate al servidor mediante SSH, verifica que los archivos existan en /root/tdserverscripts y ejecuta el script de configuración base.

# Conectar al servidor
ssh root@SERVER_IP

# Navegar a la ruta del script
cd /root/tdserverscripts

# Ejecutar el script
sudo bash bin/system/server-base-setup.sh

El script muestra un asistente interactivo con todas las opciones disponibles para la configuración del servidor. Sigue las instrucciones del asistente para completar la configuración.

Las configuraciones que el script aplica son:

| Paso | Nombre | |---|---|---| | 01 | Información y confirmación | | 02 | Hostname | | 03 | System Update y Essentials | | 04 | Timezone y Locale | | 05 | Usuario deploy & Hardening SSH | | 06 | Firewall base | | 07 | Swap space | | 08 | Optimizaciones |

Verificar conexión usando deploy

Antes de cerrar la terminal o continuar, es importante verificar que la conexión mediante SSH usando el usuario deploy sea exitosa. Abrir una terminal diferente a la actual y ejecutar el siguiente comando:

ssh deploy@SERVER_IP

Reemplaza SERVER_IP con la dirección IP del servidor.

Resolución de errores

🎯 Objetivo: Resolver cualquier error que pueda surgir durante la instalación del script base.

Error “Connection refused” al intentar conectar con el usuario deploy ❌

Posible causa: El usuario no está conectado mediante la red WARP de Cloudflare. Solución: Verifica que el usuario esté conectado mediante la red WARP de Cloudflare y que la llave SSH esté configurada correctamente.

Error “Permission denied (publickey)” al intentar conectar con el usuario deploy ❌

Posible causa: La llave SSH del usuario deploy no está configurada correctamente. Solución: Verifica que la llave SSH esté configurada correctamente y que el usuario tenga los permisos adecuados.

Los comandos con sudo solicitan contraseña ❌

Posible causa: La configuración de suoders no fue aplicada correctamente. Solución: Como usuario root, ejecutar los siguientes comandos:

cat /etc/sudoers.d/deploy

# El archivo debería contener la siguiente línea:
deploy ALL=(ALL) NOPASSWD: ALL

# Si no existe o es incorrecto, crear o corregir:
echo "deploy ALL=(ALL) NOPASSWD:ALL" | sudo tee /etc/sudoers.d/deploy
sudo chmod 0440 /etc/sudoers.d/deploy

# Verificar sintaxis
sudo visudo -c

Script falla en System Update ❌

Posible causa: Repositorios del servidor tienen problemas o servidor sin internet. Solución: Ejecutar los siguientes comandos:

# Verificar conectividad
ping -c 3 8.8.8.8
ping -c 3 google.com

# Verificar repositorios
apt-get update

# Si hay errores con repos, actualizar:
# Para Debian:
sudo sed -i 's/deb.debian.org/ftp.debian.org/g' /etc/apt/sources.list

# Reintentar ejecución de script