[ceph.git] / ceph / doc / dev / testing.rst

Testing notes
=============


build-integration-branch
------------------------

Setup
^^^^^

#. Create a github token at `<https://github.com/settings/tokens>`_
   and put it in ``~/.github_token``.  Note that only the
   ``public_repo`` under the ``repo`` section needs to be checked.

#. Create a ceph repo label `wip-yourname-testing` if you don't
   already have one at `<https://github.com/ceph/ceph/labels>`_.

#. Create the ``ci`` remote::

     git remote add ci git@github.com:ceph/ceph-ci

Using
^^^^^

#. Tag some subset of `needs-qa` commits with your label (usually `wip-yourname-testing`).

#. Create the integration branch::

     git checkout master
     git pull
     ../src/script/build-integration-branch wip-yourname-testing

#. Smoke test::

     make && ctest -j12

#. Push to ceph-ci::

     git push ci $(git rev-parse --abbrev-ref HEAD)
Commit	Line	Data
28e407b8 AA	1	Testing notes
	2	=============
	3
	4
	5	build-integration-branch
	6	------------------------
	7
	8	Setup
	9	^^^^^
	10
	11	#. Create a github token at `<https://github.com/settings/tokens>`_
	12	and put it in ``~/.github_token``. Note that only the
	13	``public_repo`` under the ``repo`` section needs to be checked.
	14
	15	#. Create a ceph repo label `wip-yourname-testing` if you don't
	16	already have one at `<https://github.com/ceph/ceph/labels>`_.
	17
	18	#. Create the ``ci`` remote::
	19
	20	git remote add ci git@github.com:ceph/ceph-ci
	21
	22	Using
	23	^^^^^
	24
	25	#. Tag some subset of `needs-qa` commits with your label (usually `wip-yourname-testing`).
	26
	27	#. Create the integration branch::
	28
	29	git checkout master
	30	git pull
	31	../src/script/build-integration-branch wip-yourname-testing
	32
	33	#. Smoke test::
	34
	35	make && ctest -j12
	36
	37	#. Push to ceph-ci::
	38
	39	git push ci $(git rev-parse --abbrev-ref HEAD)
	40