Skip to content
This repository has been archived by the owner on Aug 19, 2024. It is now read-only.
/ nomad-mastodon Public archive

(Archived) An example of how to run Mastodon using the Nomad cluster orchestrator

License

Notifications You must be signed in to change notification settings

lopcode/nomad-mastodon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Running Mastodon with Nomad

This repository is designed to be read with my blog post, and you should be familiar with the first-party setup guide too.

It includes Nomad task definitions that I use to run my own Mastodon instance, as well as a couple of helpful scripts. They're tuned to run on a single t4g.medium server on AWS.

It's supposed to be for inspiration, rather than a step-by-step guide. You won't be able to run it out of the box using this repository, but I hope it's useful as a reference to get you started.

If you know of a better way to do something, or want to offer other improvements, please send me a message on Mastodon @carrot@bunny.cloud before opening a PR.

For interest, it's actually a redacted copy of the cluster folder, from a repository I use to manage the infrastructure for bunny.cloud. Not included are the terraform and ansible definitions for all the underlying infrastructure.

Screenshot of Nomad running Mastodon

Components

The Nomad task definitions include:

  • A front proxy (nginx)
  • Web server (Mastodon - Ruby on Rails)
  • A message processor (Mastodon - Sidekiq)
  • A streaming server (Mastodon - Node)
  • A SQL migrations task (ran before every deploy)
  • A periodic cleanup task (to remove old media)

Scripts

  • install_dependencies.sh installs local dependencies to run scripts
  • deploy_cluster.sh uses the Nomad CLI to deploy all the tasks
  • ./tootctl.sh runs a given tootctl command in a running sidekiq allocation
🥕 carrot 🗂 bunny-cloud-infra/infra/cluster 🐙 main $ ./tootctl.sh version
Discovering alloc of "mastodon-sidekiq" to run tootctl in...
Found alloc with ID: ef0fd901-d598-9fe6-b2c2-3c577c0aee2e
Executing: "tootctl version"
4.0.2

License

Everything here is MIT licensed - use it, change it, and please credit me if you do something public with it.

About

(Archived) An example of how to run Mastodon using the Nomad cluster orchestrator

Resources

License

Stars

Watchers

Forks