Mercurial > p > roundup > code

annotate website/README.txt @ 8408:e882a5d52ae5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
refactor: move RateLimitExceeded to roundup.cgi.exceptions RateLimitExceeded is an HTTP exception that raises code 429. Move it to roundup.cgi.exceptions where all the other exceptions that result in http status codes are located. Also make it inherit from HTTPException since it is one. Also add docstrings for all HTTP exceptions and order HTTPExceptions by status code. BREAKING CHANGE: if somebody is importing RateLimitExceeded they will need to change their import. I consider it unlikely anybody is using RateLimitExceeded. Detectors and extensions are unlikely to raise RateLimitExceeded. So I am leaving it out of the upgrading doc. Just doc in change log.
author John Rouillard <rouilj@ieee.org>
date Sun, 10 Aug 2025 21:27:06 -0400
parents b976dd2beb1a
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4915
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
1 Roundup has three web sites:
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
2
6269
92cc82788f83 Replace http:....roundup-tracker.org with https.
John Rouillard <rouilj@ieee.org>
parents: 6263
diff changeset
3 * https://www.roundup-tracker.org/
6343
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
4 * https://issues.roundup-tracker.org/
5941
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
5 * https://wiki.roundup-tracker.org/
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
6
6343
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
7 www is hosted on SourceForge, issues is hosted on a python software
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
8 foundation host and wiki is hosted at waldman-edv.
5941
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
9
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
10 updating services hosted on sf.net (www)
4915
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
11 =================================================
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
12 Generic SF instructions for web service recommend
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
13 uploading files through SFTP, described here:
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
14 http://sourceforge.net/p/forge/documentation/Project%20Web%20Services/
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
15
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
16 However, SFTP is ugly to script in non-interactive
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
17 mode, so we use SSH access to fetch everything and
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
18 build from server side.
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
19
5633
7a570b1f0d67 website: improve sf login instructions
Bernhard Reiter <bernhard@intevation.de>
parents: 5612
diff changeset
20 Working with sf.net
4915
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
21 -------------------
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
22 Current docs are taken down with SourceForge Trac,
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
23 so working instructions are available from here:
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
24 http://web.archive.org/web/20140618231150/http://sourceforge.net/apps/trac/sourceforge/wiki/Shell%20service
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
25
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
26 # log in, replace <user> with your account
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
27 ssh -t <user>,roundup@shell.sourceforge.net create
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
28
4956
4e7208743254 Update web site instruction to restore web presence of
anatoly techtonik <techtonik@gmail.com>
parents: 4940
diff changeset
29 # set project_home
4915
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
30 project_home=/home/project-web/roundup
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
31
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
32 # pull latest Roundup source with www and wiki
4940
ff4d939f4619 website/README: Make "hg up" location-independent
anatoly techtonik <techtonik@gmail.com>
parents: 4934
diff changeset
33 hg pull -u --cwd ${project_home}/src/roundup
5343
f1270730505d Add directions on how to handle issues when updating using hg.
John Rouillard <rouilj@ieee.org>
parents: 4956
diff changeset
34 # see below if this fails with: not trusting file
f1270730505d Add directions on how to handle issues when updating using hg.
John Rouillard <rouilj@ieee.org>
parents: 4956
diff changeset
35 # /home/project-web/roundup/src/roundup/.hg/hgrc from untrusted
f1270730505d Add directions on how to handle issues when updating using hg.
John Rouillard <rouilj@ieee.org>
parents: 4956
diff changeset
36 # user 110231, group 48
4915
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
37
4956
4e7208743254 Update web site instruction to restore web presence of
anatoly techtonik <techtonik@gmail.com>
parents: 4940
diff changeset
38 # read up on other people changes and add yours
4e7208743254 Update web site instruction to restore web presence of
anatoly techtonik <techtonik@gmail.com>
parents: 4940
diff changeset
39 cd ${project_home}
4e7208743254 Update web site instruction to restore web presence of
anatoly techtonik <techtonik@gmail.com>
parents: 4940
diff changeset
40 vim logbuch.txt
4e7208743254 Update web site instruction to restore web presence of
anatoly techtonik <techtonik@gmail.com>
parents: 4940
diff changeset
41
8398
b976dd2beb1a doc: record loss of all files in project directory except the website.
John Rouillard <rouilj@ieee.org>
parents: 8293
diff changeset
42 [ Note: all the files in the project home except htdocs that make up
b976dd2beb1a doc: record loss of all files in project directory except the website.
John Rouillard <rouilj@ieee.org>
parents: 8293
diff changeset
43 the website were gone. I created a new logbuch.txt file. We need to
b976dd2beb1a doc: record loss of all files in project directory except the website.
John Rouillard <rouilj@ieee.org>
parents: 8293
diff changeset
44 build the docs outside the sourceforge envirnment and rsync them in
b976dd2beb1a doc: record loss of all files in project directory except the website.
John Rouillard <rouilj@ieee.org>
parents: 8293
diff changeset
45 as there is no longer a working sphinx environment. ]
b976dd2beb1a doc: record loss of all files in project directory except the website.
John Rouillard <rouilj@ieee.org>
parents: 8293
diff changeset
46
5343
f1270730505d Add directions on how to handle issues when updating using hg.
John Rouillard <rouilj@ieee.org>
parents: 4956
diff changeset
47 If you get a "not trusting" error the problem is that the .hg files in
6232
1ae6e7842f39 Fix punctuation typo.
John Rouillard <rouilj@ieee.org>
parents: 5948
diff changeset
48 use are not owned by you and hg won't use them. Add this to your
5343
f1270730505d Add directions on how to handle issues when updating using hg.
John Rouillard <rouilj@ieee.org>
parents: 4956
diff changeset
49 ~/.hgrc file (create file if needed)
f1270730505d Add directions on how to handle issues when updating using hg.
John Rouillard <rouilj@ieee.org>
parents: 4956
diff changeset
50
f1270730505d Add directions on how to handle issues when updating using hg.
John Rouillard <rouilj@ieee.org>
parents: 4956
diff changeset
51 [trusted]
f1270730505d Add directions on how to handle issues when updating using hg.
John Rouillard <rouilj@ieee.org>
parents: 4956
diff changeset
52 groups=48
f1270730505d Add directions on how to handle issues when updating using hg.
John Rouillard <rouilj@ieee.org>
parents: 4956
diff changeset
53 users=110231
f1270730505d Add directions on how to handle issues when updating using hg.
John Rouillard <rouilj@ieee.org>
parents: 4956
diff changeset
54
f1270730505d Add directions on how to handle issues when updating using hg.
John Rouillard <rouilj@ieee.org>
parents: 4956
diff changeset
55 if the uid/gid changes you may have to change the values.
f1270730505d Add directions on how to handle issues when updating using hg.
John Rouillard <rouilj@ieee.org>
parents: 4956
diff changeset
56 See: https://www.mercurial-scm.org/wiki/Trust for details
f1270730505d Add directions on how to handle issues when updating using hg.
John Rouillard <rouilj@ieee.org>
parents: 4956
diff changeset
57
5633
7a570b1f0d67 website: improve sf login instructions
Bernhard Reiter <bernhard@intevation.de>
parents: 5612
diff changeset
58 When done working in the sf shell, you can destroy it early
7a570b1f0d67 website: improve sf login instructions
Bernhard Reiter <bernhard@intevation.de>
parents: 5612
diff changeset
59 to free resources:
7a570b1f0d67 website: improve sf login instructions
Bernhard Reiter <bernhard@intevation.de>
parents: 5612
diff changeset
60
7a570b1f0d67 website: improve sf login instructions
Bernhard Reiter <bernhard@intevation.de>
parents: 5612
diff changeset
61 shutdown
4620
0aafd64866d1 website/README.txt: Improved: Added new generic sf.net section.
Bernhard Reiter <bernhard@intevation.de>
parents: 4609
diff changeset
62
4915
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
63 updating www.roundup-tracker.org
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
64 ---------------------------------
8278
9489ea677a61 doc: update README for www.roundup-tracker.org.
John Rouillard <rouilj@ieee.org>
parents: 8166
diff changeset
65 Note that sourceforge still only has python2 available on it's
9489ea677a61 doc: update README for www.roundup-tracker.org.
John Rouillard <rouilj@ieee.org>
parents: 8166
diff changeset
66 systems. Doc updates probably need to be done by building on local
9489ea677a61 doc: update README for www.roundup-tracker.org.
John Rouillard <rouilj@ieee.org>
parents: 8166
diff changeset
67 machine using modern Sphinx (7.x or greater) and the generated files
9489ea677a61 doc: update README for www.roundup-tracker.org.
John Rouillard <rouilj@ieee.org>
parents: 8166
diff changeset
68 pushed to the website.
9489ea677a61 doc: update README for www.roundup-tracker.org.
John Rouillard <rouilj@ieee.org>
parents: 8166
diff changeset
69
9489ea677a61 doc: update README for www.roundup-tracker.org.
John Rouillard <rouilj@ieee.org>
parents: 8166
diff changeset
70 Also the files htdocs/ahref* and htdocs/google* have to be copied from
9489ea677a61 doc: update README for www.roundup-tracker.org.
John Rouillard <rouilj@ieee.org>
parents: 8166
diff changeset
71 the current production tree to the new directory so we keep some level
9489ea677a61 doc: update README for www.roundup-tracker.org.
John Rouillard <rouilj@ieee.org>
parents: 8166
diff changeset
72 of analytics.
9489ea677a61 doc: update README for www.roundup-tracker.org.
John Rouillard <rouilj@ieee.org>
parents: 8166
diff changeset
73
9489ea677a61 doc: update README for www.roundup-tracker.org.
John Rouillard <rouilj@ieee.org>
parents: 8166
diff changeset
74 -----
9489ea677a61 doc: update README for www.roundup-tracker.org.
John Rouillard <rouilj@ieee.org>
parents: 8166
diff changeset
75
4915
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
76 Site update requires rebuilding HTML files. For that
6263
3a851df879cd Remove doc dependency sphinxcontrib-cheeseshop.
John Rouillard <rouilj@ieee.org>
parents: 6232
diff changeset
77 `sphinx` is required/
3a851df879cd Remove doc dependency sphinxcontrib-cheeseshop.
John Rouillard <rouilj@ieee.org>
parents: 6232
diff changeset
78 Hopefully, it is already installed into virtualenv, so
4915
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
79 the whole procedure looks like so:
4227
25db485027cf add website instructions
Richard Jones <richard@users.sourceforge.net>
parents:
diff changeset
80
4915
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
81 # activate the virtualenv
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
82 . ${project_home}/docbuilder/bin/activate
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
83 # cd to website source and build it
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
84 cd ${project_home}/src/roundup/website/www
5845
e338969b1d23 Make sure to update to proper revision now that we have maint branch releases.
John Rouillard <rouilj@ieee.org>
parents: 5633
diff changeset
85 hg up <release tag> # make sure you are using the released code
4915
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
86 make clean
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
87 make html
5633
7a570b1f0d67 website: improve sf login instructions
Bernhard Reiter <bernhard@intevation.de>
parents: 5612
diff changeset
88 # you can check which files updated (the date will change with many files)
7a570b1f0d67 website: improve sf login instructions
Bernhard Reiter <bernhard@intevation.de>
parents: 5612
diff changeset
89 #diff -ur --brief ${project_home}/htdocs/ ./html/
4915
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
90 # copy to website dir
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
91 cp -r -p ./html/* ${project_home}/htdocs/
4956
4e7208743254 Update web site instruction to restore web presence of
anatoly techtonik <techtonik@gmail.com>
parents: 4940
diff changeset
92 # copy legacy html doc to website docs/ dir
4e7208743254 Update web site instruction to restore web presence of
anatoly techtonik <techtonik@gmail.com>
parents: 4940
diff changeset
93 # (in main doc/conf.py this is done automatically)
4e7208743254 Update web site instruction to restore web presence of
anatoly techtonik <techtonik@gmail.com>
parents: 4940
diff changeset
94 cp -r -p ../../doc/html_extra/* ${project_home}/htdocs/docs/
4915
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
95 # or try it with rsync (skip --dry-run when ready)
0e22b13c5ab5 website/README.txt: Test and update instructions
anatoly techtonik <techtonik@gmail.com>
parents: 4871
diff changeset
96 #rsync --dry-run -v --checksum --recursive ./html/* ${project_home}/htdocs/
5941
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
97
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
98
5948
728a8a25dd70 Fix wording.
John Rouillard <rouilj@ieee.org>
parents: 5941
diff changeset
99 If you are releasing an alpha/beta release, don't update:
5941
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
100
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
101 ${project_home}/htdocs/docs/
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
102
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
103 instead update:
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
104
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
105 ${project_home}/htdocs/dev-docs/
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
106
6269
92cc82788f83 Replace http:....roundup-tracker.org with https.
John Rouillard <rouilj@ieee.org>
parents: 6263
diff changeset
107 and the URL will be: https://www.roundup-tracker.org/dev-docs/docs.html
5941
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
108
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
109 Note there appears to be a cache somewhere in the path, so you may
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
110 need to use:
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
111
6269
92cc82788f83 Replace http:....roundup-tracker.org with https.
John Rouillard <rouilj@ieee.org>
parents: 6263
diff changeset
112 https://www.roundup-tracker.org/dev-docs/docs.html?foo=1
5941
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
113
29d428927362 prep for 2.0.0alpha0 release.
John Rouillard <rouilj@ieee.org>
parents: 5845
diff changeset
114 to cache bust.
6343
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
115
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
116 Updating issues.roundup-tracker.org
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
117 ===================================
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
118
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
119 The tracker resides on bugs.ams1.psf.io (188.166.48.69). You can also
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
120 ssh to issues.roundup-tracker.org. They have the same fingerprint:
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
121
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
122 ED25519 key fingerprint is f1:f7:3d:bf:3b:01:8d:e1:4e:30:b3:0f:6e:98:b8:9b.
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
123
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
124 The roundup installation belongs to the user roundup.
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
125 The setup uses virtualenv. Use the python version:
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
126
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
127 /srv/roundup/env/bin/python2.7
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
128
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
129 to get a python with roundup on the PYTHONPATH.
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
130
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
131 The Roundup tracker https://issues.roundup-tracker.org/ is in
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
132 /srv/roundup/trackers/roundup/ with the database set to
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
133 /srv/roundup/data/roundup/. Note that postgres is used for the
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
134 backend, so the database directory above is used for msgs and files.
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
135
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
136 Source is in: /srv/roundup/src/
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
137
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
138 Roundup is run using gunicorn and wsgi.
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
139
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
140 You have 'sudo -u roundup' access if you need to run things as the
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
141 roundup user.
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
142
8166
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
143 The configuration is tracked in multiple places.
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
144 The one used by PSF infrastrcuture is:
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
145
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
146 https://github.com/psf/bpo-tracker-roundup
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
147
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
148 Contact ee-durbin (or psf infra) for an invite to their repo.
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
149
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
150 Usually testing is done with: the "website/issues" section
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
151 of Roundup's Mercurical SCM repository and copied manually to the live
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
152 tracker.
6343
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
153
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
154 * get a working copy of roundup/website/issues from the SCM, either via
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
155 hg clone https://hg.code.sf.net/p/roundup/code
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
156 or download a snapshot:
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
157 https://sourceforge.net/p/roundup/code/ci/default/tarball
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
158
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
159 * check the differences
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
160 diff -ur /srv/roundup/trackers/roundup/ roundup/website/issues/
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
161
8166
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
162 Copy differences using 'sudo -u roundup ...' into production for testing.
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
163
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
164 Restart the server with:
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
165
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
166 sudo service roundup-roundup restart
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
167
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
168 The git version is what PSF uses if they have to rebuild/move our
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
169 tracker. So it's important to keep it up to date.
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
170
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
171 They also generate the config.ini from an ansible script. So if you
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
172 need to change settings in config.ini (e.g. logging from ERROR to
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
173 WARNING) and have it persist across (daily+) ansible runs you need to
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
174 update:
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
175
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
176 pillar/base/bugs.sls
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
177
53da2c697fab update instruction on care and feeding for tracker.
John Rouillard <rouilj@ieee.org>
parents: 6343
diff changeset
178 in the https://github.com/python/psf-salt repo and then push it.
6343
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
179
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
180 Getting a user account
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
181 ~~~~~~~~~~~~~~~~~~~~~~
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
182
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
183 To get access to the host, submit a pull request for:
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
184
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
185 https://github.com/python/psf-salt
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
186
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
187 by forking the repo, make a change similar to:
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
188
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
189 https://github.com/rouilj/psf-salt/commit/2aa55d0fc5a343f45f5507437d3fba077cbaf852
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
190
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
191 and submit it as a pull request. Contact ewdurbin via #roundup IRC or by
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
192 adding an issue to the master psf-salt repo.
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
193
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
194
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
195 updating wiki.roundup-tracker.org
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
196 =================================
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
197 Wiki isn't hosted on sourceforge anymore. See:
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
198
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
199 https://issues.roundup-tracker.org/issue2551045
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
200
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
201 for details on Implementing wiki move to Waldmann-EDV.
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
202
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
203 Contact Thomas Waldmann. Web site: https://www.waldmann-edv.de/
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
204 email: info AT waldmann-edv DOT de.
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
205
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
206 The sites theme is under wiki/wiki/data/plugin/theme/roundup.py. Last
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
207 updated by emailing Thomas 2/2021. Images/icons and css under
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
208 wiki/_static.
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
209
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
210 Backups are assumed to be done by Waldmann-edv. There does not appear
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
211 to be a way to get access to the underlying filesystem via ssh or to
bea4a6956c89 Moved roundup-tracker.org infrastructure docs to website/README.txt
John Rouillard <rouilj@ieee.org>
parents: 6340
diff changeset
212 do a backup/tarball via with web.
8293
5d1f833801f9 docs: updated DNS contact points and ownership.
John Rouillard <rouilj@ieee.org>
parents: 8278
diff changeset
213
5d1f833801f9 docs: updated DNS contact points and ownership.
John Rouillard <rouilj@ieee.org>
parents: 8278
diff changeset
214 DNS
5d1f833801f9 docs: updated DNS contact points and ownership.
John Rouillard <rouilj@ieee.org>
parents: 8278
diff changeset
215 ===
5d1f833801f9 docs: updated DNS contact points and ownership.
John Rouillard <rouilj@ieee.org>
parents: 8278
diff changeset
216 Thomas Waldman is also our DNS manager. All changes should go to him
5d1f833801f9 docs: updated DNS contact points and ownership.
John Rouillard <rouilj@ieee.org>
parents: 8278
diff changeset
217 at email: info AT waldmann-edv DOT de.
5d1f833801f9 docs: updated DNS contact points and ownership.
John Rouillard <rouilj@ieee.org>
parents: 8278
diff changeset
218
5d1f833801f9 docs: updated DNS contact points and ownership.
John Rouillard <rouilj@ieee.org>
parents: 8278
diff changeset
219 Richard Jones still owns/pays for the roundup-tracker.org domain.
5d1f833801f9 docs: updated DNS contact points and ownership.
John Rouillard <rouilj@ieee.org>
parents: 8278
diff changeset
220 It expires on: 2026-01-06T10:49:58Z.
5d1f833801f9 docs: updated DNS contact points and ownership.
John Rouillard <rouilj@ieee.org>
parents: 8278
diff changeset
221
Roundup Issue Tracker: http://roundup-tracker.org/