From 9aa560e78150ebac2895efc35e2d6fc466e55079 Mon Sep 17 00:00:00 2001 From: Jochen Ehret Date: Mon, 2 Feb 2026 14:03:05 +0100 Subject: [PATCH] Update Azure Storage blobstore documentation * the Fog implementation is deprecated and will be removed * describe new Storage CLI configuration --- common/cc-blobstore-config.html.md.erb | 46 +++++++++++++++++--------- 1 file changed, 31 insertions(+), 15 deletions(-) diff --git a/common/cc-blobstore-config.html.md.erb b/common/cc-blobstore-config.html.md.erb index bb7ebdb..b196a2c 100644 --- a/common/cc-blobstore-config.html.md.erb +++ b/common/cc-blobstore-config.html.md.erb @@ -13,7 +13,7 @@ The [`cf-deployment`](https://github.com/cloudfoundry/cf-deployment/blob/master/ By default, `cf-deployment` uses the WebDAV blobstore, and no additional ops files are needed. 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: buildpacks, droplets, packages, and resource_pool. 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: buildpacks, droplets, packages, and resource_pool. 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. This document describes the following common blobstore configurations: @@ -22,7 +22,7 @@ This document describes the following common blobstore configurations: * [Fog with AWS IAM Instance Profiles](#fog-aws-iam) * [Fog with Google Cloud Storage](#fog-gcs) * [Fog with Google Cloud Storage Service Accounts](#fog-gcs-service-account) -* [Fog with Azure Storage](#fog-azure) +* [Storage CLI with Azure Storage](#storage-cli-azure) * [Fog with Other S3 Compatible Stores](#fog-s3-other) * [Fog with NFS](#fog-local-nfs) * [WebDAV](#webdav) internal blobstore @@ -355,7 +355,7 @@ You need this key to configure your blobstore. resource_pool: *resource_pool ``` -##Fog with Azure Storage +##Storage CLI with Azure Storage To configure your blobstores to use Azure Storage credentials, do the following: @@ -364,25 +364,41 @@ To configure your blobstores to use Azure Storage credentials, do the following: ``` cc: buildpacks: - blobstore_type: fog + blobstore_provider: AzureRM + blobstore_type: storage-cli buildpack_directory_key: YOUR-AZURE-BUILDPACK-CONTAINER - fog_connection: &fog_connection - provider: AzureRM - environment: AzureCloud - azure_storage_account_name: YOUR-AZURE-STORAGE-ACCOUNT-NAME + connection_config: azure_storage_access_key: YOUR-AZURE-STORAGE-ACCESS-KEY + azure_storage_account_name: YOUR-AZURE-STORAGE-ACCOUNT-NAME + container_name: YOUR-AZURE-BUILDPACK-CONTAINER + environment: AzureCloud droplets: - blobstore_type: fog + blobstore_provider: AzureRM + blobstore_type: storage-cli droplet_directory_key: YOUR-AZURE-DROPLET-CONTAINER - fog_connection: *fog_connection + connection_config: + azure_storage_access_key: YOUR-AZURE-STORAGE-ACCESS-KEY + azure_storage_account_name: YOUR-AZURE-STORAGE-ACCOUNT-NAME + container_name: YOUR-AZURE-DROPLET-CONTAINER + environment: AzureCloud packages: - blobstore_type: fog + blobstore_provider: AzureRM + blobstore_type: storage-cli app_package_directory_key: YOUR-AZURE-PACKAGE-CONTAINER - fog_connection: *fog_connection + connection_config: + azure_storage_access_key: YOUR-AZURE-STORAGE-ACCESS-KEY + azure_storage_account_name: YOUR-AZURE-STORAGE-ACCOUNT-NAME + container_name: YOUR-AZURE-PACKAGE-CONTAINER + environment: AzureCloud resource_pool: - blobstore_type: fog + blobstore_provider: AzureRM + blobstore_type: storage-cli resource_directory_key: YOUR-AZURE-RESOURCE-CONTAINER - fog_connection: *fog_connection + connection_config: + azure_storage_access_key: YOUR-AZURE-STORAGE-ACCESS-KEY + azure_storage_account_name: YOUR-AZURE-STORAGE-ACCOUNT-NAME + container_name: YOUR-AZURE-RESOURCE-CONTAINER + environment: AzureCloud ``` 1. Replace `YOUR-AZURE-STORAGE-ACCOUNT-NAME` and `YOUR-AZURE-STORAGE-ACCESS-KEY` with your Azure Storage credentials. @@ -394,7 +410,7 @@ To configure your blobstores to use Azure Storage credentials, do the following: only lowercase alphanumeric characters and hyphens. See [Azure's storage name restrictions][azure-name-restrictions]. -1. You can provide further configuration through the `fog_connection` hash, which is passed through to the Fog gem. +1. You can provide further configuration through the `connection_config` hash, which is passed through to the [`Storage CLI`](https://github.com/cloudfoundry/storage-cli) implementation. ## Fog with Other S3 Compatible Stores