Object Storage

Crea buckets compatibles con S3 desde Object Storage en my.cubepath.com. Funcionan con cualquier cliente S3: la AWS CLI, rclone, restic, boto3 y el resto de SDKs de AWS, o cubecli.

https://eu.cubestorage.io   (región eu)

Nota

Tu cuenta debe estar verificada antes de poder crear un bucket, y Object Storage solo está disponible en proyectos con facturación por hora.

Para qué sirve

Object Storage guarda ficheros (objetos) en buckets y los sirve por HTTPS con la API S3. Encaja con datos que escribes desde una aplicación o una herramienta, no desde un disco montado:

• Backups y archivos: dumps de bases de datos, copias de servidores con restic o rclone, logs que tienes que conservar.
• Datos de aplicación: ficheros que suben tus usuarios, informes generados, exportaciones.
• Recursos estáticos y media servidos al público a través del CDN.

Los buckets son siempre privados. No hay buckets públicos ni hosting de webs estáticas: para publicar ficheros, conecta el bucket a una zona CDN (mira Servir ficheros al público más abajo).

Tiers

Todos los tiers de una región comparten el mismo endpoint. Un bucket no puede cambiar de tier una vez creado.

Crear un bucket

Nota

Tu primer bucket puede requerir un saldo de al menos 5 $. Cada organización puede tener hasta 20 buckets.

Crear un access key

Los clientes S3 se autentican con un access key, no con tu usuario de CubePath ni con tu token de API. Abre Object Storage → Access keys → Crear access key:

• Nombre: para qué es la clave (por ejemplo, backups-db01).
• Tier: las claves funcionan sobre los buckets de un tier.
• Permiso: Lectura y escritura, o Solo lectura.
• Acceso a buckets: Todos los buckets del proyecto en ese tier (incluidos los que crees después), o Solo los buckets seleccionados.
• Caducidad (opcional): la clave deja de funcionar al final de ese día (UTC) y después se elimina.

Aviso: La secret access key solo se muestra una vez. Cópiala o descarga uno de los ficheros listos para usar (.env, rclone.conf o ~/.aws/credentials) antes de cerrar el diálogo. Si la pierdes, borra la clave y crea otra.

La clave empieza a funcionar unos segundos después de crearla, cuando su estado pasa a Active.

Consejo

Crea una clave por aplicación, dale solo los buckets que necesita y hazla de solo lectura si nunca escribe. Así, si se filtra una clave, expone un bucket y no todos.

Conectar un cliente S3

Usa el endpoint https://eu.cubestorage.io, la región eu y tu access key.

AWS CLI

aws configure set aws_access_key_id CPXXXXXXXXXXXXXXXXXX
aws configure set aws_secret_access_key TU_SECRET
aws configure set region eu

aws s3 cp backup.tar.gz s3://mi-bucket/ --endpoint-url https://eu.cubestorage.io
aws s3 ls s3://mi-bucket/ --endpoint-url https://eu.cubestorage.io

rclone (~/.config/rclone/rclone.conf)

[cubepath]
type = s3
provider = Other
access_key_id = CPXXXXXXXXXXXXXXXXXX
secret_access_key = TU_SECRET
endpoint = https://eu.cubestorage.io
region = eu

rclone copy ./backups cubepath:mi-bucket/backups

cubecli

cubecli s3 bucket create mi-bucket --tier ia
cubecli s3 key create --name backups --tier ia --bucket mi-bucket --output rclone >> ~/.config/rclone/rclone.conf

Funcionan los dos estilos de URL: https://eu.cubestorage.io/mi-bucket/fichero.txt (path style) y https://mi-bucket.eu.cubestorage.io/fichero.txt (virtual host). Las subidas directas desde un navegador (CORS) solo funcionan con la URL path style.

Las pestañas del bucket

El tamaño cuenta todas las versiones guardadas y se actualiza aproximadamente cada 15 minutos.

Archivos

La pestaña Archivos es un explorador de ficheros dentro del panel: abre carpetas, Sube ficheros (o arrástralos al panel), Descarga, Borra ficheros o carpetas enteras y crea una Nueva carpeta. Los ficheros grandes se suben por partes automáticamente.

El explorador funciona con tu sesión del panel; los scripts y aplicaciones usan un access key y cualquier cliente S3. Sus peticiones se facturan como cualquier otra petición al bucket.

Ajustes

• Versionado conserva cada versión de un objeto, para poder recuperar ficheros sobrescritos o borrados. Las versiones antiguas se almacenan y facturan como cualquier otro dato. Una vez activado, el versionado se puede suspender pero nunca desactivar.
• Protección contra borrado impide borrar el bucket desde el panel, la API o la CLI hasta que la desactives.

Servir ficheros al público

Los buckets siguen siendo privados. Para publicar sus ficheros, añade el bucket como origen de una zona CDN: abre la zona → Orígenes → Añadir origen y elige el bucket. La pestaña CDN del bucket te lleva hasta ahí y muestra la URL pública cuando está conectado.

El CDN lee el bucket con una clave dedicada de solo lectura que solo funciona desde los edges del CDN, y cachea los ficheros cerca de tus visitantes. Los access keys de tu bucket nunca salen de tus aplicaciones.

• El tráfico del bucket al CDN no se factura como egress: pagas la zona CDN.
• Las peticiones de los edges del CDN cuentan como peticiones de clase B del bucket.
• Un origen CDN por bucket. Para dejar de servirlo, borra ese origen de la zona.

Precios

Se factura por horas vencidas, desde que el bucket está activo hasta que se borra. No se cobra nada mientras se está creando.

Gratis cada mes, por organización y tier: 5 GiB-mes de almacenamiento, 5 GiB de egress y 20.000 peticiones. Recibes un email cuando se agota lo gratuito.

La pestaña Uso muestra el almacenamiento, el egress y las peticiones de cada bucket en el mes, lo facturado hasta ahora y una proyección del mes completo. Las peticiones fallidas (4xx y 5xx) nunca se facturan.

Límites

• 20 buckets por organización y 20 access keys por proyecto y tier.
• 5 GiB por subida simple; los ficheros más grandes van por partes (multipart, hasta 10.000 partes). El panel se encarga de ello por ti.
• 1 TiB por bucket como límite blando: recibes un email cuando un bucket lo supera y, si sigue por encima pasadas 72 horas, se pausan las subidas a ese bucket (lecturas, listados y borrados siguen funcionando) hasta que vuelva a estar por debajo. Contacta con soporte si un bucket necesita más.
• Las URLs prefirmadas duran como mucho 24 horas. Las subidas multipart sin terminar se limpian a los 7 días.

Borrar un bucket

Desde Ajustes → Eliminar bucket, escribe el nombre del bucket para confirmar.

• Por defecto el bucket solo se borra si está vacío. Marca Eliminar también todos los objetos del bucket para borrar antes todos los objetos, versiones y subidas a medias. No se puede deshacer y tarda un rato en buckets grandes.
• Un bucket protegido, o que todavía sirve un origen CDN, no se puede borrar hasta que desactives la protección o quites el origen.
• La facturación se detiene cuando termina el borrado. El nombre queda reservado para tu organización durante 90 días.

Nota

Si un bucket aparece como suspendido, tus datos se conservan pero no se puede acceder a ellos. Si es porque tu organización está suspendida, recargar el saldo restaura el acceso.