Compare commits

..
Author SHA1 Message Date
danoloan10 7af3e36de4 ci(deploy): el pipeline corre entero en las PRs menos el despliegue
pipeline / Desplegar en el host (pull_request) Skipped
pipeline / Build + comprobaciones (pull_request) Successful in 15s
- Nuevo trigger pull_request: el job 'build' valida dependencias, build,
  smoke de noindex y sintaxis de scripts/deploy.sh sin tocar el host.
- El job 'deploy' queda condicionado a github.event_name != 'pull_request':
  sólo despliega en push a master o workflow_dispatch.
- Workflow renombrado a 'pipeline' (fichero sigue siendo deploy.yml) y
  concurrency agrupada por ref.
- README: documentado el comportamiento en PRs vs master.
2026-10-26 15:54:23 +01:00
4 changed files with 69 additions and 78 deletions
+37 -6
View File
@@ -2,17 +2,21 @@
#
# El runner self-hosted de Gitea corre como root en el mismo host que sirve
# git.localesp.es y remigracion.jumpingcrab.com, así que no hay SSH ni
# secretos: el job compila y luego ejecuta scripts/deploy.sh.
# secretos: el job compila y, si toca desplegar, ejecuta scripts/deploy.sh.
#
# Destino: /opt/remigracion/dist + vhost nginx HTTP (sin TLS: el DNS de
# remigracion.jumpingcrab.com no permite emitir Let's Encrypt). El entorno es
# privado: noindex por cabecera, meta robots y robots.txt.
name: deploy
# En pull_request el pipeline corre ENTERO menos el despliegue: sirve para
# validar el build y las comprobaciones antes de mergear. Sólo se despliega
# en push a master (o con workflow_dispatch).
#
# Destino: /opt/remigracion/dist + vhost nginx HTTP. Entorno privado:
# noindex por cabecera, meta robots y robots.txt.
name: pipeline
on:
push:
branches:
- master
pull_request:
workflow_dispatch:
concurrency:
@@ -20,7 +24,8 @@ concurrency:
cancel-in-progress: true
jobs:
deploy:
build:
name: Build + comprobaciones
runs-on: self-hosted
timeout-minutes: 15
steps:
@@ -41,6 +46,32 @@ jobs:
set -euo pipefail
grep -qi 'name="robots"' dist/index.html
grep -q 'Disallow: /' dist/robots.txt
echo "OK: dist/index.html lleva meta robots y dist/robots.txt bloquea todo"
- name: Comprobar que el script de despliegue es válido
shell: bash
run: |
bash -n scripts/deploy.sh
echo "OK: scripts/deploy.sh sin errores de sintaxis"
deploy:
name: Desplegar en el host
runs-on: self-hosted
needs: build
# Clave: en PRs no se despliega nada; sólo se valida el pipeline.
if: github.event_name != 'pull_request'
timeout-minutes: 15
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Dependencias
shell: bash
run: npm ci --no-audit --no-fund
- name: Build (vite)
shell: bash
run: npm run build
- name: Desplegar en el host
shell: bash
+19 -16
View File
@@ -60,14 +60,11 @@ El JSON tiene tres claves:
## Despliegue
Entorno de previsualización privado en **<https://remigracion.jumpingcrab.com/>**
Entorno de previsualización privado en **<http://remigracion.jumpingcrab.com/>**
(mismo host que `localesp.es` y `git.localesp.es`).
- **HTTP y HTTPS:** el vhost escucha en 80 y 443 (mismo `server` block, así
que las reglas anti-indexación no se duplican). Certificado Let's Encrypt
emitido con webroot en `/var/www/letsencrypt` y renovado por
`certbot-renew.timer`; el `--deploy-hook` recarga nginx. El puerto 80 no
redirige a 443: sirve la app igual.
- **Sin TLS a propósito:** el DNS de `remigracion.jumpingcrab.com` no permite
emitir un certificado Let's Encrypt, así que se sirve sólo por HTTP.
- **No indexable:** el entorno no debe aparecer en buscadores, agregadores ni
crawlers de IA. Se aplica en tres capas independientes:
1. nginx devuelve `403` a los user-agents de rastreadores conocidos.
@@ -76,10 +73,19 @@ Entorno de previsualización privado en **<https://remigracion.jumpingcrab.com/>
3. `public/robots.txt` (`Disallow: /`) y `<meta name="robots">` en
`index.html`.
Automatización: `.gitea/workflows/deploy.yml` compila y publica en cada push a
`master` (también se puede lanzar a mano con `workflow_dispatch`). El runner
self-hosted de Gitea corre como root en el mismo host, así que el job no
necesita SSH ni secretos.
Automatización: `.gitea/workflows/deploy.yml` (workflow `pipeline`) tiene dos
jobs:
- **`build`** (siempre): `npm ci`, `npm run build`, comprobación de que el
bundle lleva `meta robots` + `robots.txt`, y `bash -n` del script de deploy.
- **`deploy`** (sólo si NO es una PR): repite el build y ejecuta
`scripts/deploy.sh`.
En las **pull requests** el pipeline corre entero menos el despliegue, así que
sirve para verificar el CI antes de mergear. Se despliega en cada push a
`master` y también a mano con `workflow_dispatch`. El runner self-hosted de
Gitea corre como root en el mismo host, así que el job no necesita SSH ni
secretos.
Artefactos y servicios en el host (mismo patrón que
`prototipo-yb01-ef.localesp.es`):
@@ -88,8 +94,6 @@ Artefactos y servicios en el host (mismo patrón que
|---|---|
| Build estático (raíz de nginx) | `/opt/remigracion/dist` |
| vhost nginx (fuente en `deploy/nginx.conf`) | `/etc/nginx/conf.d/remigracion.jumpingcrab.com.conf` |
| Certificado Let's Encrypt | `/etc/letsencrypt/live/remigracion.jumpingcrab.com/` |
| Webroot ACME | `/var/www/letsencrypt` |
| Script de despliegue | `scripts/deploy.sh` |
Despliegue manual:
@@ -99,10 +103,9 @@ npm ci && npm run build
sudo bash scripts/deploy.sh
```
El script sincroniza `dist/`, crea el webroot ACME, etiqueta el árbol para
SELinux (`httpd_sys_content_t`), instala el vhost si cambió (con rollback si
`nginx -t` falla), recarga nginx y verifica `200` en HTTP y HTTPS (validando
el certificado) más la cabecera `X-Robots-Tag`.
El script sincroniza `dist/`, etiqueta el árbol para SELinux
(`httpd_sys_content_t`), instala el vhost si cambió (con rollback si
`nginx -t` falla), recarga nginx y verifica `200` + `X-Robots-Tag`.
## Próximos pasos
+4 -21
View File
@@ -1,27 +1,18 @@
# remigracion.jumpingcrab.com — entorno privado de previsualización.
#
# Sirve el build estático de Vite desde /opt/remigracion/dist por HTTP y HTTPS
# en el mismo server block. El certificado lo emite certbot con webroot en
# /var/www/letsencrypt y se renueva con el timer del sistema (el deploy-hook
# del certificado recarga nginx).
# Sin TLS a propósito: el DNS de este dominio no permite emitir un certificado
# Let's Encrypt, así que se sirve sólo por HTTP.
#
# No indexación (objetivo doble):
# 1. 403 en el borde a los rastreadores conocidos, antes de servir nada.
# 2. Cabecera X-Robots-Tag en TODAS las respuestas (incluidos 4xx/5xx).
# 1. Cabecera X-Robots-Tag en TODAS las respuestas (incluidos 4xx/5xx).
# 2. 403 en el borde a los rastreadores conocidos, antes de servir nada.
# El bundle también declara <meta name="robots"> y sirve un robots.txt
# con "Disallow: /" (ver public/robots.txt e index.html).
server {
listen 80;
listen [::]:80;
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name remigracion.jumpingcrab.com;
ssl_certificate /etc/letsencrypt/live/remigracion.jumpingcrab.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/remigracion.jumpingcrab.com/privkey.pem;
include /etc/letsencrypt/options-ssl-nginx.conf;
ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
root /opt/remigracion/dist;
index index.html;
charset utf-8;
@@ -35,14 +26,6 @@ server {
return 403;
}
# Validación ACME de certbot. Vive fuera del árbol desplegado para que el
# 'rsync --delete' del deploy no borre el challenge a mitad de una renovación.
location ^~ /.well-known/acme-challenge/ {
root /var/www/letsencrypt;
default_type "text/plain";
add_header X-Robots-Tag "noindex, nofollow" always;
}
# robots.txt generado aquí mismo: el deploy no depende del build para esto.
location = /robots.txt {
add_header Content-Type "text/plain; charset=utf-8" always;
+9 -35
View File
@@ -16,8 +16,6 @@ APP_HOST="remigracion.jumpingcrab.com"
DEPLOY_ROOT="/opt/remigracion"
VHOST_PATH="/etc/nginx/conf.d/remigracion.jumpingcrab.com.conf"
BACKUP_DIR="/var/backups/nginx"
TLS_CERT_PATH="/etc/letsencrypt/live/remigracion.jumpingcrab.com/fullchain.pem"
ACME_WEBROOT="/var/www/letsencrypt"
usage() {
echo "Usage: $0" >&2
@@ -57,17 +55,6 @@ artifact::require_build() {
fi
}
# El vhost sirve HTTP y HTTPS: sin certificado nginx -t fallaría.
tls::require_certificate() {
if [ ! -f "$TLS_CERT_PATH" ]; then
fail "falta el certificado $TLS_CERT_PATH — emitelo con: certbot certonly --webroot -w $ACME_WEBROOT -d $APP_HOST --deploy-hook 'systemctl reload nginx'"
fi
}
acme::prepare_webroot() {
mkdir -p "$ACME_WEBROOT"
}
artifact::sync() {
local root="$1"
@@ -153,23 +140,14 @@ nginx::reload() {
}
http::expect() {
local scheme="$1"
local url="$2"
local expected="$3"
local port="80"
local url="$1"
local expected="$2"
local attempt
local code
if [ "$scheme" = "https" ]; then
port="443"
fi
# Se resuelve el dominio a loopback: prueba el vhost correcto y, en HTTPS,
# la cadena y el nombre del certificado (sin -k).
# nginx recarga en segundo plano: se reintenta antes de dar el deploy por fallido.
for attempt in $(seq 1 15); do
code="$(curl -s -o /dev/null -m 5 -w '%{http_code}' \
--resolve "$APP_HOST:$port:127.0.0.1" "$url" 2>/dev/null || true)"
code="$(curl -s -o /dev/null -m 5 -w '%{http_code}' -H "Host: $APP_HOST" "$url" || true)"
if [ "$code" = "$expected" ]; then
return 0
fi
@@ -182,16 +160,14 @@ http::expect() {
http::verify() {
local headers
# HTTPS valida además la cadena y el nombre del certificado (sin -k).
http::expect "http" "http://$APP_HOST/" "200"
http::expect "https" "https://$APP_HOST/" "200"
http::expect "http" "http://$APP_HOST/robots.txt" "200"
http::expect "http://127.0.0.1/" "200"
http::expect "http://127.0.0.1/robots.txt" "200"
headers="$(curl -sI -m 10 --resolve "$APP_HOST:443:127.0.0.1" "https://$APP_HOST/" | tr -d '\r')"
headers="$(curl -sI -m 10 -H "Host: $APP_HOST" "http://127.0.0.1/" | tr -d '\r')"
if ! grep -qi '^X-Robots-Tag:.*noindex' <<< "$headers"; then
fail "falta la cabecera X-Robots-Tag: noindex en la respuesta HTTPS"
fail "falta la cabecera X-Robots-Tag: noindex en la respuesta"
fi
log "verificado: HTTP y HTTPS 200, certificado válido, X-Robots-Tag: noindex"
log "verificado: HTTP 200 y X-Robots-Tag: noindex"
}
main() {
@@ -202,10 +178,8 @@ main() {
host::require_root
host::require_tools
artifact::require_build "$root"
tls::require_certificate
artifact::sync "$root"
acme::prepare_webroot
selinux::label
if vhost::install "$root"; then
@@ -213,7 +187,7 @@ main() {
fi
http::verify
log "LISTO: https://$APP_HOST/ (no indexable)"
log "LISTO: http://$APP_HOST/ (sin TLS, no indexable)"
}
main "$@"