Skip to content

Demo app for easily getting started with Bunnyshell

Notifications You must be signed in to change notification settings

aris-bunnyshell/demo-books

 
 

Repository files navigation

Bunnyshell Books - Demo Appp

Bunnyshell CI

This app is a CRUD example, composed out of a frontend, one backend service and one database. Its purpose is to illustrate how you can quickly get started with Bunnyshell.

Summary of app functional requirements:

  • Each Book has id, title, description, availability status.
  • We can create, retrieve, update, delete Books.
  • There is a Search bar for searching Books by title.

Inspired fromm:

  Summary of app functional requirements:

  • Each Book has id, title, description, availability status.
  • We can create, retrieve, update, delete Books.
  • There is a Search bar for searching Books by title.

Development

Copy the .env.sample to .env in order to have env vars for development, as the defaults are set to work with Bunnyshell, in prod mode.

Add the following line to /etc/hosts on your local machine

127.0.0.1 books.local.bunnyshell.com books-api.local.bunnyshell.com

Then, just run docker compose up and open the apps:

Projects setup & run

In each project directory, you can run:

npm install

Compiles and hot-reloads for development

npm start

Deployment

The backend service can be deployed using the existing Helm Chart and the frontend app can be deployed using the existing Kubernetes manifest files.

Using the backend Helm Chart

Available parameters that you can customize and write to a my_values.yaml file, for example.

Name Description Value
serviceImage An existing built image for the service ""
replicas The number of replicas 1
ingress.className The ingress class name to be used nginx
ingress.host The host that the ingress resource will use example.com
postgres.host The database server host db
postgres.db The database initial database name bunny_books
postgres.user The database authentication username postgres
postgres.password The database authentication password pass
frontendUrl The URL of the frontend application https://example.com
helm install -f my_values.yaml my-release ./helm/backend

Using the frontend Kubernetes manifests

kubectl apply -f ./manifests/frontend

You can alter / configure the raw manifests using different tools, like Kustomize & sed:

cd manifests/frontend

kustomize create --autodetect --recursive --namespace=my-custom-namespace

kustomize edit set image needsimage=mybuiltimage:latest

kustomize edit add patch --kind Deployment --name frontend --patch '[{"op": "add", "path": "/spec/template/spec/containers/0/env/-", "value": {"name": "ENV", "value": "staging"}}]'

sed -i "s/frontend.example.com/kmyhost.myapp.com/g" ingress.yaml

kubectl apply -k .'

About

Demo app for easily getting started with Bunnyshell

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 56.0%
  • JavaScript 18.7%
  • CSS 13.0%
  • Dockerfile 7.2%
  • HTML 5.1%