From 6e8baf37780ed36f9dd302cdc60317d590d9b60b Mon Sep 17 00:00:00 2001
From: Thomas Sileo <t@a4.io>
Date: Thu, 11 Apr 2019 20:22:38 +0200
Subject: [PATCH] Add migration note

---
 Makefile  |  3 +++
 README.md | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 35 insertions(+)

diff --git a/Makefile b/Makefile
index daad832..6870cf1 100644
--- a/Makefile
+++ b/Makefile
@@ -14,6 +14,9 @@ reload-fed:
 	WEB_PORT=5006 CONFIG_DIR=./tests/fixtures/instance1/config docker-compose -p instance1 -f docker-compose-tests.yml up -d --force-recreate --build
 	WEB_PORT=5007 CONFIG_DIR=./tests/fixtures/instance2/config docker-compose -p instance2 -f docker-compose-tests.yml up -d --force-recreate --build
 
+poussetaches:
+	git clone https://github.com/tsileo/poussetaches.git pt && cd pt && docker build . -t poussetaches:latest && cd - && rm -rf pt
+
 reload-dev:
 	# docker build . -t microblogpub:latest
 	docker-compose -f docker-compose-dev.yml up -d --force-recreate
diff --git a/README.md b/README.md
index 32a26fa..398c2ab 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,38 @@
 
 **Still in early development.**
 
+## Perform the "drop-celery" migration
+
+The project is dropping Celery/RabbitMQ in favor of [poussetaches](https://github.com/tsileo/poussetaches), written specifically for microblog.pub.
+
+First you need to know your Docker compose project name, it should be the name of the project directory, without dot.
+If you haven't renamed the directory it should be `microblogpub`.
+If you're not sure you can run `$ docker-compose ps`, and get `{project_name}_{service}_{version}` in the output, like `microblogpub_web_1`
+
+Generate a secret for poussetaches (you can use whatever secret you want):
+
+```
+$ python -c "import os, binascii; print(binascii.hexlify(os.urandom(32)).decode())"
+```
+
+Update the `.env` file and append:
+
+```
+POUSSETACHES_AUTH_KEY=yourgeneratedsecret
+COMPOSE_PROJECT_NAME=microblogpub
+```
+
+Then switch to the `drop-celery` branch:
+
+```
+$ git checkout drop-celery
+# Build the poussetaches container
+$ make poussetaches
+$ make update
+```
+
+And you should be good!
+
 ## Features
 
  - Implements a basic [ActivityPub](https://activitypub.rocks/) server (with federation)