Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bhattaraib58/rent-app-json-server
Test API For Easy, Fast, Fake JSON Server
https://github.com/bhattaraib58/rent-app-json-server
Last synced: 26 days ago
JSON representation
Test API For Easy, Fast, Fake JSON Server
- Host: GitHub
- URL: https://github.com/bhattaraib58/rent-app-json-server
- Owner: bhattaraib58
- Created: 2019-10-11T04:58:08.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2022-12-11T08:59:51.000Z (almost 2 years ago)
- Last Synced: 2023-03-05T23:45:28.338Z (over 1 year ago)
- Language: JavaScript
- Homepage: https://rent-app-api.herokuapp.com/
- Size: 211 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Deploy `json-server` to `{{ free hosting site }}`
> Instructions how to deploy the full fake REST API [json-server](https://github.com/typicode/json-server) to various free hosting sites. Should only be used in development purpose but can act as a simpler database for smaller applications.
* [**Create your database**](#create-your-database)
* [Deploy to **Heroku**](#deploy-to-heroku)
* [Deploy to **now**](#deploy-to-now)
* [Deploy to **Azure**](#deploy-to-azure)
## Create your database
1 . Clone this repo to anywhere on your computer.
```bash
git clone https://github.com/jesperorb/json-server-heroku.git
```
2 . Change `db.json` to **your own content** according to the [`json-server example`](https://github.com/typicode/json-server#example) and then `commit` your changes to git.
_this example will create `/posts` route , each resource will have `id`, `title` and `content`. `id` will auto increment!_
```json
{
"posts":[
{
"id" : 0,
"title": "First post!",
"content" : "My first content!"
}
]
}
```
---
## Deploy to **Heroku**
Heroku is a free hosting service for hosting small projects. Easy setup and deploy from the command line via _git_.
###### Pros
* Easy setup
* Free
###### Cons
* App has to sleep a couple of hours every day.
* "Powers down" after 30 mins of inactivity. Starts back up when you visit the site but it takes a few extra seconds. Can maybe be solved with [**Kaffeine**](http://kaffeine.herokuapp.com/)
---
### Install Heroku
1 . [Create your database](#create-your-database)
2 . Create an account on
[https://heroku.com](https://heroku.com)
3 . Install the Heroku CLI on your computer:
[https://devcenter.heroku.com/articles/heroku-cli](https://devcenter.heroku.com/articles/heroku-cli)
4 . Connect the Heroku CLI to your account by writing the following command in your terminal and follow the instructions on the command line:
```bash
heroku login
```
5 . Then create a remote heroku project, kinda like creating a git repository on GitHub. This will create a project on Heroku with a random name. If you want to name your app you have to supply your own name like `heroku create project-name`:
```bash
heroku create my-cool-project
```
6 . Push your app to __Heroku__ (you will see a wall of code)
```bash
git push heroku master
```
7 . Visit your newly create app by opening it via heroku:
```bash
heroku open
```
8 . For debugging if something went wrong:
```bash
heroku logs --tail
```
---
#### How it works
Heroku will look for a startup-script, this is by default `npm start` so make sure you have that in your `package.json` (assuming your script is called `server.js`):
```json
"scripts": {
"start" : "node server.js"
}
```
You also have to make changes to the port, you can't hardcode a dev-port. But you can reference herokus port. So the code will have the following:
```js
const port = process.env.PORT || 4000;
```
---
## Deploy to **now**
1 . [Create your database](#create-your-database)
2 . Install now cli-tool globally
```bash
npm install -g now
```
3 . Run the `now` command in this folder/repo where your project is. If you run it for the first time, you will be prompted to login, after login, run the command again:
```
now --public
```
_`--public` is to skip the prompt telling you that you will open source your project if you deploy it to now_
4 . The URL will be copied automatically and you can just paste it into your browser.
5. **Optional**: Rename the deployment:
```bash
now alias https://your-deployed-name.now.sh new-name
```
_first argument is the deployed site, second argument is the new name to give it_
---
## Deploy to **Azure**
You can also use _Microsoft Azure_ to deploy a smaller app for free to the Azure platform. The service is not as easy as _Heroku_ and you might go insane because the documentation is really really bad at some times and it's hard to troubleshoot.
The **pros** are that on _Azure_ the app **will not be forced to sleep**. It will sleep automatically on inactivity but you can just visit it and it will start up.
## Installation
1 . Create a Microsoft Account that you can use on Azure:
https://azure.microsoft.com/
2 . Install the `azure-cli`:
https://docs.microsoft.com/en-us/cli/azure/install-azure-cli
_This might cause some trouble, you will see. Remember to restart your terminal or maybe your computer if the commands after this does not work_
3 . Login to the service via the command line and follow the instructions:
```bash
az login
```
_You will be prompted to visit a website and paste a confirmation code_
## Create the project
1 . [Create your database](#create-your-database)
2 . Create a resource group for your projects, replace the name to whatever you want just be sure to use the same group name in all commands to come. You only have to create the resource group and service plan once, then you can use the same group and plan for all other apps you create if you like.
```bash
az group create -n NameOfResourceGroup -l northeurope
```
3 . Create a service plan:
```
az appservice plan create -n NameOfServicePlan -g NameOfResourceGroup
```
4 . Create the actual app and supply the service plan and resource group
```bash
az webapp create -n NameOfApp -g NameOfResourceGroup --plan NameOfServicePlan
```
5 . Create deployment details. A git-repo is not created automatically so we have to create it with a command:
```bash
az webapp deployment source config-local-git -n NameOfApp -g NameOfResourceGroup
```
6 . From the command in step 5 you should get a **url** in return. Copy this url and add it as a remote to your local git project, for example:
```bash
git remote add azure https://[email protected]/deploy-testing.git
```
7 . Now you should be able to push your app:
```bash
git push azure master
```
You should be prompted to supply a password, this should be the pass to your account. If not, you can choose a different password at your Dashboard for Azure: **[https://portal.azure.com/](https://portal.azure.com/)**
Choose **App Services** in the sidebar to the left and the choose your app in the list that appears then go to **Deployment Credentials** to change your password for deployment:
https://docs.microsoft.com/en-us/azure/app-service/app-service-deployment-credentials