README.md 2.92 KB
Newer Older
Markus Scheidgen's avatar
Markus Scheidgen committed
1
2
3
[![pipeline status](https://gitlab.mpcdf.mpg.de/nomad-lab/nomad-FAIR/badges/master/pipeline.svg)](https://gitlab.mpcdf.mpg.de/nomad-lab/nomad-FAIR/commits/master)
[![coverage report](https://gitlab.mpcdf.mpg.de/nomad-lab/nomad-FAIR/badges/master/coverage.svg)](https://gitlab.mpcdf.mpg.de/nomad-lab/nomad-FAIR/commits/master)

4
5
This project tries and test approaches that might lead to an improved architecture for
nomad@FAIR.
6

7
8
## Getting started

Markus Scheidgen's avatar
Markus Scheidgen committed
9
Read the docs. The documentation is part of the source code. It covers aspects like
10
11
12
13
14
15
16
17
introduction, architecture, development setup/deployment, contributing, and API reference.

### Read the docs on the latest deployed version

Currently, there is only a *staging* version running at garching. There is
no real production system yet. You have to expect frequent down times and restarts.
You can access the running system and its documentation here:

Daniel Speckhard's avatar
Daniel Speckhard committed
18
[http://enc-staging-nomad.esc.rzg.mpg.de/nomad/docs](http://enc-staging-nomad.esc.rzg.mpg.de/fairdi/nomad/v0.3.0/docs)
19
20

### Generate the docs from the source
21

22
First, clone this repo and init its submodules:
23
```
24
25
git clone git@gitlab.mpcdf.mpg.de:nomad-lab/nomad-FAIR.git
cd nomad-FAIR
26
git submodules init --depth 1
27
28
```

29
Second, create and source your own virtual python environment:
30
```
31
pip install virtualenv
32
virtualenv -p `which python3` .pyenv
33
source .pyenv/bin/activate
34
35
```

36
37
Third, install the development dependencies, including the documentation system
[sphinx](http://www.sphinx-doc.org/en/master/index.html):
38
```
39
40
pip install --upgrade pip
pip install --upgrade setuptools
Markus Scheidgen's avatar
Markus Scheidgen committed
41
pip install -r requirements.txt
42
43
```

44
Forth, generate the documentation:
45
```
46
47
cd docs
make html
48
49
```

50
Conintue with reading the documentation for further setup and contribution guidelines:
51
```
52
cd .build/html
53
python -m http.server 8888
54
```
55
56
Open [http://localhost:8888/html/setup.html](http://localhost:8888/html/setup.html) in
your browser.
Markus Scheidgen's avatar
Markus Scheidgen committed
57
58
59

## Change log

60
61
62
63
64
### v0.5.0
- Raw file API with support to list directories. This replaces the `files` calculation
  metadata key. It was necessary due to arbitrary large lists of *auxfiles* in some
  calculations.

65
66
67
68
69
70
### v0.4.6
- admin commands to directly manipulate upload data
- additional migration scripts
- fixed system normalizer to understand indexed atom labels correctly
- many minor bugfixes

71
72
73
74
75
### v0.4.5
- improved uploads view with published uploads
- support for publishing to the existing nomad CoE repository
- many minor bugfixes

76
### v0.4.4
77
- improved GUI navigation
78
79
- support for multiple domains
- info API endpoint
Markus Scheidgen's avatar
Markus Scheidgen committed
80
- metainfo browser
Markus Scheidgen's avatar
Markus Scheidgen committed
81
- support for latest exciting version
Markus Scheidgen's avatar
Markus Scheidgen committed
82
- bugfixes in system normalization
Markus Scheidgen's avatar
Markus Scheidgen committed
83
- many minor bugfixes
84

85
86
87
88
89
90
91
### v0.4.3
- more flexible celery routing
- config via nomad.yml
- repo_db can be disabled
- publishing of calculations with failed processing
- cli for managing running processing tasks

Markus Scheidgen's avatar
Markus Scheidgen committed
92
93
94
### v0.4.2
- bugfixes regarding the migration
- better migration configurability and reproducibility
Markus Scheidgen's avatar
Markus Scheidgen committed
95
- scales to multi node kubernetes deployment