OpenStackClient/Dotfiles

1. 编号列表项

[状态：提案]

OpenStackClient 以通常的 UNIX 方式在当前用户的家目录中保存本地状态和配置信息。

顶层

~/.openstack

所有保存的文件都位于当前用户家目录中的 ~/.openstack 目录下方。 该目录并非仅供 OpenStackClient 独占使用，而是首先定义内容和用途。 只要所有文件和目录都考虑到这一点进行命名，就应该很容易避免冲突。 如果这被广泛采用，提取一个在 ~/.openstack 中已知名称的“注册表”以供常用参考可能是有意义的。

缓存

~/.openstack/cache

遗留 CLI 的当前用途之一是用于 bash-completion 缓存。 此外，还预计会有一个本地缓存，用于存储大量对象的 UUID-名称映射。 如果缓存文件以可移植的格式存储，则它们可以由多个应用程序共享。

一个考虑因素是，缓存文件需要根据使用的云和用户凭据进行分隔。 因此，缓存文件存储在以请求中使用的端点和用户名哈希命名的目录中。 [注意：稍后需要考虑域。]

OpenStackClient 配置

~/.openstack/oscrc

OpenStackClient 最初没有任何存储的配置，从环境变量、命令行选项和交互式提示中获取所需的一切。 随着云和用户凭据的数量超过几个，这很快变得不方便。 再次，致敬 UNIX 传统，此文件命名为 ~/.openstackclient/oscrc。

存储在 oscrc 中的内容包括任何全局命令行选项，例如 --os-username 和 --os-identity-api-version。 命名上的一个区别是消除了 --os- 前缀，因此一个简短的文件可能如下所示

identity-api-version=3
project-name=CloudDemo

密钥环

~/.openstack/osc-keyring

OpenStackClient 已经使用 ~/.openstack-keyring.cfg 来存储凭据，当 OS_USE_KEYRING=True 时。 目前的唯一更改是将文件移动到此处。

---