diff --git a/docs/64_dandi_archive.md b/docs/64_dandi_archive.md index fb6c47dd..1869316f 100644 --- a/docs/64_dandi_archive.md +++ b/docs/64_dandi_archive.md @@ -32,18 +32,72 @@ This `Procfile` shouldn't need to be changed or reconfigured much for a DANDI-cl ## Understanding metrics and logging via Heroku +Heroku provides observability in a very convenient manner. If you'd like to see what is happening with your app in real-time, simply access the options shown in the image below +

+ +

### Configuring email alerts via Heroku +Heroku will send relevant updates for any concerning behavior/downtime/etc. to your email. Be sure to configure this, as it is a manual step. + +You'll find options in the `Access` tab + +

+ +

+ ## Creating a Django "superuser" (Admin) Account +Django has the concept of a `superuser` -- essentially an `administrator` user type. For steps such as [setting up authentication for DANDI Archive](../61_dandi_authentication/#creating-sites-and-social-app-in-dandi-archive-admin-panel) +you'll need to set up a `superuser` account. + +Go into your Heroku app, and identify the `Run Console` option: + +

+ +

+ +Initialize a `bash` session + +

+ +

+ +Once in the console, run a quick `ls` to ensure that you can see the `manage.py` file. The `manage.py` file is Django's entrypoint to a handful of management commands. + +You'll now want to create a `superuser` + +

+ +

+ +You'll be prompted to create a user -- **Note: use an email that is not associated with your GitHub account, as GitHub is the default authentication provider for DANDI Archive**. + +To do one final test, try using your credentials to log into the Django Admin panel -- it should be located at `/admin` for your API, such as `your-apps-domain.com/admin` + +You are all set here! + ## Updating Allowed Hosts ## Referencing Authentication credentials from migrations -## Deployment Strategy via Heroku's Procfile - ## Approval of Users ## Setting up Staging Environments \ No newline at end of file diff --git a/docs/img/heroku_bash.png b/docs/img/heroku_bash.png new file mode 100644 index 00000000..0a376aee Binary files /dev/null and b/docs/img/heroku_bash.png differ diff --git a/docs/img/heroku_console.png b/docs/img/heroku_console.png new file mode 100644 index 00000000..a75a8c71 Binary files /dev/null and b/docs/img/heroku_console.png differ diff --git a/docs/img/heroku_user.png b/docs/img/heroku_user.png new file mode 100644 index 00000000..301fc8f4 Binary files /dev/null and b/docs/img/heroku_user.png differ diff --git a/docs/img/members_heroku.png b/docs/img/members_heroku.png new file mode 100644 index 00000000..8f7a4705 Binary files /dev/null and b/docs/img/members_heroku.png differ diff --git a/docs/img/metrics_heroku.png b/docs/img/metrics_heroku.png new file mode 100644 index 00000000..0166be71 Binary files /dev/null and b/docs/img/metrics_heroku.png differ