README.md

Grocy

WARNING:

This project is out of date and needs to be improved and migrated to Kustomize.

Summary:

These manifests are used to deploy an instance of Grocy.

Approximate Deployment Time: 1-5 minutes

Requirements:

1. Load Balancer integration so that the Service can expose the pods.
2. NFS Server to which Kubernetes can bind Persistent Volumes.
3. Directory structsure created on the NFS Endpoint you specify in vars.yml.
4. Python modules required to use the k8s Ansible module.
   • pip install openshift kubernetes pyyaml
   • If you're on MacOS, you might have to do this instead.

Instructions:

1. Modify vars.yml with parameters according to your environment.
2. Create the necessary directories defined in vars.yml on your NFS server.
3. Execute the playbook: ansible-playbook provision.yml.
4. Navigate to http://host.name:9432/ to access the software. The default credentials are admin : admin. Be sure to change these.

TODO:

1. Figure out a way to allow this to scale to more than one pod.

Deletion:

1. You can roll back this deployment with the delete.yml playbook: ansible-playbook delete.yml.
   • Please note, this will not remove the deployed namespace because I could not be sure you didn't specify an existing namespace. I would hate to delete your default for example. So you must manually clean that up. kubectl delete ns >namespace name<