This sample code helps get you started with a simple Flask web service deployed by AWS Elastic Beanstalk.
This sample includes:
- README.md - this file
- requirements.txt - this file is used install Python dependencies needed by the Flask application
- application.py - this file contains the Flask application
- flaskrun.py - this file contains a CLI wrapper that allows you to pass options to your Flask application
- .ebextensions/ - this directory contains the configuration files that allow AWS Elastic Beanstalk to deploy your application
These directions assume you want to develop on your local computer, and not from the Amazon EC2 instance itself. If you're on the Amazon EC2 instance, the virtual environment is already set up for you, and you can start working on the code.
To work on the sample code, you'll need to clone your project's repository to your local computer. If you haven't, do that first. You can find instructions in the AWS CodeStar user guide.
-
Create a Python virtual environment for your Flask project. This virtual environment allows you to isolate this project and install any packages you need without affecting the system Python installation. At the terminal, type the following command:
$ virtualenv .venv -
Activate the virtual environment:
$ activate ./venv/bin/activate -
Install Python dependencies for this project:
$ pip install -r requirements.txt -
Start the Flask development server:
$ python application.py --port 8000 -
Open http://127.0.0.1:8000/ in a web browser to view the output of your service.
Once you have a virtual environment running, you can start making changes to the sample Flask web service. We suggest making a small change to application.py first, so you can see how changes pushed to your project's repository are automatically picked and deployed to the Amazon EC2 instance by AWS Elastic Beanstalk. (You can watch the progress on your project dashboard.) Once you've seen how that works, start developing your own code, and have fun!
Learn more about AWS CodeStar by reading the user guide. Ask questions or make suggestions on our forum.
User Guide: http://docs.aws.amazon.com/codestar/latest/userguide/welcome.html Forum: https://forums.aws.amazon.com/forum.jspa?forumID=248