| tflink | |
| jskladan |
| libtaskotron |
Build an rpm with doit chainbuild, then install, check permissions and try to run a task. Worked for me.
| Automatic diff as part of commit; lint not applicable. |
| Automatic diff as part of commit; unit tests not applicable. |
| Path | Packages | |||
|---|---|---|---|---|
| M | docs/source/devguide.rst (6 lines) | |||
| M | docs/source/index.rst (10 lines) | |||
| M | docs/source/quickstart.rst (9 lines) | |||
| M | libtaskotron.spec (32 lines) | |||
| M | libtaskotron/directives/bash_directive.py (2 lines) |
| Commit | Tree | Parents | Author | Summary | Date |
|---|---|---|---|---|---|
| c1e23dbc29de | 1fcc489c13d9 | ccd76e1948c4 | Martin Krizek | Use dedicated group for dirs libtaskotron writes into (Show More…) | May 10 2016, 10:26 AM |
| Show First 20 Lines • Show All 97 Lines • ▼ Show 20 Line(s) | |||||
| 98 | is a command line interface to Phabricator which can be used to submit code | 98 | is a command line interface to Phabricator which can be used to submit code | ||
| 99 | reviews, download/apply code under review among other useful functions. | 99 | reviews, download/apply code under review among other useful functions. | ||
| 100 | 100 | | |||
| 101 | As Arcanist is an interface to Phabricator, we **strongly recommend** that you | 101 | As Arcanist is an interface to Phabricator, we **strongly recommend** that you | ||
| 102 | install it using our packages instead of from the upstream git repos (as | 102 | install it using our packages instead of from the upstream git repos (as | ||
| 103 | described in upstream documentation). That way, there is no question that the | 103 | described in upstream documentation). That way, there is no question that the | ||
| 104 | Arcanist version used locally is compatible with our Phabricator instance. | 104 | Arcanist version used locally is compatible with our Phabricator instance. | ||
| 105 | 105 | | |||
| 106 | To add our yum repository containing Phabricator related packages, run:: | 106 | To add our dnf repository containing Phabricator related packages, run:: | ||
| 107 | 107 | | |||
| 108 | sudo curl https://repos.fedorapeople.org/repos/tflink/phabricator/fedora-phabricator.repo \ | 108 | sudo curl https://repos.fedorapeople.org/repos/tflink/phabricator/fedora-phabricator.repo \ | ||
| 109 | -o /etc/yum.repos.d/fedora-phabricator.repo | 109 | -o /etc/yum.repos.d/fedora-phabricator.repo | ||
| 110 | 110 | | |||
| 111 | Once the repository has been configured, install Arcanist using:: | 111 | Once the repository has been configured, install Arcanist using:: | ||
| 112 | 112 | | |||
| 113 | sudo yum install arcanist | 113 | sudo dnf -y install arcanist | ||
| 114 | 114 | | |||
| 115 | Arcanist is written in PHP and installing it will pull in several PHP packages | 115 | Arcanist is written in PHP and installing it will pull in several PHP packages | ||
| 116 | as dependencies. | 116 | as dependencies. | ||
| 117 | 117 | | |||
| 118 | 118 | | |||
| 119 | .. _installing-gitflow: | 119 | .. _installing-gitflow: | ||
| 120 | 120 | | |||
| 121 | gitflow | 121 | gitflow | ||
| 122 | ^^^^^^^ | 122 | ^^^^^^^ | ||
| 123 | 123 | | |||
| 124 | The `gitflow plugin for git <https://github.com/nvie/gitflow>`_ is another | 124 | The `gitflow plugin for git <https://github.com/nvie/gitflow>`_ is another | ||
| 125 | useful, but not required tool that is available in the Fedora repositories. | 125 | useful, but not required tool that is available in the Fedora repositories. | ||
| 126 | 126 | | |||
| 127 | To install the gitflow plugin, run:: | 127 | To install the gitflow plugin, run:: | ||
| 128 | 128 | | |||
| 129 | sudo yum install gitflow | 129 | sudo dnf -y install gitflow | ||
| 130 | 130 | | |||
| 131 | 131 | | |||
| 132 | .. _submitting-code: | 132 | .. _submitting-code: | ||
| 133 | 133 | | |||
| 134 | Submitting code | 134 | Submitting code | ||
| 135 | --------------- | 135 | --------------- | ||
| 136 | 136 | | |||
| 137 | Libtaskotron follows the `gitflow <http://nvie.com/posts/a-successful-git-branching-model/>`_ | 137 | Libtaskotron follows the `gitflow <http://nvie.com/posts/a-successful-git-branching-model/>`_ | ||
| ▲ Show 20 Lines • Show All 275 Lines • Show Last 20 Lines | |||||
| Show First 20 Lines • Show All 72 Lines • ▼ Show 20 Line(s) | 71 | which is updated as new versions are released. To enable this repo:: | |||
|---|---|---|---|---|---|
| 73 | sudo curl https://copr.fedorainfracloud.org/coprs/tflink/taskotron/repo/fedora-23/tflink-taskotron-fedora-23.repo \ | 73 | sudo curl https://copr.fedorainfracloud.org/coprs/tflink/taskotron/repo/fedora-23/tflink-taskotron-fedora-23.repo \ | ||
| 74 | -o /etc/yum.repos.d/tflink-taskotron-fedora-23.repo | 74 | -o /etc/yum.repos.d/tflink-taskotron-fedora-23.repo | ||
| 75 | 75 | | |||
| 76 | .. TODO - replace this link with a non-copr repo that's more stable over time | 76 | .. TODO - replace this link with a non-copr repo that's more stable over time | ||
| 77 | 77 | | |||
| 78 | The easiest way to get started is to install ``libtaskotron-core`` and all of the | 78 | The easiest way to get started is to install ``libtaskotron-core`` and all of the | ||
| 79 | other modules with:: | 79 | other modules with:: | ||
| 80 | 80 | | |||
| 81 | sudo yum install libtaskotron | 81 | sudo dnf -y install libtaskotron | ||
| 82 | 82 | | |||
| 83 | Note: The permissions on several notable directories (e.g. ``/var/log/taskotron``, | 83 | Since the ``runtask`` command writes into system-wide locations on the filesystem, | ||
| 84 | ``/var/lib/taskotron/``, ``/var/cache/taskotron``) are set to ``777``. If | 84 | any user who runs it will need to be added to the ``taskotron`` group with the command:: | ||
| 85 | desired, edit ``/etc/taskotron/taskotron.yaml`` and set these paths to | 85 | | ||
| 86 | directories with more appropriate permissions. | 86 | sudo usermod -G taskotron <user> | ||
| 87 | 87 | | |||
| 88 | 88 | | |||
| 89 | libtaskotron modules | 89 | libtaskotron modules | ||
| 90 | -------------------- | 90 | -------------------- | ||
| 91 | 91 | | |||
| 92 | As functionality has been added to libtaskotron, we've started breaking up that | 92 | As functionality has been added to libtaskotron, we've started breaking up that | ||
| 93 | functionality into modules to increase flexibility and shrink the minimal | 93 | functionality into modules to increase flexibility and shrink the minimal | ||
| 94 | install profile. Each module is packaged separately for easy installation. | 94 | install profile. Each module is packaged separately for easy installation. | ||
| ▲ Show 20 Lines • Show All 79 Lines • Show Last 20 Lines | |||||
| Show All 11 Lines | 9 | :: | |||
|---|---|---|---|---|---|
| 12 | -o /etc/yum.repos.d/tflink-taskotron-fedora-23.repo | 12 | -o /etc/yum.repos.d/tflink-taskotron-fedora-23.repo | ||
| 13 | 13 | | |||
| 14 | 14 | | |||
| 15 | Install | 15 | Install | ||
| 16 | ======= | 16 | ======= | ||
| 17 | 17 | | |||
| 18 | :: | 18 | :: | ||
| 19 | 19 | | |||
| 20 | sudo yum install libtaskotron | 20 | sudo dnf -y install libtaskotron | ||
| 21 | 21 | | |||
| 22 | This will install libtaskotron-core and all of its modules, see `detailed | 22 | This will install libtaskotron-core and all of its modules, see `detailed | ||
| 23 | install instructions <index.html#install-libtaskotron>`_ for more information | 23 | install instructions <index.html#install-libtaskotron>`_ for more information | ||
| 24 | on installing individual modules. | 24 | on installing individual modules. | ||
| 25 | 25 | | |||
| 26 | Since the ``runtask`` command writes into system-wide locations on the filesystem, | ||||
| 27 | any user who runs it will need to be added to the ``taskotron`` group with the command:: | ||||
| 28 | | ||||
| 29 | sudo usermod -G taskotron <user> | ||||
| 30 | | ||||
| 26 | 31 | | |||
| 27 | Run | 32 | Run | ||
| 28 | === | 33 | === | ||
| 29 | 34 | | |||
| 30 | :: | 35 | :: | ||
| 31 | 36 | | |||
| 32 | runtask -i <item> -t <type> -a <arch> <yaml formula> | 37 | runtask -i <item> -t <type> -a <arch> <yaml formula> | ||
| 33 | 38 | | |||
| 34 | .. note:: | 39 | .. note:: | ||
| 35 | By default, runtask will attempt to execute tasks locally. More command line | 40 | By default, runtask will attempt to execute tasks locally. More command line | ||
| 36 | flags are needed in order to enable disposable clients. `More details on | 41 | flags are needed in order to enable disposable clients. `More details on | ||
| 37 | running tasks can be found here <index.html#running-tasks>`_ | 42 | running tasks can be found here <index.html#running-tasks>`_ | ||
| 38 | 43 | | |||
| 39 | 44 | | |||
| 40 | | ||||
| 41 | | ||||
| 42 | Formulae: General Syntax | 45 | Formulae: General Syntax | ||
| 43 | ======================== | 46 | ======================== | ||
| 44 | 47 | | |||
| 45 | .. code-block:: yaml | 48 | .. code-block:: yaml | ||
| 46 | 49 | | |||
| 47 | name: polyjuice potion | 50 | name: polyjuice potion | ||
| 48 | desc: potion that allows to take the form of someone else | 51 | desc: potion that allows to take the form of someone else | ||
| 49 | maintainer: hermione | 52 | maintainer: hermione | ||
| ▲ Show 20 Lines • Show All 53 Lines • Show Last 20 Lines | |||||
| 1 | # sitelib for noarch packages, sitearch for others (remove the unneeded one) | 1 | # sitelib for noarch packages, sitearch for others (remove the unneeded one) | ||
|---|---|---|---|---|---|
| 2 | %{!?python_sitelib: %global python_sitelib %(%{__python} -c "from distutils.sysconfig import get_python_lib; print(get_python_lib())")} | 2 | %{!?python_sitelib: %global python_sitelib %(%{__python} -c "from distutils.sysconfig import get_python_lib; print(get_python_lib())")} | ||
| 3 | %{!?python_sitearch: %global python_sitearch %(%{__python} -c "from distutils.sysconfig import get_python_lib; print(get_python_lib(1))")} | 3 | %{!?python_sitearch: %global python_sitearch %(%{__python} -c "from distutils.sysconfig import get_python_lib; print(get_python_lib(1))")} | ||
| 4 | 4 | | |||
| 5 | Name: libtaskotron | 5 | Name: libtaskotron | ||
| 6 | Version: 0.4.12 | 6 | Version: 0.4.12 | ||
| 7 | Release: 1%{?dist} | 7 | Release: 2%{?dist} | ||
| 8 | Summary: Taskotron Support Library | 8 | Summary: Taskotron Support Library | ||
| 9 | 9 | | |||
| 10 | License: GPLv3 | 10 | License: GPLv3 | ||
| 11 | URL: https://bitbucket.org/fedoraqa/libtaskotron | 11 | URL: https://bitbucket.org/fedoraqa/libtaskotron | ||
| 12 | Source0: http://qadevel.fedoraproject.org/releases/%{name}/%{name}-%{version}.tar.gz | 12 | Source0: http://qadevel.fedoraproject.org/releases/%{name}/%{name}-%{version}.tar.gz | ||
| 13 | 13 | | |||
| 14 | BuildArch: noarch | 14 | BuildArch: noarch | ||
| 15 | 15 | | |||
| ▲ Show 20 Lines • Show All 67 Lines • ▼ Show 20 Line(s) | |||||
| 83 | Requires: testcloud >= 0.1.2 | 83 | Requires: testcloud >= 0.1.2 | ||
| 84 | BuildRequires: python-paramiko >= 1.15.1 | 84 | BuildRequires: python-paramiko >= 1.15.1 | ||
| 85 | BuildRequires: testcloud >= 0.1.2 | 85 | BuildRequires: testcloud >= 0.1.2 | ||
| 86 | 86 | | |||
| 87 | %description -n libtaskotron-disposable | 87 | %description -n libtaskotron-disposable | ||
| 88 | Module for libtaskotron which enables the use of disposable clients | 88 | Module for libtaskotron which enables the use of disposable clients | ||
| 89 | 89 | | |||
| 90 | 90 | | |||
| 91 | %pre | ||||
| 92 | getent group taskotron >/dev/null || groupadd taskotron | ||||
| 93 | | ||||
| 91 | %prep | 94 | %prep | ||
| 92 | %setup -q | 95 | %setup -q | ||
| 93 | 96 | | |||
| 94 | %check | 97 | %check | ||
| 95 | %{__python} setup.py test | 98 | %{__python} setup.py test | ||
| 96 | 99 | | |||
| 97 | %build | 100 | %build | ||
| 98 | %{__python} setup.py build | 101 | %{__python} setup.py build | ||
| 99 | 102 | | |||
| 100 | %install | 103 | %install | ||
| 101 | rm -rf $RPM_BUILD_ROOT | 104 | rm -rf $RPM_BUILD_ROOT | ||
| 102 | %{__python} setup.py install -O1 --skip-build --root %{buildroot} | 105 | %{__python} setup.py install -O1 --skip-build --root %{buildroot} | ||
| 103 | 106 | | |||
| 104 | # configuration files | 107 | # configuration files | ||
| 105 | mkdir -p %{buildroot}%{_sysconfdir}/taskotron/ | 108 | mkdir -p %{buildroot}%{_sysconfdir}/taskotron/ | ||
| 106 | install conf/taskotron.yaml.example %{buildroot}%{_sysconfdir}/taskotron/taskotron.yaml | 109 | install conf/taskotron.yaml.example %{buildroot}%{_sysconfdir}/taskotron/taskotron.yaml | ||
| 107 | install conf/namespaces.yaml.example %{buildroot}%{_sysconfdir}/taskotron/namespaces.yaml | 110 | install conf/namespaces.yaml.example %{buildroot}%{_sysconfdir}/taskotron/namespaces.yaml | ||
| 108 | install conf/yumrepoinfo.conf.example %{buildroot}%{_sysconfdir}/taskotron/yumrepoinfo.conf | 111 | install conf/yumrepoinfo.conf.example %{buildroot}%{_sysconfdir}/taskotron/yumrepoinfo.conf | ||
| 109 | 112 | | |||
| 110 | # log dir | 113 | # log dir | ||
| 111 | install -m 777 -d %{buildroot}/%{_localstatedir}/log/taskotron | 114 | install -d %{buildroot}/%{_localstatedir}/log/taskotron | ||
| 112 | 115 | | |||
| 113 | # tmp dir | 116 | # tmp dir | ||
| 114 | install -m 777 -d %{buildroot}/%{_tmppath}/taskotron | 117 | install -d %{buildroot}/%{_tmppath}/taskotron | ||
| 115 | 118 | | |||
| 116 | # artifacts dir | 119 | # artifacts dir | ||
| 117 | install -m 777 -d %{buildroot}/%{_sharedstatedir}/taskotron/artifacts | 120 | install -d %{buildroot}/%{_sharedstatedir}/taskotron/artifacts | ||
| 118 | 121 | | |||
| 119 | # cache dir | 122 | # cache dir | ||
| 120 | install -m 777 -d %{buildroot}/%{_localstatedir}/cache/taskotron | 123 | install -d %{buildroot}/%{_localstatedir}/cache/taskotron | ||
| 121 | 124 | | |||
| 122 | # images dir | 125 | # images dir | ||
| 123 | install -m 777 -d %{buildroot}/%{_sharedstatedir}/taskotron/images | 126 | install -d %{buildroot}/%{_sharedstatedir}/taskotron/images | ||
| 124 | 127 | | |||
| 125 | %files | 128 | %files | ||
| 126 | 129 | | |||
| 127 | %files -n libtaskotron-core | 130 | %files -n libtaskotron-core | ||
| 128 | %doc readme.rst LICENSE | 131 | %doc readme.rst LICENSE | ||
| 129 | %{python_sitelib}/libtaskotron/*.py* | 132 | %{python_sitelib}/libtaskotron/*.py* | ||
| 130 | %{python_sitelib}/libtaskotron/directives/*.py* | 133 | %{python_sitelib}/libtaskotron/directives/*.py* | ||
| 131 | %{python_sitelib}/libtaskotron/ext/*.py* | 134 | %{python_sitelib}/libtaskotron/ext/*.py* | ||
| 132 | %{python_sitelib}/libtaskotron/report_templates/*.j2 | 135 | %{python_sitelib}/libtaskotron/report_templates/*.j2 | ||
| 133 | %{python_sitelib}/*.egg-info | 136 | %{python_sitelib}/*.egg-info | ||
| 134 | 137 | | |||
| 135 | %dir %{python_sitelib}/libtaskotron/ext/fedora | 138 | %dir %{python_sitelib}/libtaskotron/ext/fedora | ||
| 136 | %dir %{python_sitelib}/libtaskotron/ext | 139 | %dir %{python_sitelib}/libtaskotron/ext | ||
| 137 | %dir %{python_sitelib}/libtaskotron/directives | 140 | %dir %{python_sitelib}/libtaskotron/directives | ||
| 138 | %dir %{python_sitelib}/libtaskotron/report_templates | 141 | %dir %{python_sitelib}/libtaskotron/report_templates | ||
| 139 | 142 | | |||
| 140 | %attr(755,root,root) %{_bindir}/runtask | 143 | %attr(755, root, root) %{_bindir}/runtask | ||
| 141 | 144 | | |||
| 142 | %dir %attr(777, root, root) %{_localstatedir}/log/taskotron | 145 | %dir %attr(2775, root, taskotron) %{_tmppath}/taskotron | ||
| 143 | %dir %attr(777, root, root) %{_tmppath}/taskotron | 146 | %dir %attr(2775, root, taskotron) %{_localstatedir}/log/taskotron | ||
| 144 | %dir %attr(777, root, root) %{_sharedstatedir}/taskotron/artifacts | 147 | %dir %attr(2775, root, taskotron) %{_localstatedir}/cache/taskotron | ||
| 145 | %dir %attr(777, root, root) %{_localstatedir}/cache/taskotron | 148 | %dir %attr(2775, root, taskotron) %{_sharedstatedir}/taskotron | ||
| 146 | %dir %attr(777, root, root) %{_sharedstatedir}/taskotron/images | 149 | %dir %attr(2775, root, taskotron) %{_sharedstatedir}/taskotron/artifacts | ||
| 150 | %dir %attr(2775, root, taskotron) %{_sharedstatedir}/taskotron/images | ||||
| 147 | 151 | | |||
| 148 | %files -n libtaskotron-config | 152 | %files -n libtaskotron-config | ||
| 149 | %dir %{_sysconfdir}/taskotron | 153 | %dir %{_sysconfdir}/taskotron | ||
| 150 | %config(noreplace) %{_sysconfdir}/taskotron/taskotron.yaml | 154 | %config(noreplace) %{_sysconfdir}/taskotron/taskotron.yaml | ||
| 151 | %config %{_sysconfdir}/taskotron/namespaces.yaml | 155 | %config %{_sysconfdir}/taskotron/namespaces.yaml | ||
| 152 | %config %{_sysconfdir}/taskotron/yumrepoinfo.conf | 156 | %config %{_sysconfdir}/taskotron/yumrepoinfo.conf | ||
| 153 | 157 | | |||
| 154 | %files -n libtaskotron-fedora | 158 | %files -n libtaskotron-fedora | ||
| 155 | %dir %{python_sitelib}/libtaskotron/ext/fedora | 159 | %dir %{python_sitelib}/libtaskotron/ext/fedora | ||
| 156 | %{python_sitelib}/libtaskotron/ext/fedora/* | 160 | %{python_sitelib}/libtaskotron/ext/fedora/* | ||
| 157 | 161 | | |||
| 158 | %files -n libtaskotron-disposable | 162 | %files -n libtaskotron-disposable | ||
| 159 | %dir %{python_sitelib}/libtaskotron/ext/disposable | 163 | %dir %{python_sitelib}/libtaskotron/ext/disposable | ||
| 160 | %{python_sitelib}/libtaskotron/ext/disposable/* | 164 | %{python_sitelib}/libtaskotron/ext/disposable/* | ||
| 161 | 165 | | |||
| 162 | %changelog | 166 | %changelog | ||
| 167 | * Tue May 10 2016 Martin Krizek <mkrizek@fedoraproject.org> - 0.4.12-2 | ||||
| 168 | - remove global write permissions of libtaskotron directories and change group ownership | ||||
| 169 | to the taskotron group | ||||
| 170 | | ||||
| 163 | * Mon May 9 2016 Martin Krizek <mkrizek@fedoraproject.org> - 0.4.12-1 | 171 | * Mon May 9 2016 Martin Krizek <mkrizek@fedoraproject.org> - 0.4.12-1 | ||
| 164 | - bash directive | 172 | - bash directive | ||
| 165 | - allow using a dot to access attributes of a variable in formula | 173 | - allow using a dot to access attributes of a variable in formula | ||
| 166 | - various fixes | 174 | - various fixes | ||
| 167 | 175 | | |||
| 168 | * Mon Apr 18 2016 Martin Krizek <mkrizek@fedoraproject.org> - 0.4.11-1 | 176 | * Mon Apr 18 2016 Martin Krizek <mkrizek@fedoraproject.org> - 0.4.11-1 | ||
| 169 | - add result namespace whitelist | 177 | - add result namespace whitelist | ||
| 170 | - various fixes and small improvements | 178 | - various fixes and small improvements | ||
| ▲ Show 20 Lines • Show All 193 Lines • Show Last 20 Lines | |||||
| Show All 29 Lines | 27 | returns: | | |||
|---|---|---|---|---|---|
| 30 | 30 | | |||
| 31 | If this command is supposed to be the main check of the task, it is supposed to provide text | 31 | If this command is supposed to be the main check of the task, it is supposed to provide text | ||
| 32 | output in a :ref:`resultyaml-format`. This format is then used in the | 32 | output in a :ref:`resultyaml-format`. This format is then used in the | ||
| 33 | :ref:`resultsdb directive <resultsdb_directive>`. | 33 | :ref:`resultsdb directive <resultsdb_directive>`. | ||
| 34 | 34 | | |||
| 35 | raises: | | 35 | raises: | | ||
| 36 | * :class:`.TaskotronDirectiveError`: if ``command`` was not provided or executed command returned | 36 | * :class:`.TaskotronDirectiveError`: if ``command`` was not provided or executed command returned | ||
| 37 | non-zero returncode. | 37 | non-zero returncode. | ||
| 38 | 38 | version_added: 0.4.12 | |||
| 39 | """ | 39 | """ | ||
| 40 | 40 | | |||
| 41 | EXAMPLES = """ | 41 | EXAMPLES = """ | ||
| 42 | 42 | | |||
| 43 | This executes the shell command in subprocess:: | 43 | This executes the shell command in subprocess:: | ||
| 44 | 44 | | |||
| 45 | - name: pull docker image | 45 | - name: pull docker image | ||
| 46 | bash: | 46 | bash: | ||
| ▲ Show 20 Lines • Show All 42 Lines • Show Last 20 Lines | |||||
I think this would be better phrased as "any user who runs it will need to be added to the `taskotron` group"