Compare commits
1
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
027bdebd1e |
@@ -2,21 +2,17 @@
|
||||
#
|
||||
# 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, si toca desplegar, ejecuta scripts/deploy.sh.
|
||||
# secretos: el job compila y luego ejecuta scripts/deploy.sh.
|
||||
#
|
||||
# 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
|
||||
# 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
|
||||
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- master
|
||||
pull_request:
|
||||
workflow_dispatch:
|
||||
|
||||
concurrency:
|
||||
@@ -24,8 +20,7 @@ concurrency:
|
||||
cancel-in-progress: true
|
||||
|
||||
jobs:
|
||||
build:
|
||||
name: Build + comprobaciones
|
||||
deploy:
|
||||
runs-on: self-hosted
|
||||
timeout-minutes: 15
|
||||
steps:
|
||||
@@ -46,32 +41,6 @@ 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
|
||||
|
||||
@@ -60,11 +60,14 @@ El JSON tiene tres claves:
|
||||
|
||||
## Despliegue
|
||||
|
||||
Entorno de previsualización privado en **<http://remigracion.jumpingcrab.com/>**
|
||||
Entorno de previsualización privado en **<https://remigracion.jumpingcrab.com/>**
|
||||
(mismo host que `localesp.es` y `git.localesp.es`).
|
||||
|
||||
- **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.
|
||||
- **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.
|
||||
- **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.
|
||||
@@ -73,19 +76,10 @@ Entorno de previsualización privado en **<http://remigracion.jumpingcrab.com/>*
|
||||
3. `public/robots.txt` (`Disallow: /`) y `<meta name="robots">` en
|
||||
`index.html`.
|
||||
|
||||
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.
|
||||
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.
|
||||
|
||||
Artefactos y servicios en el host (mismo patrón que
|
||||
`prototipo-yb01-ef.localesp.es`):
|
||||
@@ -94,6 +88,8 @@ 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:
|
||||
@@ -103,9 +99,10 @@ npm ci && npm run build
|
||||
sudo bash scripts/deploy.sh
|
||||
```
|
||||
|
||||
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`.
|
||||
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`.
|
||||
|
||||
## Próximos pasos
|
||||
|
||||
|
||||
+21
-4
@@ -1,18 +1,27 @@
|
||||
# remigracion.jumpingcrab.com — entorno privado de previsualización.
|
||||
#
|
||||
# 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.
|
||||
# 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).
|
||||
#
|
||||
# No indexación (objetivo doble):
|
||||
# 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.
|
||||
# 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).
|
||||
# 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;
|
||||
@@ -26,6 +35,14 @@ 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;
|
||||
|
||||
+35
-9
@@ -16,6 +16,8 @@ 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
|
||||
@@ -55,6 +57,17 @@ 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"
|
||||
|
||||
@@ -140,14 +153,23 @@ nginx::reload() {
|
||||
}
|
||||
|
||||
http::expect() {
|
||||
local url="$1"
|
||||
local expected="$2"
|
||||
local scheme="$1"
|
||||
local url="$2"
|
||||
local expected="$3"
|
||||
local port="80"
|
||||
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}' -H "Host: $APP_HOST" "$url" || true)"
|
||||
code="$(curl -s -o /dev/null -m 5 -w '%{http_code}' \
|
||||
--resolve "$APP_HOST:$port:127.0.0.1" "$url" 2>/dev/null || true)"
|
||||
if [ "$code" = "$expected" ]; then
|
||||
return 0
|
||||
fi
|
||||
@@ -160,14 +182,16 @@ http::expect() {
|
||||
http::verify() {
|
||||
local headers
|
||||
|
||||
http::expect "http://127.0.0.1/" "200"
|
||||
http::expect "http://127.0.0.1/robots.txt" "200"
|
||||
# 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"
|
||||
|
||||
headers="$(curl -sI -m 10 -H "Host: $APP_HOST" "http://127.0.0.1/" | tr -d '\r')"
|
||||
headers="$(curl -sI -m 10 --resolve "$APP_HOST:443:127.0.0.1" "https://$APP_HOST/" | tr -d '\r')"
|
||||
if ! grep -qi '^X-Robots-Tag:.*noindex' <<< "$headers"; then
|
||||
fail "falta la cabecera X-Robots-Tag: noindex en la respuesta"
|
||||
fail "falta la cabecera X-Robots-Tag: noindex en la respuesta HTTPS"
|
||||
fi
|
||||
log "verificado: HTTP 200 y X-Robots-Tag: noindex"
|
||||
log "verificado: HTTP y HTTPS 200, certificado válido, X-Robots-Tag: noindex"
|
||||
}
|
||||
|
||||
main() {
|
||||
@@ -178,8 +202,10 @@ 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
|
||||
@@ -187,7 +213,7 @@ main() {
|
||||
fi
|
||||
|
||||
http::verify
|
||||
log "LISTO: http://$APP_HOST/ (sin TLS, no indexable)"
|
||||
log "LISTO: https://$APP_HOST/ (no indexable)"
|
||||
}
|
||||
|
||||
main "$@"
|
||||
|
||||
Reference in New Issue
Block a user