Mercurial > p > roundup > code
comparison website/README.txt @ 6343:bea4a6956c89
Moved roundup-tracker.org infrastructure docs to website/README.txt
This change makes developers.txt as the place for people contributing
to the code base and README.txt to those maintaining the
infrastructure.
The old state was website/README.txt had reference to
doc/developers.txt for updating issues.roundup-tracker.org. Removed
reference and move docs to website/README.txt.
doc/developers.txt had a section on updating website and wiki that
referenced website/README.txt. Removed section, replaced with sentence
that references website/README.txt for all infrastructure.
| author | John Rouillard <rouilj@ieee.org> |
|---|---|
| date | Sun, 14 Mar 2021 20:52:11 -0400 |
| parents | 53e968351250 |
| children | 53da2c697fab |
comparison
equal
deleted
inserted
replaced
| 6342:31bac6f2dd8b | 6343:bea4a6956c89 |
|---|---|
| 1 Roundup has three web sites: | 1 Roundup has three web sites: |
| 2 | 2 |
| 3 * https://www.roundup-tracker.org/ | 3 * https://www.roundup-tracker.org/ |
| 4 * https://issues.roundup-tracker.org/ | |
| 4 * https://wiki.roundup-tracker.org/ | 5 * https://wiki.roundup-tracker.org/ |
| 5 * https://issues.roundup-tracker.org/ | |
| 6 | 6 |
| 7 www and wiki are hosted on SourceForge. | 7 www is hosted on SourceForge, issues is hosted on a python software |
| 8 | 8 foundation host and wiki is hosted at waldman-edv. |
| 9 | |
| 10 updating issues.roundup-tracker.org | |
| 11 =================================== | |
| 12 See doc/developers.txt for details on accessing the new location. | |
| 13 | |
| 14 | |
| 15 updating wiki.roundup-tracker.org | |
| 16 ================================= | |
| 17 Wiki isn't hosted on sourceforge anymore. See: | |
| 18 | |
| 19 https://issues.roundup-tracker.org/issue2551045 | |
| 20 | |
| 21 for details on Implementing wiki move to Waldmann-EDV. | |
| 22 | |
| 23 Contact Thomas Waldmann. Web site: https://www.waldmann-edv.de/ | |
| 24 email: info AT waldmann-edv DOT de. | |
| 25 | |
| 26 The sites theme is under wiki/wiki/data/plugin/theme/roundup.py. Last | |
| 27 updated by emailing Thomas 2/2021. Images/icons and css under | |
| 28 wiki/_static. | |
| 29 | |
| 30 Backups are assumed to be done by Waldmann-edv. There does not appear | |
| 31 to be a way to get access to the underlying filesystem via ssh or to | |
| 32 do a backup/tarball via with web. | |
| 33 | |
| 34 ============== | |
| 35 | 9 |
| 36 updating services hosted on sf.net (www) | 10 updating services hosted on sf.net (www) |
| 37 ================================================= | 11 ================================================= |
| 38 Generic SF instructions for web service recommend | 12 Generic SF instructions for web service recommend |
| 39 uploading files through SFTP, described here: | 13 uploading files through SFTP, described here: |
| 54 | 28 |
| 55 # set project_home | 29 # set project_home |
| 56 project_home=/home/project-web/roundup | 30 project_home=/home/project-web/roundup |
| 57 | 31 |
| 58 # pull latest Roundup source with www and wiki | 32 # pull latest Roundup source with www and wiki |
| 59 # (the warning about "Not trusting file ... " can be ignored | |
| 60 # for now https://sourceforge.net/p/forge/site-support/8217/) | |
| 61 hg pull -u --cwd ${project_home}/src/roundup | 33 hg pull -u --cwd ${project_home}/src/roundup |
| 62 # see below if this fails with: not trusting file | 34 # see below if this fails with: not trusting file |
| 63 # /home/project-web/roundup/src/roundup/.hg/hgrc from untrusted | 35 # /home/project-web/roundup/src/roundup/.hg/hgrc from untrusted |
| 64 # user 110231, group 48 | 36 # user 110231, group 48 |
| 65 | 37 |
| 122 need to use: | 94 need to use: |
| 123 | 95 |
| 124 https://www.roundup-tracker.org/dev-docs/docs.html?foo=1 | 96 https://www.roundup-tracker.org/dev-docs/docs.html?foo=1 |
| 125 | 97 |
| 126 to cache bust. | 98 to cache bust. |
| 99 | |
| 100 Updating issues.roundup-tracker.org | |
| 101 =================================== | |
| 102 | |
| 103 The tracker resides on bugs.ams1.psf.io (188.166.48.69). You can also | |
| 104 ssh to issues.roundup-tracker.org. They have the same fingerprint: | |
| 105 | |
| 106 ED25519 key fingerprint is f1:f7:3d:bf:3b:01:8d:e1:4e:30:b3:0f:6e:98:b8:9b. | |
| 107 | |
| 108 The roundup installation belongs to the user roundup. | |
| 109 The setup uses virtualenv. Use the python version: | |
| 110 | |
| 111 /srv/roundup/env/bin/python2.7 | |
| 112 | |
| 113 to get a python with roundup on the PYTHONPATH. | |
| 114 | |
| 115 The Roundup tracker https://issues.roundup-tracker.org/ is in | |
| 116 /srv/roundup/trackers/roundup/ with the database set to | |
| 117 /srv/roundup/data/roundup/. Note that postgres is used for the | |
| 118 backend, so the database directory above is used for msgs and files. | |
| 119 | |
| 120 Source is in: /srv/roundup/src/ | |
| 121 | |
| 122 Roundup is run using gunicorn and wsgi. | |
| 123 | |
| 124 You have 'sudo -u roundup' access if you need to run things as the | |
| 125 roundup user. | |
| 126 | |
| 127 The configuration is in the "website/issues" section of Roundup's | |
| 128 Mercurical SCM repository and copied manually to the live tracker. | |
| 129 | |
| 130 * get a working copy of roundup/website/issues from the SCM, either via | |
| 131 hg clone https://hg.code.sf.net/p/roundup/code | |
| 132 or download a snapshot: | |
| 133 https://sourceforge.net/p/roundup/code/ci/default/tarball | |
| 134 | |
| 135 * check the differences | |
| 136 diff -ur /srv/roundup/trackers/roundup/ roundup/website/issues/ | |
| 137 | |
| 138 Copy differences using 'sudo -u roundup ...'. | |
| 139 | |
| 140 Getting a user account | |
| 141 ~~~~~~~~~~~~~~~~~~~~~~ | |
| 142 | |
| 143 To get access to the host, submit a pull request for: | |
| 144 | |
| 145 https://github.com/python/psf-salt | |
| 146 | |
| 147 by forking the repo, make a change similar to: | |
| 148 | |
| 149 https://github.com/rouilj/psf-salt/commit/2aa55d0fc5a343f45f5507437d3fba077cbaf852 | |
| 150 | |
| 151 and submit it as a pull request. Contact ewdurbin via #roundup IRC or by | |
| 152 adding an issue to the master psf-salt repo. | |
| 153 | |
| 154 | |
| 155 updating wiki.roundup-tracker.org | |
| 156 ================================= | |
| 157 Wiki isn't hosted on sourceforge anymore. See: | |
| 158 | |
| 159 https://issues.roundup-tracker.org/issue2551045 | |
| 160 | |
| 161 for details on Implementing wiki move to Waldmann-EDV. | |
| 162 | |
| 163 Contact Thomas Waldmann. Web site: https://www.waldmann-edv.de/ | |
| 164 email: info AT waldmann-edv DOT de. | |
| 165 | |
| 166 The sites theme is under wiki/wiki/data/plugin/theme/roundup.py. Last | |
| 167 updated by emailing Thomas 2/2021. Images/icons and css under | |
| 168 wiki/_static. | |
| 169 | |
| 170 Backups are assumed to be done by Waldmann-edv. There does not appear | |
| 171 to be a way to get access to the underlying filesystem via ssh or to | |
| 172 do a backup/tarball via with web. |
