README-azure.md

Azure Blob Storage

$ cat ~/.azure/config
[storage]
account = "myblobstorage"
key = "MY-STORAGE-KEY"
$ $GOPATH/bin/goofys wasb://container <mountpoint>
$ $GOPATH/bin/goofys wasb://container:prefix <mountpoint> # if you only want to mount objects under a prefix

Users can also configure credentials via AZURE_STORAGE_ACCOUNT and AZURE_STORAGE_KEY environment variables. See Azure CLI configuration for details. Goofys does not support connection_string or sas_token yet.

Goofys also accepts full wasb URIs:

$ $GOPATH/bin/goofys wasb://container@myaccount.blob.core.windows.net <mountpoint>
$ $GOPATH/bin/goofys wasb://container@myaccount.blob.core.windows.net/prefix <mountpoint>

In this case account configuration in ~/.azure/config or AZURE_STORAGE_ACCOUNT can be omitted. Alternatively, --endpoint can also be used to specify storage account:

$ $GOPATH/bin/goofys --endpoint https://myaccount.blob.core.windows.net wasb://container <mountpoint>
$ $GOPATH/bin/goofys --endpoint https://myaccount.blob.core.windows.net wasb://container:prefix <mountpoint>

Note that if full wasb URI is not specified, prefix separator is :.

Finally, insteading of specifying storage account access key, goofys can also use Azure CLI access tokens:

$ az login
# list all subscribtions and select the needed one
$ az account list
# select current subscription (get its id from previous step)
$ az account set --subscription <name or id>
$ $GOPATH/bin/goofys wasb://container@myaccount.blob.core.windows.net <mountpoint>

Azure Data Lake Storage Gen1

Follow the Azure CLI login sequence from above, and then:

$ $GOPATH/bin/goofys adl://servicename.azuredatalakestore.net <mountpoint>
$ $GOPATH/bin/goofys adl://servicename.azuredatalakestore.net:prefix <mountpoint>

Azure Data Lake Storage Gen2

Configure your credentials the same way as Azure Blob Storage above, and then:

$ $GOPATH/bin/goofys abfs://container <mountpoint>
$ $GOPATH/bin/goofys abfs://container:prefix <mountpoint>