Compare commits

...

5 Commits

Author SHA1 Message Date
Ben Klaas
9aa9ea65c2 Updates to quickstart while onboarding Carly 2022-08-22 14:25:39 -05:00
Ben Klaas
55bc3e54ed Merge pull request #23 from 18F/jim/080522/sampleenv
sample env
2022-08-09 09:47:40 -05:00
Jim Moffet
a3002c89db Merge pull request #22 from 18F/devdocs_update
Devdocs update
2022-08-05 09:16:56 -07:00
Ben Klaas
b32585d20d Remove old QUICKSTART 2022-08-05 02:34:29 +00:00
Ben Klaas
9f21018d8e Update QUICKSTART 2022-08-05 02:22:21 +00:00

View File

@@ -8,30 +8,36 @@ 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)
- 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
```
# If you are the first on your team to deploy, set up AWS SES/SNS as instructed below
Create .env file as described in the .env section 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)
Also make sure there is NOT a Postgres daemon running on port 5432.
# 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"
# choose devcontainer-api folder, after reload, hit "show logs" in bottom-right
Using the command palette (shift+cmd+p), search and select “Remote Containers: Open Folder in Container...”
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
make run-flask
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.
# Open another terminal and run the background tasks
make run-celery
```
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-flask`
Open another terminal and run the background tasks:
`make run-celery`
Confirm that everything is working by hitting localhost:6011 and it responds with a 200 OK.
---
## Setting Up
### `.env` file