{"id":13549438,"url":"https://github.com/linkedin/ambry","last_synced_at":"2026-10-19T11:12:52.467Z","repository":{"id":11419679,"uuid":"13870893","full_name":"linkedin/ambry","owner":"linkedin","description":"Distributed object store","archived":false,"fork":false,"pushed_at":"2026-10-17T00:04:30.000Z","size":38368,"stargazers_count":1786,"open_issues_count":143,"forks_count":298,"subscribers_count":115,"default_branch":"master","last_synced_at":"2026-10-17T02:26:40.917Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/linkedin/ambry/wiki","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/linkedin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"claude":"CLAUDE.md","gemini":null,"cursor":null,"copilot":null,"dco":null,"cla":null,"disclosure":null}},"created_at":"2013-10-25T20:04:54.000Z","updated_at":"2026-10-17T00:04:36.000Z","dependencies_parsed_at":"2026-08-25T05:22:45.915Z","dependency_job_id":null,"html_url":"https://github.com/linkedin/ambry","commit_stats":null,"previous_names":[],"tags_count":1560,"template":false,"template_full_name":null,"purl":"pkg:github/linkedin/ambry","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linkedin%2Fambry","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linkedin%2Fambry/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linkedin%2Fambry/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linkedin%2Fambry/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/linkedin","download_url":"https://codeload.github.com/linkedin/ambry/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linkedin%2Fambry/sbom","scorecard":{"id":514227,"data":{"date":"2025-08-11","repo":{"name":"github.com/linkedin/ambry","commit":"11a3949cf3da49521477c81e3e7efffb097f0a7a"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":5.1,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":10,"reason":"30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":9,"reason":"Found 28/30 approved changesets -- score normalized to 9","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/github-actions.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Binary-Artifacts","score":9,"reason":"binaries present in source code","details":["Warn: binary detected: gradle/wrapper/gradle-wrapper.jar:1"],"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/github-actions.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/github-actions.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/github-actions.yml:51: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/github-actions.yml:59: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/github-actions.yml:69: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/github-actions.yml:75: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/github-actions.yml:80: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/github-actions.yml:88: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/github-actions.yml:98: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/github-actions.yml:104: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/github-actions.yml:128: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/github-actions.yml:136: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/github-actions.yml:146: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/github-actions.yml:152: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/github-actions.yml:176: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/github-actions.yml:184: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/github-actions.yml:199: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/github-actions.yml:205: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/github-actions.yml:210: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/github-actions.yml:217: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/github-actions.yml:224: update your workflow using https://app.stepsecurity.io/secureworkflow/linkedin/ambry/github-actions.yml/master?enable=pin","Warn: npmCommand not pinned by hash: .github/workflows/github-actions.yml:48","Info:   0 out of  10 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of  11 third-party GitHubAction dependencies pinned","Info:   0 out of   1 npmCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 28 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-20T01:22:54.234Z","repository_id":11419679,"created_at":"2025-08-20T01:22:54.234Z","updated_at":"2025-08-20T01:22:54.234Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":344872684,"owners_count":38355271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-10-03T21:59:58.778Z","status":"online","status_checked_at":"2026-10-19T02:00:06.414Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T12:01:21.879Z","updated_at":"2026-10-19T11:12:52.461Z","avatar_url":"https://github.com/linkedin.png","language":"Java","funding_links":[],"categories":["Java","Distributed Filesystem","`Distributed Filesystem `","对象存储"],"sub_categories":["文件同步"],"readme":"# Ambry\n\n[![Github Actions CI](https://github.com/linkedin/ambry/actions/workflows/github-actions.yml/badge.svg)](https://github.com/linkedin/ambry/actions/workflows/github-actions.yml)\n[![codecov.io](https://codecov.io/github/linkedin/ambry/branch/master/graph/badge.svg)](https://codecov.io/github/linkedin/ambry)\n[![license](https://img.shields.io/github/license/linkedin/ambry.svg)](LICENSE)\n\nAmbry is a distributed object store that supports storage of trillions of small immutable objects (50K -100K) as well as billions of large objects. It was specifically designed to store and serve media objects in web companies. However, it can be used as a general purpose storage system to store DB backups, search indexes or business reports. The system has the following characterisitics: \n\n1. Highly available and horizontally scalable\n2. Low latency and high throughput\n3. Optimized for both small and large objects\n4. Cost effective\n5. Easy to use\n\nRequires JDK version 1.11 - 1.14.\n\n## Documentation\nDetailed documentation is available at https://github.com/linkedin/ambry/wiki\n\n## Research\nPaper introducing Ambry at [SIGMOD 2016](http://sigmod2016.org/) -\u003e http://dprg.cs.uiuc.edu/data/files/2016/ambry.pdf\n\nReach out to us at ambrydev@googlegroups.com if you would like us to list a paper that is based off of research on Ambry.\n\n## Getting Started\n##### Step 1: Download the code, build it and prepare for deployment.\nTo get the latest code and build it, do\n\n    $ git clone https://github.com/linkedin/ambry.git \n    $ cd ambry\n    $ ./gradlew allJar\n    $ cd target\n    $ mkdir logs\nAmbry uses files that provide information about the cluster to route requests from the frontend to servers and for replication between servers. We will use a simple clustermap that contains a single server with one partition. The partition will use `/tmp` as the mount point.\n##### Step 2: Deploy a server.\n    $ nohup java -Dlog4j2.configurationFile=file:../config/log4j2.xml -jar ambry.jar --serverPropsFilePath ../config/server.properties --hardwareLayoutFilePath ../config/HardwareLayout.json --partitionLayoutFilePath ../config/PartitionLayout.json \u003e logs/server.log \u0026\n\nThrough this command, we configure the log4j properties, provide the server with configuration options and cluster definitions and redirect output to a log. Note down the process ID returned (`serverProcessID`) because it will be needed for shutdown.  \nThe log will be available at `logs/server.log`. Alternately, you can change the log4j properties to write the log messages to a file instead of standard output.\n##### Step 3: Deploy a frontend.\n    $ nohup java -Dlog4j2.configurationFile=file:../config/log4j2.xml -cp \"*\" com.github.ambry.frontend.AmbryFrontendMain --serverPropsFilePath ../config/frontend.properties --hardwareLayoutFilePath ../config/HardwareLayout.json --partitionLayoutFilePath ../config/PartitionLayout.json \u003e logs/frontend.log \u0026\n\nNote down the process ID returned (`frontendProcessID`) because it will be needed for shutdown. Make sure that the frontend is ready to receive requests.\n\n    $ curl http://localhost:1174/healthCheck\n    GOOD\nThe log will be available at `logs/frontend.log`. Alternately, you can change the log4j properties to write the log messages to a file instead of standard output.\n##### Step 4: Interact with Ambry !\nWe are now ready to store and retrieve data from Ambry. Let us start by storing a simple image. For demonstration purposes, we will use an image `demo.gif` that has been copied into the `target` folder.\n###### POST\n    $ curl -i -H \"x-ambry-service-id:CUrlUpload\"  -H \"x-ambry-owner-id:`whoami`\" -H \"x-ambry-content-type:image/gif\" -H \"x-ambry-um-description:Demonstration Image\" http://localhost:1174/ --data-binary @demo.gif\n    HTTP/1.1 201 Created\n    Location: AmbryID\n    Content-Length: 0\nThe CUrl command creates a `POST` request that contains the binary data in demo.gif. Along with the file data, we provide headers that act as blob properties. These include the size of the blob, the service ID, the owner ID and the content type.  \nIn addition to these properties, Ambry also has a provision for arbitrary user defined metadata. We provide `x-ambry-um-description` as user metadata. Ambry does not interpret this data and it is purely for user annotation.\nThe `Location` header in the response is the blob ID of the blob we just uploaded.\n###### GET - Blob Info\nNow that we stored a blob, let us verify some properties of the blob we uploaded.\n\n    $ curl -i http://localhost:1174/AmbryID/BlobInfo\n    HTTP/1.1 200 OK\n    x-ambry-blob-size: {Blob size}\n    x-ambry-service-id: CUrlUpload\n    x-ambry-creation-time: {Creation time}\n    x-ambry-private: false\n    x-ambry-content-type: image/gif\n    x-ambry-owner-id: {username}\n    x-ambry-um-desc: Demonstration Image\n    Content-Length: 0\n###### GET - Blob\nNow that we have verified that Ambry returns properties correctly, let us obtain the actual blob.\n\n    $ curl http://localhost:1174/AmbryID \u003e demo-downloaded.gif\n    $ diff demo.gif demo-downloaded.gif \n    $\nThis confirms that the data that was sent in the `POST` request matches what we received in the `GET`. If you would like to see the image, simply point your browser to `http://localhost:1174/AmbryID` and you should see the image that was uploaded !\n###### DELETE\nAmbry is an immutable store and blobs cannot be updated but they can be deleted in order to make them irretrievable. Let us go ahead and delete the blob we just created.\n\n    $ curl -i -X DELETE http://localhost:1174/AmbryID\n    HTTP/1.1 202 Accepted\n    Content-Length: 0\nYou will no longer be able to retrieve the blob properties or data.\n\n    $ curl -i http://localhost:1174/AmbryID/BlobInfo\n    HTTP/1.1 410 Gone\n    Content-Type: text/plain; charset=UTF-8\n    Content-Length: 17\n    Connection: close\n\n    Failure: 410 Gone\n##### Step 5: Stop the frontend and server.\n    $ kill -15 frontendProcessID\n    $ kill -15 serverProcessID\nYou can confirm that the services have been shut down by looking at the logs.\n##### Additional information:\nIn addition to the simple APIs demonstrated above, Ambry provides support for `GET` of only user metadata and `HEAD`. In addition to the `POST` of binary data that was demonstrated, Ambry also supports `POST` of `multipart/form-data` via CUrl or web forms.\nOther features of interest include:\n* **Time To Live (TTL)**: During `POST`, a TTL in seconds can be provided through the addition of a header named `x-ambry-ttl`. This means that Ambry will stop serving the blob after the TTL has expired. On `GET`, expired blobs behave the same way as deleted blobs.\n* **Private**: During `POST`, providing a header named `x-ambry-private` with the value `true` will mark the blob as private. API behavior can be configured based on whether a blob is public or private.\n\n## Testing\n\u003e**WARNING**: Tests currently can take upwards of 40 minutes to run\n\nAmbry requires [azurite](https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azurite?tabs=npm%2Cblob-storage)\nand MySQL for testing. To install on MacOS:\n\nazurite:\n```\n$ npm install -g azurite\n$ azurite\n```\n\nmysql:\n```\n$ brew install mysql\n$ brew services start mysql\n$ mysql -uroot\nmysql\u003e CREATE USER 'travis'@'localhost';\nmysql\u003e GRANT ALL PRIVILEGES ON *.* to 'travis'@'localhost';\nmysql\u003e FLUSH PRIVILEGES;\nmysql\u003e CREATE DATABASE AmbryRepairRequests;\nmysql\u003e USE AmbryRepairRequests; SOURCE ./ambry-mysql/src/main/resources/AmbryRepairRequests.ddl;\n```\n\nThen run `./gradlew build` to build and run all unit tests.\n\n## Named-blob cleaner purge (review proposal)\n\nNormal named-blob cleanup retains the latest version. The optional\n`NamedBlobsCleanupRunner` constructor accepting a `Predicate\u003cContainer\u003e purgeEligibility`\nand `boolean purgeDryRun` can instead delete every unexpired, non-deleted mapping in\nselected containers, including latest READY versions and recent IN_PROGRESS versions.\nExisting constructors never enable purge. Container/account exclusions and disabled\nnamed-blob mode still take precedence; container lifecycle status is not changed.\n\nThe caller owns the eligibility policy. It must require explicit per-container opt-in,\nverify that the source data is no longer needed, and prevent source reads and writes\nbefore returning `true`. For a migration, write routing alone is not proof of read\ncutover or destination completeness. Keep this policy live so removing approval\nacts as a kill switch; it is checked before every page and every blob deletion.\nA check cannot cancel an already-issued deletion, so it does not replace fencing\nsource traffic. Start with `purgeDryRun=true`: this reports only the first bounded page\nper eligible container, not a full-container count, and performs no blob or metadata\ndeletion for those containers. Other containers continue normal cleanup.\n\n`MySqlNamedBlobDb` scans purge candidates in ascending primary-key order rather than\nnormal cleanup's descending version order. The last blob name remains an inclusive\ncursor so a name with more versions than a page is revisited. Purge waits for metadata\nsoft-deletion before fetching another page and stops on deletion or metadata failure,\nor if the next page repeats versions that should have been removed;\nthe next scheduled run restarts its purge sweep. Unlike normal cleanup, it never skips\na name after repeated query kills. Primary-key ordering avoids the mixed-order filesort,\nbut filtering already-deleted rows can still require scanning many index entries:\nthis is not a fixed query-latency guarantee or a fix for normal-cleanup scans.\n\nDatabase implementations without purge support fail explicitly through the new default\n`NamedBlobDb.pullStaleBlobs` overload. Blob deletion continues to use the supplied\nrouter's existing offline `deleteBlob(blobId, serviceId)` path. This OSS change does not\nguarantee primary-only routing in a composite router; that must be verified by its\nintegration. Migration-state/completeness checks, deployment configuration, composite\ndatabase delegation, and any secondary metadata cleanup are deliberately outside this\nOSS proposal. Expired/already-deleted mappings remain under their existing cleanup\nmechanisms; metadata soft-deletion does not itself immediately reclaim storage bytes.\n\n`PurgePreviewBlobCount` counts dry-run candidates and `PurgedBlobCount` counts versions\nprocessed after metadata cleanup succeeds. Failures use the existing container failure\ncounter and logs. These are cumulative counters, not distinct-blob inventories.\n\nFocused validation (the integration tests require the local MySQL setup above and the\n`AmbryNamedBlobs` schema from `ambry-named-mysql/src/main/resources/NamedBlobsSchema.ddl`):\n\n```bash\n./gradlew -PdisableShipkit :ambry-frontend:test --tests com.github.ambry.frontend.NamedBlobsCleanupRunnerTest \\\n  :ambry-named-mysql:test --tests com.github.ambry.named.MySqlNamedBlobDbTest\n./gradlew -PdisableShipkit :ambry-named-mysql:intTest \\\n  --tests 'com.github.ambry.named.MySqlNamedBlobDbIntegrationTest.testPurge*'\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinkedin%2Fambry","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinkedin%2Fambry","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinkedin%2Fambry/lists"}