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>®ion=us-east-1&allow_http=trueendpoint=es la URL S3 del servidor, por ejemplohttp://localhost:9000ohttp://minio:9000dentro de una red de Compose.region=es obligatorio para el cliente S3; MinIO acepta cualquier valor (us-east-1es lo convencional).allow_http=truepermite HTTP plano. Quítalo cuando MinIO sirva TLS.
Las credenciales son la access key y el secreto de MinIO en las variables de AWS:
export AWS_ACCESS_KEY_ID=minioadminexport AWS_SECRET_ACCESS_KEY=minioadminUsarlo
Crea primero el bucket (el motor no crea buckets), y luego:
import namidb
db = namidb.Client( "s3://namidb?ns=prod&endpoint=http://localhost:9000®ion=us-east-1&allow_http=true")db.cypher("CREATE (:Person {name: 'Alice'})")namidb-server \ --store "s3://namidb?ns=prod&endpoint=http://localhost:9000®ion=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
PUTconIf-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.