You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+26-65Lines changed: 26 additions & 65 deletions
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
# NSS Instructor Applications Project
1
+
# Learning Platform Project
2
2
3
3
## Installs Needed
4
4
@@ -20,22 +20,14 @@ Go to [Postgresapp](https://postgresapp.com/) to download and run the Postgres a
20
20
21
21
pgAdmin is not a required install, but if you ever have the desire to have a browser-based interface for working directly with the database, go to [pgAdmin](https://www.pgadmin.org/download/) to download the administration tool for Postgres.
22
22
23
-
## Setup
23
+
## Getting Started
24
24
25
-
### Getting Started
25
+
1. Fork this repo to your own Github account.
26
+
2. Clone it.
27
+
3.`cd` into the project directory.
28
+
4. Run `pipenv shell` to create a virtual environment.
26
29
27
-
Fork this repo to your own Github account, and then clone it. Then `cd` into the project directory.
28
-
29
-
### Project Installs and Config
30
-
31
-
If you are running on a Mac or Ubuntu, run the following commands.
32
-
33
-
```sh
34
-
pipenv shell
35
-
pipenv install
36
-
```
37
-
38
-
### Github OAuth App
30
+
## Github OAuth App
39
31
40
32
1. Go to your Github account settings
41
33
2. Open **Developer Settings**
@@ -48,53 +40,36 @@ pipenv install
48
40
9. Leave **Enable Device Flow** unchecked
49
41
10. Create the app and **do not close** the screen that appears
50
42
11. Go to Github and click the **Generate a new client secret** button
51
-
14.**DO NOT CLOSE THIS TAB OR NAVIGATE AWAY**
52
-
53
-
### Environment Variables
54
-
55
-
Several environment variables need to be set up by you to make the setup process faster and more secure. Set up the following environment variables anywhere in your shell initialization file _(i.e. `.bashrc` or `.zshrc`)_.
43
+
12.**DO NOT CLOSE TAB. CLIENT AND SECRET NEEDED BELOW.**
56
44
57
-
#### OAuth
45
+
##Environment Variables
58
46
59
-
Copy the client ID and secret key that was generated in the previous step as the value of the corresponding variables.
47
+
Several environment variables need to be set up by you to make the setup process faster and more secure.
60
48
61
-
```sh
62
-
export LEARN_OPS_CLIENT_ID={Github app client ID}
63
-
export LEARN_OPS_SECRET_KEY={Github app secret}
64
-
```
49
+
### Django Secret Key
65
50
66
-
#### Database
67
-
68
-
> **Tip:** You get to pick any Postgres password you want, but don't use spaces in it.
69
-
70
-
```sh
71
-
export LEARN_OPS_DB=learnops
72
-
export LEARN_OPS_USER=learnops
73
-
export LEARN_OPS_PASSWORD={Postgres user password}
74
-
export LEARN_OPS_HOST=localhost
75
-
export LEARN_OPS_PORT=5432
76
-
```
77
-
78
-
#### Django Secret Key
79
-
80
-
To generate a Django secret key, run the following command in your terminal.
51
+
You will need a Django secret key environment variable. Run the following command in your terminal to generate one and save it for later.
Add the following environment variable to your init file. If you are running the API in a container using a tool like Multipass or Docker, you must add the IP address of the container to this comma-separated list.
59
+
Set up the following environment variables anywhere in your shell initialization file _(i.e. `.bashrc`or `.zshrc`)_.
@@ -108,7 +83,7 @@ In the main directory there is a bash script that you can run to create the data
108
83
It will prompt you for your password.
109
84
110
85
```sh
111
-
./createdb.sh
86
+
./setup_mac.sh
112
87
```
113
88
114
89
> For Mac, if you get feedback that `psql command not found`, add the following to your PATH in your shell initialization file _(.bashrc or .zshrc)_. Make sure the version is correct. You may not have version 10 of Postgres. If you don't, determine your version and replace the 10.
@@ -117,20 +92,6 @@ It will prompt you for your password.
0 commit comments