Differential D273

Update docs with instruction for building rpms on el7
ClosedPublic
Actions

Authored by mkrizek on Jan 19 2015, 3:44 PM.

Details

Reviewers
tflink
Commits
rBLKR678ac203739f: Update docs with instruction for building rpms on el7
Summary

Also fixes typos in Makefile

Test Plan

make docs

Diff Detail

Repository
rBLKR blockerbugs
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.
mkrizek retitled this revision from to Update docs with instruction for building rpms on el7.Jan 19 2015, 3:44 PM
mkrizek updated this object.
mkrizek edited the test plan for this revision. (Show Details)
mkrizek added a reviewer: tflink.
tflink requested changes to this revision.Jan 19 2015, 3:48 PM

overall, looks pretty good to me. just the one makefile change

Makefile
73–74

The noarch rpm is centos.noarch.rpm

This revision now requires changes to proceed.Jan 19 2015, 3:48 PM
mkrizek updated this revision to Diff 754.Jan 19 2015, 4:11 PM
  • Fix rpm noarch file name
tflink accepted this revision.Jan 20 2015, 3:56 PM
This revision is now accepted and ready to land.Jan 20 2015, 3:56 PM
Closed by commit rBLKR678ac203739f: Update docs with instruction for building rpms on el7 (authored by mkrizek). · Explain WhyJan 20 2015, 5:20 PM
This revision was automatically updated to reflect the committed changes.

Revision Contents

PathPackages
MMakefile (6 lines)
Mdocs/source/development_tasks.rst (29 lines)

Diff 756

View Options

Makefile

Show First 20 Lines • Show All 64 Lines • ▼ Show 20 Line(s)
65$(SRC)-$(VERSION).tar.gz: 65​$(SRC)-$(VERSION).tar.gz:
66 git archive $(GITBRANCH) --prefix=$(SRC)-$(VERSION)/ | gzip -c9 > $@ 66​ git archive $(GITBRANCH) --prefix=$(SRC)-$(VERSION)/ | gzip -c9 > $@
67 67​
68mocksrpm: archive 68​mocksrpm: archive
69 mock -r epel-7-x86_64 --buildsrpm --spec $(SPECFILE) --sources . 69​ mock -r epel-7-x86_64 --buildsrpm --spec $(SPECFILE) --sources .
70 cp /var/lib/mock/epel-7-x86_64/result/$(NVR).$(TARGETDIST).centos.src.rpm . 70​ cp /var/lib/mock/epel-7-x86_64/result/$(NVR).$(TARGETDIST).centos.src.rpm .
71 71​
72mockbuild: mocksrpm 72​mockbuild: mocksrpm
73 mock -r epel-6-x86_64 --no-clean --rebuild $(NVR).$(TARGETDIST).centos.src.rpm 73​ mock -r epel-7-x86_64 --no-clean --rebuild $(NVR).$(TARGETDIST).centos.src.rpm
74 cp /var/lib/mock/epel-7-x86_64/result/$(NVR).$(TARGETDIST).noarch.rpm . 74​ cp /var/lib/mock/epel-7-x86_64/result/$(NVR).$(TARGETDIST).centos.noarch.rpm .
tflinkUnsubmitted
Not Done

The noarch rpm is centos.noarch.rpm

75 75​
76kojibuild: mocksrpm 76​kojibuild: mocksrpm
77 koji build --scratch epel7-testing-candidate $(NVR).$(TARGETDIST).src.rpm 77​ koji build --scratch epel7-candidate $(NVR).$(TARGETDIST).centos.src.rpm
78 78​
79nvr: 79​nvr:
80 @echo $(NVR) 80​ @echo $(NVR)
81 81​
82cleanvenv: 82​cleanvenv:
83 rm -rf $(VENV) 83​ rm -rf $(VENV)
84 84​
85virtualenv: $(VENV) 85​virtualenv: $(VENV)
86 86​
87$(VENV): 87​$(VENV):
88 virtualenv --distribute $(VENV) 88​ virtualenv --distribute $(VENV)
89 sh -c ". $(VENV)/bin/activate; pip install kitchen paver Babel; deactivate" 89​ sh -c ". $(VENV)/bin/activate; pip install kitchen paver Babel; deactivate"
90 sh -c ". $(VENV)/bin/activate; pip install python-fedora; deactivate" 90​ sh -c ". $(VENV)/bin/activate; pip install python-fedora; deactivate"
91 sh -c ". $(VENV)/bin/activate; pip install -r requirements.txt; deactivate" 91​ sh -c ". $(VENV)/bin/activate; pip install -r requirements.txt; deactivate"
92 92​
View Options

docs/source/development_tasks.rst

Show First 20 Lines • Show All 80 Lines • ▼ Show 20 Line(s)80 * Request that the new build be pulled into infra's repository and deploy on
81 staging 81​ staging
82 82​
83 * After a reasonable amount of testing, deploy to production 83​ * After a reasonable amount of testing, deploy to production
84 84​
85 85​
86Building a Blockerbugs RPM 86​Building a Blockerbugs RPM
87========================== 87​==========================
88 88​
89Step-by-step process for building an rpm (el6, probably) for devel, stg, production 89​Step-by-step process for building an rpm (el7, probably) for devel, staging and production.
90 90​
91These instructions are deliberately abstracted for version and branch so that 91​These instructions are deliberately abstracted for version and branch so that
92they can be used for other things than just releases. The relevant variables are: 92​they can be used for other things than just releases. The relevant variables are:
93 93​
94 * ``$VERSION`` - the version as set in both ``__init__.py`` and ``blockerbugs.spec`` 94​ * ``$VERSION`` - the version as set in both ``__init__.py`` and ``blockerbugs.spec``
95 95​
96 * ``$RELEASE`` - the release as set in ``blockerbugs.spec`` 96​ * ``$RELEASE`` - the release as set in ``blockerbugs.spec``
97 97​
98 * ``$BRANCH`` - the git branch you're working with (master, develop, feature/t123-foobar etc.) 98​ * ``$BRANCH`` - the git branch you're working with (master, develop, feature/t123-foobar etc.)
99 99​
100 * ``$BASEDIR`` - the base directory for your git checkout 100​ * ``$BASEDIR`` - the base directory for your git checkout
101 101​
102Make sure that all the files you're working on are committed in your git repo and 102​Make sure that all the files you're working on are committed in your git repo and
103create a tarball by running this command in ``$BASEDIR``:: 103​create a tarball by running this command in ``$BASEDIR``::
104 104​
105​ python run_cli.py minify
105 git archive --format=tar --prefix=blockerbugs-$VERSION/ $BRANCH | gzip -c > blockerbugs-$VERSION.tar.gz 106​ git archive --format=tar --prefix=blockerbugs-$VERSION/ $BRANCH | gzip -c > blockerbugs-$VERSION.tar.gz
106 107​
108​or::
109​
110​ make archive
111​
107Create an srpm using mock and copy the result into ``$BASEDIR``:: 112​Create an srpm using mock and copy the result into ``$BASEDIR``::
108 113​
109 mock -r epel-6-x86_64 --buildsrpm --spec blockerbugs.spec --sources $BASEDIR 114​ mock -r epel-7-x86_64 --buildsrpm --spec blockerbugs.spec --sources $BASEDIR
110 cp /var/lib/mock/epel-6-x86_64/result/blockerbugs*.src.rpm $BASEDIR/. 115​ cp /var/lib/mock/epel-7-x86_64/result/blockerbugs*.src.rpm $BASEDIR/.
116​
117​or::
118​
119​ make mocksrpm
111 120​
112From here, you can either build the rpm locally using mock or using a koji scratch 121​From here, you can either build the rpm locally using mock or using a koji scratch
113build. 122​build.
114 123​
115Building Locally with Mock 124​Building Locally with Mock
116-------------------------- 125​--------------------------
117 126​
118Run this command to build an rpm locally with mock (using ``--no-clean`` will prevent 127​Run this command to build an rpm locally with mock (using ``--no-clean`` will prevent
119mock from rebuilding the environment):: 128​mock from rebuilding the environment)::
120 129​
121 mock -r epel-6-x86_64 --rebuild $BASEDIR/blockerbugs-$VERSION-$RELEASE.el6.src.rpm 130​ mock -r epel-7-x86_64 --rebuild $BASEDIR/blockerbugs-$VERSION-$RELEASE.el7.centos.src.rpm
122 cp /var/lib/mock/epel-6-x86_64/result/blockerbugs*.noarch.rpm $BASEDIR/. 131​ cp /var/lib/mock/epel-7-x86_64/result/blockerbugs*.noarch.rpm $BASEDIR/.
132​
133​or::
134​
135​ make mockbuild
123 136​
124Building a Koji Scratch Build 137​Building a Koji Scratch Build
125----------------------------- 138​-----------------------------
126 139​
127The blocker tracking app isn't in the main Fedora repos, so we can't do official 140​The blocker tracking app isn't in the main Fedora repos, so we can't do official
128builds but we can do scratch builds with this command:: 141​builds but we can do scratch builds with this command::
129 142​
130 koji build --scratch dist-6E-epel-testing-candidate $BASEDIR/blockerbugs-$VERSION-$RELEASE.el6.src.rpm 143​ koji build --scratch epel7-candidate $BASEDIR/blockerbugs-$VERSION-$RELEASE.el7.centos.src.rpm
144​
145​or::
146​
147​ make kojibuild
131 148​
132Using Alembic 149​Using Alembic
133============= 150​=============
134 151​
135`Alembic <https://alembic.readthedocs.org/en/latest/index.html>`_ is 'a lightweight 152​`Alembic <https://alembic.readthedocs.org/en/latest/index.html>`_ is 'a lightweight
136lightweight database migration tool for usage with the SQLAlchemy Database 153​lightweight database migration tool for usage with the SQLAlchemy Database
137Toolkit for Python.' and used to manage the database schema used with the application. 154​Toolkit for Python.' and used to manage the database schema used with the application.
138 155​
▲ Show 20 Lines • Show All 66 Lines • Show Last 20 Lines