This repository is now archived and has been merged with the gitops-stack for direct local development and easier maintenance.
This repository aims to provide a ready-to-go Tilt setup for ephemeral FAF infrastructure local development on kubernetes.
The tilt stack uses kubernetes resources from the gitops-stack.
The tilt stack is designed to replicate production as close as possible for local development. The default values from gitops-stack have been used where applicable
- Tilt
- Kuberenetes (Docker Desktop or Minikube are recommended for those new to kubernetes) Tilt cluster setup
- For windows users a bash program. By default git bash is used with an assumed installation directory of C:/Program Files/Git
- helm must be installed to generate the k8s from the helm charts in the gitops repo
In the root directoy of your repository run tilt up. This will start all the faf services in the correct order. The status of each service can be viewed in the tilt UI by visiting http://localhost:10350. This is the control server for tilt where you can restart services or disable them for substitution by services you would like to run from source code as you actively develop them.
To develop against the FAF infrastructure you should disable the service in tilt that you are actively developing. Once disabled you can start up your developed version. Some tweaks may need to be made to the default configuration parameters in the source code. The proper values can be found in the configMaps in each of the services kubernetes deploy yaml files.
The default test data that is loaded can be found in /sql/test-data.sql. This can be overridden by providing a new path with the tilt configuration key test-data-path when running tilt up or in the tilt_config.json file in the repository root directory.