cab53d10ac
Clean up references to lists.openstack.org other than as a virtual host on the new lists01.opendev.org Mailman v3 server. Update a few stale references to the old openstack-infra mailing list (and accompanying stale references to the OpenStack Foundation and OpenStack Infra team). Update our mailing list service documentation to reflect the new system rather than the old one. Once this change merges, we can create an archival image of the old server and delete it (as well as removing it from our emergency skip list for Ansible). Side note, the lists.openstack.org server will be 11.5 years old on November 1, created 2012-05-01 21:14:53 UTC. Farewell, old friend! Change-Id: I54eddbaaddc7c88bdea8a1dbc88f27108c223239
55 lines
1.4 KiB
ReStructuredText
55 lines
1.4 KiB
ReStructuredText
:title: Mailing Lists
|
|
|
|
.. _lists:
|
|
|
|
Mailing Lists
|
|
#############
|
|
|
|
`The Mailman Suite <https://www.list.org/>`_ (Mailman Core, Postorius,
|
|
Hyperkitty) is installed on lists.opendev.org to run mailing lists for the
|
|
OpenDev Collaboratory and projects it hosts, as well as archives of those
|
|
lists.
|
|
|
|
At a Glance
|
|
===========
|
|
|
|
:Hosts:
|
|
* https://lists.opendev.org (and numerous other aliases)
|
|
:Ansible:
|
|
* :git_file:`playbooks/service-lists3.yaml`
|
|
* :git_file:`playbooks/roles/mailman3`
|
|
:Projects:
|
|
* https://www.list.org/
|
|
* https://gitlab.com/mailman/
|
|
:Bugs:
|
|
* https://storyboard.openstack.org/#!/project/748
|
|
* https://gitlab.com/mailman/
|
|
:Resources:
|
|
* `Mailman Documentation <https://docs.mailman3.org/>`_
|
|
|
|
Adding a List
|
|
=============
|
|
|
|
A list may be added by adding it to the ``openstack-infra/system-config``
|
|
repository in :git_file:`inventory/service/host_vars/lists01.opendev.org.yaml`.
|
|
For example:
|
|
|
|
.. code-block:: yaml
|
|
|
|
- name: Example list
|
|
description: 'This is an example'
|
|
admin: 'admin@example.com'
|
|
password: "{{ mailman_list_password }}"
|
|
|
|
Scripted Interaction with Lists
|
|
===============================
|
|
|
|
This may only be performed with root access to the list server.
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo docker-compose -f /etc/mailman-compose/docker-compose.yaml exec -T -u mailman mailman-core mailman help
|
|
|
|
Use context help for the CLI's many subcommands, or see the Mailman v3
|
|
documentation for more details.
|