Operar en BYOS
Una vez que tu servidor está conectado, el trabajo del día a día se parece al del alojamiento gestionado. Esta página cubre las áreas en las que ejecutar en tu propio servidor se comporta de forma distinta: dominios y SSL, Odoo Enterprise, copias de seguridad y comportamiento de la suscripción.
Dominios y SSL
Los despliegues en tu propio servidor reciben una dirección skysize.io por defecto, pero las nuevas direcciones por defecto están limitadas por cuenta. La configuración recomendada es adjuntar tu propio dominio al proyecto una sola vez: un registro DNS wildcard, y cada rama recibe un nombre de host bajo él con certificados emitidos en tu servidor. Consulta Tu dominio en BYOS. El resto de esta sección describe cómo añadir un único dominio a una rama.
Agregar tu dominio
- Abre la sección Dominios de la rama y agrega tu dominio (por ejemplo
erp.mycompany.com), dejando SSL habilitado. - En tu proveedor de DNS, crea un registro A que apunte el dominio a la dirección IPv4 pública de tu servidor (se muestra en la página de detalle del servidor en el panel).
- Espera a que el DNS se propague y luego abre el dominio en un navegador.
En el alojamiento gestionado apuntas un CNAME a tu nombre de host *.skysize.io. En BYOS no existe ese nombre de host, así que apuntas un registro A directamente a la IP de tu servidor. El resto de la guía de dominios personalizados se aplica sin cambios.
Certificados SSL
Los certificados HTTPS para los despliegues BYOS se emiten en tu servidor mediante Let's Encrypt, y se renuevan ahí automáticamente. Los certificados propios de la plataforma de Skysize nunca se instalan en hardware de clientes.
Para que la emisión tenga éxito:
- El DNS del dominio ya debe resolver a tu servidor.
- Los puertos 80 y 443 del servidor deben ser accesibles desde internet, en el firewall del servidor y en el grupo de seguridad de tu proveedor cloud (Let's Encrypt valida el dominio por HTTP).
Hasta que se emita el certificado, el sitio puede estar accesible brevemente solo por HTTP.
Odoo Enterprise en tu propio servidor
Los despliegues Enterprise en tu servidor leen el código fuente de Odoo Enterprise con tu propio acceso, de tu propia suscripción de Odoo Enterprise. Las credenciales enterprise de Skysize nunca se usan en hardware de clientes.
Configúralo en la página de detalle de tu servidor, en Fuente de Odoo Enterprise. Hay dos opciones.
Clave de despliegue (recomendado)
Mantén tu propia copia del código Enterprise en un repositorio privado que controles, en cualquier alojamiento git: GitHub, GitLab, Bitbucket o un servidor autoalojado. Necesita una rama por versión de Odoo, con el nombre de la versión (por ejemplo 19.0). Si Odoo te dio acceso a odoo/enterprise, crea tu copia como un espejo: un repositorio privado nuevo y vacío con el mismo contenido, no un fork de GitHub. Un fork del repositorio privado de Odoo sigue vinculado al repositorio de Odoo, y GitHub puede impedir que Skysize instale automáticamente la clave de despliegue en él, aunque seas administrador. Sin acceso a odoo/enterprise, sube en su lugar el archivo del código fuente descargado de odoo.com.
git clone --bare git@github.com:odoo/enterprise.git
cd enterprise.git
git push --mirror git@github.com:tu-empresa/enterprise.git
- Introduce la URL del repositorio (forma SSH o HTTPS) y haz clic en Generar clave de despliegue.
- Skysize genera una clave de solo lectura solo para ese repositorio. Cuando una de tus cuentas Git conectadas es administradora del repositorio, la clave se instala en él automáticamente.
- Si no, copia la clave pública y añádela a las claves de despliegue del repositorio, solo con acceso de lectura. Instalar automáticamente vuelve a intentarlo después de conectar la cuenta Git adecuada.
Una clave de despliegue nunca da acceso a nada más que a ese repositorio, y eliminarla en el servidor también la retira del repositorio cuando Skysize la instaló. Mantén el repositorio actualizado cuando Odoo publique correcciones; actualizarlo cada mes es un buen hábito. Para un espejo, ejecuta git fetch origin '+refs/heads/*:refs/heads/*' --prune en el clon bare y luego otra vez git push --mirror.
Las claves de despliegue necesitan el agente 1.4.4 o posterior en el servidor.
Imagen Docker con Enterprise
El servidor puede ejecutar una imagen Docker que ya contiene Enterprise; en ese caso no se descarga nada.
Puedes configurar cualquiera de las dos al crear un proyecto Enterprise: si el servidor de destino aún no tiene una fuente Enterprise, el panel te pide una, con la clave de despliegue como opción por defecto.
¿Por qué no el repositorio oficial de Odoo?
Apuntar tu servidor directamente a odoo/enterprise haría que cada despliegue trajera lo que Odoo haya publicado ese día. Un cambio que espera un código Community más reciente que el de tu imagen puede romper la instancia, sin forma de volver atrás. Con tu propia copia decides cuándo actualizar y puedes revertir una actualización problemática. Por eso el panel ofrece claves de despliegue sobre tu propio repositorio, no sobre el de Odoo.
Sin clave de despliegue ni imagen Enterprise, los builds Enterprise en ese servidor fallan porque no se encuentra el código enterprise. Los proyectos Community no se ven afectados.
Workers y memoria
Tu servidor, tu dimensionamiento: en BYOS el número de workers del despliegue no lo fija el plan, lo eliges tú. Abre la Configuración del proyecto y ve a Workers y memoria. Estos ajustes dimensionan solo el despliegue de producción; los despliegues de staging y de desarrollo se ejecutan siempre como un único proceso de Odoo, con recursos fijos.
- Workers: el número de procesos HTTP de Odoo. Déjalo en 0 para un único proceso que atiende a la vez el HTTP y las acciones planificadas, lo adecuado para una instancia pequeña o un servidor modesto. Indica 2 o más para ejecutar Odoo en modo multiproceso, donde cada worker atiende peticiones en paralelo.
- Workers cron: cuántos procesos ejecutan las acciones planificadas. Solo se usan en modo multiproceso; el valor predeterminado de Odoo es 2.
- Memoria por worker: el límite de memoria de cada proceso de Odoo, en MB. El mínimo es 512 MB y el valor predeterminado 1024 MB. Odoo reinicia el proceso que lo supera, así que súbelo si tu carga de trabajo incluye importaciones o informes grandes.
Al cambiar cualquiera de estos valores, el panel muestra, antes de aplicar, la memoria máxima que puede usar el despliegue: cada proceso en su límite, más 512 MB de margen para el contenedor. Comprueba que tu servidor dispone de esa memoria, además de Postgres y de todo lo demás que ejecute.
Aplicar y reiniciar guarda el dimensionamiento y reinicia el despliegue de producción, así que cuenta con una breve interrupción.
Los ajustes Tiempo de espera de las solicitudes y Tiempo de espera de los workers cron están en la misma sección y funcionan exactamente igual que en el alojamiento gestionado. Consulta Límites de tiempo.
Copias de seguridad
El sistema de copias de seguridad completo funciona en BYOS: copias de seguridad diarias automáticas de producción, copias de seguridad manuales, restauraciones, descargas e importaciones. Los trabajos de copia de seguridad se ejecutan en tu servidor y luego suben el archivo al destino de almacenamiento configurado del proyecto.
Elegir dónde se almacenan las copias de seguridad
Los proyectos BYOS hacen copias de seguridad en tu propio almacenamiento: el almacenamiento de la plataforma Skysize no se ofrece como destino, de modo que tanto los datos en vivo (en tu servidor) como las copias de seguridad permanecen en una infraestructura que tú controlas. Mientras no configures un destino no se hace ninguna copia de seguridad, y el proyecto muestra un aviso rojo indicándolo.
- Abre la Configuración del proyecto y ve a Destino de copias de seguridad.
- En Tus destinos de copias de seguridad, haz clic en Añadir destino y crea un destino (consulta los campos de cada tipo a continuación). Usa Probar para verificar la conexión: la prueba se ejecuta en el servidor de la rama de producción, así que despliega primero esa rama.
- El primer destino que añadas se selecciona automáticamente como Destino de almacenamiento del proyecto. Si más adelante añades otros, elige el que quieras usar en Destino de almacenamiento y guarda.
Campos de cada tipo
Cada destino tiene un Nombre y un Tipo. Los demás campos dependen del tipo. Las credenciales se guardan cifradas y no se vuelven a mostrar: al editar, deja un secreto en blanco para conservarlo. El Prefijo siempre es opcional y coloca los archivos en una carpeta, lo que resulta útil cuando varios proyectos comparten un bucket.
AWS S3
| Campo | Valor |
|---|---|
| Bucket | El nombre del bucket. Debe existir ya. |
| Región | La región del bucket. Por defecto, us-east-1. |
| Autenticación | Rol de IAM si tu servidor es una instancia EC2, así no se guarda ningún secreto. Si no, Claves de acceso, con el ID de clave de acceso y la Clave de acceso secreta de un usuario de IAM. |
El rol o el usuario necesita los permisos que aparecen en el formulario. Copiar la política JSON te da una política lista para pegar en AWS.
Compatible con S3 (Wasabi, R2, MinIO...)
Para otros proveedores con una API S3, como Wasabi, Backblaze B2, Cloudflare R2, MinIO, OVH, Scaleway, Hetzner y DigitalOcean Spaces.
| Campo | Valor |
|---|---|
| Bucket | El nombre del bucket. Debe existir ya. |
| Endpoint | La URL S3 de tu proveedor. |
| Región | La región de tu proveedor, o cualquier valor si no tiene. |
| ID de clave de acceso y Clave de acceso secreta | La clave que te dio tu proveedor. |
| URL de estilo ruta | Actívalo solo si tu proveedor lo exige. |
Google Cloud Storage
| Campo | Valor |
|---|---|
| Bucket | El nombre del bucket. Debe existir ya. |
| Credenciales | Predeterminadas del servidor si tu servidor funciona en Google Cloud con acceso al bucket, así no se guarda ninguna clave. Si no, Clave de cuenta de servicio: pega el contenido del archivo de clave. |
La cuenta de servicio necesita el rol Storage Object Admin en el bucket. Con Predeterminadas del servidor, Google firma los enlaces de descarga en nombre del servidor, así que la VM también necesita el permiso de acceso cloud-platform, y su cuenta de servicio el rol Service Account Token Creator sobre sí misma. Una clave de cuenta de servicio no necesita ninguno de los dos.
Azure Blob Storage
| Campo | Valor |
|---|---|
| Cuenta de almacenamiento | El nombre de la cuenta, no su URL. |
| Contenedor | El nombre del contenedor. |
| Autenticación | Identidad administrada si tu servidor funciona en Azure, así no se guarda ningún secreto. Si no, Clave de acceso: key1 o key2 en Access keys de la cuenta de almacenamiento. |
| Client ID de la identidad administrada | Opcional. Solo si el servidor tiene varias identidades asignadas por el usuario. |
Una identidad administrada necesita los roles Storage Blob Data Contributor y Storage Blob Delegator en la cuenta.
Sistema de archivos
Escribe los archivos en un Directorio del servidor que ejecuta el proyecto.
Las copias de seguridad en el sistema de archivos están en la misma máquina que tus bases de datos. Protegen contra datos erróneos (borrados accidentales, actualizaciones fallidas), pero no contra la pérdida del propio servidor. Para la recuperación ante desastres, usa uno de los tipos de almacenamiento anteriores, o copia tú mismo el directorio de copias fuera del servidor.
Las copias de seguridad se crean en el servidor antes de subirse, así que mantén suficiente espacio libre en disco para una copia comprimida de tu base de datos más grande junto con su filestore.
Guardar los archivos una sola vez (deduplicación)
La mayoría de los archivos de un filestore de Odoo (adjuntos, imágenes, documentos) no cambian de una copia a otra, pero una copia de seguridad normal los vuelve a guardar todos cada día. Activa Guardar una sola vez los archivos compartidos (deduplicación) en el formulario del destino para guardar cada archivo una sola vez por proyecto: cada copia conserva su volcado completo de la base de datos y apunta a los archivos que necesita. Con un filestore grande, el almacenamiento de copias se reduce mucho, y el almacenamiento de copias que se muestra para el proyecto es lo que realmente se guarda.
- Se aplica solo a las copias nuevas. Las copias anteriores se quedan como están y siguen funcionando. Desactivarlo también se aplica solo a las copias nuevas.
- Las restauraciones, las copias externas y las descargas funcionan como siempre: Skysize reconstruye un
.zipestándar de Odoo con el filestore. - En un destino de tipo bucket, la primera descarga de una copia tarda unos minutos en prepararse. El botón muestra Preparando… para todos los miembros del proyecto, y la descarga empieza sola si mantienes la página abierta. Una vez lista, la copia se descarga con un clic durante aproximadamente un día, y el botón muestra el tiempo restante. Si tu dominio apunta directamente a tu servidor, la descarga empieza enseguida.
- Los archivos de tu bucket ya no son copias de Odoo completas por sí solos: no tienen filestore, y los archivos están en una carpeta
blobs/. Restáuralos y descárgalos a través de Skysize, no directamente desde el bucket. - Una limpieza diaria borra los archivos que ya no usa ninguna copia. Los archivos de menos de un día se conservan siempre.
Necesita el agente de Skysize 1.4.23 o posterior en tu servidor (los agentes se actualizan solos).
Si tu suscripción caduca
Si tu suscripción de Bring Your Own Server caduca o se cancela, Skysize nunca entra en tu servidor para apagar nada:
- Los despliegues en ejecución siguen funcionando. Tus instancias de Odoo y sus datos permanecen activos en tu hardware.
- El trabajo nuevo queda bloqueado. Los builds, los despliegues y las copias de seguridad de los proyectos BYOS se rechazan hasta que la suscripción vuelva a estar activa, y no se pueden agregar nuevos servidores ni proyectos BYOS. Los proyectos afectados muestran un aviso en el panel.
- Renovar lo restaura todo. Renueva o vuelve a comprar la suscripción desde la página Agentes y los builds y las copias de seguridad se reanudan; no hace falta reinstalar nada.
Si la cuenta permanece sin ninguna suscripción activa de Bring Your Own Server durante un periodo prolongado (unos 30 días), los servidores conectados que no estén alojando despliegues de proyectos activos se eliminan del panel. Tendrías que registrarlos e inscribirlos de nuevo después de volver a suscribirte. Los servidores que aún alojan tus despliegues en ejecución no se eliminan.
Límites y diferencias frente al alojamiento en la nube
- Sin dominios
*.skysize.io. Cada despliegue al que quieras llegar desde la web necesita tu propio dominio, con un registro A apuntando a tu servidor. - Sin interruptor de proxy de Cloudflare. El tráfico va directo a tu servidor. Si quieres una CDN o protección contra DDoS por delante, configúralo en tu propio proveedor de DNS o de proxy.
- Sin selección de región. La ubicación de tu servidor es la región. La latencia y la residencia de datos vienen determinadas por dónde lo alojes.
- Sin nivel gratuito. Los proyectos BYOS siempre requieren una suscripción activa de Bring Your Own Server, una por proyecto.
- La capacidad la gestionas tú. La CPU, la RAM y el disco están limitados por tu hardware. Vigila las métricas del servidor en el panel y agrega recursos, o conecta servidores adicionales, antes de que se agoten. Con varios servidores, producción se ejecuta en el servidor que seleccionaste y las demás ramas se reparten entre todos ellos.
- El mantenimiento del servidor es tuyo. Las actualizaciones del sistema operativo, los parches de seguridad y la configuración del firewall de la máquina son tu responsabilidad. Skysize mantiene actualizados el agente y tus despliegues de Odoo.
Todo lo demás, incluidos los flujos de trabajo de ramas, los logs de build, la gestión de accesos y las restauraciones, se comporta exactamente igual que en el alojamiento gestionado.