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