Azure 仓库

要启用 Azure 仓库，首先需要通过指定一个或多个 azure.client.CLIENT_NAME.SETTING_NAME 形式的设置来配置 Azure 仓库客户端。默认情况下，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

在此示例中，客户端超时时间对于使用 default 客户端的仓库来说，每次尝试为 10s，失败前重试 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 对强一致性租约的支持。每个租约在任何时候只能由单个节点持有。该节点在对受保护的 Blob 执行读取或写入操作时会出示其租约。如果租约无效或过期，受租约保护的操作将失败。为了对寄存器执行比较和交换操作，Elasticsearch 首先获取 Blob 的租约，然后在租约下读取 Blob 内容，最后在同一租约下上传更新后的 Blob。此过程确保读取和写入操作以原子方式发生。