This application was deployed on Heroku using Gunicorn as the Python web server. Django serves the website, AWS serves all our static and media assets, Stripe is used as the payment processor and Gmail is the email provider.
By the end of the deployment you should have the following Heroku environment variables set for your project to run:
Key | Value |
---|---|
AWS_ACCESS_KEY_ID | Provided when creating a user in the IAM Management Console on AWS |
AWS_SECRET_ACCESS_KEY | Provided when creating a user in the IAM Management Console on AWS |
DATABASE_URL | Automatically added when installing the Heroku Postgres add-on |
EMAIL_HOST_PASS | Provided when generating an app password for your Google account |
EMAIL_HOST_USER | Provided when generating an app password for your Google account |
SECRET_KEY | anythingyouwant |
STRIPE_PUBLIC_KEY | Accessible from your Stripe Developer portal |
STRIPE_SECRET_KEY | Accessible from your Stripe Developer portal |
STRIPE_WH_SECRET | Accessible when creating a Stripe webhook - reveal Signing secret |
USE_AWS | True |
Pre-requisites: Heroku account, Stripe account, AWS account, Gmail account
Create your Heroku account here.
Start off by cloning this project to your machine:
git clone https://github.com/arlandfran/white_library.git
Next open a terminal and install Heroku CLI. Installation steps for each platform can be found in the official documentation here.
Once you've installed Heroku CLI run heroku login
and follow the prompts.
Navigate to the project directory if you haven't already cd white_library
and run heroku create my-app-name
. Be sure to pass in your own unique app name such as "white-library-test" as white-library is already taken.
$ heroku create white-library-test
Creating ⬢ white-library-test... done
https://white-library-test.herokuapp.com/ | https://git.heroku.com/white-library-test.git
By default the app is created in the US region, if you want to create the app in Europe provide the --region flag in the
heroku create
command.heroku create my-app-name --region eu
Once your Heroku app has been created, a git remote called heroku
should also have been created and associated with your local git repository. You can confirm this by running git remote -v
.
$ git remote -v
heroku https://git.heroku.com/white-library-test.git (fetch)
heroku https://git.heroku.com/white-library-test.git (push)
origin https://github.com/arlandfran/white-library.git (fetch)
origin https://github.com/arlandfran/white-library.git (push)
Note: If you would like to setup automatic deployment on Heroku, you will need to have your own Github repository of this project, in which case you will need to fork this project and then connect that forked repository to Heroku.
$ git remote -v
heroku https://git.heroku.com/white-library-test.git (fetch)
heroku https://git.heroku.com/white-library-test.git (push)
origin https://github.com/your-github-username/white-library.git (fetch)
origin https://github.com/your-github-username/white-library.git (push)
Next we'll need to use the Heroku Postgres add-on for this project:
heroku addons:create heroku-postgresql:hobby-dev
This will provision a PostgreSQL database for your project and automatically add a DATABASE_URL
environment variable in your Heroku config.
Next we'll need to add a SECRET_KEY
environment variable for Django to use:
heroku config:set SECRET_KEY="anythingyouwant"
I recommend using a Fort Knox password from RandomKeygen.
At this stage you should be able to deploy your application to Heroku using git push heroku main
and Heroku will automatically detect the language for your app is Python and configure the correct buildpack for the deployment. If you want to however manually set the buildpack you can do so by running these commands:
heroku buildpacks:set heroku/python
Create your AWS account here.
Once you've created your account, sign into AWS as the root user and search for 'S3' by typing in the search bar or hitting ALT+S
and select S3.
Under Buckets click create Create Bucket, choose a bucket name and select the closest region to you. For Object Ownership choose ACLs enabled and ensure Bucket owner preferred is selected. Finally, uncheck Block all public access, acknowledge allowing public settings and create the bucket, every other setting can be left as default.
Now that the bucket has been created, open the bucket and under the Properties tab, enable Static Website Hosting and specify index.html as the index document. Next go to the Permissions > Bucket policy (copy the Bucket ARN) > Policy Generator (this should open in a new tab).
Set the policy type to S3 Bucket Policy, type * in the Principal field and select GetObject under Actions. Paste the copied Bucket ARN into the ARN field and add the statement. Once the statement has been added, generate the policy and copy the generated policy. You can now close the tab, paste the generated policy into the policy editor and save your changes.
Now go back to Permissions > Access Control List. Check the List box for Everyone (public access), acknowledge these changes and save your changes.
The last thing you'll need to do now is setup the CORS configuration. Scroll to the bottom of the Permissons page and paste this configartion in the JSON editor:
[
{
"AllowedHeaders": ["Authorization"],
"AllowedMethods": ["GET"],
"AllowedOrigins": ["*"],
"ExposeHeaders": []
}
]
Search for 'IAM' by typing in the search bar or hitting ALT+S
and select IAM.
Select User Groups located in sidebar and create a group. Choose a group name such as 'manage-white-library' and create the group.
After creating the group, select Policies located in the sidebar and create a policy. Select the JSON tab and import managed policy. Search for 'S3', select AmazonS3FullAccess and import the policy. Edit the resource object and include your copied Bucket ARN:
"Resource": [
"{your_bucket_arn}",
"{your_bucket_arn}/*"
]
Review the policy, give it an appropriate name and description and create the policy.
Once you've created your policy, go back to User Groups > your created user group > Permissions. Expand the Add Permissions dropdown and select Attach policies. Search for your newly created policy and attach the policy.
The last thing you'll need to do now is add a user to your user group. In the sidebar select Users > Add users. Give the user an appropriate name, enable programmatic access and on the next page add your user to your user group.
Once your user has been created, download the CSV file that contains your user's Access key ID and Secret access key.
Important: This is the only time the CSV will be available so please download the CSV.
Now that AWS has been configured, we will need some set some Heroku environment variables so that the next time you deploy to Heroku, AWS will retrieve your static files and store them in a static/
folder.
heroku config:set AWS_ACCESS_KEY_ID="your_access_key_id"
heroku config:set AWS_SECRET_ACCESS_KEY="your_secret_access_key"
You'll also need to set an USE_AWS
environment variable as Django will be looking for this variable to determine whether to serve static files locally or from AWS.
heroku config:set USE_AWS="True"
Once these environment variables have been set and you have deployed to Heroku. On navigating to your S3 Bucket you will see that a static/
folder now exists. Go ahead and create a folder called media
and upload the files found here, and under Permissions, grant public-read access.
With that AWS should be properly setup to serve your static and media files
Create your Stripe account here.
Once you've created your account navigate to the Developers page and select API Keys in the sidebar. Copy your publishable key and secret key and add these to your Heroku environment variables.
heroku config:set STRIPE_PUBLIC_KEY="your_stripe_public_key"
heroku config:set STRIPE_SECRET_KEY="your_stripe_secret_key"
Now navigate to Webhooks > Add endpoint. Use your Heroku app url as the endpoint URL and choose Select all events when selecting events to listen to. Once the endpoint has been added, reveal the Signing secret and add it to your Heroku enviroment variables:
heroku config:set STRIPE_WH_SECRET="your_stripe_wh_secret"
With this Stripe should now be setup to properly listen for payments from Heroku and properly setup the PaymentElement
on the checkout view.
Create your Gmail account here or use an existing one.
Navigate to your Google account Settings > Security > Signing into Google and setup 2-Step Verification.
After you've enabled 2-Step Verification, go back to Settings > Security > Signing into Google and open App passwords.
Verify your account and select the following options:
-
Select app: Mail
-
Select device: Other (provide Django as the custom name)
Generate your app password and add this to your Heroku environment variables as EMAIL_HOST_PASS
:
heroku config:set EMAIL_HOST_PASS="your_gmail_app_password"
Lastly you'll need to add your Gmail account username and password to Heroku as environment variables and Django will be properly configured to send emails:
heroku config:set EMAIL_HOST_USER="your_gmail_username"
heroku config:set EMAIL_HOST_PASS="your_gmail_password"
Pre-requisites: Node, Python
To run this application locally clone the Github repository and install the node dependencies to enable ESlint for this project.
git clone https://github.com/arlandfran/white_library.git
cd white_library
npm install
Next create a virtual environment for the Python dependencies and install them in the virtual environment.
python -m venv venv
. venv/bin/activate
# venv\Scripts\activate.bat for Windows
pip install -r requirements.txt
Before you can run the app locally you'll need to set the local environment variables that Django needs to run.
# set VAR_NAME if using windows
export DEVELOPMENT=True
export SECRET_KEY=anythingyouwant
export STRIPE_PUBLIC_KEY=your_stripe_public_key
export STRIPE_SECRET_KEY=your_stripe_secret_key
export STRIPE_WH_SECRET=your_stripe_wh_secret
python manage.py runserver
to start Django's development server and in another terminal window run python manage.py tailwind start
to enable browser reloading for Tailwind.
Visit http://127.0.0.1:8000/
to see your app running locally.