How to install django-dynamodb2-sessions
- Download and install ActivePython
- Open Command Prompt
- Type
pypm install django-dynamodb2-sessions
Lastest release
If You need backend uses Amazon DynamoDB v. 1 see Greg Taylor github
First step: create DynamoDB Table
Visit your DynamoDB tab in the AWS Management Console and follow instructions:
- Choose the Create Table option.
- Enter your sessions table name (example: sessions).
- Select Primary Key Type = Hash.
- Select Hash Attribute Type as String.
- Enter session_key for Hash Attribute Name.
- Choose the Continue option twice.
- Fill Provisioned Throughput Capacity (only for tests: read - 10 units, write - 5 units).
- Choose the Continue option.
- Choose the Create option.
Second step: installation
Install django-dynamodb2-sessions using pip:
pip install django-dynamodb2-sessions
Export your AWS key and secret key as environment variables because of security:
export AWS_ACCESS_KEY_ID='YourKey' export AWS_SECRET_ACCESS_KEY='YourSecretKey' export AWS_REGION_NAME = 'YourRegion'
In your settings.py file, you'll need set variables:
import os AWS_ACCESS_KEY_ID = os.environ.get('AWS_ACCESS_KEY_ID', '') # set Your AWS key AWS_SECRET_ACCESS_KEY = os.environ.get('AWS_SECRET_ACCESS_KEY', '') # set Your AWS secret key AWS_REGION_NAME = os.environ.get('AWS_REGION_NAME', '') # set Your AWS region DYNAMODB_SESSIONS_TABLE_NAME = '' # set Your sessions table name
Set your session backend to:
SESSION_ENGINE = 'dynamodb_sessions.backends.cached_dynamodb'
or:
SESSION_ENGINE = 'dynamodb_sessions.backends.dynamodb'
Optional you can set always consistent parametr. If you are not using cache to this sessions backend you can force all reads from Dynamodb by setting True. Default: False:
DYNAMODB_SESSIONS_ALWAYS_CONSISTENT = False
Versions
0.1
- Initial release.
0.3
- Added removing expired sessions command management.
0.2
- Added new version of boto to requirements
License
django-dynamodb2-sessions is licensed under the BSD License.