BorgQueen.CloudFS.Interfaces 0.0.3

CloudFS

The CloudFS library is a collection of .NET assemblies as gateways to various publicly accessible Cloud storage services.

Branch	Build status	Code coverage	Code analysis	Quality gate
master
develop			see above	see above

Objective

This library provides access to file system operations of various publicly accessible Cloud storage services behind a common interface. It thus facilitates the flexible integration of Cloud storage into arbitrary .NET applications.

Supported Cloud storage services

Consideration of a cloud storage service as a target for CloudFS depends on these conditions:

• free storage space quota of at least 10 GB
• file expiration period no shorter than 90 days for free users
• alternatively, in response to a stated interest by the community, a cloud storage service may be included despite shortcomings in the preceding aspects
• availability of a .NET-accessible API under a non-invasive open source license (Apache, MIT, MS-PL)

Currently the following cloud storage services are supported in CloudFS via the specified API libraries:

^{<b id="f1">1</b>} Maximum supported file size for upload through the respective cloud API.<br/>This is a non-authoritative value determined through unit tests. ^<br/> ^{<b id="f2">2</b>} Following Microsoft's November 2^nd, 2015 announcement of its "OneDrive storage plans change in pursuit of productivity and collaboration" the OneDrive cloud storage service will fail to meet the above stated requirements for support in CloudFS after mid-July 2016.<br/>Despite this unprecedented and highly objectionable degradation of service quality, OneDrive will continue to be supported by CloudFS for historical reasons. ^<br/> ^{<b id="f3">3</b>} This version of OneDriveSDK has been deprecated by Microsoft. ^<br/> ^{<b id="f4">4</b>} The Copy cloud storage service was discontinued as of May 1^st 2016 according to this announcement.<br/>The Copy gateway has therefore been retired from CloudFS. ^<br/> ^{<b id="f5">5</b>} WebDAV-based cloud storage is available through various public cloud providers or by self-hosting an OwnCloud private cloud. ^<br/>

System Requirements

• Platform
  • .NET 4.6.2
• Operating system
  • tested on Windows 8.1 x64 and Windows Server 2012 R2 (until version 1.0.0-alpha) /<br/>Windows 10 x64 (from version 1.0.1-alpha)
  • expected to run on Windows 7/8/8.1/10 and Windows Server 2008(R2)/2012(R2)/2016

Local compilation

Several cloud storage services require additional authentication of external applications for access to cloud filesystem contents.<br/>For cloud storage services with this kind of authentication policy in place you need to take the following steps before compiling CloudFS locally:

• register for a developer account with the respective cloud service
• create a cloud application configuration with sufficient rights to access the cloud filesystem
• enter the service-provided authentication details into the prepared fields in the Secrets class of the affected PowerShellCloudProvider gateway project

At the time of writing this Readme, the following URLs provided access to application management tasks such as registering a new application or changing an application's configuration:

Release Notes

Future plans

• include additional gateways for more Cloud storage services
• improve stability of large file uploads