# Developer Instructions

### Running the Server Locally

This section shows how to get the server running on a local environment We use this primarily for testing

1. Open a terminal on your computer
2. Clone this project
3. cd Lucky7-Capstone
4. Follow the steps outlined in 'Starting the server' below
5. Go to [http://localhost:3000](http://localhost:3000/)

### Starting the Server

1. npm install
2. npm run dev (or "npm run start" in a different terminal to have the changes incorporate live
3. If you did npm run start, open a new terminal
4. pip3 install -r requirements.txt
5. python3 server.py

Use 'CTRL+SHIFT+R' to reload the page after making any changes.

(Thanks <https://github.com/jwkvam/minimal-flask-react>)

### Running the Production Server

Our production website is running on an EC2 instance This section outlines how to get the EC2 instance running and how to connect to it

#### Connecting to an existing instance

Once you are in the AWS console you can see the EC2 instances that exist in your account

1. If there are no running instances, you will need to set one up follow the 'Creating an EC2 Instance' below
2. If there is already an instance, ask Adam for the private key file follow the instructions 'What to do with a Key Pair'
3. You can now connect to the server with ssh: ssh -i "\~/.ssh/CapstoneEC2.pem" <ubuntu@ec2-52-55-161-116.compute-1.amazonaws.com>

#### Starting the Production Server

After you have followed the instructions to connect to the instance you can run our server

1. clone this git repository if it does not yet exist
2. cd into the repo
3. git pull
4. follow the instructions "Starting the Server" above
5. When you close the terminal, the server will shut down. If you do not want this behavior, simply run the servers in a persistant window like tmux

**HELP IT WON'T START!** I keep an instance of the server running in the background and you cannot have two servers running at once. Simply kill the old version of the server with the command:

tmux kill-server

#### Creating an EC2 Instance

1. Follow the steps in 'Accessing the AWS Console'
2. In the 'Find Services' search bar, search for EC2
3. In the EC2 console, click the 'Running Instances' link
4. Click the 'Launch Instance' button at the top of the screen
5. Select 'Ubuntu Server'
6. Select t2.micro general purpose instance type
7. Click 'Review and Launch'
8. Launch the instance
9. Select 'Create a new key pair'
10. Name the key pair CapstoneEC2
11. Download the Private Key
12. Follow the below instructions 'What to do with a Private Key'
13. Launch the instance
14. Follow the steps above 'Connecting to and Existing Instance'
15. Once you have connected clone this repository
16. Run sudo apt update
17. Run sudo apt install npm
18. Run sudo apt install python3-pip
19. go back to the EC2 console in the AWS console in your browser
20. In order to connect to this server on the internet, you need to allow inbound http access on port 3000
21. Select your running instance
22. In the description tab, you should find a section named 'Security Groups'
23. Click the attached security group (should be something like 'launch-wizard-5'
24. Click edit
25. Add a rule
26. Select 'Custome TCP Rule' under type
27. Select 'anywhere' for the source
28. Type 3000 for the port range

#### Accessing the AWS Console

1. Open a web browser and navigate to <https://aws.amazon.com/education/awseducate/>
2. Click 'Login to AWS Educate'
3. Ask Adam for login credentials and log in
4. Click the hamburger menu in the upper right and click AWS Account
5. Click the orange 'AWS Educate Starter Account'
6. Click the orange 'AWS Console'

#### What to do with a Private Key

1. When you have a private key, you should put it in the folder \~/.ssh/ ex: mv \~/downloads/CapstoneEC2.pem \~/.ssh/
2. Don't share the private key with any one