OpenStack 开发人员邮件列表摘要 1 月 9 日 - 15 日

Success Bot Says

  • stevemar:最新的 python-neutronclient 使用 keystoneauth,太棒了!
  • devkulkarni:Solum 的 Devstack 插件终于按预期工作了。
  • dulek:初步测试表明我们的滚动升级功能运行良好——我可以使用 Mitaka 的 Cinder API 服务与 Liberty 的 cinder-scheduler 和 c-volume 服务。
  • 通过 IRC 发送消息“#success [插入成功案例]”告诉我们你的成功案例。

跨项目规范与 API 指南

  • 添加 clouds.yaml 支持规范 [1]
  • 弃用单个 CLI,转而支持 OSC [2]
  • 添加分页参数的描述 [3]。

发布模型将在 Mitaka-2 左右冻结

  • 截止日期:Mitaka-2,1 月 21 日
  • 例如,您的发布模型是 release:independent,并且您想切换到周期性模型(例如 release:cycle-with-intermediary 或 release:cycle-with-milestones)。[4]
  • 要更改您的项目,请在 reference/projects.yaml 文件中提出 openstack/governance 变更 [5]。

OpenStack API 指南的愿景与变更

  • 新工具:fairy-slipper [6]
    • 将文件从 WADL 迁移到 Swagger。
    • 提供参考信息。
  • 新的构建任务,用于从项目仓库构建 API 指南到 developer.openstack.org
  • 在上次跨项目会议上讨论过这个问题 [7],以解答问题。
  • 有各种规范 [8][9] 需要审查这项工作。
  • 了解本月的进展 [10]。

奥斯汀 OpenStack 峰会“上游开发”轨道

  • 征集演讲者 [11]:在奥斯汀举行的 OpenStack 会议将有一个新的轨道,专门面向 OpenStack 上游开发者。
    • 了解新的开发流程
    • 基础设施团队为我们提供的工具
    • 新的 OSLO 库特性(或其他地方)
    • 最佳实践
  • 可能在设计峰会轨道开始之前的周一。
  • 如果您有一个适合该听众的主题,请提交![12]

您几乎不需要更改每个仓库

  • 有很多补丁会调整许多、许多仓库中的相同内容。
  • 标准化很好,但是如果您正在更改多个仓库,我们应该考虑另一种应用该更改的方式。
  • 如果您发现自己在许多项目中重复进行相同的更改,请先在开发邮件列表中开始讨论。

R-11 周发布倒计时,1 月 18 日至 22 日

  • 重点
    • 下周是 Mitaka 周期第二个里程碑。
    • 主要功能工作应该取得良好进展,或者重新评估是否真的需要在本周期完成。
  • 发布操作
    • 遵循 cycle-with-milestone 的项目联络员应在 1 月 21 日结束前将标签请求提交到 openstack/releases 仓库。
    • 应审查发布联络员职责更新 [13]。
  • 重要日期
    • Mitaka 2:1 月 19 日至 21 日
    • Mitaka 2 标签截止日期:1 月 21 日
    • 发布模型将在 1 月 21 日冻结

应用程序开发者指南接下来会怎样?

摘要

本月,developer.openstack.org 网站焕然一新,并更改了其源工具。请阅读详细信息,了解这些更改如何影响您的项目团队。

我们为什么要更改 developer.openstack.org 网站?

您可能知道,developer.openstack.org 网站记录了已经存在于 developer.openstack.org 网站上的十几个 OpenStack 服务的 900 多个 GET/PUT/POST/DELETE/PATCH 调用。正如东京峰会上几位主题演讲者优雅地指出的那样,OpenStack API 的可信度和一致性影响了他们决定在 OpenStack 云中运行其业务工作负载的决定。

这些接口需要文档,大量的文档,而不仅仅是参考文档。虽然维护准确的 参考 需要付出巨大的努力,但我们还需要记录 API 用法和场景。

现在我们已经编写了 API 指南 和 “编写您的第一个 OpenStack 应用程序” 教程,我们希望该网站成为应用程序开发者、产品开发者以及任何需要释放其 OpenStack 基础设施力量的人的首选位置。

在本版本中,文档平台引入了可让您从 WADL 迁移到 Swagger 并将 RST 源文档与 API 参考文档集成的工具。 “为什么” 分析很明确:我们必须社区化这些信息,并使其易于维护和更新,以便用户能够信任它,并将其工作负载建立在其之上。

稍后,本文将回答“如何”的问题。

为什么在这个发布周期的这个时间点进行所有这些更改?

好吧,我们还没有像发布服务文档那样发布 API 文档。我们对该网站进行了大量的维护,包括错误修复等。但是现在是时候冒险了。上个版本我们做了一个概念验证。这个版本我们发布了一个解决方案,帮助我们朝着我们的目标取得增量进展。

1 月 16 日之后如何保持 API 文档更新?

1 月 16 日,我们将 Images API WADL 和 DocBook 文件迁移到 Swagger 和 RST 文件。然后我们将测试构建过程和内容本身,以验证迁移。

测试完成后,我们将迁移以下服务的的文件

  • 身份验证
  • 计算
  • Images
  • Networks
  • 块存储
  • Object Storage

然后,其余服务可以使用经过验证的工具迁移其文件。

如果您提供 OpenStack API 服务,请继续阅读。

对于 nova 项目,请将您的操作方法和概念文章放在 nova 仓库的 api-guide 文件夹中。其他项目可以模仿这些 创建 api-guideCompute api-guide 的构建任务 的补丁。您继续在 openstack/api-site 仓库中更新参考信息。但是,源文件已更改。

在本版本中,您可以嵌入源代码中的注释,以生成参考信息。这是一个来自 nova 项目的 示例补丁。由于还没有项目完全这样做,构建任务仍然需要编写。

如果您的项目已经有 WADL 文件,它们将被迁移到 Swagger 文件并存储在 api-site 仓库中。WADL 文件将被删除;您可以从 Git 中检索它们。

如果您的项目没有 WADL 文件,那么您编写 Swagger 加上 RST 来记录您的 API 调用、参数和参考信息。您可以从注释生成 Swagger,或者从头开始创建 Swagger,并将其存储在 api-site 仓库中。您应该审查、存储和构建 RST,以获取来自您的项目团队仓库中的概念或操作方法信息。

所有项目都应使用 OpenStack API 工作组的这套 API 文档指南,只要他们的服务具有 REST API。本文档告诉您应该编写什么以及如何编写。如果您遵循建议的提纲,您的 API 指南将准确且完整。

在源文件和构建任务存在之后,文档将构建到 developer.openstack.org。

在哪里可以获得项目 API 指南的帮助?

这些规范描述了详细信息:应用程序开发者指南重做 API 参考信息

您可以在 #openstack-sdks 或 #openstack-docs 上 IRC 上提问。我们期待那些实现愿望的 API 文档仙女,但与此同时,我们可以为您指明方向并为您提供完成任务的工具。

如果我还有其他问题怎么办?

通过电子邮件或 IRC 联系我,Anne Gentle,我会尽快回复您。

我渴望让我们的受众拥有出色的以用户为中心的文件,并希望您加入我们,共同实现这一愿景。

标签:

OpenStack 开发人员邮件列表摘要 1 月 2 日 - 8 日

SuccessBot 说

  • russellb:将 OVS 移植到 Python 3。
  • notmyname:删除了 swift 擦除码文档上的 beta 标签。
  • AJaeger:OpenStack 配置参考已从 DocBook XML 迁移到 RST [1]。
  • notmyname:本季的 Outreachy 实习生的第一个补丁被合并了。
  • odyssey4me:OpenStack-Ansible 12.0.3 已标记。
  • jordanP:我的第三方 CI 正确警告我一个补丁会破坏我的驱动程序。
  • asselin:发布了 OpenStack 第三方 CI 文档 [2]。

Gate CI 测试略有延迟

  • 时间:2016 年 1 月 31 日
  • 原因
    • 由于 OpenStack Infra 团队使用的公共云 [3] 停用,我们将拥有更少的资源。
    • Jeremy Stanley 表示 Infra 团队正在努力引入新的提供商来吸收影响。

R-12 周发布倒计时,1 月 11 日至 25 日

  • 重点
    • 第二个里程碑即将到来。完成主要功能或重新评估是否真的需要在本周期完成。
  • 行动
    • 确定需要在 M-2 标签之前完成的工作。
    • 发布联络员的职责正在更新。如有任何问题或疑虑,请提供评论 [4]。
  • 重要日期
    • Mitaka 2:1 月 19 日至 21 日
    • 发布计划 [5]。

重新引入 Twisted 到 global-requirements

  • global-requirements 中的一项更改引入了 mimic,一个可以模拟各种 API 的 http 服务器。
  • Mimic 依赖于 twisted,过去为了避免开发者需要了解多个框架,twisted 被移除 [5]。
  • Jim Rollenhagen 解释了 Ironic 对 Mimic 的需求
    • 为了进行功能测试,而不是单元测试,后者可以使用 requests-mock 完成。
    • 为了建立一个更便宜的 Ironic 环境来进行这些测试。
  • Jay Pipes 注意到
    • 这是一种引入更多错误表面的另一种方式,因为您需要使 Mimic 与真实的接口保持最新。
    • 使用客户端调用假 HTTP API 的功能测试与使用 requests-mock 进行单元测试相比,优势并不明显。

OpenStack 社区新闻简报 (12 月 12 日 - 22 日)

运行 OpenStack 云?来参加第一次欧洲中期运营商聚会

该聚会将于 2016 年 2 月 15 日至 16 日在曼彻斯特举行,是运营商分享最佳实践和提供反馈的机会。

OpenStack 启动成功的关键:Platform9 Systems

Platform9 Systems 公开了其启动手册,重点介绍了生态系统挑战以及对其他启动公司的建议,包括他们如何通过简单性、选择性和互操作性来区分其产品。

OpenStack 运营商联系在一起

为了使聚会更有效率和更有用,Workday 的 Edgar Magana 建议进行更小、更以运营商为中心的聚会。

通往奥斯汀的道路

  • 演讲者征集 现在已开放,参加 4 月在奥斯汀举行的 OpenStack 峰会! 赶快 – 提交演讲的截止日期是太平洋标准时间 2 月 1 日晚上 11:59。
    • 新:演讲者提交的演讲数量最多为 个。
  • 其他峰会项目现已发布

社区反馈

OpenStack 始终对反馈和社区贡献感兴趣,如果您希望在 OpenStack 每周社区新闻通讯中看到新的部分,或者对内容呈现方式有想法,请与我们联系:[email protected]

CFP 截止日期

2015 年 12 月 12 日至 18 日 OpenStack 开发人员邮件列表摘要

技巧 ‘n 窍门 

即将举行的活动 

其他新闻

OpenStack 开发人员邮件列表摘要 12 月 12 日 - 18 日

Success Bot Says

  • jroll:Ironic 正在使用 devstack 插件。
  • 通过 IRC 发送消息“#success [插入成功案例]”告诉我们你的成功案例。

跨项目规范

  • 技术委员会批准
    • DLM 编年史 [1]。
      • OpenStack 将采用 Tooz 作为分布式锁管理解决方案的抽象层。这将允许项目提供 Tooz 提供的所有选项,以满足其分布式锁管理需求。
      • 当前参考实现是 ZooKeeper,用于测试。
  • 接近批准
    • 库和客户端的向后兼容性 [2]。
    • 弃用单个 CLI,转而支持 OSC [3]。

Gerrit 2.11 中值得享受的新功能

  • 新的搜索字符串
    • 补丁大小
      • delta:<=10
      • 显示少于等于 10 行改动的补丁
    • 按组评分
      • 标签:Code-Review<=-1,nova-core
      • 按 nova-core 团队的 -1 过滤
    • 消息:/comment
      • 查询可以使用多个单词
  • UI 功能
    • is:amergable 字段
    • 第 3 列
      • 相关更改:线性补丁系列中的所有更改。
      • 冲突:系统中的所有未关闭的补丁,这些补丁将与此补丁冲突。
      • 相同主题:分组审查。
    • 内联编辑整个补丁。
      • 点击文件列表上方的“编辑”按钮。完成后,点击“保存”,然后在主页上最终点击“发布编辑”。
      • “跟进”按钮:构建一个完整的跟进补丁,您可以内联编辑它来修复拼写错误等问题。

稳定会议时间提案

DocImpact 与 Reno

  • Sean 注意到对所有 Nova 更改的新任务正在处理提交消息 [5]。
  • 由于 Reno 中包含升级注释,UpgradeImpact 已被弃用。
  • 不再使用 DocImpact,提交消息中的 SecurityImpact,将创建新的特殊部分,使用 Reno 来触发创建错误并发送今天这样的电子邮件。希望这些通知的质量更好。

OpenStack 的 N 和 O 名称的提名现已开放

  • 对于 N 版本,地理区域为“德克萨斯山地” [6]
  • 对于 O 版本,地理区域为“加泰罗尼亚” [7]
  • OpenStack 基金会的个人成员应已通过电子邮件收到投票链接。[8]
  • 投票于 UTC 时间 12 月 22 日结束。

OpenStack 每周社区新闻简报 (12 月 5 日 - 11 日)

旅行补助金帮助全球社区成员参加 OpenStack Summit

来自 15 个国家的关键贡献者参加了最近在东京举行的 OpenStack 首脑会议。奥斯汀的计划正在增长——了解更多关于旅行支持计划的信息。

OpenStack Mitaka 版本:Neutron、Cinder 和 Ceilometer 的下一步是什么

会见项目团队负责人 (PTL),并了解如何参与。

查看这个 OpenStack 操作员工具库

这些工具由操作员贡献并为操作员服务,可为您的工作提供快速解决方案

OpenStack 设计比赛 T 恤现已上市!

Joline Buscemi 赢得了 OpenStack 基金会每年举办的第三届社区 T 恤设计比赛。

社区反馈

OpenStack 始终对反馈和社区贡献感兴趣,如果您希望在 OpenStack 每周社区新闻通讯 中看到新的部分,或者对内容呈现方式有想法,请与我们联系: [email protected]

CFP 截止日期

OpenStack 开发人员邮件列表摘要 12月5日-11日

技巧 ‘n 窍门 

即将举行的活动 

其他新闻

OpenStack 开发人员邮件列表摘要 12月5日-11日

Success Bot Says

  • AJaeger:随着 Juno 结束生命周期,Python 2.6 测试已从 OpenStack CI 中删除。
  • 通过 IRC 发送消息“#success [插入成功案例]”告诉我们你的成功案例。

Gerrit 更新 12/16

  • Gerrit 将于 12 月 16 日 17:00-21:00 UTC 下线
  • Gerrit 将升级到 2.11
  • IP 地址保持不变。
  • 如有问题,请回复线程或在 IRC #openstack-infra 上提问。

R-17 周倒计时,12 月 7-11 日

  • 重点应放在首脑会议上确定的跨项目主题 [1] 上,以及您的项目是否需要完成任何工作来解决这些主题。
  • Doug Hellmann 将在 12 月 21 日之前离线。发布管理团队的其余成员将能够通过以下方式提供帮助
    • IRC #openstack-release
    • 邮件列表,主题中带有“[release]”。
  • 发布操作
    • 如果 Liberty 版本说明页 [2] 没有指向您项目版本说明的链接,请向 openstack/releases 中的可交付文件提交补丁。

错误 现在在补丁合并时将自动关闭

  • 作为弃用我们使用 Launchpad 来跟踪已完成的工作的一部分,当包含“Fixes-Bug”的补丁合并时,该错误将移动到“已修复发布”而不是“已修复提交”。

清理 Gate 中的弃用警告

  • 我们在弹性搜索集群中处理大量日志,这导致经常出现集群中可用 RAM 不足的问题。
  • 一般来说,项目应该查看其日志记录的详细程度,以及这是否真的必要。
  • 使用此查询 [3] 显示过去 7 天在 master 上运行的作业中的弃用警告显示 17576707 次命中。
  • 我们需要志愿者来对 Devstack 进行更改,以避免使用已弃用的选项。
    • 如果您想提供帮助,请使用主题“stop-using-deprecated-options” [4]。

稳定团队 PTL 当选

  • 近 200 名选民选举 Matt Riedmann 为首个稳定团队 PTL [5]。
  • Matt 将下周研究会议时间,以开始讨论从发布团队过渡和工作项目。

发布 OpenStack 健康仪表板

  • 一个仪表板,用于可视化在 gate 中运行的测试的状态 [6]。
  • 从去年 9 月开始,它仍然处于早期阶段。
  • 最大的限制
    • 数据存储:使用 subunit2sql 作为所有数据的后端,并且仅收集 gate 和周期性队列中 tempest 和 grenade 运行的结果。
    • 在 tempest 开始运行之前失败的运行没有结果。
  • 代码 [7]
  • Launchpad [8]
  • 需要完成的工作项目 [9]。

OpenStack 每周社区新闻简报 (11 月 28 日 – 12 月 4 日)

个人成员董事提名现已开放

个人成员董事提名的截止日期是 2015 年 12 月 11 日星期五

如何使用 OpenStack、可穿戴传感器和智能应用程序管理医疗和健康数据

Rackspace 的 Anne Gentle 说:“我们的希望是激励您研究开源,思考解决您可能已经遇到的数据问题的方法。”

为什么不应该有充满孤岛的数据中心

OpenStack 将开发人员与新工具联系起来,同时利用共同的基础,基金会首席运营官 Mark Collier 说道。

为每月 10 亿页浏览量和 1.7 亿独立访客提供支持的 OpenStack

NTT Resonant 运营 goo,这是日本领先的网络门户和互联网搜索引擎之一

社区反馈

OpenStack 始终对反馈和社区贡献感兴趣,如果您希望在 OpenStack 每周社区新闻通讯 中看到新的部分,或者对内容呈现方式有想法,请与我们联系: [email protected]

之前活动的报告 

CFP 和选举截止日期

OpenStack 开发人员邮件列表摘要 11月28日至12月4日

技巧 ‘n 窍门 

即将举行的活动 

其他新闻

OpenStack 开发人员邮件列表摘要 11月28日至12月4日

Success Bot Says

  • dims:跨项目、技术债务减少工作带来回报,oslo-incubator 仓库中不再留有任何代码。
  • dhellmann:horizn、searchlight、python-openstackclient、ironic-introspec、manila、barbican、aodh 和 sahara 已标记为 mitaka-1 里程碑!
  • odyssey4me:OpenStack-Ansible for Kilo 和 Liberty 已发布。
  • ttx:Nova mitaka-1 (13.0.0.0b1) 发布!
  • flaper87:Glance m-1 发布
  • AJaeger:网络指南已翻译成日语,请阅读 [1]
  • stevemar:所有 keystone 项目中都已获得 reno。
  • 通过 IRC 发送消息“#success [插入成功案例]”告诉我们你的成功案例。

即将合并的跨项目规范

  • 客户端和库的向后兼容性 [2]。
  • 支持 OpenStack 客户端而弃用单个 CLI [3]。
  • 分布式锁管理器编年史 [4]。

R-17 周倒计时,12 月 7-11 日

  • 所有带有标签的项目列表 [5]。
  • Reno 中存在一个已知错误,即合并后发布说明未出现 [6]。
  • 团队应该进行回顾,以考虑迄今为止的周期进展如何。
  • 每个项目都有一个补丁,该补丁从 setup.cfg 文件中删除版本字段。请尽快查看该补丁。
  • Mitaka 2 发布:1 月 19-21 日
  • Mitaka 发布计划 [7]。

锁文件传奇(以及我们接下来可以做什么)

  • Josh Harlow 写道,不同的项目使用文件锁来确保同一台机器上的任何应用程序都无法操纵给定的资源。
  • 过时的锁文件错误发生 [8],并且没有简单的方法来确定何时可以手动删除锁文件。
  • 提出的创造性解决方案 [9][10]。
  • Josh 提出使用偏移锁。创建一个大小为 X 的单个文件来存储锁,而不是拥有代表锁的许多文件。
    • Clint 说这只是让锁文件目录看起来干净,但仍然使每个偏移量过时并需要清理。
      • 想法:拥有一个 cron 作业,该作业在设定的合理时间内删除锁文件。
  • Ben Nemec 认为这主要是对不清理旧文件的外观抱怨。过去在进程间锁方面遇到的麻烦,他从未觉得外观问题足以重新审视这个问题。
  • Clint 认为缺少的是清理过时锁的元数据。可以使用
    • fcntl 锁 – 您可以让内核在您想要清理锁并获取锁时确定锁定进程是否仍然存活。
    • 创建锁 – 您需要在锁中写入这些信息,并将其删除,然后找到一种方法来确保该进程存活并知道它拥有该锁,这并不简单。

记录非托管项目的里程碑

  • 带有 non-release:managed 标签的项目应
    • 准备一个补丁,以记录 openstack/releases 存储库中的可交付文件,记录您发布的现有 beta 标签。在提交消息中包含您正在记录现有里程碑标签。
    • 准备一个补丁,以从项目存储库中删除 setup.cfg 文件中的版本行。此补丁应依赖于带有主题“remove-version-from-setup”的发布补丁。
    • 在步骤 2 的审查中链接到评论,添加注释到里程碑标签请求。

跨项目规范联络人

  • Mike Perez 写道,我们今天在跨项目规范方面遇到的问题
    • 规范作者由于缺乏关注而无法推进规范。最终感到沮丧并放弃。
    • 一些项目可能会错过 TC 批准的跨项目规范。
  • 在列表中提出了一项建议,并在跨项目会议 [11] 上讨论,即从每个项目指定跨项目规范联络人,并承担以下责任
    • 监视跨项目规范存储库 [12]。
      • 评论涉及您项目的规范。+1 以供 TC 批准。
        • 如果您无法为您的项目提供有关某些规范的技术指导,那么由您来让合适的人参与进来。
        • 假设您让其他人参与进来,那么由您来确保他们跟上沟通。
  • 在必要时,在您的项目会议上与某些跨项目规范进行沟通。这也有助于上一个要点,即获取对某些规范的技术知识。
  • 参加跨项目会议 [13]。

宣布 OVH 成为 OpenStack CI 系统的新的云服务提供商

OpenStack 项目基础设施团队已将 OVH 的 OpenStack 计算实例添加到项目的持续集成系统中。

有很多方式可以参与像 OpenStack 项目这样的开源社区,而 OVH 正在以最能发挥其优势的方式参与:为项目贡献云资源,以驱动我们的测试和自动化系统——这些资源对于持续开发至关重要。

OpenStack 每天运行多达 30,000 个自动化任务,以测试提议的更改并构建文档和软件制品。负责此工作的系统本身就是一个大型多云应用。它利用 Rackspace、HP Cloud 以及现在 OVH 的 OpenStack 计算实例为开发者提供这项服务。每个实例运行单个任务,然后被删除,以确保下一个任务从一个干净的状态开始。这给我们的供应商带来了极高的需求。

我们对 OVH 的加入感到非常兴奋,这不仅是因为它将帮助我们扩展以满足不断增长的项目需求,还因为它展示了 OpenStack 的关键特性之一:跨云兼容性。当开发者将提议的更改上传到 OpenStack 项目时,来自我们任何贡献云供应商的可用实例都将被互换使用以进行测试。

我们能够做到这一点,这得益于许多 OpenStack 项目的帮助。首先,我们使用 Diskimage-builder 在所有供应商上创建一个基础镜像。这确保了我们的所有测试都在相同的环境中运行。我们的测试资源管理器 Nodepool 使用 shade 库将这些镜像上传到我们的供应商,使用 OpenStack Image service。我们的每个供应商的配置略有不同,但 shade 处理细节,以便 Nodepool 可以专注于业务逻辑。Nodepool 然后识别来自我们的自动化系统 Zuul 的需求,以根据需要创建 OpenStack 计算实例。

基础设施团队感谢 OVH 的贡献以及我们现有的云供应商,并且我们很高兴与他们分享使用这个非常苛求的 OpenStack 应用的经验。