11# Grounds Development Infrastructure (grounds-dev) 🚀
22
3- A local development infrastructure that provisions a k3d Kubernetes cluster with PostgreSQL and Agones (game server hosting) .
3+ A local development infrastructure that provisions a k3d Kubernetes cluster with all necessary components to run the Grounds network .
44
55## 🎯 Quick Start
66
@@ -15,6 +15,7 @@ The `make up` command will automatically install missing prerequisites and deplo
1515- ** k3d Kubernetes cluster** (1 server + 2 agents)
1616- ** PostgreSQL database** in ` databases ` namespace
1717- ** Agones** for game server hosting in ` games ` namespace
18+ - ** Valkey** in ` databases ` namespace
1819- ** Dummy HTTP server** for testing in ` infra ` namespace
1920- ** API namespace** for API services and microservices
2021
@@ -71,32 +72,17 @@ This enables pulling private GHCR images without specifying `imagePullSecrets` i
7172| ---------| -------------|
7273| ` make up ` | Start complete development environment |
7374| ` make down ` | Stop and delete the cluster |
75+ | ` make reset ` | Reset the cluster (down + up) |
7476| ` make status ` | Show cluster and deployment status |
7577| ` make logs ` | Show logs for all services |
7678| ` make test ` | Test the deployment |
77- | ` make export-kubeconfig ` | Export cluster kubeconfig to ./kubeconfig |
7879| ` make help ` | Show all available commands |
7980
8081### Development Helpers
8182
8283| Command | Description |
8384| ---------| -------------|
8485| ` make port-forward ` | Port forward services to localhost |
85- | ` make db-connect ` | Connect to PostgreSQL database |
86- | ` make shell ` | Open shell in PostgreSQL pod |
87-
88- ### Kubeconfig Access
89-
90- The cluster kubeconfig is automatically exported to ` ./kubeconfig ` during setup.
91-
92- ``` bash
93- # Use the local kubeconfig
94- export KUBECONFIG=$( pwd) /kubeconfig
95- kubectl get nodes
96-
97- # Or manually re-export
98- make export-kubeconfig
99- ```
10086
10187## 🌐 Service Access
10288
@@ -107,9 +93,6 @@ make export-kubeconfig
10793- ** Port** : ` 5432 `
10894
10995``` bash
110- # Connect to database
111- make db-connect
112-
11396# Port forward to access locally
11497kubectl port-forward -n databases svc/postgresql 5432:5432
11598```
@@ -124,20 +107,6 @@ kubectl get fleets -n games
124107kubectl get gameservers -n games
125108```
126109
127-
128- ### API Services
129- - ** Namespace** : ` api `
130- - ** Purpose** : Host API services and microservices
131-
132- ``` bash
133- # Deploy API services to the api namespace
134- kubectl apply -f manifests/ -n api
135-
136- # Check API services
137- kubectl get pods -n api
138- kubectl get services -n api
139- ```
140-
141110### Dummy HTTP Server (Testing)
142111- ** URL** : http://localhost/demo
143112- ** Namespace** : ` infra `
@@ -157,9 +126,9 @@ kubectl get pods -A
157126make logs
158127
159128# Restart everything
160- make down && make up
129+ make reset
161130```
162131
163132## 🔒 Security Note
164133
165- ⚠️ ** Development only!** Default credentials (app/app) are used. Not for production.
134+ ⚠️ ** Development only!** Default credentials (app/app) are used. Not for production.
0 commit comments