A Content-Addressed Pastebin featuring
It is highly derived from silverp1's and buhman's project pb, and they deserve recognition for this idea.
See about.md (available at /about after Deployment) for usage details.
A pre-built image of the project is available from Docker Hub:
docker pull tucked/pbnh:latestAlternatively, it can always be built locally:
docker build --tag pbnh:latest .Before deploying, create a configuration file that tells the app how to run:
edit sample_config.ymlPrimarily, SQLALCHEMY_DATABASE_URI needs to be set.
Any dialect supported by SQLAlchemy should work;
however, only SQLite and PostgreSQL are currently tested.
Note: In-memory databases are NOT supported.
If the server is not configured correctly, it will produce an error like this:
[2023-02-28 07:07:03 +0000] [6] [WARNING] [Errno 2] Unable to load configuration file (No such file or directory): '/etc/pbnh.yaml'
[2023-02-28 07:07:03 +0000] [6] [ERROR] SQLALCHEMY_DATABASE_URI is not set in the config.
Failed to find application object: 'create_app(check_db=True)'
[2023-02-28 07:07:03 +0000] [6] [INFO] Worker exiting (pid: 6)
[2023-02-28 07:07:03 +0000] [1] [INFO] Shutting down: Master
[2023-02-28 07:07:03 +0000] [1] [INFO] Reason: App failed to load.Gunicorn serves the project, and configuration for it can be bind-mounted to /pbnh/gunicorn.conf.py.
See https://docs.gunicorn.org/en/20.1.0/configure.html#configuration-file for more information.
For the sake of demonstration, this guide will set up an SQLite database.
Start by setting this in the configuration file: SQLALCHEMY_DATABASE_URI: sqlite:////pbnh/tmpdb.sqlite
Then, create a file to use for that database (and make it editable to the container user):
touch paste.sqlite
chmod 666 paste.sqliteNext, initialize the database:
docker run --interactive --tty \
--volume "$PWD/sample_config.yml:/etc/pbnh.yaml:ro" \
--volume "$PWD/paste.sqlite:/pbnh/tmpdb.sqlite" \
pbnh:latest pipenv run flask --app pbnh db initIf the database is not initialized correctly, the server will produce an error like this:
[2023-04-16 19:04:25 +0000] [1] [INFO] Starting gunicorn 20.1.0
[2023-04-16 19:04:25 +0000] [1] [INFO] Listening at: http://0.0.0.0:8000 (1)
[2023-04-16 19:04:25 +0000] [1] [INFO] Using worker: sync
[2023-04-16 19:04:25 +0000] [7] [INFO] Booting worker with pid: 7
[2023-04-16 19:04:26 +0000] [7] [INFO] PBNH_CONFIG is not set in the environment. Trying /etc/pbnh.yaml...
[2023-04-16 19:04:26 +0000] [7] [INFO] /etc/pbnh.yaml was loaded successfully.
[2023-04-16 19:04:26 +0000] [7] [ERROR] (sqlite3.OperationalError) no such table: paste
[SQL: SELECT paste.id AS paste_id, paste.hashid AS paste_hashid, paste.ip AS paste_ip, paste.timestamp AS paste_timestamp, paste.mime AS paste_mime, paste.sunset AS paste_sunset, paste.data AS paste_data
FROM paste
WHERE paste.hashid = ?
LIMIT ? OFFSET ?]
[parameters: ('Has the database been initialized?', 1, 0)]
(Background on this error at: https://sqlalche.me/e/20/e3q8)
[2023-04-16 19:04:26 +0000] [7] [INFO] The database is not usable. Trying again in 10 seconds...Note: If this happens, the container will remain running so that it can be used to initialize the database:
docker ps # Get the container name or ID.
docker exec "$container_name_or_ID" pipenv run flask --app pbnh db initFinally, start the app:
docker run --interactive --tty \
--volume "$PWD/sample_config.yml:/etc/pbnh.yaml:ro" \
--volume "$PWD/paste.sqlite:/pbnh/tmpdb.sqlite" \
--publish 12345:8000 \
pbnh:latestThen, open http://localhost:12345/ in a browser.
Note: In a production environment, a reverse proxy (e.g. nginx) should be deployed in front of the app. See https://flask.palletsprojects.com/en/2.2.x/deploying/ for more information.
To run the tests, run the sut ("System Under Test") service in docker-compose.test.yml:
docker compose -f docker-compose.test.yml run sutNote: This pattern is meant to be compatible with automated repository testing on Docker Hub.