Skip to content

Commit 6ce71f5

Browse files
sync-gh-pages: docs and Helm chart 1.2.36 (#1571)
1 parent f166a53 commit 6ce71f5

File tree

91 files changed

+3739
-936
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

91 files changed

+3739
-936
lines changed

docs/README.md

Lines changed: 0 additions & 54 deletions
This file was deleted.

docs/api/ArangoBackup.V1.md

Lines changed: 51 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,48 @@
1+
---
2+
layout: page
3+
parent: CRD reference
4+
title: ArangoBackup V1
5+
---
6+
17
# API Reference for ArangoBackup V1
28

39
## Spec
410

511
### .spec.backoff.iterations
612

7-
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec_backoff.go#L31)</sup>
13+
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_spec_backoff.go#L31)</sup>
814

915
Iterations defines number of iterations before reaching MaxDelay. Default to 5
1016

1117
***
1218

1319
### .spec.backoff.max_delay
1420

15-
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec_backoff.go#L29)</sup>
21+
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_spec_backoff.go#L29)</sup>
1622

1723
MaxDelay defines maximum delay in seconds. Default to 600
1824

1925
***
2026

2127
### .spec.backoff.max_iterations
2228

23-
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec_backoff.go#L33)</sup>
29+
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_spec_backoff.go#L33)</sup>
2430

2531
MaxIterations defines maximum number of iterations after backoff will be disabled. Default to nil (no limit)
2632

2733
***
2834

2935
### .spec.backoff.min_delay
3036

31-
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec_backoff.go#L27)</sup>
37+
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_spec_backoff.go#L27)</sup>
3238

3339
MinDelay defines minimum delay in seconds. Default to 30
3440

3541
***
3642

3743
### .spec.deployment.name
3844

39-
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L54)</sup>
45+
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_spec.go#L54)</sup>
4046

4147
Name of the ArangoDeployment Custom Resource within same namespace as ArangoBackup Custom Resource.
4248

@@ -46,7 +52,7 @@ This field is **immutable**: can't be changed after backup creation
4652

4753
### .spec.download.credentialsSecretName
4854

49-
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L81)</sup>
55+
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_spec.go#L81)</sup>
5056

5157
CredentialsSecretName is the name of the secret used while accessing repository
5258

@@ -59,7 +65,7 @@ This field is **immutable**: can't be changed after backup creation
5965

6066
### .spec.download.id
6167

62-
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L89)</sup>
68+
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_spec.go#L89)</sup>
6369

6470
ID of the ArangoBackup to be downloaded
6571

@@ -69,7 +75,7 @@ This field is **immutable**: can't be changed after backup creation
6975

7076
### .spec.download.repositoryURL
7177

72-
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L77)</sup>
78+
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_spec.go#L77)</sup>
7379

7480
RepositoryURL is the URL path for file storage
7581
Same repositoryURL needs to be defined in `credentialsSecretName` if protocol is other than local.
@@ -90,15 +96,15 @@ This field is **immutable**: can't be changed after backup creation
9096

9197
### .spec.lifetime
9298

93-
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L47)</sup>
99+
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_spec.go#L47)</sup>
94100

95101
Lifetime is the time after which the backup will be deleted. Format: "1.5h" or "2h45m".
96102

97103
***
98104

99105
### .spec.options.allowInconsistent
100106

101-
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L66)</sup>
107+
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_spec.go#L66)</sup>
102108

103109
AllowInconsistent flag for Backup creation request.
104110
If this value is set to true, backup is taken even if we are not able to acquire lock.
@@ -111,7 +117,7 @@ This field is **immutable**: can't be changed after backup creation
111117

112118
### .spec.options.timeout
113119

114-
Type: `number` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L61)</sup>
120+
Type: `number` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_spec.go#L61)</sup>
115121

116122
Timeout for Backup creation request in seconds. Works only when AsyncBackupCreation feature is set to false.
117123

@@ -123,7 +129,7 @@ This field is **immutable**: can't be changed after backup creation
123129

124130
### .spec.policyName
125131

126-
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L42)</sup>
132+
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_spec.go#L42)</sup>
127133

128134
PolicyName name of the ArangoBackupPolicy which created this Custom Resource
129135

@@ -133,7 +139,7 @@ This field is **immutable**: can't be changed after backup creation
133139

134140
### .spec.upload.credentialsSecretName
135141

136-
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L81)</sup>
142+
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_spec.go#L81)</sup>
137143

138144
CredentialsSecretName is the name of the secret used while accessing repository
139145

@@ -146,7 +152,7 @@ This field is **immutable**: can't be changed after backup creation
146152

147153
### .spec.upload.repositoryURL
148154

149-
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L77)</sup>
155+
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_spec.go#L77)</sup>
150156

151157
RepositoryURL is the URL path for file storage
152158
Same repositoryURL needs to be defined in `credentialsSecretName` if protocol is other than local.
@@ -167,99 +173,99 @@ This field is **immutable**: can't be changed after backup creation
167173

168174
### .status.available
169175

170-
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L36)</sup>
176+
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_status.go#L36)</sup>
171177

172178
Available Determines if we can restore from ArangoBackup
173179

174180
***
175181

176182
### .status.backoff.iterations
177183

178-
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status_backoff.go#L30)</sup>
184+
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_status_backoff.go#L30)</sup>
179185

180186
***
181187

182188
### .status.backup.downloaded
183189

184-
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L66)</sup>
190+
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_status.go#L66)</sup>
185191

186192
Downloaded Determines if ArangoBackup has been downloaded.
187193

188194
***
189195

190196
### .status.backup.id
191197

192-
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L56)</sup>
198+
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_status.go#L56)</sup>
193199

194200
***
195201

196202
### .status.backup.imported
197203

198-
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L67)</sup>
204+
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_status.go#L67)</sup>
199205

200206
***
201207

202208
### .status.backup.keys
203209

204-
Type: `array` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L70)</sup>
210+
Type: `array` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_status.go#L70)</sup>
205211

206212
***
207213

208214
### .status.backup.numberOfDBServers
209215

210-
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L62)</sup>
216+
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_status.go#L62)</sup>
211217

212218
NumberOfDBServers Cluster size of the Backup in ArangoDB
213219

214220
***
215221

216222
### .status.backup.potentiallyInconsistent
217223

218-
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L58)</sup>
224+
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_status.go#L58)</sup>
219225

220226
***
221227

222228
### .status.backup.sizeInBytes
223229

224-
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L60)</sup>
230+
Type: `integer` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_status.go#L60)</sup>
225231

226232
SizeInBytes Size of the Backup in ArangoDB.
227233

228234
***
229235

230236
### .status.backup.uploaded
231237

232-
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L64)</sup>
238+
Type: `boolean` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_status.go#L64)</sup>
233239

234240
Uploaded Determines if ArangoBackup has been uploaded
235241

236242
***
237243

238244
### .status.backup.version
239245

240-
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L57)</sup>
246+
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_status.go#L57)</sup>
241247

242248
***
243249

244250
### .status.message
245251

246-
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_state.go#L88)</sup>
252+
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_state.go#L91)</sup>
247253

248254
Message for the state this object is in.
249255

250256
***
251257

252258
### .status.progress.jobID
253259

254-
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_state.go#L111)</sup>
260+
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_state.go#L114)</sup>
255261

256262
JobID ArangoDB job ID for uploading or downloading
257263

258264
***
259265

260266
### .status.progress.progress
261267

262-
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_state.go#L114)</sup>
268+
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_state.go#L117)</sup>
263269

264270
Progress ArangoDB job progress in percents
265271

@@ -272,22 +278,25 @@ Example:
272278

273279
### .status.state
274280

275-
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_state.go#L82)</sup>
281+
Type: `string` <sup>[\[ref\]](https://github.com/arangodb/kube-arangodb/blob/1.2.36/pkg/apis/backup/v1/backup_state.go#L85)</sup>
276282

277283
State holds the current high level state of the backup
278284

279285
Possible Values:
280-
* Pending (default) - state in which Custom Resource is queued. If Backup is possible changed to "Scheduled"
281-
* Scheduled - state which will start create/download process
282-
* Download - state in which download request will be created on ArangoDB
283-
* DownloadError - state when download failed
284-
* Downloading - state for downloading progress
285-
* Create - state for creation, field available set to true
286-
* Upload - state in which upload request will be created on ArangoDB
287-
* Uploading - state for uploading progress
288-
* UploadError - state when uploading failed
289-
* Ready - state when Backup is finished
290-
* Deleted - state when Backup was once in ready, but has been deleted
291-
* Failed - state for failure
292-
* Unavailable - state when Backup is not available on the ArangoDB. It can happen in case of upgrades, node restarts etc.
286+
* `""` (default) - state for un-initialized Custom Resource
287+
* `"Pending"` - state in which Custom Resource is queued. If Backup is possible changed to "Scheduled"
288+
* `"Scheduled"` - state which will start create/download process
289+
* `"Download"` - state in which download request will be created on ArangoDB
290+
* `"DownloadError"` - state when download failed
291+
* `"Downloading"` - state for downloading progress
292+
* `"Create"` - state for backup when it is scheduled for creation, field available set to true
293+
* `"Creating"` - state for backup when it is creating
294+
* `"CreateError"` - state for backup when it is creation failed
295+
* `"Upload"` - state in which upload request will be created on ArangoDB
296+
* `"Uploading"` - state for uploading progress
297+
* `"UploadError"` - state when uploading failed
298+
* `"Ready"` - state when Backup is finished
299+
* `"Deleted"` - state when Backup was once in ready, but has been deleted
300+
* `"Failed"` - state for failure
301+
* `"Unavailable"` - state when Backup is not available on the ArangoDB. It can happen in case of upgrades, node restarts etc.
293302

0 commit comments

Comments
 (0)