mirror of https://github.com/ceph/ceph
89 lines
2.9 KiB
ReStructuredText
89 lines
2.9 KiB
ReStructuredText
Notes on Ceph repositories and test lab
|
|
=======================================
|
|
|
|
Special branches
|
|
----------------
|
|
|
|
* ``master``: current tip (integration branch)
|
|
* ``next``: pending release (feature frozen, bugfixes only)
|
|
* ``last``: last/previous release
|
|
* ``dumpling``, ``cuttlefish``, ``bobtail``, ``argonaut``, etc.: stable release branches
|
|
* ``dumpling-next``: backports for stable release, pending testing
|
|
|
|
Rules
|
|
-----
|
|
|
|
The source repos are all on github.
|
|
|
|
* Any branch pushed to ceph.git will kick off builds that will either
|
|
run unit tests or generate packages for gitbuilder.ceph.com. Try
|
|
not to generate unnecessary load. For private, unreviewed work,
|
|
only push to branches named ``wip-*``. This avoids colliding with
|
|
any special branches.
|
|
|
|
* Nothing should every reach a special branch unless it has been
|
|
reviewed.
|
|
|
|
* Preferred means of review is via github pull requests to capture any
|
|
review discussion.
|
|
|
|
* For multi-patch series, the pull request can be merged via github,
|
|
and a Reviewed-by: ... line added to the merge commit.
|
|
|
|
* For single- (or few-) patch merges, it is preferable to add the
|
|
Reviewed-by: directly to the commit so that it is also visible when
|
|
the patch is cherry-picked for backports.
|
|
|
|
* All backports should use ``git cherry-pick -x`` to capture which
|
|
commit they are cherry-picking from.
|
|
|
|
|
|
Teuthology lab hardware
|
|
-----------------------
|
|
|
|
* 96 plana: 8 core, 4 disk, 1gig and 10gig networks. Used for nightly runs.
|
|
|
|
* 64 burnupi: Dell R515s: 6 core, 8 disk, 1gig and 10gig networks, moderate CPU. crummy SAS expanders.
|
|
|
|
* 120 mira: 8 core, 8 disks, 1gig network. older hardware, flakier disks
|
|
|
|
* 8 vercoi: 24 core, RAID; VM hosts
|
|
|
|
* 4 senta: 25 core: VM hosts
|
|
|
|
* 36 saya: Calxeda ARM7 nodes (for testing)
|
|
|
|
* 24 tala: Calxeda ARM7 nodes (gitbuilder)
|
|
|
|
* ~200 vps: VMs running on mira hardware
|
|
|
|
Locking machines
|
|
----------------
|
|
|
|
* All tests pull their builds from gitbuilder.ceph.com.
|
|
|
|
* Anybody can lock machines with ``teuthology-lock --lock-many NUM
|
|
--machine-type TYPE``.
|
|
|
|
* Machines are locked as ``whoami''@``hostname -s``. --owner to
|
|
choose otherwise.
|
|
|
|
* Automated tests current run on the ``plana``; please avoid locking
|
|
these for personal use.
|
|
|
|
* To unlock, please use ``teuthology-nuke -t list.yaml -r -u``, which
|
|
will reboot and clean up any leftover test state before unlocking
|
|
(or fail to unlock). It looks for a ``targets::`` section in the
|
|
yaml, so the regular job yaml will work. You can get a list of all
|
|
locked machines with ``teuthology-lock --list-targets``.
|
|
|
|
* ``teuthology-lock -a --brief`` or ``teuthology-lock --summary`` to
|
|
see what is locked and by whom.
|
|
|
|
* Be conscientious about scheduling entire qa runs. Coordinate
|
|
utilization on IRC. Make sure you are running the latest version
|
|
ceph-qa-suite.git and teuthology.git.
|
|
|
|
* Results for scheduled runs appear in /a/$jobname on the teuthology
|
|
machine. ``ls -alt | head`` to find them.
|