2017-03-08 02:47:23 +00:00
|
|
|
|
---
|
2020-01-18 00:18:09 +00:00
|
|
|
|
layout: docs
|
|
|
|
|
page_title: Azure - Storage Backends - Configuration
|
2017-03-08 02:47:23 +00:00
|
|
|
|
description: |-
|
|
|
|
|
The Azure storage backend is used to persist Vault's data in an Azure Storage
|
|
|
|
|
Container. The storage container must already exist and the provided account
|
|
|
|
|
credentials must have read and write permissions to the storage container.
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Azure Storage Backend
|
|
|
|
|
|
|
|
|
|
The Azure storage backend is used to persist Vault's data in an
|
|
|
|
|
[Azure Storage Container][azure-storage]. The storage container must already
|
|
|
|
|
exist and the provided account credentials must have read and write permissions
|
2019-11-06 21:24:37 +00:00
|
|
|
|
to the storage container. The storage account type must support block blobs. This
|
|
|
|
|
currently includes the general purpose "Storage V2" type with _Standard_ performance
|
|
|
|
|
(Premium will not work), as well as Premium "Block Blob Storage"
|
|
|
|
|
([limited region availability](https://azure.microsoft.com/en-us/global-infrastructure/services/?products=storage®ions=all)).
|
|
|
|
|
|
2017-03-08 02:47:23 +00:00
|
|
|
|
- **No High Availability** – the Azure storage backend does not support high
|
|
|
|
|
availability.
|
|
|
|
|
|
|
|
|
|
- **Community Supported** – the Azure storage backend is supported by the
|
|
|
|
|
community. While it has undergone review by HashiCorp employees, they may not
|
|
|
|
|
be as knowledgeable about the technology. If you encounter problems with them,
|
|
|
|
|
you may be referred to the original author.
|
|
|
|
|
|
|
|
|
|
```hcl
|
2017-03-08 14:17:00 +00:00
|
|
|
|
storage "azure" {
|
2017-03-08 02:47:23 +00:00
|
|
|
|
accountName = "my-storage-account"
|
|
|
|
|
accountKey = "abcd1234"
|
|
|
|
|
container = "container-efgh5678"
|
2018-08-15 23:40:36 +00:00
|
|
|
|
environment = "AzurePublicCloud"
|
2017-03-08 02:47:23 +00:00
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
The current implementation is limited to a maximum of 4 megabytes per blob.
|
|
|
|
|
|
|
|
|
|
## `azure` Parameters
|
|
|
|
|
|
|
|
|
|
- `accountName` `(string: <required>)` – Specifies the Azure Storage account
|
|
|
|
|
name.
|
|
|
|
|
|
2020-10-28 22:04:26 +00:00
|
|
|
|
- `accountKey` `(string: <optional>)` – Specifies the Azure Storage account key,
|
2020-12-17 21:53:33 +00:00
|
|
|
|
if left empty, uses managed identity auth.
|
2017-03-08 02:47:23 +00:00
|
|
|
|
|
|
|
|
|
- `container` `(string: <required>)` – Specifies the Azure Storage Blob
|
|
|
|
|
container name.
|
|
|
|
|
|
2018-08-15 23:40:36 +00:00
|
|
|
|
- `environment` `(string: "AzurePublicCloud")` - Specifies the cloud
|
2020-01-18 00:18:09 +00:00
|
|
|
|
environment the storage account belongs to by way of the case-insensitive
|
|
|
|
|
name defined in the [Azure Go SDK][azure-environment].
|
2018-08-15 23:40:36 +00:00
|
|
|
|
|
2019-10-08 15:51:36 +00:00
|
|
|
|
- `arm_endpoint` `(string: "")` - Specifies the cloud environment
|
|
|
|
|
the storage account belongs to by way of the Azure Resource Manager endpoint
|
|
|
|
|
URL.
|
|
|
|
|
|
2017-03-26 18:32:26 +00:00
|
|
|
|
- `max_parallel` `(string: "128")` – Specifies The maximum number of concurrent
|
2017-03-08 02:47:23 +00:00
|
|
|
|
requests to Azure.
|
|
|
|
|
|
|
|
|
|
## `azure` Examples
|
|
|
|
|
|
|
|
|
|
This example shows configuring the Azure storage backend with a custom number of
|
|
|
|
|
maximum parallel connections.
|
|
|
|
|
|
|
|
|
|
```hcl
|
2017-03-08 14:17:00 +00:00
|
|
|
|
storage "azure" {
|
2017-03-08 02:47:23 +00:00
|
|
|
|
accountName = "my-storage-account"
|
|
|
|
|
accountKey = "abcd1234"
|
|
|
|
|
container = "container-efgh5678"
|
|
|
|
|
max_parallel = 512
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
[azure-storage]: https://azure.microsoft.com/en-us/services/storage/
|
2019-11-06 21:24:37 +00:00
|
|
|
|
[azure-environment]: https://godoc.org/github.com/Azure/go-autorest/autorest/azure#pkg-variables
|