Planet.wikimedia.org
What is planet?
An RSS feed aggregator. See meta:Planet_Wikimedia for details.
How do I access it?
en.planet.wikimedia.org and several other languages, *.planet.wikimedia.org.
Which languages exist?
The current list of languages is:
- Arabic / العربية
- Catalan / Català
- Czech / Česky
- German / Deutsch
- English
- Spanish / Español
- French / Français
- Scandinavian
- Indonesian / Bahasa Indonesia
- Italian / Italiano
- Polish / Polski
- Portuguese / Português
- Romanian / Română
- Russian / Русский
- Serbian / Српски / srpski
- Chinese / 中文
How to add a new language?
Make a change in the operations/puppet repo in ./modules/profile/manifests/planet/venus.pp . You'll see the existing examples.
Where should I report issues?
On Phabricator. In product Wikimedia, component Planet
Where does it run?
On planetX001 where X={1, 2} varying on the datacenter (eqiad, codfw). Before that it was on zirconium in eqiad. The even older planet was on singer.
Where's the code?
In git, in the operations/puppet repo:
- ./manifests/role/planet.pp
- ./manifests/misc/planet.pp
and
How are planets being updated?
Puppet creates cron jobs, running as user "planet".
crontab -u planet -l example: 0 0 * * * /usr/bin/planet -v /usr/share/planet-venus/wikimedia/de/config.ini > /var/log/planet/de-planet.log 2>&1
There is also /var/lib/planet/update-planets to update all planets at once. run with sudo -u planet though to not mess up permissions on log files.
How do I add or remove feed URLs?
- Clone the
operations/puppet
Git repository:git clone https://gerrit.wikimedia.org/r/operations/puppet
; - go to
modules/planet/templates/feeds/
and edit one of the[language]_config.erb
files (where [language] matches the code of the language of the new feed); - submit to Gerrit and have somebody review and it.
- → Use "planet-feeds" as the topic (branch) when submitting. Moreover, prepend "planet:" to the commit message, e. g.
planet: Add XYZ feed
(861452). Currently, in November 2022, user Dzahn is responsible for reviewing and merging respective change sets and may be added as reviewer. See the Git/Reviewers #operations/puppet MediaWiki.org page for reference.
- → Use "planet-feeds" as the topic (branch) when submitting. Moreover, prepend "planet:" to the commit message, e. g.
You can see the existing lists of feeds that are included at https://gerrit.wikimedia.org/r/plugins/gitiles/operations/puppet/+/refs/heads/production/modules/planet/templates/feeds/
How do I change HTML of the index pages?
- see above, edit ./puppet/templates/planet/index.html.tmpl.erb
How do I add/change translations in the index pages or add a new language?
- see above, edit ./puppet/manifests/role/planet.pp (find $planet_languages=...)