Saltearse al contenido

MinIO

MinIO es un object store compatible con S3 que ejecutas tú mismo. NamiDB habla con él a través del backend s3:// con un endpoint personalizado. Las mismas instrucciones aplican a otros servidores compatibles con S3 alojados por ti.

Para un stack de Compose listo con MinIO y namidb-server, consulta Docker + MinIO.

URI

s3://<bucket>[/<prefix>]?ns=<namespace>&endpoint=<url>&region=us-east-1&allow_http=true
  • endpoint= es la URL S3 del servidor, por ejemplo http://localhost:9000 o http://minio:9000 dentro de una red de Compose.
  • region= es obligatorio para el cliente S3; MinIO acepta cualquier valor (us-east-1 es lo convencional).
  • allow_http=true permite HTTP plano. Quítalo cuando MinIO sirva TLS.

Las credenciales son la access key y el secreto de MinIO en las variables de AWS:

Ventana de terminal
export AWS_ACCESS_KEY_ID=minioadmin
export AWS_SECRET_ACCESS_KEY=minioadmin

Usarlo

Crea primero el bucket (el motor no crea buckets), y luego:

import namidb
db = namidb.Client(
"s3://namidb?ns=prod&endpoint=http://localhost:9000&region=us-east-1&allow_http=true"
)
db.cypher("CREATE (:Person {name: 'Alice'})")
Ventana de terminal
namidb-server \
--store "s3://namidb?ns=prod&endpoint=http://localhost:9000&region=us-east-1&allow_http=true" \
--auth-token "$NAMIDB_AUTH_TOKEN"

Los objetos quedan bajo tenants/prod/ en el bucket namidb (o bajo <prefix>/prod/ cuando el URI tiene un prefijo).

Requisitos

  • Escrituras condicionales. El servidor debe rechazar un segundo PUT con If-None-Match: * sobre una clave existente. Las versiones actuales de MinIO lo hacen; las versiones muy antiguas y algunos otros servidores “compatibles con S3” no, y no son seguros para NamiDB. Ejecuta la prueba de Object stores contra tu servidor antes de confiar en él.
  • Almacenamiento durable para MinIO. La durabilidad de NamiDB es la durabilidad del bucket. Dale a MinIO volúmenes persistentes y la redundancia que necesites.
  • Regla de ciclo de vida para las cargas multipart incompletas, como en cualquier object store.

Higiene de credenciales

Los valores por defecto minioadmin / minioadmin son para pruebas locales. En cualquier entorno compartido crea un usuario de MinIO dedicado cuya política permita s3:GetObject, s3:PutObject, s3:DeleteObject, s3:ListBucket y s3:AbortMultipartUpload solo sobre el bucket de NamiDB, y mantén el puerto de la API de MinIO fuera de redes públicas.