{"id":13564373,"url":"https://github.com/awslabs/coldsnap","last_synced_at":"2025-04-03T21:30:44.214Z","repository":{"id":38149050,"uuid":"281498842","full_name":"awslabs/coldsnap","owner":"awslabs","description":"A command line interface for Amazon EBS snapshots","archived":false,"fork":false,"pushed_at":"2025-04-03T00:10:11.000Z","size":521,"stargazers_count":220,"open_issues_count":22,"forks_count":28,"subscribers_count":17,"default_branch":"develop","last_synced_at":"2025-04-03T00:19:39.099Z","etag":null,"topics":["amazon","aws","ebs","snapshots"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/awslabs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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}},"created_at":"2020-07-21T20:35:15.000Z","updated_at":"2025-04-02T23:08:08.000Z","dependencies_parsed_at":"2023-02-10T18:15:51.357Z","dependency_job_id":"b4429dd5-b786-43f5-8d70-dbf662e30468","html_url":"https://github.com/awslabs/coldsnap","commit_stats":{"total_commits":145,"total_committers":17,"mean_commits":8.529411764705882,"dds":0.5586206896551724,"last_synced_commit":"64a4c67410b03ab1bbdee9000c152347699956a1"},"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awslabs%2Fcoldsnap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awslabs%2Fcoldsnap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awslabs%2Fcoldsnap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awslabs%2Fcoldsnap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/awslabs","download_url":"https://codeload.github.com/awslabs/coldsnap/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246912450,"owners_count":20853861,"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":["amazon","aws","ebs","snapshots"],"created_at":"2024-08-01T13:01:30.344Z","updated_at":"2025-04-03T21:30:44.207Z","avatar_url":"https://github.com/awslabs.png","language":"Rust","funding_links":[],"categories":["Rust","Other Awesome Lists"],"sub_categories":["General Utilities"],"readme":"coldsnap\n--------\n\n`coldsnap` is a command-line interface that uses the Amazon EBS direct APIs to upload and download snapshots.\n\nIt does not need to launch an EC2 instance or manage EBS volume attachments.\nIt can be used to simplify snapshot handling in an automated pipeline.\n\n## Usage\n\n### Credentials\n\nColdsnap uses the same credential mechanisms as the `aws cli`.\nFor example, if you have credentials in `~/.aws/credentials`, these will be used.\nYou can specify the name of the profile to be used by adding `--profile profile-name`.\n\nYou can also define environment variables, for example:\n\n```\n$ export AWS_ACCESS_KEY_ID=EXAMPLEAKIAIOSFODNN7\n$ export AWS_SECRET_ACCESS_KEY=EXAMPLEKEYwJalrXUtnFEMI/K7MDENG/bPxRfiCY\n$ export AWS_DEFAULT_REGION=us-west-2\n```\n\nIf the name of a profile is provided, then it will be used.\nIf not, then the default behavior of the AWS Rust SDK credential provider will be used.\n[Here] is the description of the default behavior.\n\n[Here]: https://docs.rs/aws-config/latest/aws_config/default_provider/credentials/struct.DefaultCredentialsChain.html\n\n### Upload\n\nUpload a local file into an EBS snapshot:\n\n```\n$ coldsnap upload disk.img\n```\n\nIf you want to wait for the uploaded snapshot to be in \"available\" state, add `--wait`:\n\n```\n$ coldsnap upload --wait disk.img\n```\n\nAlternately, you can use `coldsnap wait`, which offers more flexibility in terms of wait duration and behavior.\n\n```\n$ coldsnap wait snap-1234\n```\n\nIf you want to add tags to the uploaded snapshot, add `--tag Key=k,Value=v` for each desired tag:\n\n```\n$ coldsnap upload snap-1234 --tag \"Key=MyKeyName,Value=MyKeyValue\" --tag \"Key=MyOtherKeyName,Value=MyOtherKeyValue\"\n```\n\n\n### Download\n\nDownload an EBS snapshot into a local file:\n\n```\n$ coldsnap download snap-1234 disk.img\n```\n\nRun `coldsnap --help` to see more options.\n\n## Installation\n\n`coldsnap` can be installed using [`cargo`](https://rustup.rs/).\n\n```\n$ cargo install --locked coldsnap\n```\n\n## Security\n\nSee [CONTRIBUTING](CONTRIBUTING.md#security-issue-notifications) for more information.\n\n## License\n\nThis project is licensed under the Apache-2.0 License.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawslabs%2Fcoldsnap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fawslabs%2Fcoldsnap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawslabs%2Fcoldsnap/lists"}