Хранилище Azure

Для включения хранилищ Azure сначала необходимо настроить клиента хранилища Azure, указав один или несколько параметров вида azure.client.CLIENT_NAME.SETTING_NAME. По умолчанию хранилища azure используют клиента с именем default, но при регистрации каждого хранилища можно указать имя другого клиента.

Единственный обязательный параметр клиента хранилища Azure — account, который является защищённым параметром, определённым в хранилище ключей Elasticsearch. Для задания этого параметра используйте инструмент elasticsearch-keystore на каждом узле:

bin/elasticsearch-keystore add azure.client.default.account

Если вы измените этот параметр после запуска узла, вызовите API перезагрузки защищённых параметров узлов для перезагрузки нового значения.

Можно определить более одного клиента, задав их значения account. Например, чтобы задать клиента default и другой клиент с именем secondary, выполните следующие команды на каждом узле:

bin/elasticsearch-keystore add azure.client.default.account
bin/elasticsearch-keystore add azure.client.secondary.account

Параметры key и sas_token также являются защищёнными параметрами и могут быть заданы с помощью команд, подобных следующим:

bin/elasticsearch-keystore add azure.client.default.key
bin/elasticsearch-keystore add azure.client.secondary.sas_token

Другие параметры клиента хранилища Azure должны быть заданы в elasticsearch.yml перед запуском узла. Например:

azure.client.default.timeout: 10s
azure.client.default.max_retries: 7
azure.client.default.endpoint_suffix: core.chinacloudapi.cn
azure.client.secondary.timeout: 30s

В этом примере таймаут клиента составляет 10s за попытку для хранилищ, использующих клиента default, с 7 повторными попытками перед ошибкой и суффиксом конечной точки core.chinacloudapi.cn. Для хранилищ, использующих клиента secondary, таймаут составит 30s за попытку, но будут использованы значения по умолчанию для конечной точки и произойдёт отказ после стандартного количества повторных попыток.

После правильной настройки клиента хранилища Azure зарегистрируйте хранилище Azure следующим образом, указав имя клиента с помощью параметра хранилища client настроек хранилища:

resp = client.snapshot.create_repository(
    name="my_backup",
    repository={
        "type": "azure",
        "settings": {
            "client": "secondary"
        }
    },
)
print(resp)

const response = await client.snapshot.createRepository({
  name: "my_backup",
  repository: {
    type: "azure",
    settings: {
      client: "secondary",
    },
  },
});
console.log(response);

PUT _snapshot/my_backup
{
  "type": "azure",
  "settings": {
    "client": "secondary"
  }
}

Если вы используете клиента default, можно опустить параметр хранилища client:

resp = client.snapshot.create_repository(
    name="my_backup",
    repository={
        "type": "azure"
    },
)
print(resp)

const response = await client.snapshot.createRepository({
  name: "my_backup",
  repository: {
    type: "azure",
  },
});
console.log(response);

PUT _snapshot/my_backup
{
  "type": "azure"
}

Следующий список описывает доступные параметры клиента. Те, что должны храниться в хранилище ключей, отмечены как (Защищённые, перезагружаемые); остальные параметры должны храниться в файле elasticsearch.yml. Значение по умолчанию CLIENT_NAME равно default, но вы можете настроить клиента с другим именем и указать его при регистрации хранилища.

Репозиторий Azure поддерживает следующие настройки, которые могут быть указаны при регистрации репозитория Azure следующим образом:

resp = client.snapshot.create_repository(
    name="my_backup",
    repository={
        "type": "azure",
        "settings": {
            "client": "secondary",
            "container": "my_container",
            "base_path": "snapshots_prefix"
        }
    },
)
print(resp)

const response = await client.snapshot.createRepository({
  name: "my_backup",
  repository: {
    type: "azure",
    settings: {
      client: "secondary",
      container: "my_container",
      base_path: "snapshots_prefix",
    },
  },
});
console.log(response);

PUT _snapshot/my_backup
{
  "type": "azure",
  "settings": {
    "client": "secondary",
    "container": "my_container",
    "base_path": "snapshots_prefix"
  }
}

Согласно руководству по именованию контейнеров, имя контейнера должно быть допустимым именем DNS, соответствующим следующим правилам именования:

Реализация линейно-порядкового регистра для репозиториев Azure основана на поддержке Azure для жёстко согласованных аренд. Каждая аренда может быть удерживаема только одним узлом в любое время. Узел предоставляет свою аренду при выполнении операции чтения или записи защищённого блока. Защищённые арендой операции завершаются ошибкой, если аренда недопустима или истекла. Чтобы выполнить операцию сравнения и обмена в регистре, Elasticsearch сначала получает аренду на блок, затем считывает содержимое блока в рамках этой аренды, а затем загружает обновлённый блок под той же арендой. Этот процесс гарантирует, что операции чтения и записи выполняются атомарно.