Update Azure Storage blobstore documentation#214
Update Azure Storage blobstore documentation#214anita-flegg merged 3 commits intocloudfoundry:masterfrom
Conversation
jochenehret
commented
Feb 2, 2026
- the Fog implementation is deprecated and will be removed
- describe new Storage CLI configuration
* the Fog implementation is deprecated and will be removed * describe new Storage CLI configuration
| If you want to configure your blobstore manually, see the topics below for guidance. | ||
|
|
||
| The Cloud Controller has four types of objects that need to be stored in a blobstore: <code>buildpacks</code>, <code>droplets</code>, <code>packages</code>, and <code>resource_pool</code>. By default, the blobstore configuration uses the Fog Ruby gem, but can also use the WebDAV protocol. | ||
| The Cloud Controller has four types of objects that need to be stored in a blobstore: <code>buildpacks</code>, <code>droplets</code>, <code>packages</code>, and <code>resource_pool</code>. By default, the blobstore configuration uses the Fog Ruby gem, but can also use the WebDAV protocol. Note that the Ruby Fog implementation is deprecated and will be gradually replaced with the new [`Storage CLI`](https://github.com/cloudfoundry/storage-cli) implementations. |
There was a problem hiding this comment.
This paragraph uses both "Fog Ruby" and "Ruby Fog." Are both correct?
And if it's deprecated, is it really still the default?
There was a problem hiding this comment.
I'm changing "Fog Ruby" to "Ruby Fog". For now, the Fog implementation is considered the default. We are replacing Fog with the new "storage-cli" implementation step-by-step and eventuall we'll remove Fog entirely.
| If you want to configure your blobstore manually, see the topics below for guidance. | ||
|
|
||
| The Cloud Controller has four types of objects that need to be stored in a blobstore: <code>buildpacks</code>, <code>droplets</code>, <code>packages</code>, and <code>resource_pool</code>. By default, the blobstore configuration uses the Fog Ruby gem, but can also use the WebDAV protocol. | ||
| The Cloud Controller has four types of objects that need to be stored in a blobstore: <code>buildpacks</code>, <code>droplets</code>, <code>packages</code>, and <code>resource_pool</code>. By default, the blobstore configuration uses the Ruby Fog gem, but can also use the WebDAV protocol. Note that the Ruby Fog implementation is deprecated and will be gradually replaced with the new [`Storage CLI`](https://github.com/cloudfoundry/storage-cli) implementations. |
There was a problem hiding this comment.
What I mean is -- if it's deprecated, why is it still the default?
There was a problem hiding this comment.
Well because the transition to the new "storage-cli" implementation is still ongoing. Only for some hyperscalers (AliCloud, Azure) the "storage-cli" implementation is rolled out. For the others, the Ruby Fog implementation is still the default.
There was a problem hiding this comment.
To me, deprecated means "no longer supported"/"don't use," so still being default doesn't make sense.
How about wording it something like this:
The new storage-cli solution is being rolled out across the various hyperscalers (AliCloud and Azure, for example, so the Ruby Fog gem is still the default for some hyperscalers.
There was a problem hiding this comment.
Well there are different interpretations of "deprecated". In our case it means "no longer actively developed" and "has outdated dependencies", but is still working. So in lack of a replacement, Ruby Fog is still the default for many providers.
But I'll rephrase the paragraph.