Skip to content

Commit

Permalink
(Documentation) Improvements and fixes for rendered documentation (GH…
Browse files Browse the repository at this point in the history
… pages) (#1477)
  • Loading branch information
nikita-vanyasin authored Nov 7, 2023
1 parent 562cb5e commit b80bfb7
Show file tree
Hide file tree
Showing 20 changed files with 1,031 additions and 1,006 deletions.
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
# Change Log

## [master](https://github.com/arangodb/kube-arangodb/tree/master) (N/A)
- (Documentation) Improvements and fixes for rendered documentation (GH pages)

## [1.2.35](https://github.com/arangodb/kube-arangodb/tree/1.2.35) (2023-11-06)
- (Maintenance) Update go-driver to v1.6.0, update IsNotFound() checks
Expand Down
62 changes: 31 additions & 31 deletions docs/api/ArangoBackup.V1.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,33 +6,33 @@

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

[Code Reference](/pkg/apis/backup/v1/backup_spec_backoff.go#L31)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec_backoff.go#L31)

### .spec.backoff.max_delay: integer

MaxDelay defines maximum delay in seconds. Default to 600

[Code Reference](/pkg/apis/backup/v1/backup_spec_backoff.go#L29)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec_backoff.go#L29)

### .spec.backoff.max_iterations: integer

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

[Code Reference](/pkg/apis/backup/v1/backup_spec_backoff.go#L33)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec_backoff.go#L33)

### .spec.backoff.min_delay: integer

MinDelay defines minimum delay in seconds. Default to 30

[Code Reference](/pkg/apis/backup/v1/backup_spec_backoff.go#L27)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec_backoff.go#L27)

### .spec.deployment.name: string

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

This field is **immutable**: can't be changed after backup creation

[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L54)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L54)

### .spec.download.credentialsSecretName: string

Expand All @@ -43,15 +43,15 @@ Links:

This field is **immutable**: can't be changed after backup creation

[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L81)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L81)

### .spec.download.id: string

ID of the ArangoBackup to be downloaded

This field is **immutable**: can't be changed after backup creation

[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L89)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L89)

### .spec.download.repositoryURL: string

Expand All @@ -70,42 +70,42 @@ azure://test

This field is **immutable**: can't be changed after backup creation

[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L77)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L77)

### .spec.lifetime: integer

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

[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L47)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L47)

### .spec.options.allowInconsistent: boolean

AllowInconsistent flag for Backup creation request.
If this value is set to true, backup is taken even if we are not able to acquire lock.

Default Value: false
Default Value: `false`

This field is **immutable**: can't be changed after backup creation

[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L66)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L66)

### .spec.options.timeout: number

Timeout for Backup creation request in seconds.

Default Value: 30
Default Value: `30`

This field is **immutable**: can't be changed after backup creation

[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L61)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L61)

### .spec.policyName: string

PolicyName name of the ArangoBackupPolicy which created this Custom Resource

This field is **immutable**: can't be changed after backup creation

[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L42)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L42)

### .spec.upload.credentialsSecretName: string

Expand All @@ -116,7 +116,7 @@ Links:

This field is **immutable**: can't be changed after backup creation

[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L81)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L81)

### .spec.upload.repositoryURL: string

Expand All @@ -135,75 +135,75 @@ azure://test

This field is **immutable**: can't be changed after backup creation

[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L77)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L77)

## Status

### .status.available: boolean

Available Determines if we can restore from ArangoBackup

[Code Reference](/pkg/apis/backup/v1/backup_status.go#L36)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L36)

### .status.backoff.iterations: integer

[Code Reference](/pkg/apis/backup/v1/backup_status_backoff.go#L30)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status_backoff.go#L30)

### .status.backup.downloaded: boolean

Downloaded Determines if ArangoBackup has been downloaded.

[Code Reference](/pkg/apis/backup/v1/backup_status.go#L66)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L66)

### .status.backup.id: string

[Code Reference](/pkg/apis/backup/v1/backup_status.go#L56)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L56)

### .status.backup.imported: boolean

[Code Reference](/pkg/apis/backup/v1/backup_status.go#L67)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L67)

### .status.backup.keys: array

[Code Reference](/pkg/apis/backup/v1/backup_status.go#L70)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L70)

### .status.backup.numberOfDBServers: integer

NumberOfDBServers Cluster size of the Backup in ArangoDB

[Code Reference](/pkg/apis/backup/v1/backup_status.go#L62)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L62)

### .status.backup.potentiallyInconsistent: boolean

[Code Reference](/pkg/apis/backup/v1/backup_status.go#L58)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L58)

### .status.backup.sizeInBytes: integer

SizeInBytes Size of the Backup in ArangoDB.

[Code Reference](/pkg/apis/backup/v1/backup_status.go#L60)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L60)

### .status.backup.uploaded: boolean

Uploaded Determines if ArangoBackup has been uploaded

[Code Reference](/pkg/apis/backup/v1/backup_status.go#L64)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L64)

### .status.backup.version: string

[Code Reference](/pkg/apis/backup/v1/backup_status.go#L57)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_status.go#L57)

### .status.message: string

Message for the state this object is in.

[Code Reference](/pkg/apis/backup/v1/backup_state.go#L86)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_state.go#L86)

### .status.progress.jobID: string

JobID ArangoDB job ID for uploading or downloading

[Code Reference](/pkg/apis/backup/v1/backup_state.go#L109)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_state.go#L109)

### .status.progress.progress: string

Expand All @@ -214,7 +214,7 @@ Example:
90%
```

[Code Reference](/pkg/apis/backup/v1/backup_state.go#L112)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_state.go#L112)

### .status.state: string

Expand All @@ -235,5 +235,5 @@ Possible Values:
* Failed - state for failure
* Unavailable - state when Backup is not available on the ArangoDB. It can happen in case of upgrades, node restarts etc.

[Code Reference](/pkg/apis/backup/v1/backup_state.go#L80)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_state.go#L80)

38 changes: 19 additions & 19 deletions docs/api/ArangoBackupPolicy.V1.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,25 +6,25 @@

AllowConcurrent if false, ArangoBackup will not be created when previous Backups are not finished

Default Value: true
Default Value: `true`

[Code Reference](/pkg/apis/backup/v1/backup_policy_spec.go#L35)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_policy_spec.go#L35)

### .spec.maxBackups: integer

MaxBackups defines how many backups should be kept in history (per deployment). Oldest healthy Backups will be deleted.
If not specified or 0 then no limit is applied

Default Value: 0
Default Value: `0`

[Code Reference](/pkg/apis/backup/v1/backup_policy_spec.go#L43)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_policy_spec.go#L43)

### .spec.schedule: string

Schedule is cron-compatible specification of backup schedule
Parsed by https://godoc.org/github.com/robfig/cron

[Code Reference](/pkg/apis/backup/v1/backup_policy_spec.go#L32)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_policy_spec.go#L32)

### .spec.selector: meta.LabelSelector

Expand All @@ -33,58 +33,58 @@ DeploymentSelector Selector definition for selecting matching ArangoBackup Custo
Links:
* [Kubernetes Documentation](https://godoc.org/k8s.io/apimachinery/pkg/apis/meta/v1#LabelSelector)

[Code Reference](/pkg/apis/backup/v1/backup_policy_spec.go#L39)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_policy_spec.go#L39)

### .spec.template.backoff.iterations: integer

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

[Code Reference](/pkg/apis/backup/v1/backup_spec_backoff.go#L31)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec_backoff.go#L31)

### .spec.template.backoff.max_delay: integer

MaxDelay defines maximum delay in seconds. Default to 600

[Code Reference](/pkg/apis/backup/v1/backup_spec_backoff.go#L29)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec_backoff.go#L29)

### .spec.template.backoff.max_iterations: integer

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

[Code Reference](/pkg/apis/backup/v1/backup_spec_backoff.go#L33)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec_backoff.go#L33)

### .spec.template.backoff.min_delay: integer

MinDelay defines minimum delay in seconds. Default to 30

[Code Reference](/pkg/apis/backup/v1/backup_spec_backoff.go#L27)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec_backoff.go#L27)

### .spec.template.lifetime: integer

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

[Code Reference](/pkg/apis/backup/v1/backup_policy_spec.go#L61)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_policy_spec.go#L61)

### .spec.template.options.allowInconsistent: boolean

AllowInconsistent flag for Backup creation request.
If this value is set to true, backup is taken even if we are not able to acquire lock.

Default Value: false
Default Value: `false`

This field is **immutable**: can't be changed after backup creation

[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L66)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L66)

### .spec.template.options.timeout: number

Timeout for Backup creation request in seconds.

Default Value: 30
Default Value: `30`

This field is **immutable**: can't be changed after backup creation

[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L61)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L61)

### .spec.template.upload.credentialsSecretName: string

Expand All @@ -95,7 +95,7 @@ Links:

This field is **immutable**: can't be changed after backup creation

[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L81)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L81)

### .spec.template.upload.repositoryURL: string

Expand All @@ -114,19 +114,19 @@ azure://test

This field is **immutable**: can't be changed after backup creation

[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L77)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_spec.go#L77)

## Status

### .status.message: string

Message from the operator in case of failures - schedule not valid, ArangoBackupPolicy not valid

[Code Reference](/pkg/apis/backup/v1/backup_policy_status.go#L33)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_policy_status.go#L33)

### .status.scheduled: meta.Time

Scheduled Next scheduled time in UTC

[Code Reference](/pkg/apis/backup/v1/backup_policy_status.go#L31)
[Code Reference](https://github.com/arangodb/kube-arangodb/blob/1.2.35/pkg/apis/backup/v1/backup_policy_status.go#L31)

Loading

0 comments on commit b80bfb7

Please sign in to comment.