This repository provides an entry point to the services and tools included in the MINT framework, including a pointer to their latest release or DOI. This page can also be browsed at https://mintproject.github.io/mint.
More detailed information about the features and servicesin MINT can be found in the project website: http://mint-project.info/
All the documentation for the MINT framework can be found in the MINT documentation page.
To test the MINT services on your local machine, we strongly recommend using the microk8s Kubernetes distribution. Follow the instructions in the microk8s documentation to install microk8s on your machine.
Tested on MacOS (arm64) and microk8s 1.28/stable. Tested on Ubuntu 22.04 (amd64) and microk8s 1.28/stable.
Install the microk8s using the following command:
$ microk8s install --memory 8
Support for 'multipass' needs to be set up. Would you like to do that now? [y/N]: y
Enable required addons:
$ microk8s enable dns
$ microk8s enable dashboard
$ microk8s enable hostpath-storage
$ microk8s enable ingress
To test, list the existing resources. It should be list multiple services, deployments, and pods. Please wait until all the resources are up and running.
$ microk8s kubectl get all --all-namespaces
Verify the node status
$ microk8s kubectl get nodes
Use the following commands to install the MINT services:
$ microk8s helm repo add mint https://mintproject.github.io/mint
$ microk8s helm repo update
$ microk8s helm install testing-mint mint/MINT --namespace mint --create-namespace
If you using MacOS Silicon, you need to install the arm64
version of the postgresql database.
WARNING: The arm64 image has not been tested and may not work as expected. Please use it at your own risk.
$ microk8s helm repo add mint https://mintproject.github.io/mint
$ microk8s helm repo update
$ microk8s helm install testing-mint mint/mint --namespace mint --create-namespace --set arm_support=true
Helm will returns the URL to access the MINT services. You can use the following command to get the URL:
The MINT system has been installed!
Please remember to edit your `/etc/hosts/`
After that, you can access to the MINT services
http://mint.local
http://ensemble-manager.mint.local
http://cromo.mint.local
http://mic.mint.local
http://datacatalog.mint.local
If you are using microk8s on a VM, need to get the IP address of the VM to access the MINT services. You can use the following command to get the IP address of the VM:
$ microk8s kubectl get node -o json | jq '.items[].status.addresses[] | select(.type=="InternalIP") | .address'
10.211.59.16
Then, edit the /etc/hosts
file and add the following lines:
$ sudo vim /etc/hosts
Add the following lines (replace the IP address with the IP address of the VM):
10.211.59.16 mint.local
10.211.59.16 cromo.mint.local
10.211.59.16 mic.mint.local
10.211.59.16 api.mic.mint.local
10.211.59.16 datacatalog.mint.local
10.211.59.16 endpoint.models.mint.local
10.211.59.16 graphql.mint.local
10.211.59.16 models.mint.local
10.211.59.16 api.models.mint.local
10.211.59.16 endpoint.models.mint.local
To remove the MINT services, use the following command:
$ helm uninstall mint -n mint
$ kubectl delete pvc --all -n mint
$ kubectl delete jobs --all -n mint
or
bash uninstall.sh
This repository contains the helm charts for the MINT services. The helm charts are used to deploy the services in a Kubernetes cluster. The helm charts are organized in the following folders:
charts
: contains the helm templates for the MINT servicesreleases
: contains the helm releases for the MINT servicesTo release a new version of the MINT charts, follow the following steps:
Edit the helm/Chart.yaml
file and update the version
field.
Run the following command to package the helm charts:
make release