Mentions légales du service

Skip to content
Snippets Groups Projects
Lucas Nussbaum's avatar
Lucas Nussbaum authored
be72fb35
History

FIXME update this doc

The reference API data of Grid'5000 is stored in a git repository as JSON files. Those files are organized into hierarchical folders (see data/). The git repository comes with scripts to ease the generation of those API files (see generators/). The generator uses data from input/. The node information (input/grid5000/sites//clusters//nodes/*.yaml) is fetched using g5k-checks. The other input files are created manually.

The git repository also includes scripts for generating:

  • The OAR properties ie. the node information that is registered in OAR databases. OAR properties allow user to select resources matching their experiment requirements.
  • The configuration files of the following puppet modules: bindg5kb, conmang5k, dhcpg5k, kadeployg5k and lanpowerg5k.

Automated tasks are provided to validate and generate data:

rake oar:properties          # Generate oar properties

rake puppet:all              # Launch all puppet generators

rake puppet:bindg5k          # Generate bindg5k configuration

rake puppet:conmang5k        # Generate conmang5k configuration

rake puppet:dhcpg5k          # Generate dhcpg5k configuration

rake puppet:kadeployg5k      # Generate kadeployg5k configuration

rake puppet:kavlang5k        # Generate kavlang5k configuration

rake puppet:lanpowerg5k      # Generate lanpowerg5k configuration

rake reference-api           # Creates json data from inputs

rake validators:homogeneity  # Check homogeneity of clusters

rake validators:schema       # Check input data schema validity

rake wiki:all                # Launch all wiki generators

rake wiki:cpu_parameters     # Generate the media parts for cpu_parameters page

rake wiki:oar_properties     # Generate the media parts for oar_properties page

rake wiki:disk_reservation   # Generate the media parts for disk_reservation page

rake wiki:hardware           # Generate the media parts for hardware page

rake wiki:site_hardware      # Generate the media parts for site hardware pages

rake wiki:site_network       # Generate the media parts for site network pages

For more information about generators and validators, please see generators/README.md.

Credentials

all tools should use ~/.grid5000_api.yml. Example:

 uri: https://api.grid5000.fr/
 username: username
 password: password
 version: stable