1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
# `rook-client` Python API Classes
The Rook CRDs are evolving over time and to verify that clients make use of the correct definitions,
this project provides generated API classes to let users write correct clients easily.
Right now, it supports three operators:
* Ceph
* Edgefs
* Cassandra
It is used to type check client code against the Rook API using [mypy](mypy-lang.org).
Inspired by [kubernetes-client/python](https://github.com/kubernetes-client/python/tree/master/kubernetes/client/models)
Main uses case is the mgr/rook orchestrator module of the Ceph MGR
## Code Generation
This project contains a `generate_model_classes.py` which can generate
model classes from Kubernetes CRDs and is **independent** of Rook.
Usage:
```
python generate_model_classes.py <crds.yaml> <output-folder>
```
## Installing `rook-client`
To install `rook-client`, run:
```bash
pip install -e 'git+https://github.com/ceph/rook-client-python#egg=rook-client'
```
## Usage
```python
def objectstore(api_name, name, namespace, instances):
from rook_client.ceph import cephobjectstore as cos
rook_os = cos.CephObjectStore(
apiVersion=api_name,
metadata=dict(
name=name,
namespace=namespace
),
spec=cos.Spec(
metadataPool=cos.MetadataPool(
failureDomain='host',
replicated=cos.Replicated(
size=1
)
),
dataPool=cos.DataPool(
failureDomain='osd',
replicated=cos.Replicated(
size=1
)
),
gateway=cos.Gateway(
port=80,
instances=instances
)
)
)
return rook_os.to_json()
```
## Demo
## Regenerate
To re-generate the python files, run
```bash
./generate.sh
```
|
