roib20/petinvent

An inventory for your pets! PetInvent allows you to track your pets

PetInvent

An inventory for your pets! PetInvent allows you to track your pets. Many animal species and breeds are available to choose from.

This project is a full stack web application that uses DevOps best practices - including containerization, micro-services, Infrastructure as Code (IaC), CI/CD pipelines, GitOps, Kubernetes and more.

Live Demo: petbuddy.party

Installation

A local clean install using Docker and docker compose can be easily achieved using the clean-install.sh shell script.

Advanced users can deploy manually using Docker and docker compose, or using Kubernetes and Helm with the charts and shell scripts under the Kubernetes folder.

Contribution

Is your favorite animal missing? Found any bugs? You are welcome to open issues, pull requests or forks.

Technology Stack

Full Stack Web Application

• Back-end Language: Python
• Back-end Framework: Flask
• Front-end Languages: HTML, CSS & JavaScript
• Front-end Framework: Bootstrap v5
• Database: SQL - PostgreSQL, MySQL, MariaDB or SQLite
• Scripting Languages: Bash & POSIX Shell Command Language

Containerization (Docker)

• Container Engine: Docker & containerd
• Container Image Format: OCI Image Format, built using Dockerfile
• Container Image Registry: GitHub Packages - GitHub Container Registry ¹
• Deployment: Docker Compose ²

Container Orchestration (Kubernetes)

• Kubernetes Engine: Google Kubernetes Engine (GKE) ³
• Kubernetes Packaging: Helm

Pipeline

• Infrastructure as Code (IaC): Terraform ⁴

• CI/CD: Github Actions

• GitOps: Argo CD ⁵

• Cloud Provider: Google Cloud Platform (GCP)

Kubernetes Stack ⁶

• Application: PetInvent
• Database: PostgreSQL HA packaged by Bitnami
• Secret Management: Sealed Secrets
• Ingress Controller: Ingress NGINX Controller
• TLS Certificate: cert-manager & Let's Encrypt
• Authoritative DNS: ExternalDNS & Cloudflare DNS
• Domain Registrar: Cloudflare Registrar

Footnotes

1. See container image here: ghcr.io/roib20/petinvent ↩

2. Used for testing and local deployments (see Installation instructions above). ↩

3. Used for cloud deployments ↩

4. See repo: Terraform - Provision a GKE Cluster with Cloudflare Ingress and ArgoCD ↩

5. See repo: petinvent-gitops ↩

6. Deployed using the Pipeline above. ↩