从Github仓库同步信息
项目描述
在您的Odoo实例中加载Github数据
此模块允许您
从Github获取Odoo社交信息(组织、团队、用户)
从Github获取Odoo代码结构信息(仓库、分支)
从Github下载源代码
配置
安装后,您需要
打开您的odoo.conf文件,并添加额外的设置来提及Github凭证,以及源代码将被下载的本地路径
github_login = your_github_login
github_password = your_github_password
source_code_local_path = /workspace/source_code/
注意:确保Odoo进程有对该文件夹的读写访问权限
转到‘设置’/‘技术’/‘参数’/‘系统参数’,并定义以下值
github.max_try:在引发错误之前调用API的次数。您的连接越不稳定/越慢,此值应该越高
git.partial_commit_during_analysis:如果您想在每次仓库分析后提交分析结果到数据库中,设置为True。我们建议在执行初始下载(可能包含大量仓库)时设置为True,以减小事务大小
转到您的用户表单,将他们添加到新的‘Connector Github Manager’组中。此组的成员将有机会运行Github同步。
使用方法
从Github的初始上传
要从Github获取信息,您必须
转到‘Github’/‘设置’/‘同步对象’
选择您要同步的对象类型及其Github名称
完成组织设置后,转到‘Github’/‘Github社区’/‘组织’
组织创建后,您可以为您的项目创建系列。转到‘Github’/‘组织’/点击您的组织/‘组织系列’标签页
选择要下载的分支
此设置将防止下载不需要的分支,只下载主分支(发布版本)
在‘设置’标签页中,设置您不想下载的仓库(或您想下载的仓库)。如果设置‘特定仓库’,则忽略‘忽略仓库’的值。
在‘设置’标签页中,设置您用于持续集成和覆盖的‘外部服务’的URL。
完成后,点击‘同步’按钮,以同步仓库、团队和成员。(此过程可能需要一段时间,具体取决于您的规模)
团队/成员同步
您可以同步成员团队
转到‘团队’/树状视图/‘操作’/‘从Github更新’。
在每个团队中,您可以看到成员列表和成员的角色
在每个团队中,您可以看到仓库列表,但不能看到团队权限。(见‘已知问题’部分)
仓库同步
您可以为您的仓库同步分支
转到‘仓库’/树状视图/‘操作’/‘从Github更新’
在每个仓库中,您可以看到主分支列表和代码源的大小。
获取源代码
最后,您可以下载所有分支的源代码
转到‘仓库分支’/树状视图/‘操作’/‘下载并分析源代码’。
在树状视图中,您可以手动更新源代码或刷新分析。
Github中的数据创建
您可以直接从Odoo创建两个项目在Github
团队
转到‘设置’/‘在Github创建团队’。
设置信息并点击在Github上创建。
Odoo将尝试创建团队。如果访问权限和数据正确,创建将直接在Github完成
之后,将执行同步,以在Odoo实例中创建相应的团队。
仓库
转到‘设置’/‘在Github创建团队’。
设置信息并点击在Github上创建。
注意
本模块的分析是基本的:目前,它只是给出分支大小。
尽管如此,您可以根据需要开发额外的Odoo自定义模块来扩展分析功能并获取额外的统计数据。
这样,您可以看到github_connector_odoo模块,如果您的仓库包含Odoo模块。
报告
本模块提供了几个报告
系列分支
系列大小
技术信息
本模块提供了4个cron任务,您可以选择启用
同步所有组织和团队(cron_update_organization)
同步所有仓库的分支列表(cron_update_branch_list)
下载所有Github分支的源代码(cron_download_code)
分析所有Github分支的源代码(cron_analyze_code)
路线图/已知问题
目前,Github API不提供一些在经典UI中可用的信息,包括
团队层次结构:该字段存在于模型github_team.parent_id中,但未使用。
可能的改进
创建一个新的模块github_connector_website,该模块可以显示非登录用户团队/仓库/分支信息。
分析提交(作者、按系列的数量等...):此功能已在V8.0 PR中部分实现。
同步拉取请求、问题、评论:此功能已在V8.0 PR中部分实现。
重构github连接器
有一个名为PyGitHub的Python库可用。使用它可能很有趣,而不是使用自定义代码。然而,此库没有提供对子对象的良好访问,目前产生了不必要的API调用。例如,更新仓库应在调用父组织之前进行调用(当前模块更快)。
``sudo pip install PyGitHub``
错误跟踪器
错误在GitHub Issues上进行跟踪。如果遇到问题,请检查您的错误是否已被报告。如果您是第一个发现的人,请通过提供详细和受欢迎的反馈来帮助我们解决问题。
致谢
贡献者
Sylvain LE GAL (https://twitter.com/legalsylvain)
Sébastien BEAU (sebastien.beau@akretion.com)
Benoît GUILLOT (benoit.guillot@akretion.com)
Vicent Cubells (vicent.cubells@tecnativa.com)
Enrique Martín (enriquemartin@digital5.es)
维护者
本模块由OCA维护。
OCA,或Odoo社区协会,是一个非营利组织,其使命是支持Odoo功能的协作开发并推广其广泛使用。
要为此模块做出贡献,请访问https://odoo-community.org。
项目详情
哈希值 for odoo11_addon_github_connector-11.0.1.1.2-py2.py3-none-any.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 33a0d54e86b8673d3dddc979387763bd781556e7d302cdfaf67987a99c3bcb91 |
|
MD5 | 759c0c6ffe6da78041e2448c4cb0847e |
|
BLAKE2b-256 | e8bb14f0bb111daceb64d69b9e57817fd38054dd8f21c4514de5f5b3457f37fa |