Deployment of librepages for Friendly Forge Format

Bonjour,

Here are the notes for the deployment of https://librepages.org for publishing the documentation published in the html-documentation repository.

Define pages.forgefriends.org (to handle the webhook instructing librepages to pull) and format.forgefriends.org which is where the documentation will be published in the Gandi.net DNS zone.

On the libvirt hypervisor that hosts everything, update the Enough configuration:

Create the VM

  • ~/.enough/forgefriends.lan/inventory/all.yml add pages-host:
  • ~/.enough/forgefriends.lan/inventory/host_vars/pages-host/provision.yml add libvirt_ram: 1024
  • enough --domain forgefriends.lan host create --driver libvirt pages-host

Setup librepages

  • ~/.enough/forgefriends.lan/inventory/group_vars/pages-service-group.yml with pages_repository: "https://lab.forgefriends.org/friendlyforgeformat/html-documentation/"
  • enough --domain forgefriends.lan playbook -- --limit bind-host,pages-host,localhost venv/share/enough/enough-playbook.yml |& tee /tmp/pages.yml

Setup the reverse proxy

  • ~/.enough/forgefriends.lan/proxy-playbook.yml (- name: setup pages.forgefriends.org & name: setup format.forgefriends.org)
  • enough --domain forgefriends.lan playbook -- --limit proxy-host,localhost ~/.enough/forgefriends.lan/proxy-playbook.yml

Setup the webhook

  • TBD
1 Like