Apache OpenDAL™ Oli

oli 代表 OpenDAL 命令行界面。它旨在提供一种统一且用户友好的方式来操作存储在各种存储服务中的数据。

如何使用 oli

oli 提供类似于本地文件系统使用的 oli ls、oli cat、oli stat、oli cp 和 oli rm 等基本子命令。

安装 oli

oli 可以通过 cargo 安装

cargo install oli --all-features

cargo 是 Rust 的包管理器。可以通过访问 安装 Rust 官方网站来安装 cargo。

配置 oli 配置文件

oli 需要一个配置文件才能运行，它应该是

• ~/.config/oli/config.toml 在 Linux 上
• ~/Library/Application Support/oli/config.toml 在 macOS 上
• C:\Users\<UserName>\AppData\Roaming\oli\config.toml 在 Windows 上

config.toml 的内容应遵循以下模式

[profiles.<profile_name>]
configuration_key1 = "value1"
configuration_key2 = "value2"

[profiles.<another_profile_name>]
configuration_key3 = "value3"
configuration_key4 = "value4"

以下是一个 config.toml 的示例

[profiles.s3]
type = "s3"
root = "/assets"
bucket = "<bucket>"
region = "<region>"
endpoint = "https://s3.amazonaws.com"
access_key_id = "<access_key_id>"
secret_access_key = "<secret_access_key>"

[profiles.r2]
type = "s3"
root = "/assets"
bucket = "<bucket>"
region = "auto"
endpoint = "https://<account_id>.r2.cloudflarestorage.com"
access_key_id = "<access_key_id>"
secret_access_key = "<secret_access_key>"

对于不同的服务，您可以在相应的 服务文档 中找到配置键。

示例：使用 oli 将文件上传到 AWS S3

$ oli cp ./update-ecs-loadbalancer.json s3://update-ecs-loadbalancer.json
$ oli ls s3://                                                           
fleet.png
update-ecs-loadbalancer.json

示例：使用 oli 将文件从 S3 复制到 R2

$ oli cp s3://fleet.png r2://fleet.png
$ oli ls r2://
fleet.png

为 oli 贡献

贡献不仅关于代码，还关于文档、示例等！🚀

如果您对 oli 有任何问题或建议，请随时在 GitHub 上提交问题。

由于 oli 是 Apache OpenDAL 的一部分，您应遵循贡献指南。关于 oli 仍有很多工作要做，您可以通过这个 GitHub 问题 跟踪它们。

品牌

第一次和最突出的提及必须使用全称：在任何个人使用（网页、传单、幻灯片等）中都必须使用 Apache OpenDAL™。根据上下文和写作风格，您应足够频繁地使用名称的全称，以确保读者清楚地理解 OpenDAL 项目和 OpenDAL 软件产品与 ASF 作为母组织之间的关联。

更多详情，请参阅 Apache 产品名称使用指南。

许可和商标

根据 Apache License，版本 2.0 许可：http://www.apache.org/licenses/LICENSE2.0

Apache OpenDAL、OpenDAL 和 Apache 是 Apache 软件基金会的注册商标或商标。