[OSS Upstream Training] 8 workflow of an open stack contribution and tools

Công cụ và qui trình đóng góp vào OpenStack

2015 / 12 / 26Fujitsu Vietnam LimitedPODC (Platform Offshore Development Center)Cao Xuân Hoàng ([email protected])

Copyright 2015 Fujitsu Vietnam Limited

2 Copyright 2015 Fujitsu Vietnam Limited

devstack.org Làm thế nào để đóng góp vào OpenStack launchpad.net review.openstack.org Mô hình rẽ nhánh (Branching model) Qui trinh kiểm tra Jenkins



devstack.org


rejoin-stack.sh


http://localhost/


Thực hành


Tải devstack source code và thực hành



http://launchpad.net/


https://www.openstack.org/join/


Sign In


No agreement


New agreement


Sign the Individual agreement


Bạn có làm cho công ty nào không?


Nếu những đóng góp của bạn đại diện cho một công ty, hãy báo người quản lý nhập thông tin của bạn vào CCLA “Corporate Contributor License Agreement”

http://docs.openstack.org/infra/manual/developers.html#account-setup




Signed agreement


Thực hành


Hãy đăng ký trở thành thành viên và ký vào cam kết đóng góp.



http://launchpad.net/


Blueprint


Là diễn đàn dùng để liệt kê và lên kế hoạch cho công việc muốn hướng đến.

Blueprint dùng để mô tả/giải thích cho giải pháp nhằm đạt được kết quả

Hiện nay hầu hết các dự án quản lý blueprints trên git repo được gọi là “specs”

https://wiki.openstack.org/wiki/Blueprints#Nova https://wiki.openstack.org/wiki/Blueprints#Neutron

https://wiki.openstack.org/wiki/Blueprints#Nova

https://wiki.openstack.org/wiki/Blueprints#Nova

https://wiki.openstack.org/wiki/Blueprints#Neutron

Trạng thái lỗi


New Lỗi mới được tạo

Incomplete Lỗi cần thêm thông tin từ người tạo ra nó

Confirmed Lỗi được xác thực

Triaged Lỗi đang được trao đổi, phân tích làm thế nào khác phục

In Progress Lỗi đã có người nhận khắc phục và đang trong quá trình sửa chữa

Fix Committed Nhánh chứa lỗi đã được hòa vào nhánh chính

Fix Released Kết quả sửa lỗi được đưa vào lần phát hành gần nhất

Trạng thái lỗi


Invalid Đây không phải là lỗi

Opinion Đây là vấn đề đúng theo cách của nó

Won't Fix Đây là vấn đề đúng nhưng chúng tôi không mong đợi sẽ sửa nó

Trạng thái lỗi


New Incomplete Confirmed Triaged In Progress Fix Committed Fix Released Invalid Opinion Won't Fix

Mức độ quan trọng của lỗi


Critical Mất dữ liệu / ảnh hưởng đến hầu hết người dùng và không khắc phục được

HighMất dữ liệu / ảnh hưởng hầu hết ngườ dùng nhưng có thể khắc phuc được.Lỗi ở các tính năng quan trọng và không khặc phục được.

Medium Lỗi ở các tính năng quan trọng nhưng có thể khắc phục.Lỗi ở các tính năng phụ và không khắc phục được.

Low Vấn đề nhỏ và dễ dàng khắc phục được.

Wishlist Không hẳn là lỗi nhưng được đề nghị để cải thiện tính năng cho dự án

Undefined Chưa đánh giá mức độ ảnh hưởng ở thời điểm thiết lập

Mức độ quan trọng của lỗi


Critical High Medium Low Wishlist Undefined

Đánh dấu lỗi


low-hanging-fruit Các lỗi dễ dàng sửa chữa, phù hợp cho những người mới bắt đầu làm quen với việc đóng góp vào OpenStack.

documentation Lỗi liên quan hoặc ảnh hưởng đến tài liệu.

i18n Các vấn đề liên quan đến i18n.

security Sửa lỗi có khả năng nảy sinh vấn đề liên quan bảo mật

ops Sửa lỗi có ảnh hưởng quan trong đến hoạt động của OpenStack

SERIES-rc-potential Đánh dấu lỗi cần được giải phóng cho lần kế tiếp

SERIES-backport-potential Đánh dấu lỗi có thể đưa vào các bản đã giải phóng trước đó.

Per project tags https://wiki.openstack.org/wiki/BugTags

https://wiki.openstack.org/wiki/BugTags

Đánh dấu lỗi


Assigned To Người hiện tại đang chịu trách nhiệm sửa chửa. Phải được thiết lập khi lỗi ở trạng thái “In progress”

Milestone Cột mốc ta cần sửa cho lỗi hoặc mốc/phiên bản mà nó đã sửa.

Thông báo lỗi


Thiết lập đúng theo từng dự án của OpenStack Kiểm tra trùng lặp Trạng thái sẽ là “New”

Xác thực và đặt mức ưu tiên


Thiếu thông tin => Trạng thái: “Incomplete” Thiết lập lại và đúng vấn đề => Trạng thái: “Confirmed” Người phát triển chính hoặc người giám sát lỗi của dự án =>

Mực độ quan trọng: <mức ảnh hưởng lỗi>

Debugging


Xác định làm thế nào để sửa lỗi Hỏi người phát triển chính hoặc quản lý lỗi => Trạng thái:

“Triaged”

Sửa lỗi


Người phát triển sẽ làm việc với lỗi được chỉ định Trạng thái: “In progress” Gerrit sẽ tự động thiết lập trạng thái của lỗi

Sau khi lỗi đã sửa được chấp nhận


Kiểm tra, chấp nhận và được hòa vào nhánh chính Trạng thái: “Fix Committed” Thiết lập mốc hoặc nhánh được phát hành Trạng thái: “Fix Released”

Thực hành


Kiểm tra những lỗi trên launchpad và nâng cao khả năng sửa lỗi của bạn



review.openstack.org


Qui trình xử lý trên gerrit


Nhập mã ssh


https://review.openstack.org/#/settings/ssh-keys

https://review.openstack.org/#/settings/ssh-keys

Cấu hình git


git config --global user.name "Firstname Lastname" git config --global user.email "[email protected]"

mailto:[email protected]

Cài đặt git review


apt-get / yum / pip install … git review

git clone


git review -s


git checkout -b TOPIC-BRANCH


Chạy unit tests


Mời người kiểm tra


git commit --amend


Lịch sử các bản ghép trên gerrit


patchset diffs


Thực hành


Tải bản ghép lên gerrit và mời người kiểm tra



nvie inspired


Các nhánh ổn định


2013.2 branch and tags


2013.2.4 preparation


Kiểm tra


Thực hành


Chuyển đến nhánh ổn định gần đây nhất



Đồng nhất qui trình kiểm tra


Đồng nhất qui trình kiểm tra


Góp ý trên từng dòng


Bản nháp góp ý trên từng dòng


Người kiểm tra thông thường


Người kiểm tra chính


Thực hành


Đẩy bản đang sửa chữa hoặc bản nháp lên gerrit và mời người kiểm tra



Xử lý tất cả các bản đóng góp


Kiểm tra trên gerrit


Thông báo lỗi


Không phải là lỗi


Kiểm tra lại lỗi (recheck)


Thực hành


Thêm lỗi và kiểm tra các thông báo từ jenkins

THANK YOU!


Reference linkhttps://wiki.openstack.org/wiki/OpenStack_Upstream_Training/Info

https://wiki.openstack.org/wiki/OpenStack_Upstream_Training/Info

https://wiki.openstack.org/wiki/OpenStack_Upstream_Training/Info

Copyright 2014 Fujitsu Vietnam Limited

Presentations & Public Speaking

[OSS Upstream Training] 8 workflow of an open stack contribution and tools