darkhelm/notifications-api
1
0
Fork 0
mirror of https://github.com/GSA/notifications-api.git synced 2026-02-03 01:41:05 -05:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #22 from 18F/devdocs_update

Browse Source 
Devdocs update
This commit is contained in:
Jim Moffet
2022-08-05 09:16:56 -07:00
committed by GitHub
parent 03679453a0 b32585d20d
commit a3002c89db
1 changed files with 18 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
README.md
View File

@@ -8,30 +8,33 @@ Contains:
- an internal-only REST API built using Flask to manage services, users, templates, etc (this is what the [admin app](http://github.com/18F/notifications-admin) talks to) - an internal-only REST API built using Flask to manage services, users, templates, etc (this is what the [admin app](http://github.com/18F/notifications-admin) talks to)
- asynchronous workers built using Celery to put things on queues and read them off to be processed, sent to providers, updated, etc - asynchronous workers built using Celery to put things on queues and read them off to be processed, sent to providers, updated, etc
## QUICKSTART
---
If you are the first on your team to deploy, set up AWS SES/SNS as instructed in the AWS setup section below.
## QUICK START Create .env file as described in the .env section below.
```
# If you are the first on your team to deploy, set up AWS SES/SNS as instructed below
# create .env file as instructed below Install VS Code
Open VS Code and install the Remote-Containers plug-in from Microsoft.
# download vscode and install the Remote-Containers plug-in from Microsoft Make sure your docker daemon is running (on OS X, this is typically accomplished by opening the Docker Desktop app)
# make sure your docker daemon is running Create the external docker network:
# create the external docker network `docker network create notify-network`
docker network create notify-network
# Using the command pallette (cmd+p), search "Remote Containers: Open folder in project" Using the command palette (shift+cmd+p), search and select “Remote Containers: Open Folder in Container...”
# choose devcontainer-api folder, after reload, hit "show logs" in bottom-right When prompted, choose **devcontainer-api** folder (note: this is a *subfolder* of notification-api). This will startup the container in a new window (replacing the current one).
# Check vscode panel > ports, await green dot, open a new terminal and run the web server After this page loads, hit "show logs” in bottom-right. The first time this runs it will need to build the Docker image, which will likely take several minutes.
make run-flask
# Open another terminal and run the background tasks Select View->Open View..., then search/select “ports”. Await a green dot on the port view, then open a new terminal and run the web server:
make run-celery `make run-flask`
```
Open another terminal and run the background tasks:
`make run-celery`
---
## Setting Up ## Setting Up
### `.env` file ### `.env` file