{"id":13564294,"url":"https://github.com/containers/storage","last_synced_at":"2025-05-12T11:17:05.426Z","repository":{"id":37549328,"uuid":"63429318","full_name":"containers/storage","owner":"containers","description":"Container Storage Library","archived":false,"fork":false,"pushed_at":"2025-05-07T22:55:20.000Z","size":83550,"stargazers_count":601,"open_issues_count":95,"forks_count":255,"subscribers_count":32,"default_branch":"main","last_synced_at":"2025-05-11T11:08:41.772Z","etag":null,"topics":["buildah","containers","podman","skopeo"],"latest_commit_sha":null,"homepage":"","language":"Go","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/containers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE-OF-CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-07-15T14:48:14.000Z","updated_at":"2025-05-10T22:31:47.000Z","dependencies_parsed_at":"2023-10-16T02:28:12.939Z","dependency_job_id":"e8a2312a-da73-416d-9f4c-2e7de77896f7","html_url":"https://github.com/containers/storage","commit_stats":{"total_commits":17912,"total_committers":1651,"mean_commits":"10.849182313749242","dds":0.9515966949531041,"last_synced_commit":"48e12ae2d80f64e38f7c12f4c31e9908855e435c"},"previous_names":[],"tags_count":183,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/containers%2Fstorage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/containers%2Fstorage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/containers%2Fstorage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/containers%2Fstorage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/containers","download_url":"https://codeload.github.com/containers/storage/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253554084,"owners_count":21926613,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["buildah","containers","podman","skopeo"],"created_at":"2024-08-01T13:01:29.338Z","updated_at":"2025-05-11T11:08:55.770Z","avatar_url":"https://github.com/containers.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"`storage` is a Go library which aims to provide methods for storing filesystem\nlayers, container images, and containers.  A `containers-storage` CLI wrapper\nis also included for manual and scripting use.\n\nTo build the CLI wrapper, use 'make binary'.\n\nOperations which use VMs expect to launch them using 'vagrant', defaulting to\nusing its 'libvirt' provider.  The boxes used are also available for the\n'virtualbox' provider, and can be selected by setting $VAGRANT_PROVIDER to\n'virtualbox' before kicking off the build.\n\nThe library manages three types of items: layers, images, and containers.\n\nA *layer* is a copy-on-write filesystem which is notionally stored as a set of\nchanges relative to its *parent* layer, if it has one.  A given layer can only\nhave one parent, but any layer can be the parent of multiple layers.  Layers\nwhich are parents of other layers should be treated as read-only.\n\nAn *image* is a reference to a particular layer (its _top_ layer), along with\nother information which the library can manage for the convenience of its\ncaller.  This information typically includes configuration templates for\nrunning a binary contained within the image's layers, and may include\ncryptographic signatures.  Multiple images can reference the same layer, as the\ndifferences between two images may not be in their layer contents.\n\nA *container* is a read-write layer which is a child of an image's top layer,\nalong with information which the library can manage for the convenience of its\ncaller.  This information typically includes configuration information for\nrunning the specific container.  Multiple containers can be derived from a\nsingle image.\n\nLayers, images, and containers are represented primarily by 32 character\nhexadecimal IDs, but items of each kind can also have one or more arbitrary\nnames attached to them, which the library will automatically resolve to IDs\nwhen they are passed in to API calls which expect IDs.\n\nThe library can store what it calls *metadata* for each of these types of\nitems.  This is expected to be a small piece of data, since it is cached in\nmemory and stored along with the library's own bookkeeping information.\n\nAdditionally, the library can store one or more of what it calls *big data* for\nimages and containers.  This is a named chunk of larger data, which is only in\nmemory when it is being read from or being written to its own disk file.\n\n**[Contributing](CONTRIBUTING.md)**\nInformation about contributing to this project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontainers%2Fstorage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcontainers%2Fstorage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontainers%2Fstorage/lists"}