{"id":31287844,"url":"https://github.com/abdulrahmanalpha/k8s-voting-app","last_synced_at":"2025-10-17T16:02:01.536Z","repository":{"id":316201945,"uuid":"1062388032","full_name":"AbdulrahmanAlpha/k8s-voting-app","owner":"AbdulrahmanAlpha","description":"🗳️ Kubernetes Voting App : DevOps Demo with Ingress \u0026 LoadBalancer","archived":false,"fork":false,"pushed_at":"2025-09-23T08:30:37.000Z","size":118,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-23T09:29:02.839Z","etag":null,"topics":["demo-app","devops","docker","ingress","kubernetes","loadbalancer","microservices","nginx"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AbdulrahmanAlpha.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-23T07:34:06.000Z","updated_at":"2025-09-23T08:30:41.000Z","dependencies_parsed_at":"2025-09-23T09:29:04.340Z","dependency_job_id":null,"html_url":"https://github.com/AbdulrahmanAlpha/k8s-voting-app","commit_stats":null,"previous_names":["abdulrahmanalpha/k8s-voting-app"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/AbdulrahmanAlpha/k8s-voting-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdulrahmanAlpha%2Fk8s-voting-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdulrahmanAlpha%2Fk8s-voting-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdulrahmanAlpha%2Fk8s-voting-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdulrahmanAlpha%2Fk8s-voting-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AbdulrahmanAlpha","download_url":"https://codeload.github.com/AbdulrahmanAlpha/k8s-voting-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbdulrahmanAlpha%2Fk8s-voting-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276738208,"owners_count":25695859,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-24T02:00:09.776Z","response_time":97,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["demo-app","devops","docker","ingress","kubernetes","loadbalancer","microservices","nginx"],"created_at":"2025-09-24T11:26:09.870Z","updated_at":"2025-09-24T11:26:12.894Z","avatar_url":"https://github.com/AbdulrahmanAlpha.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🗳️ Kubernetes Voting App: DevOps Demo\n\nA fully containerized **microservices Voting App** deployed on Kubernetes with a clean **ClusterIP → LoadBalancer → Ingress** networking model.  \nPerfect for **DevOps \u0026 SRE learners** who want to practice real-world Kubernetes deployments.\n\n---\n\n## 🚀 Features\n- Microservices-based voting application:\n  - `vote` (Python/Flask frontend)\n  - `result` (Node.js/Express frontend)\n  - `worker` (background processor)\n  - `redis` (queue)\n  - `postgres` (database)\n- Modern **Kubernetes networking**:\n  - Internal `ClusterIP` for service-to-service comms\n  - External `LoadBalancer` for exposure\n  - `Ingress` with hostname-based routing (`/vote`, `/result`)\n- Secrets, ConfigMaps, and Persistent Volumes for stateful services.\n- Verified to run on **kind/minikube** locally and supports **cloud-native migration**.\n\n---\n# K8S diagram\n\n![K8S Diagram](./docs/k8s-voting-app.drawio.png)\n\n---\n\n## 📂 Project Structure\n```\n\nk8s-voting-app/\n│── k8s/                   # All Kubernetes manifests\n│   ├── vote-deploy.yaml\n│   ├── result-deploy.yaml\n│   ├── worker-deploy.yaml\n│   ├── redis-deploy.yaml\n│   ├── postgres-deploy.yaml\n│   ├── ingress.yaml\n│   └── ...\n│── docs/                  # Documentation \u0026 guides\n│── README.md              # Project overview\n│── LICENSE\n\n````\n\n---\n\n## ⚡ Quickstart (Run Locally)\n\n### 1. Clone repo\n```bash\ngit clone https://github.com/\u003cyour-username\u003e/k8s-voting-app.git\ncd k8s-voting-app\n````\n\n### 2. Start a local cluster\n\n```bash\n# Using kind\nkind create cluster --name voting-cluster\n# OR using minikube\nminikube start\n```\n\n### 3. Deploy app\n\n```bash\nkubectl create ns voting\nkubectl apply -n voting -f k8s/\n```\n\n### 4. Verify pods \u0026 services\n\n```bash\nkubectl get pods -n voting\nkubectl get svc -n voting\n```\n\n### 5. Access via Ingress\n\n* Edit `/etc/hosts`:\n\n  ```\n  127.0.0.1 voting.local\n  ```\n* Test:\n\n  ```bash\n  curl -H \"Host: voting.local\" http://localhost:8080/vote\n  curl -H \"Host: voting.local\" http://localhost:8080/result\n  ```\n\n---\n\n## 🛠️ Troubleshooting\n\n* Use `kubectl port-forward` to test health:\n\n  ```bash\n  kubectl port-forward svc/vote 8081:80 -n voting\n  curl http://localhost:8081\n  ```\n* Check ingress logs:\n\n  ```bash\n  kubectl logs -n ingress-nginx deploy/ingress-nginx-controller\n  ```\n\n---\n\n## 🎯 Use Cases\n\n* Learn **K8s networking** (ClusterIP, LoadBalancer, Ingress).\n* Practice **DevOps workflows**: GitOps, CI/CD, Helm replacement with pure YAML.\n* Build muscle memory for **troubleshooting K8s apps**.\n\n---\n\n## 📸 Demo Screenshot(Result Webpage)\n\n![result webpage, Demo iamge](./docs/k8s-voting-app.png)\n---\n\n## 🧑‍💻 Author\n\n👤 **Abdulrahman A. Muhamad**\n\n* 🌐 [Portfolio](https://abdulrahman-alpha.web.app)\n* 💼 [LinkedIn](https://www.linkedin.com/in/abdulrahmanalpha)\n* 🐙 [GitHub](https://github.com/AbdulrahmanAlpha)\n\n---\n\n## 📜 License\n\nMIT: free to use, share, and learn from.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdulrahmanalpha%2Fk8s-voting-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabdulrahmanalpha%2Fk8s-voting-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdulrahmanalpha%2Fk8s-voting-app/lists"}