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
How are planets being updated?
Puppet creates systemd timers and services, running as user "planet". sudo systemctl cat planet-update-en
User=planet Environment="HTTPS_PROXY=http://url-downloader.eqiad.wikimedia.org:8080" ExecStart=/usr/bin/rawdog -d /etc/rawdog/en/ -v -u -w
To seem them all:
$ sudo systemctl list-units | grep planet
How do I add or remove feed URLs?
- Clone the
operations/puppetGit repository:git clone https://gerrit.wikimedia.org/r/operations/puppet; - go to
modules/planet/templates/feeds/and edit one of the[language]_config.erbfiles (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=...)