Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/trolit/simple-stack-playground
Simple stack playground to experiment with Ansible, K8S, Terraform, VMs and database providers.
https://github.com/trolit/simple-stack-playground
ansible ansible-roles javascript k8s-at-home nodejs playground playground-project terraform unix-systems virtual-machine
Last synced: about 1 month ago
JSON representation
Simple stack playground to experiment with Ansible, K8S, Terraform, VMs and database providers.
- Host: GitHub
- URL: https://github.com/trolit/simple-stack-playground
- Owner: trolit
- License: mit
- Created: 2024-05-18T21:55:52.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-06-16T22:24:44.000Z (7 months ago)
- Last Synced: 2024-10-14T07:22:49.152Z (3 months ago)
- Topics: ansible, ansible-roles, javascript, k8s-at-home, nodejs, playground, playground-project, terraform, unix-systems, virtual-machine
- Language: Shell
- Homepage:
- Size: 88.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Stack
- Docker
- Ansible
- Terraform
- Node.js, Vue, PostgreSQL, Prisma, Redis
- K8S cluster ([setup with Docker Desktop](https://docs.docker.com/desktop/kubernetes/)), kubectl
## Preview
```
+-----------------+
| K8S STATELESS |
| CLUSTER |
| |
+-----+ +--------+ |
| WWW | <---> | CLIENT | |
+-----+ +--------+ |
| ^ |
| | | +----------+
| v | | REDIS |
| +-------+ +----------+
| | API | <---> | POSTGRES |
| +-------+ +----------+
| |
+-----------------+
```
## Running project
1. Check if `ssh` is installed (`ssh -V`)
2. Create VM/machine with Unix based OS. It should have `openssh-server` installed and configured ssh connection with your machine
How to configure SSH connection?
1. Generate key named `id_cass` (in case of different name, reflect change in [ansible.cfg](./database/ansible.cfg))
```sh
sh-keygen -t rsa -b 4096 -f ~/.ssh/id_cass
```
2. Paste public key (`~/.ssh/id_cass.pub`) content to `~/.ssh/authorized_keys` on VM/machine
3. Check if current [become-directives](https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_privilege_escalation.html#become-directives) in [setup.yaml](./database/setup.yaml) match VM/machine OS.
4. Get host of VM/machine using e.g. `ip a` and define `/database/inventory`
```sh
[postgres]
db1 ansible_host=192.168.0.7
```
> Use `ansible postgres -m ping` to test if host is reachable. Note that for ping you might have to specify destination user (`ansible_user`).
5. Setup infrastructure
with script 🔥
1. Run `quick-start.sh` script from root dir.
with step-by-step guide ⚙️
1. Go to `/database` and execute [setup.yaml](./database/setup.yaml) playbook for PostgreSQL role
```sh
ansible-playbook setup.yaml --extra-vars "role=postgres" -K
```
2. Create `.env` files (x3) based on `.env.example`.
3. Modify `DATABASE_URL` and `SHADOW_DATABASE_URL` in `/api/.env` by replacing address (`127.0.0.1`) to the one that you've provided in `inventory`.
4. Go to root dir of project and build `client` and `api` images.
```
npm run dc-build
```
5. Go to [/infrastructure-as-code](./infrastructure-as-code/) and call:
```sh
terraform apply
```
> If creating client service fails and you don't want to wait until K8S tries to resurrect it again, re-run it manually after few seconds
6. Run migrations by accessing `api`:
```sh
# kubectl get pod
kubectl exec --stdin --tty -- /bin/bash
npm run db:migrate:dev
```
7. Access app at http://localhost:31000 or http://127.0.0.1:31000
8. Destroy stack using `terraform destroy`
---
- [Mikael Krief "Learning DevOps - Second Edition"](https://www.amazon.com/Learning-DevOps-comprehensive-accelerating-Kubernetes/dp/1801818967)