[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 / 26
Fujitsu Vietnam Limited
PODC (Platform Offshore Development Center)
Cao Xuân Hoàng (hoangcx@vn.fujitsu.com)
Copyright 2015 Fujitsu Vietnam Limited

1 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
 launchpad.net
 Jenkins

devstack.org

rejoin-stack.sh

http://localhost/

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

 devstack.org
 launchpad.net
 Jenkins

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#acco
unt-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.

 devstack.org
 launchpad.net
 Jenkins

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

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
High
Mấ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

Đá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

 devstack.org
 launchpad.net
 Jenkins

review.openstack.org

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

Nhập mã ssh
https://review.openstack.org/#/settings/ssh-keys

Cấu hình git
 git config --global user.name "Firstname Lastname"
 git config --global user.email "your_email@youremail.com"

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

 devstack.org
 launchpad.net
 Jenkins

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

 devstack.org
 launchpad.net
 Jenkins

Đồ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

 devstack.org
 launchpad.net
 Jenkins

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 link
https://wiki.openstack.org/wiki/OpenStack_Upstream_Training/Info

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

Recomendados

Recomendados

Más contenido relacionado

Destacado

Destacado (20)

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

Similar a [OSS Upstream Training] 8 workflow of an open stack contribution and tools (20)

Más de Vietnam Open Infrastructure User Group

Más de Vietnam Open Infrastructure User Group (20)

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