At Stream, we build a lot of showcase and example applications to show off the awesome features that our service has to offer. For nearly all of our applications, we host them on an instance – usually DigitalOcean or AWS EC2. While maintaining your codebase and keeping it relevant is difficult, we’ve found that the most challenging aspect when it comes to maintaining an application is keeping it alive and running. Additionally, with Node.js being the core language for most of our backend APIs, scaling a single threaded process can be hard to do; that’s where PM2 comes in and why we enjoy using it so much. There are many process managers out there, most notably Forever, StrongLoop's Process Manager, and good ol’ SystemD. And then there is PM2, with over 60 million downloads and 25k GitHub stars (and rising!). We like PM2 because simply put, it’s easy to use and makes managing a production environment seamless.
What is PM2?
Installing PM2
Installing PM2 is a piece of cake. First, you’ll want to make sure that you have your process.json file ready to go in your code so you can kick off the process. If you’re on macOS, installing is as simple as running yarn add global pm2. If you’re on Linux, Windows, or using a Docker container (yes, it supports Docker as well), follow the instructions here. If you’re curious what it should look like, here is an example of our process_prod.json file for Winds, our open-source RSS & Podcast application: https://gist.github.com/astrotars/b385990f2632dd389838ecbba87def5e As you can see, we’re running several processes, and PM2 handles them without any issues, automatically using the Node.js Cluster API to spawn multiple processes.
Tips & Tricks
With any application (or process manager in our case), it’s good to know a few tips and tricks from individuals who have previously used it.
Auto Restart
Process Management
- pm2 start process_prod.json - Start process(es) via process JSON file
- pm2 ls - Show a list of all applications
- pm2 stop
– Stops a specific application - pm2 start
– Starts a specific application - pm2
scale N – Scales the application you specify to N number of instances (can be used to scale up or down) - pm2 kill – Kills all running applications
- pm2 restart – Restarts all running applications
- pm2 reload – Reloads the app configuration (this comes in handy when you modify your application's environment variables)
Process Management
Log Management
- pm2 logs - Outputs logs from all running applications
- pm2 logs app - Outputs logs from only the "app" application
- pm2 flush - Flushes all log data, freeing up disk space
Remember, the most important thing to do is to enable log rotation. Doing so will split one giant log file into many smaller files that are more manageable for PM2. To do this, run the following command: pm2 install pm2-logrotate More information on Log Management can be found here. If you’re finding that your instance is filling up with logs often, think about using a centralized logging service such as Loggly, Papertrail, or ELK.
Best Practices:
Generally, I like to abide by the practices outlined in The Twelve-Factor App. They will allow you to use PM2 to its full advantage. If you haven’t read the manifesto, it comes down to these 12 rules:
- One codebase tracked in revision control, many deploys
- Explicitly declare and isolate dependencies
- Store config in the environment
- Treat backing services as attached resources
- Strictly separate build and run stages
- Execute the app as one or more stateless processes
- Export services via port binding
- Scale out via the process model
- Maximize robustness with fast startup and graceful shutdown
- Keep development, staging, and production as similar as possible
- Treat logs as event streams
- Run admin/management tasks as one-off processes
If you follow the rules above, you’ll be able to scale any application with PM2 effectively and efficiently with little to no errors.
Final Thoughts
At Stream, we’re all big fans of the open-source community and couldn’t be happier that PM2 is an open-source project. It allows us to focus on building amazing applications without worrying about the massive overhead that is required to keep an application up and running. With that said, thank you PM2! If you’d like to know more about Stream and what we do, have a look at our 5-minute tutorial that walks you through how to use our API to build a scalable newsfeed in just a few lines of code. For those of you reading, I hope you enjoyed this short read and found a couple of tidbits to be helpful. If you have any questions or comments, please leave them in the comments below! Thank you for reading and happy coding!