Repository navigation
Cairn v0.1.0-alpha.1
Pre-release
Pre-release
·
38 commits
to master
since this release
First pre-release. Single node, one data directory, one static binary. On-disk formats may
still change before 0.1.0; cairn migrate handles any change, with a snapshot taken first.
Added
- S3 API for buckets, objects, versions, multipart uploads (7 operations), CopyObject,
ListObjects v1/v2/versions, tagging, Range and conditional requests, 5 checksum algorithms,
GetObjectAttributes, bucket policies and PublicAccessBlock, lifecycle expiration and
abort-incomplete-multipart, SSE-S3 (AES256) and bucket default encryption. ACLs work the
way S3 has defaulted to since 2023 (BucketOwnerEnforced). Per-operation status and
deviations:docs/COMPAT.md. Clients tested: aws-cli, rclone, mc, aws-sdk-s3. - Undo without setup: every bucket keeps history, so deleting an object, a version or a
whole bucket goes to the trash;cairn trash restorebrings it back byte-identical. - Point-in-time recovery without a prior snapshot: read any object as of an instant with
x-cairn-as-of, orcairn pitr restorea bucket to one, including before it was deleted. - Deduplication: content-addressed blobs; identical uploads, copies and restores write no
new bytes, encrypted or not. - MCP server (stdio and HTTP at
/_cairn/mcp) whose every tool call is an IAM policy
decision; time travel needscairn:TimeTravel. - Security: SigV4 (header and presigned), IAM users, groups, managed and inline policies,
roles, STSAssumeRole/GetSessionToken, explicit-deny-wins evaluation on S3, admin and
MCP requests; root credential sealed in the credential store atcairn init, never logged;
encryption at rest with a master key from file or environment. - Recovery and integrity: crash-consistent writes (kill -9 safe),
cairn fsck [--repair],
scheduledcairn scrub, encrypted full and incrementalcairn backup/cairn restore,
schema migrations withcairn migrate --dry-run,507on a full disk with reads and deletes
still working. - Operations:
/healthz,/readyz, Prometheus/metrics, JSON logs with request ids, an
audit log of mutating and denied requests,cairn config check, andcairn adminfor users,
keys, groups, policies, roles, buckets, trash and PITR (--json). - Footprint: 17.3 MiB static binary (x86_64), about 10 MiB idle RSS, under 60 MiB RSS
while streaming a 10 GiB object. - Distribution: static musl binaries for x86_64 and aarch64, a multi-arch image on
ghcr.io/solutionforest/cairn, CycloneDX SBOMs andSHA256SUMS;deploy/has a
docker-compose file, a hardened systemd unit and an example config with every key.
Not in this release
Replication, tiering, event notifications, OIDC, Object Lock, SSE-C / SSE-KMS, CORS,
PostObject, quotas and rate limiting are not supported; docs/COMPAT.md lists how each
related request is answered.