2017-06-01 23:02:31 +03:00
|
|
|
[](https://travis-ci.org/Azure/blobxfer)
|
|
|
|
|
[](https://coveralls.io/github/Azure/blobxfer?branch=master)
|
|
|
|
|
[](https://pypi.python.org/pypi/blobxfer)
|
|
|
|
|
[](https://pypi.python.org/pypi/blobxfer)
|
|
|
|
|
[](https://hub.docker.com/r/alfpark/blobxfer)
|
|
|
|
|
[](http://microbadger.com/images/alfpark/blobxfer)
|
2017-01-13 01:44:44 +03:00
|
|
|
|
2017-06-01 23:02:31 +03:00
|
|
|
# blobxfer
|
|
|
|
|
`blobxfer` is an advanced data movement tool and library for Azure Storage
|
|
|
|
|
Blob and Files. With `blobxfer` you can copy your files into or out of Azure
|
|
|
|
|
Storage with the CLI or integrate the `blobxfer` data movement library into
|
|
|
|
|
your own Python scripts.
|
2017-01-13 01:44:44 +03:00
|
|
|
|
2017-06-01 23:02:31 +03:00
|
|
|
## Major Features
|
|
|
|
|
* Command-line interface (CLI) providing data movement capability to and
|
|
|
|
|
from Azure Blob and File Storage
|
|
|
|
|
* High-performance design with asynchronous transfers and disk I/O
|
|
|
|
|
* YAML configuration driven execution support
|
|
|
|
|
* Resume support
|
|
|
|
|
* Vectored IO
|
|
|
|
|
* `stripe` mode allows striping a single file across multiple blobs to
|
|
|
|
|
break through single blob or fileshare throughput limits including
|
|
|
|
|
multi-storage account destinations
|
|
|
|
|
* `replica` mode allows replication of a file across multiple locations
|
|
|
|
|
including multi-storage account destinations
|
|
|
|
|
* Client-side encryption support
|
|
|
|
|
* Advanced skip options for rsync-like operations
|
|
|
|
|
* Store/restore POSIX filemode and uid/gid
|
|
|
|
|
* `stdin` piping support
|
|
|
|
|
* Append blob support
|
|
|
|
|
* Configurable one-shot block upload support
|
|
|
|
|
* Block (chunk) size selection support
|
|
|
|
|
* Rsync-like `--delete-after` support
|
|
|
|
|
* Support for reading from blob snapshots
|
|
|
|
|
* Automatic block blob size adjustment for uploading
|
|
|
|
|
* Automatic uploading of VHD and VHDX files as page blobs
|
|
|
|
|
* Wildcard filtering with include and exclude support
|
|
|
|
|
* No clobber support in either direction
|
|
|
|
|
* File logging support
|
2017-01-13 01:44:44 +03:00
|
|
|
|
2017-06-01 23:02:31 +03:00
|
|
|
## Installation
|
|
|
|
|
`blobxfer` is on [PyPI](https://pypi.python.org/pypi/blobxfer) and on
|
|
|
|
|
[Docker Hub](https://hub.docker.com/r/alfpark/blobxfer/). Please refer to
|
|
|
|
|
the [installation guide](https://github.com/Azure/blobxfer/blob/master/docs/01-installation.md)
|
|
|
|
|
on how to install `blobxfer`.
|
|
|
|
|
|
|
|
|
|
## Documentation
|
|
|
|
|
Please refer to the [blobxfer Documentation](https://github.com/Azure/blobxfer/blob/master/docs)
|
|
|
|
|
for more details and usage information.
|
|
|
|
|
|
|
|
|
|
## Change Log
|
|
|
|
|
For recent changes, please refer to the
|
|
|
|
|
[CHANGELOG.md](https://github.com/Azure/blobxfer/blob/master/CHANGELOG.md)
|
|
|
|
|
file.
|
2017-01-13 01:44:44 +03:00
|
|
|
|
|
|
|
|
------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
This project has adopted the
|
|
|
|
|
[Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
|
|
|
|
|
For more information see the
|
|
|
|
|
[Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
|
|
|
|
|
or contact [<opencode@microsoft.com>](mailto:opencode@microsoft.com) with any
|
|
|
|
|
additional questions or comments.
|
