使用指南：Rust中的Etcd客户端库

使用指南：Rust中的Etcd客户端库

etcd-client An etcd v3 API client 项目地址: https://gitcode.com/gh_mirrors/etc/etcd-client

Etcd-client是专为Rust设计的一个高效且异步的etcd v3 API客户端，它基于Tokio和Tonic构建，提供了全面支持etcd各种功能的解决方案。本文档旨在引导您安装此库，并详细介绍其基本使用方法、API调用和配置选项。

安装指南

添加依赖

在您的Cargo.toml文件中，确保添加以下依赖项来集成Etcd-client：

[dependencies]
etcd-client = "0.12"
tokio = { version = "1.0", features = ["full"] }

请注意，这些版本号可能随时间更新；确认最新版本以避免兼容性问题。

功能标志

• tls: 开启基于rustls的TLS连接。
• tls-roots: 启用系统信任根至rustls的TLS连接。
• tls-openssl 和 tls-openssl-vendored: 分别提供基于OpenSSL的动态和静态链接TLS连接选项。

根据需要，可以通过在Cargo.toml的 [features] 部分启用上述任意标志。

项目使用说明

基础使用

启动一个新的Etcd客户端并执行基本操作，如存取键值对，可以按照以下示例进行：

use etcd_client::{Client, Error};

#[tokio::main]
async fn main() -> Result<(), Error> {
    // 创建一个指向本地Etcd服务器的客户端实例。
    let mut client = Client::connect(["localhost:2379"], None).await?;

    // 设置键值对。
    client.put("foo", "bar", None).await?;

    // 获取键对应的值。
    let resp = client.get("foo", None).await?;
    if let Some(kv) = resp.kvs().first() {
        // 打印获取到的键值对。
        println!("键值对: {{键: {}, 值: {}}}", kv.key_str()?, kv.value_str()?);
    }

    Ok(())
}

项目API使用文档

Etcd-client支持完整的etcd v3 API，包括但不限于：

• KV操作: 包括put, get, delete等用于键值存储的基本操作。
• Watch: 实时监控键的变化并接收通知。
• Lease: 管理租约，用于键的自动过期。
• Auth: 身份验证和授权管理。
• Maintenance: 维护集群状态的操作，如成员变更。
• Cluster: 查询集群信息和成员列表。
• Lock: 分布式锁的实现，适用于并发控制。
• Election: 分布式选举机制，用于选主场景。

详细API文档可查阅Rsdoc: etcd-client Rsdoc。

项目安装方式

对于项目集成，仅通过Cargo管理即可轻松完成Etcd-client的安装和版本控制，遵循上文的依赖添加步骤。对于特定的功能需求，通过Cargo特性（Features）来选择性地开启必要的组件，例如使用TLS连接。

---

本指南为您提供了快速上手Etcd-client所需的基础知识，利用这个强大的工具，您可以无缝地在Rust应用中整合分布式协调服务的能力。记得查阅更详细的API文档，以充分利用所有可用的特性和函数。

etcd-client An etcd v3 API client 项目地址: https://gitcode.com/gh_mirrors/etc/etcd-client