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.

Roundup Issue Tracker: http://roundup-tracker.org/