This repository contains the complete example code from my PyTexas 2017 talk, "Building Asynchronous Microservices with Tornado." The code requires Python 3.6.
Running run_service.py will start the example HTTP service, listening on
a port on the localhost interface. I do not recommend reconfiguring the
service to listen on a publicly accessible IP. Pressing Ctrl+C should stop the
service.
The following environment variables must be set in order for the service to run:
SERVER_PORT- This sets the port that the HTTP server will listen on.MONGODB_URI- The URI of your MongoDB server. Example:mongodb://localhost:12345/mydbREDIS_HOST- The hostname or IP of your Redis server.REDIS_PORT- The port number your Redis server is listening on.MYSQL_HOST- The hostname or IP of your MySQL server.MYSQL_PORT- The port number your MySQL server is listening on.MYSQL_DATABASE- The name of the MySQL database to use. See section about MySQL, below.MYSQL_USER- The username to use when connecting to MySQL.MYSQL_PASSWORD- The password to use when connecting to MySQL.AWS_S3_BUCKET- The name of the AWS S3 bucket to use.AWS_S3_OBJECT- The object key in the AWS S3 bucket to read and write.
The MySQL database must be initialized before running run_service.py. To
initialize the database, set the required MYSQL_* environment variables
listed above and then run:
python service/mysql/initialize.py
This script will create the database and table used by the example service.
The example service will try to read and write a single object in an AWS S3
bucket. It uses boto3 to talk to S3, so it will
use your AWS credentials stored in ~/.aws/credentials, if available. You can
also configure your credentials by setting the AWS_ACCESS_KEY_ID and
AWS_SECRET_ACCESS_KEY environment variables.