Skip to content

Commit 1aa6b72

Browse files
ajanikowSimran-B
andauthored
[Documentation] Profile Label (#1808)
Co-authored-by: Simran <[email protected]>
1 parent 6e022ac commit 1aa6b72

File tree

5 files changed

+112
-6
lines changed

5 files changed

+112
-6
lines changed

docs/api/ArangoDeployment.V1.md

Lines changed: 28 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5886,9 +5886,21 @@ Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2
58865886

58875887
***
58885888

5889-
### .spec.sync.tls.sni.mapping.\<string\>
5889+
### .spec.sync.tls.sni.mapping
58905890

5891-
Type: `array` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/deployment/v1/tls_sni_spec.go#L30)</sup>
5891+
Type: `map[string][]string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/deployment/v1/tls_sni_spec.go#L36)</sup>
5892+
5893+
The mapping of the Server Name Indication options.
5894+
5895+
Links:
5896+
* [Server Name Indication](https://docs.arangodb.com/stable/components/arangodb-server/options/#--sslserver-name-indication)
5897+
5898+
Example:
5899+
```yaml
5900+
mapping:
5901+
secret:
5902+
- domain.example.com
5903+
```
58925904

58935905
***
58945906

@@ -7834,9 +7846,21 @@ Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2
78347846

78357847
***
78367848

7837-
### .spec.tls.sni.mapping.\<string\>
7849+
### .spec.tls.sni.mapping
78387850

7839-
Type: `array` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/deployment/v1/tls_sni_spec.go#L30)</sup>
7851+
Type: `map[string][]string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.43/pkg/apis/deployment/v1/tls_sni_spec.go#L36)</sup>
7852+
7853+
The mapping of the Server Name Indication options.
7854+
7855+
Links:
7856+
* [Server Name Indication](https://docs.arangodb.com/stable/components/arangodb-server/options/#--sslserver-name-indication)
7857+
7858+
Example:
7859+
```yaml
7860+
mapping:
7861+
secret:
7862+
- domain.example.com
7863+
```
78407864

78417865
***
78427866

docs/integration-sidecar.md

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,72 @@ has_toc: false
1010

1111
## Profile
1212

13+
### Injection
14+
15+
#### Selector
16+
17+
Using [Selector](./api/ArangoProfile.V1Beta1.md) `.spec.selectors.label` you can select which profiles are going to be applied on the Pod.
18+
19+
To not match any pod:
20+
```yaml
21+
apiVersion: scheduler.arangodb.com/v1beta1
22+
kind: ArangoProfile
23+
metadata:
24+
name: example
25+
spec:
26+
selectors:
27+
label:
28+
matchLabels: {}
29+
template: ...
30+
```
31+
32+
To match all pods:
33+
```yaml
34+
apiVersion: scheduler.arangodb.com/v1beta1
35+
kind: ArangoProfile
36+
metadata:
37+
name: example
38+
spec:
39+
selectors:
40+
label:
41+
matchLabels: {}
42+
template: ...
43+
```
44+
45+
To match specific pods (with label key=value):
46+
```yaml
47+
apiVersion: scheduler.arangodb.com/v1beta1
48+
kind: ArangoProfile
49+
metadata:
50+
name: example
51+
spec:
52+
selectors:
53+
label:
54+
matchLabels:
55+
key: value
56+
template: ...
57+
```
58+
59+
#### Selection
60+
61+
Profiles can be injected using name (not only selectors).
62+
63+
In order to inject specific profiles to the pod use label (split by `,`):
64+
65+
```yaml
66+
metadata:
67+
labels:
68+
profiles.arangodb.com/profiles: "gpu"
69+
```
70+
71+
or
72+
73+
```yaml
74+
metadata:
75+
labels:
76+
profiles.arangodb.com/profiles: "gpu,internal"
77+
```
78+
1379
## Sidecar
1480

1581
### Resource Types

pkg/apis/deployment/v1/tls_sni_spec.go

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
//
22
// DISCLAIMER
33
//
4-
// Copyright 2016-2024 ArangoDB GmbH, Cologne, Germany
4+
// Copyright 2016-2025 ArangoDB GmbH, Cologne, Germany
55
//
66
// Licensed under the Apache License, Version 2.0 (the "License");
77
// you may not use this file except in compliance with the License.
@@ -27,6 +27,12 @@ import (
2727

2828
// TLSSNISpec holds TLS SNI additional certificates
2929
type TLSSNISpec struct {
30+
// The mapping of the Server Name Indication options.
31+
// +doc/type: map[string][]string
32+
// +doc/example: mapping:
33+
// +doc/example: secret:
34+
// +doc/example: - domain.example.com
35+
// +doc/link: Server Name Indication|https://docs.arangodb.com/stable/components/arangodb-server/options/#--sslserver-name-indication
3036
Mapping map[string][]string `json:"mapping,omitempty"`
3137
}
3238

pkg/apis/deployment/v2alpha1/tls_sni_spec.go

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
//
22
// DISCLAIMER
33
//
4-
// Copyright 2016-2024 ArangoDB GmbH, Cologne, Germany
4+
// Copyright 2016-2025 ArangoDB GmbH, Cologne, Germany
55
//
66
// Licensed under the Apache License, Version 2.0 (the "License");
77
// you may not use this file except in compliance with the License.
@@ -27,6 +27,12 @@ import (
2727

2828
// TLSSNISpec holds TLS SNI additional certificates
2929
type TLSSNISpec struct {
30+
// The mapping of the Server Name Indication options.
31+
// +doc/type: map[string][]string
32+
// +doc/example: mapping:
33+
// +doc/example: secret:
34+
// +doc/example: - domain.example.com
35+
// +doc/link: Server Name Indication|https://docs.arangodb.com/stable/components/arangodb-server/options/#--sslserver-name-indication
3036
Mapping map[string][]string `json:"mapping,omitempty"`
3137
}
3238

pkg/crd/crds/database-deployment.schema.generated.yaml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12510,6 +12510,7 @@ v1:
1251012510
items:
1251112511
type: string
1251212512
type: array
12513+
description: The mapping of the Server Name Indication options.
1251312514
type: object
1251412515
type: object
1251512516
ttl:
@@ -16960,6 +16961,7 @@ v1:
1696016961
items:
1696116962
type: string
1696216963
type: array
16964+
description: The mapping of the Server Name Indication options.
1696316965
type: object
1696416966
type: object
1696516967
ttl:
@@ -29512,6 +29514,7 @@ v2alpha1:
2951229514
items:
2951329515
type: string
2951429516
type: array
29517+
description: The mapping of the Server Name Indication options.
2951529518
type: object
2951629519
type: object
2951729520
ttl:
@@ -33962,6 +33965,7 @@ v2alpha1:
3396233965
items:
3396333966
type: string
3396433967
type: array
33968+
description: The mapping of the Server Name Indication options.
3396533969
type: object
3396633970
type: object
3396733971
ttl:

0 commit comments

Comments
 (0)