ovs-cluster-agent 2.2.3

Description:

ovsclusteragent 2.2.3

cluster-agent
Table of contents

Project setup

Dependencies


Install the package
Setup parameters
Local usage example

Project Setup
Dependencies

python3-venv

Install the package
To install the package from Pypi simply run pip install ovs-cluster-agent.
Setup parameters

Setup dependencies
You can use whenever dependency manager you want to. Just run the command below (and the ones following) on behalf of the manager you prefer.

make dependencies


Setup .env parameters

CLUSTER_AGENT_BASE_API_URL="<base-api-url>"
CLUSTER_AGENT_BASE_SLURMRESTD_URL="<slurmrestd-endpoint>"
CLUSTER_AGENT_X_SLURM_USER_NAME="<slurmrestd-user-name>"
CLUSTER_AGENT_SLURMRESTD_JWT_KEY_PATH="/path/to/the/jwt/secret/key"
CLUSTER_AGENT_SLURMRESTD_JWT_KEY_STRING="jwt-secret-key-in-plain-text"
CLUSTER_AGENT_SENTRY_DSN="<sentry-dsn-key>"
CLUSTER_AGENT_OIDC_DOMAIN="<OIDC-domain>"
CLUSTER_AGENT_OIDC_AUDIENCE="<OIDC-audience>"
CLUSTER_AGENT_OIDC_CLIENT_ID="<OIDC-app-client-id>"
CLUSTER_AGENT_OIDC_CLIENT_SECRET="<OIDC-app-client-secret>"
CLUSTER_AGENT_LDAP_HOST="<hostname-for-ldap>"
CLUSTER_AGENT_LDAP_DOMAIN="<LDAP-domain>" # Defaults to match LDAP_HOST
CLUSTER_AGENT_LDAP_USERNAME="<admin-user>"
CLUSTER_AGENT_LDAP_PASSWORD="<admin-password>"

NOTE: CLUSTER_AGENT_SENTRY_DSN is optional. If you do not pass it the agent understands Sentry will not be used.
NOTE: When both CLUSTER_AGENT_SLURMRESTD_JWT_KEY_PATH and CLUSTER_AGENT_SLURMRESTD_JWT_KEY_STRING are passed, the agent will completely ignore the CLUSTER_AGENT_SLURMRESTD_JWT_KEY_PATH and will prioritize the CLUSTER_AGENT_SLURMRESTD_JWT_KEY_STRING. Beware this behaviour.
Local usage example

Run app

agentrun

Note: this command assumes you're inside a virtual environment in which the package is installed.
NOTE: beware you should care about having the same user name you're using to run the code in the slurmctld node. For example, if cluster_agent will run the make run command then the slurmctld node also must have a user called cluster_agent.