doc/install/configure-azure-blob-storage.html.textile.liquid

   1 ---
   2 layout: default
   3 navsection: installguide
   4 title: Configure Azure Blob storage
   5 ...
   6
   7 As an alternative to local and network-attached POSIX filesystems, Keepstore can store data in an Azure Storage container.
   8
   9 h2. Create a container
  10
  11 Normally, all keepstore services are configured to share a single Azure Storage container.
  12
  13 Using the Azure web portal or command line tool, create or choose a storage account with a suitable redundancy profile and availability region. Use the storage account keys to create a new container.
  14
  15 <notextile>
  16 <pre><code>~$ <span class="userinput">azure config mode arm</span>
  17 ~$ <span class="userinput">azure login</span>
  18 ~$ <span class="userinput">azure group create exampleGroupName eastus</span>
  19 ~$ <span class="userinput">azure storage account create --type LRS --location eastus --resource-group exampleGroupName exampleStorageAccountName</span>
  20 ~$ <span class="userinput">azure storage account keys list --resource-group exampleGroupName exampleStorageAccountName</span>
  21 info:    Executing command storage account keys list
  22 + Getting storage account keys
  23 data:    Primary: zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz==
  24 data:    Secondary: yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy==
  25 info:    storage account keys list command OK
  26 ~$ <span class="userinput">AZURE_STORAGE_ACCOUNT="exampleStorageAccountName" \
  27 AZURE_STORAGE_ACCESS_KEY="zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz==" \
  28 azure storage container create exampleContainerName</span>
  29 </code></pre>
  30 </notextile>
  31
  32 h2. Configure keepstore
  33
  34 Copy the primary storage account key to a file where it will be accessible to keepstore at startup time.
  35
  36 <notextile>
  37 <pre><code>~$ <span class="userinput">sudo sh -c 'cat &gt;/etc/sv/keepstore/exampleStorageAccountName.key &lt;&lt;EOF'
  38 zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz==
  39 EOF</span>
  40 ~$ <span class="userinput">sudo chmod 0400 /etc/sv/keepstore/exampleStorageAccountName.key</span>
  41 </code></pre>
  42 </notextile>
  43
  44 In your keepstore startup script, instead of specifying a local storage using @-volume /path@ or discovering mount points automatically, use @-azure-*@ arguments to specify the storage container:
  45
  46 <notextile>
  47 <pre><code>#!/bin/sh
  48
  49 exec 2&gt;&amp;1
  50 exec keepstore \
  51  -azure-storage-account-key-file <span class="userinput">/etc/sv/keepstore/exampleStorageAccountName.key</span> \
  52  -azure-storage-account-name <span class="userinput">exampleStorageAccountName</span> \
  53  -azure-storage-container-volume <span class="userinput">exampleContainerName</span>
  54 </code></pre>
  55 </notextile>
  56
  57 Start (or restart) keepstore, and check its log file to confirm it is using the new configuration.
  58
  59 <notextile>
  60 <pre><code>2015/10/26 21:06:24 Using volume azure-storage-container:"exampleContainerName" (writable=true)
  61 </code></pre>
  62 </notextile>