The process of deploying a Flask application (website and REST APIs) on Data Science & AI Workbench involves the following:
- Configuring Flask to run behind a proxy
- Enabling Anaconda Project HTTP command-line arguments
- Running Flask on the deployed host and port
Here is a small Flask application that includes the call to .run(). The file is saved to server.py.
This Flask application was written using Blueprints, which is useful
for separating components when working with a large Flask application.
Here, the nested block in if __name__ == '__main__' could be in a separate
file from the 'hello' Blueprint.
from flask import Flask, Blueprint
hello = Blueprint('hello', __name__)
@hello.route('/')
def hello_world():
return 'Hello, World!'
if __name__ == '__main__':
app = Flask(__name__)
app.register_blueprint(hello, url_prefix='/')
app.run()
Running behind an HTTPS proxy
Workbench maintains all HTTPS connections into and out of
the server and deployed instances. When writing a Flask app, you only
need to inform it that will be accessed from behind the proxy provided
by Workbench.
The simplest way to do this is with the ProxyFix function from werkzeug.
More information about proxies is provided here.
from flask import Flask, Blueprint
from werkzeug.contrib.fixers import ProxyFix
hello = Blueprint('hello', __name__)
@hello.route('/')
def hello_world():
return 'Hello, World!'
if __name__ == '__main__':
app = Flask(__name__)
app.register_blueprint(hello, url_prefix='/')
app.wsgi_app = ProxyFix(app.wsgi_app)
app.run()
Enabling command-line arguments
In your anaconda-project.yml file, you define a deployable command as follows:
commands:
default:
unix: python ${PROJECT_DIR}/server.py
supports_http_options: true
The flag supports_http_options means that server.py is expected to act on the following command line arguments defined in the Anaconda Project Reference.
This is easily accomplished by adding the following argparse code before calling app.run() in server.py
import sys
from argparse import ArgumentParser
# ... the Flask application blueprint
if __name__ == '__main__':
# arg parser for the standard anaconda-project options
parser = ArgumentParser(prog="hello_world",
description="Simple Flask Application")
parser.add_argument('--anaconda-project-host', action='append', default=[],
help='Hostname to allow in requests')
parser.add_argument('--anaconda-project-port', action='store', default=8086, type=int,
help='Port to listen on')
parser.add_argument('--anaconda-project-iframe-hosts',
action='append',
help='Space-separated hosts which can embed us in an iframe per our Content-Security-Policy')
parser.add_argument('--anaconda-project-no-browser', action='store_true',
default=False,
help='Disable opening in a browser')
parser.add_argument('--anaconda-project-use-xheaders',
action='store_true',
default=False,
help='Trust X-headers from reverse proxy')
parser.add_argument('--anaconda-project-url-prefix', action='store', default='',
help='Prefix in front of urls')
parser.add_argument('--anaconda-project-address',
action='store',
default='0.0.0.0',
help='IP address the application should listen on.')
args = parser.parse_args()
Running your Flask application
The final step is to configure the Flask application with the
Anaconda Project HTTP values and call app.run(). Note that
registering the Blueprint provides a convenient way to deploy
your application without having to rewrite the routes.
# ... the flask application blueprint
if __name__ == '__main__':
# ... parse command line arguments
app = Flask(__name__)
app.register_blueprint(hello, url_prefix=args.anaconda_project_url_prefix)
app.config['PREFERRED_URL_SCHEME'] = 'https'
app.wsgi_app = ProxyFix(app.wsgi_app)
app.run(host=args.anaconda_project_address, port=args.anaconda_project_port)
Here is the complete code for the Hello World application.
import sys
from flask import Flask, Blueprint
from argparse import ArgumentParser
from werkzeug.contrib.fixers import ProxyFix
hello = Blueprint('hello', __name__)
@hello.route('/')
def hello_world():
return "Hello, World!"
if __name__ == '__main__':
# arg parser for the standard anaconda-project options
parser = ArgumentParser(prog="hello_world",
description="Simple Flask Application")
parser.add_argument('--anaconda-project-host', action='append', default=[],
help='Hostname to allow in requests')
parser.add_argument('--anaconda-project-port', action='store', default=8086, type=int,
help='Port to listen on')
parser.add_argument('--anaconda-project-iframe-hosts',
action='append',
help='Space-separated hosts which can embed us in an iframe per our Content-Security-Policy')
parser.add_argument('--anaconda-project-no-browser', action='store_true',
default=False,
help='Disable opening in a browser')
parser.add_argument('--anaconda-project-use-xheaders',
action='store_true',
default=False,
help='Trust X-headers from reverse proxy')
parser.add_argument('--anaconda-project-url-prefix', action='store', default='',
help='Prefix in front of urls')
parser.add_argument('--anaconda-project-address',
action='store',
default='0.0.0.0',
help='IP address the application should listen on.')
args = parser.parse_args()
app = Flask(__name__)
app.register_blueprint(hello, url_prefix = args.anaconda_project_url_prefix)
app.config['PREFERRED_URL_SCHEME'] = 'https'
app.wsgi_app = ProxyFix(app.wsgi_app)
app.run(host=args.anaconda_project_address, port=args.anaconda_project_port)
