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.
• cliente y app deben ser cortos y claros.
• ambiente debe ser uno de: prod, staging, dev, test.
• No repetir palabras entre cliente y app.

Ejemplos válidos

• trantor-form990-prod
• agrosuper-intranet-staging
• tallerdigital-crm-prod
• luksic-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)

Preparar proyecto WordPress Bedrock en local

Objetivo: inicializar base Bedrock y dejar repositorio listo para Forge.

Crear proyecto

composer create-project roots/bedrock <repo>
cd <repo>

Inicializar Git

git init
git add .
git commit -m "initial bedrock setup"

Verificación

Confirmar presencia de composer.json, config/, web/ y .env.example.

Crear sitio Bedrock y base de datos en Forge

Objetivo: crear sitio compatible con Bedrock y preparar base de datos.

Crear sitio

En Forge (Sites -> New Site) usar:

• Project Type: General PHP
• Web Directory: /web (crítico para Bedrock)
• Root Domain: <dominio>

Crear base de datos

En Forge (Database):

• Crear base MySQL
• Crear usuario
• Asignar usuario

Guardar credenciales para el .env.

Conectar repositorio y habilitar deploy

Objetivo: enlazar Git con el sitio y habilitar despliegue continuo desde Forge.

Conectar repositorio

En el sitio de Forge, configurar:

• Proveedor Git (GitHub, GitLab o Bitbucket)
• Repositorio
• Rama (main o master)

Configurar deploy script

Definir script de despliegue del proyecto y guardar cambios.

Habilitar Quick Deploy

Activar Quick Deploy para que cada push a la rama de despliegue ejecute deploy automático.

Verificación

Realizar un commit de prueba y confirmar en Forge que el deploy termina en Successful.

Configurar .env de Bedrock en servidor

Objetivo: configurar conexión DB y variables clave de WordPress en producción.

Crear y editar .env

ssh forge@<ip_servidor>
cd /home/forge/<dominio>
cp .env.example .env

Configurar valores mínimos:

DB_NAME='<db_name>'
DB_USER='<db_user>'
DB_PASSWORD='<db_pass>'
DB_HOST='127.0.0.1'

WP_ENV='production'
WP_HOME='https://<dominio>'
WP_SITEURL='${WP_HOME}/wp'

# Security keys (8)
AUTH_KEY='...'
SECURE_AUTH_KEY='...'
LOGGED_IN_KEY='...'
NONCE_KEY='...'
AUTH_SALT='...'
SECURE_AUTH_SALT='...'
LOGGED_IN_SALT='...'
NONCE_SALT='...'

Generar keys en https://roots.io/salts.html.

Verificación

Confirmar que .env no exista versionado en Git:

git ls-files | grep .env

Esperado: sin resultados.

Instalar dependencias Composer de Bedrock

Objetivo: instalar WordPress core, mu-plugins y dependencias del proyecto.

Instalar dependencias

ssh forge@<ip_servidor>
cd /home/forge/<dominio>
composer install --no-interaction --prefer-dist --optimize-autoloader --no-dev

Verificación

ls -la web/wp/

Esperado: directorios wp-admin y wp-includes presentes.

Configurar SSL en Forge (Let’s Encrypt)

Objetivo: habilitar HTTPS válido para el dominio del sitio.

Verificar DNS antes de emitir certificado

El dominio debe resolver a la IP del servidor.

dig <dominio> +short

Emitir certificado en Forge

En el sitio: SSL -> Let's Encrypt -> seleccionar dominios -> Obtain Certificate.

Verificación

curl -I https://<dominio>
openssl s_client -connect <dominio>:443 -servername <dominio> < /dev/null 2>/dev/null | grep "Verify return code"

Esperado: HTTP 200 y Verify return code: 0 (ok).

Instalar WordPress en Bedrock

Objetivo: completar instalación funcional de WordPress sobre Bedrock.

Instalar dependencias

ssh forge@<ip_servidor>
cd /home/forge/<dominio>
composer install --no-interaction --prefer-dist --optimize-autoloader

Ejecutar instalación

Opción navegador: abrir https://<dominio>/wp/wp-admin/install.php.

Opción WP-CLI:

wp core install \
  --url="https://<dominio>" \
  --title="<site_title>" \
  --admin_user="<admin_user>" \
  --admin_password="<admin_pass>" \
  --admin_email="<admin_email>"

Configurar deploy script para Bedrock

Objetivo: asegurar despliegues consistentes de código y dependencias Composer.

Script recomendado

cd /home/forge/<dominio>
git pull origin $FORGE_SITE_BRANCH
composer install --no-interaction --prefer-dist --optimize-autoloader
wp core verify-checksums || true

Verificación

Hacer Deploy Now y validar acceso a home y admin.

Validación final de Bedrock en Forge

Objetivo: validar sitio, admin y estructura mínima Bedrock.

Pruebas mínimas

curl -I https://<dominio>
curl -I https://<dominio>/wp/wp-admin/

ssh forge@<ip_servidor>
cd /home/forge/<dominio>
ls -la

Esperado: respuesta HTTP correcta y estructura con config/, vendor/, web/.