Browse Source

📝 Add docs about removing the frontend (#156)

pull/13907/head
Sebastián Ramírez 5 years ago
committed by GitHub
parent
commit
7d57876bda
No known key found for this signature in database GPG Key ID: 4AEE18F83AFDEB23
  1. 4
      README.md
  2. 20
      {{cookiecutter.project_slug}}/README.md

4
README.md

@ -8,17 +8,14 @@ Generate a backend and frontend stack using Python, including interactive API do
[![API docs](img/docs.png)](https://github.com/tiangolo/full-stack-fastapi-postgresql)
### Alternative API documentation
[![API docs](img/redoc.png)](https://github.com/tiangolo/full-stack-fastapi-postgresql)
### Dashboard Login
[![API docs](img/login.png)](https://github.com/tiangolo/full-stack-fastapi-postgresql)
### Dashboard - Create User
[![API docs](img/dashboard.png)](https://github.com/tiangolo/full-stack-fastapi-postgresql)
@ -61,6 +58,7 @@ Generate a backend and frontend stack using Python, including interactive API do
* Docker multi-stage building, so you don't need to save or commit compiled code.
* Frontend tests ran at build time (can be disabled too).
* Made as modular as possible, so it works out of the box, but you can re-generate with Vue CLI or create it as you need, and re-use what you want.
* It's also easy to remove it if you have an API-only app, check the instructions in the generated `README.md`.
* **PGAdmin** for PostgreSQL database, you can modify it to use PHPMyAdmin and MySQL easily.
* **Flower** for Celery jobs monitoring.
* Load balancing between frontend and backend with **Traefik**, so you can have both under the same domain, separated by path, but served by different containers.

20
{{cookiecutter.project_slug}}/README.md

@ -394,6 +394,26 @@ VUE_APP_ENV=development
VUE_APP_ENV=staging
```
### Removing the frontend
If you are developing an API-only app and want to remove the frontend, you can do it easily:
* Remove the `./frontend` directory.
* In the `docker-compose.yml` file, remove the whole service / section `frontend`.
* In the `docker-compose.override.yml` file, remove the whole service / section `frontend`.
Done, you have a frontend-less (api-only) app. 🔥 🚀
---
If you want, you can also remove the `FRONTEND` environment variables from:
* `.env`
* `.gitlab-ci.yml`
* `./scripts/*.sh`
But it would be only to clean them up, leaving them won't really have any effect either way.
## Deployment
You can deploy the stack to a Docker Swarm mode cluster with a main Traefik proxy, set up using the ideas from <a href="https://dockerswarm.rocks" target="_blank">DockerSwarm.rocks</a>, to get automatic HTTPS certificates, etc.

Loading…
Cancel
Save