{"id":30659232,"url":"https://github.com/calpa/kong-zeabur","last_synced_at":"2025-08-31T12:44:52.175Z","repository":{"id":294144485,"uuid":"986058997","full_name":"calpa/kong-zeabur","owner":"calpa","description":"🚀 Kong Gateway DB-less template for Zeabur. One-click deployment of a lightweight, high-performance API Gateway in DB-less mode.","archived":false,"fork":false,"pushed_at":"2025-05-19T03:54:02.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-19T04:32:07.273Z","etag":null,"topics":["api-gateway","containers","db-less","kong","kong-gateway","kubernetes","microservices","serverless","zeabur"],"latest_commit_sha":null,"homepage":null,"language":null,"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/calpa.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}},"created_at":"2025-05-19T03:40:57.000Z","updated_at":"2025-05-19T03:56:43.000Z","dependencies_parsed_at":"2025-05-19T04:32:10.377Z","dependency_job_id":"8a7b91d0-bab8-4343-ae5f-c8ff206c48e2","html_url":"https://github.com/calpa/kong-zeabur","commit_stats":null,"previous_names":["calpa/kong-zeabur"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/calpa/kong-zeabur","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calpa%2Fkong-zeabur","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calpa%2Fkong-zeabur/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calpa%2Fkong-zeabur/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calpa%2Fkong-zeabur/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/calpa","download_url":"https://codeload.github.com/calpa/kong-zeabur/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calpa%2Fkong-zeabur/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272982771,"owners_count":25025984,"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-08-31T02:00:09.071Z","response_time":79,"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":["api-gateway","containers","db-less","kong","kong-gateway","kubernetes","microservices","serverless","zeabur"],"created_at":"2025-08-31T12:44:49.071Z","updated_at":"2025-08-31T12:44:52.120Z","avatar_url":"https://github.com/calpa.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌐 Kong Gateway OSS (DB-less Mode) on Zeabur\n\n\u003cdiv align=\"center\"\u003e\n\n[![Kong Gateway](https://camo.githubusercontent.com/733593a5edce1e6474a3a82297582a813bbee7ba2edee6db8b35aa8c744a1e83/68747470733a2f2f6b6f6e6768712e636f6d2f77702d636f6e74656e742f75706c6f6164732f323031382f30352f6b6f6e672d6c6f676f2d6769746875622d726561646d652e706e67)](https://zeabur.com/templates/QUF7QG)\n\n![Kong Version](https://img.shields.io/badge/Kong-3.10.0.1-blue)\n![License](https://img.shields.io/badge/License-MIT-green)\n\n[繁體中文 README](README.zh-TW.md)\n\n\u003c/div\u003e\n\n## ✨ Features\n\n- 🚀 **One-Click Deployment** on Zeabur\n- 🗄️ **Database-less** - Runs entirely in-memory\n- 📝 **Declarative Configuration** - Define routes and plugins as code\n- 🔌 **Pre-configured** with a sample httpbin service\n- 🌐 **Custom Domain** support\n- 📊 **Kong Manager** included\n- 🔄 **Stateless** - Perfect for serverless and containerized environments\n\n## 🚀 Deployment\n\n### Option 1: One-Click Deployment (Recommended)\n\n[![Deploy on Zeabur](https://zeabur.com/button.svg)](https://zeabur.com/templates/QUF7QG)\n\n1. Click the \"Deploy on Zeabur\" button above\n2. Set your preferred domain name\n3. Deploy! 🚀\n\n### Option 2: Using Zeabur CLI\n\n```bash\n# Install Zeabur CLI if you haven't\nnpm install -g @zeabur/cli\n\n# Deploy the template\nzeabur template deploy kong-db-less.yml\n\n# Or update an existing template\nzeabur template update -c QUF7QG -f kong-db-less.yml\n```\n\n## ⚙️ Configuration\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `KONG_DATABASE` | Database mode (always `off` for DB-less) | `off` |\n| `KONG_DECLARATIVE_CONFIG` | Path to declarative config | `/kong/declarative/kong.yml` |\n| `KONG_ADMIN_LISTEN` | Admin API listen address | `0.0.0.0:8001` |\n| `KONG_PROXY_ACCESS_LOG` | Proxy access log location | `/dev/stdout` |\n| `KONG_NGINX_WORKER_PROCESSES` | Number of worker processes | `1` |\n\n### Custom Configuration\n\nEdit the `kong.yml` file in the `volumes` section to customize your Kong Gateway configuration. The configuration is written in declarative YAML format.\n\n## 💡 Usage\n\n### Accessing Services\n\n- **Kong Proxy**: `https://your-domain.zeabur.app`\n  - Sample route: `https://your-domain.zeabur.app/httpbin`\n- **Kong Manager UI**: `https://your-domain.zeabur.app:8002`\n- **Status Endpoint**: `https://your-domain.zeabur.app/status`\n\n### Default Routes\n\n- `/httpbin` - Proxies to httpbin.org (example service)\n- `/status` - Health check endpoint\n\n## 🔧 Development\n\n### Updating the Template\n\n1. Make your changes to `kong-db-less.yml`\n2. Update the template on Zeabur:\n   ```bash\n   npx zeabur template update -c QUF7QG -f kong-db-less.yml\n   ```\n\n### Testing Locally\n\n1. Install [Docker](https://www.docker.com/)\n2. Run Kong Gateway locally:\n   ```bash\n   docker run -d --name kong \\\n     -e \"KONG_DATABASE=off\" \\\n     -e \"KONG_DECLARATIVE_CONFIG=/kong.yml\" \\\n     -v $(pwd)/kong.yml:/kong.yml \\\n     -p 8000:8000 \\\n     -p 8001:8001 \\\n     kong/kong-gateway:3.10.0.1\n   ```\n\n## 🔒 Security\n\n- 🔐 Admin API (port 8001) is not exposed to the internet\n- 🔒 Consider adding authentication for production use\n- 🔄 Regularly update to the latest Kong Gateway version\n- 🔒 Review and customize the default CORS and rate limiting settings\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  Made with ❤️ by \u003ca href=\"https://calpa.me\"\u003eCalpa\u003c/a\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcalpa%2Fkong-zeabur","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcalpa%2Fkong-zeabur","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcalpa%2Fkong-zeabur/lists"}