From fb8f398b3b6f4600017ee2423a32b32cfbed5fe6 Mon Sep 17 00:00:00 2001 From: Nikita Vaniasin Date: Wed, 3 Jan 2024 16:34:15 +0100 Subject: [PATCH 1/3] Improve documentation rendering for GitHub Pages - remove manually-created table of contents (now auto-created by jekyll) - add pages metadata for implementing proper navigation menus - escape special symbols for jekyll site generator - deduplicate info: Main readme.md and docs/readme.md; redirect added All old URLs are expected to work --- CHANGELOG.md | 1 + README.md | 22 ++++++-- docs/README.md | 56 ------------------- docs/api/ArangoBackup.V1.md | 6 ++ docs/api/ArangoBackupPolicy.V1.md | 6 ++ docs/api/ArangoDeployment.V1.md | 6 ++ docs/api/ArangoDeploymentReplication.V1.md | 6 ++ docs/api/ArangoLocalStorage.V1Alpha.md | 6 ++ docs/api/ArangoMLBatchJob.V1Alpha1.md | 6 ++ docs/api/ArangoMLCronJob.V1Alpha1.md | 6 ++ docs/api/ArangoMLExtension.V1Alpha1.md | 6 ++ docs/api/ArangoMLStorage.V1Alpha1.md | 6 ++ docs/api/ArangoMember.V1.md | 6 ++ docs/api/README.md | 19 ++----- docs/backup-resource.md | 6 ++ docs/backuppolicy-resource.md | 6 ++ docs/crds.md | 8 +++ docs/dashboards.md | 6 ++ ...ployment-replication-resource-reference.md | 11 ++++ docs/deployment-resource-reference.md | 6 ++ docs/design/README.md | 17 ++---- docs/design/api.md | 6 ++ docs/design/backup.md | 6 ++ docs/design/constraints.md | 6 ++ docs/design/exporter.md | 6 ++ docs/design/health.md | 6 ++ docs/design/lifecycle_hooks_and_finalizers.md | 6 ++ docs/design/pod_eviction_and_replacement.md | 6 ++ docs/design/pod_name_versus_cluster_id.md | 6 ++ docs/design/resources_and_labels.md | 6 ++ docs/design/topology_awareness.md | 6 ++ docs/driver-configuration.md | 2 + docs/features/README.md | 6 ++ docs/features/deployment_spec_defaults.md | 6 ++ docs/features/ephemeral_volumes.md | 6 ++ docs/features/failover_leader_service.md | 6 ++ docs/features/rebalancer.md | 6 ++ docs/features/rebalancer_v2.md | 6 ++ docs/features/rebuild_out_synced_shards.md | 6 ++ docs/features/secured_containers.md | 6 ++ docs/generated/actions.md | 6 ++ docs/generated/metrics/README.md | 8 +++ ...db_operator_agency_cache_health_present.md | 6 ++ .../arangodb_operator_agency_cache_healthy.md | 6 ++ .../arangodb_operator_agency_cache_leaders.md | 6 ++ ...rator_agency_cache_member_commit_offset.md | 6 ++ ...db_operator_agency_cache_member_serving.md | 6 ++ .../arangodb_operator_agency_cache_present.md | 6 ++ .../arangodb_operator_agency_cache_serving.md | 6 ++ .../arangodb_operator_agency_errors.md | 6 ++ .../arangodb_operator_agency_fetches.md | 6 ++ .../metrics/arangodb_operator_agency_index.md | 6 ++ .../arangodb_operator_engine_assertions.md | 6 ++ .../arangodb_operator_engine_ops_alerts.md | 6 ++ ...angodb_operator_engine_panics_recovered.md | 6 ++ ...erator_kubernetes_client_request_errors.md | 6 ++ ...odb_operator_kubernetes_client_requests.md | 6 ++ ...godb_operator_kubernetes_events_created.md | 13 ----- ...members_unexpected_container_exit_codes.md | 6 ++ .../arangodb_operator_rebalancer_enabled.md | 6 ++ ...ngodb_operator_rebalancer_moves_current.md | 6 ++ ...angodb_operator_rebalancer_moves_failed.md | 6 ++ ...odb_operator_rebalancer_moves_generated.md | 6 ++ ...odb_operator_rebalancer_moves_succeeded.md | 6 ++ ...tor_resources_arangodeployment_accepted.md | 6 ++ ...urces_arangodeployment_immutable_errors.md | 6 ++ ...r_resources_arangodeployment_propagated.md | 6 ++ ...ources_arangodeployment_status_restores.md | 6 ++ ...tor_resources_arangodeployment_uptodate.md | 6 ++ ...rces_arangodeployment_validation_errors.md | 6 ++ ...rces_arangodeploymentreplication_active.md | 6 ++ ...rces_arangodeploymentreplication_failed.md | 6 ++ docs/helm.md | 6 ++ docs/how-to/README.md | 19 ++----- docs/how-to/additional_configuration.md | 6 ++ docs/how-to/arch_change.md | 6 ++ docs/how-to/configuring_tz.md | 6 ++ docs/how-to/debugging.md | 6 ++ docs/how-to/logging.md | 6 ++ docs/how-to/maintenance.md | 6 ++ docs/how-to/override_detected_memory.md | 6 ++ docs/how-to/recovery.md | 6 ++ docs/how-to/rotate-pod.md | 6 ++ docs/how-to/set_license.md | 6 ++ docs/how-to/set_root_user_password.md | 6 ++ docs/index.html | 4 ++ docs/providers/eks/README.md | 5 ++ docs/storage-resource.md | 6 ++ docs/tls.md | 2 + docs/using-the-operator.md | 6 ++ internal/docs_test.go | 47 ++++++++-------- internal/features_test.go | 6 ++ internal/metrics.item.tmpl | 6 ++ 93 files changed, 569 insertions(+), 133 deletions(-) delete mode 100644 docs/README.md delete mode 100644 docs/generated/metrics/arangodb_operator_kubernetes_events_created.md create mode 100644 docs/index.html diff --git a/CHANGELOG.md b/CHANGELOG.md index 1b4bf39c7..c780dcec7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,7 @@ # Change Log ## [master](https://github.com/arangodb/kube-arangodb/tree/master) (N/A) +- (Documentation) Improve documentation rendering for GitHub Pages ## [1.2.36](https://github.com/arangodb/kube-arangodb/tree/1.2.36) (2024-01-08) - (Documentation) Improvements and fixes for rendered documentation (GH pages) diff --git a/README.md b/README.md index a72140243..c4568c257 100644 --- a/README.md +++ b/README.md @@ -2,17 +2,29 @@ [![Docker Pulls](https://img.shields.io/docker/pulls/arangodb/kube-arangodb.svg)](https://hub.docker.com/r/arangodb/kube-arangodb/) -ArangoDB Kubernetes Operator helps to run ArangoDB deployments -on Kubernetes clusters. +The ArangoDB Kubernetes Operator (`kube-arangodb`) is a set of operators +that you deploy in your Kubernetes cluster to: +- Manage deployments of the [ArangoDB database](https://arangodb.com/) +- Manage backups +- Provide `PersistentVolumes` on local storage of your nodes for optimal storage performance. +- Configure ArangoDB Datacenter-to-Datacenter Replication + +Each of these uses involves a different custom resource: +- Use an [ArangoDeployment resource](docs/deployment-resource-reference.md) to create an ArangoDB database deployment. +- Use an [ArangoMember resource](docs/api/ArangoMember.V1.md) to observe and adjust individual deployment members. +- Use an [ArangoBackup](docs/backup-resource.md) and [ArangoBackupPolicy](docs/backuppolicy-resource.md) resources to create ArangoDB backups. +- Use an [ArangoLocalStorage resource](docs/storage-resource.md) to provide local `PersistentVolumes` for optimal I/O performance. +- Use an [ArangoDeploymentReplication resource](docs/deployment-replication-resource-reference.md) to configure ArangoDB Datacenter-to-Datacenter Replication. + +Continue with [Using the ArangoDB Kubernetes Operator](docs/using-the-operator.md) +to learn how to install the ArangoDB Kubernetes operator and create your first deployment. -To get started, follow the Installation instructions below and/or -read the [tutorial](docs/using-the-operator.md). ## State The ArangoDB Kubernetes Operator is Production ready. -[Documentation](docs/README.md) +[Documentation](https://arangodb.github.io/kube-arangodb/) ### Limits diff --git a/docs/README.md b/docs/README.md deleted file mode 100644 index 7fbddbadc..000000000 --- a/docs/README.md +++ /dev/null @@ -1,56 +0,0 @@ -# ArangoDB Kubernetes Operator - -- [Intro](#intro) -- [Using the ArangoDB Kubernetes Operator](using-the-operator.md) -- [Architecture overview](design/README.md) -- [Features description and usage](features/README.md) -- [Custom Resources API Reference](api/README.md) -- [Operator Metrics & Alerts](generated/metrics/README.md) -- [Operator Actions](generated/actions.md) -- [Authentication](authentication.md) -- [Custom resources overview](crds.md): - - [ArangoDeployment](deployment-resource-reference.md) - - [ArangoDeploymentReplication](deployment-replication-resource-reference.md) - - [ArangoLocalStorage](storage-resource.md) - - [Backup](backup-resource.md) - - [BackupPolicy](backuppolicy-resource.md) - - [ArangoMLExtension](mlextension-resource.md) -- [Configuration and secrets](configuration-and-secrets.md) -- [Configuring your driver for ArangoDB access](driver-configuration.md) -- [Using Helm](helm.md) -- [Collecting metrics](metrics.md) -- [Services & Load balancer](services-and-load-balancer.md) -- [Storage configuration](storage.md) -- [Secure connections (TLS)](tls.md) -- [Upgrading ArangoDB version](upgrading.md) -- [Scaling your ArangoDB deployment](scaling.md) -- [Draining the Kubernetes nodes](draining-nodes.md) -- Known issues (TBD) -- [Troubleshooting](troubleshooting.md) -- [How-to ...](how-to/README.md) - -## Intro - -The ArangoDB Kubernetes Operator (`kube-arangodb`) is a set of operators -that you deploy in your Kubernetes cluster to: - -- Manage deployments of the ArangoDB database -- Manage backups -- Provide `PersistentVolumes` on local storage of your nodes for optimal storage performance. -- Configure ArangoDB Datacenter-to-Datacenter Replication - -Each of these uses involves a different custom resource. - -- Use an [ArangoDeployment resource](deployment-resource-reference.md) to create an ArangoDB database deployment. -- Use an [ArangoMember resource](api/ArangoMember.V1.md) to observe and adjust individual deployment members. -- Use an [ArangoBackup](backup-resource.md) and [ArangoBackupPolicy](backuppolicy-resource.md) resources to create ArangoDB backups. -- Use an [ArangoLocalStorage resource](storage-resource.md) to provide local `PersistentVolumes` for optimal I/O performance. -- Use an [ArangoDeploymentReplication resource](deployment-replication-resource-reference.md) to configure ArangoDB Datacenter-to-Datacenter Replication. -- Use an [ArangoMLExtension resource](mlextension-resource.md) to configure [ArangoML](https://github.com/arangoml) for your deployment. - -Continue with [Using the ArangoDB Kubernetes Operator](using-the-operator.md) -to learn how to install the ArangoDB Kubernetes operator and create -your first deployment. - -For more information about the production readiness state, please refer to the -[main README file](https://github.com/arangodb/kube-arangodb#production-readiness-state). diff --git a/docs/api/ArangoBackup.V1.md b/docs/api/ArangoBackup.V1.md index 65e21b73f..d9236fa95 100644 --- a/docs/api/ArangoBackup.V1.md +++ b/docs/api/ArangoBackup.V1.md @@ -1,3 +1,9 @@ +--- +title: ArangoBackup V1 +layout: page +parent: CRD reference +--- + # API Reference for ArangoBackup V1 ## Spec diff --git a/docs/api/ArangoBackupPolicy.V1.md b/docs/api/ArangoBackupPolicy.V1.md index aebff2651..d1ffffde4 100644 --- a/docs/api/ArangoBackupPolicy.V1.md +++ b/docs/api/ArangoBackupPolicy.V1.md @@ -1,3 +1,9 @@ +--- +layout: page +parent: CRD reference +title: ArangoBackupPolicy V1 +--- + # API Reference for ArangoBackupPolicy V1 ## Spec diff --git a/docs/api/ArangoDeployment.V1.md b/docs/api/ArangoDeployment.V1.md index a1f8aef9e..31928a9df 100644 --- a/docs/api/ArangoDeployment.V1.md +++ b/docs/api/ArangoDeployment.V1.md @@ -1,3 +1,9 @@ +--- +title: ArangoDeployment V1 +layout: page +parent: CRD reference +--- + # API Reference for ArangoDeployment V1 ## Spec diff --git a/docs/api/ArangoDeploymentReplication.V1.md b/docs/api/ArangoDeploymentReplication.V1.md index a9b3f958b..18b91e432 100644 --- a/docs/api/ArangoDeploymentReplication.V1.md +++ b/docs/api/ArangoDeploymentReplication.V1.md @@ -1,3 +1,9 @@ +--- +layout: page +parent: CRD reference +title: ArangoDeploymentReplication V1 +--- + # API Reference for ArangoDeploymentReplication V1 ## Spec diff --git a/docs/api/ArangoLocalStorage.V1Alpha.md b/docs/api/ArangoLocalStorage.V1Alpha.md index d0d804287..4c1dd953c 100644 --- a/docs/api/ArangoLocalStorage.V1Alpha.md +++ b/docs/api/ArangoLocalStorage.V1Alpha.md @@ -1,3 +1,9 @@ +--- +layout: page +parent: CRD reference +title: ArangoLocalStorage V1Alpha +--- + # API Reference for ArangoLocalStorage V1Alpha ## Spec diff --git a/docs/api/ArangoMLBatchJob.V1Alpha1.md b/docs/api/ArangoMLBatchJob.V1Alpha1.md index b3d1121fd..e9d01049d 100644 --- a/docs/api/ArangoMLBatchJob.V1Alpha1.md +++ b/docs/api/ArangoMLBatchJob.V1Alpha1.md @@ -1,3 +1,9 @@ +--- +parent: CRD reference +title: ArangoMLBatchJob V1Alpha1 +layout: page +--- + # API Reference for ArangoMLBatchJob V1Alpha1 ## Spec diff --git a/docs/api/ArangoMLCronJob.V1Alpha1.md b/docs/api/ArangoMLCronJob.V1Alpha1.md index c82d9095b..f4ea8c8e7 100644 --- a/docs/api/ArangoMLCronJob.V1Alpha1.md +++ b/docs/api/ArangoMLCronJob.V1Alpha1.md @@ -1,3 +1,9 @@ +--- +title: ArangoMLCronJob V1Alpha1 +layout: page +parent: CRD reference +--- + # API Reference for ArangoMLCronJob V1Alpha1 ## Spec diff --git a/docs/api/ArangoMLExtension.V1Alpha1.md b/docs/api/ArangoMLExtension.V1Alpha1.md index 719a32efe..deb5bec9d 100644 --- a/docs/api/ArangoMLExtension.V1Alpha1.md +++ b/docs/api/ArangoMLExtension.V1Alpha1.md @@ -1,3 +1,9 @@ +--- +layout: page +parent: CRD reference +title: ArangoMLExtension V1Alpha1 +--- + # API Reference for ArangoMLExtension V1Alpha1 ## Spec diff --git a/docs/api/ArangoMLStorage.V1Alpha1.md b/docs/api/ArangoMLStorage.V1Alpha1.md index 66b6fa10f..4580daf00 100644 --- a/docs/api/ArangoMLStorage.V1Alpha1.md +++ b/docs/api/ArangoMLStorage.V1Alpha1.md @@ -1,3 +1,9 @@ +--- +layout: page +parent: CRD reference +title: ArangoMLStorage V1Alpha1 +--- + # API Reference for ArangoMLStorage V1Alpha1 ## Spec diff --git a/docs/api/ArangoMember.V1.md b/docs/api/ArangoMember.V1.md index 5a0d6a683..dfa9cc4aa 100644 --- a/docs/api/ArangoMember.V1.md +++ b/docs/api/ArangoMember.V1.md @@ -1,3 +1,9 @@ +--- +layout: page +parent: CRD reference +title: ArangoMember V1 +--- + # API Reference for ArangoMember V1 ## Spec diff --git a/docs/api/README.md b/docs/api/README.md index e20ef2f4e..35ca9686e 100644 --- a/docs/api/README.md +++ b/docs/api/README.md @@ -1,13 +1,6 @@ -# Custom Resources API Reference - - - [ArangoBackup.V1](./ArangoBackup.V1.md) - - [ArangoBackupPolicy.V1](./ArangoBackupPolicy.V1.md) - - [ArangoDeployment.V1](./ArangoDeployment.V1.md) - - [ArangoDeploymentReplication.V1](./ArangoDeploymentReplication.V1.md) - - [ArangoLocalStorage.V1Alpha](./ArangoLocalStorage.V1Alpha.md) - - [ArangoMLBatchJob.V1Alpha1](./ArangoMLBatchJob.V1Alpha1.md) - - [ArangoMLCronJob.V1Alpha1](./ArangoMLCronJob.V1Alpha1.md) - - [ArangoMLExtension.V1Alpha1](./ArangoMLExtension.V1Alpha1.md) - - [ArangoMLStorage.V1Alpha1](./ArangoMLStorage.V1Alpha1.md) - - [ArangoMember.V1](./ArangoMember.V1.md) - +--- +layout: page +title: CRD reference +has_children: true +nav_order: 3 +--- diff --git a/docs/backup-resource.md b/docs/backup-resource.md index 769e0943e..b59961abe 100644 --- a/docs/backup-resource.md +++ b/docs/backup-resource.md @@ -1,3 +1,9 @@ +--- +layout: page +parent: Custom resources overview +title: ArangoBackup +--- + # ArangoBackup Custom Resource [Full CustomResourceDefinition reference ->](./api/ArangoBackup.V1.md) diff --git a/docs/backuppolicy-resource.md b/docs/backuppolicy-resource.md index c304b78e8..d9ba896fb 100644 --- a/docs/backuppolicy-resource.md +++ b/docs/backuppolicy-resource.md @@ -1,3 +1,9 @@ +--- +layout: page +parent: Custom resources overview +title: ArangoBackupPolicy +--- + # ArangoBackupPolicy Custom Resource [Full CustomResourceDefinition reference ->](./api/ArangoBackupPolicy.V1.md) diff --git a/docs/crds.md b/docs/crds.md index 363f19b89..1922a65a7 100644 --- a/docs/crds.md +++ b/docs/crds.md @@ -1,3 +1,11 @@ +--- +layout: page +has_children: true +title: Custom resources overview +nav_order: 4 +has_toc: false +--- + # Custom resources overview Main CRDs: diff --git a/docs/dashboards.md b/docs/dashboards.md index 3c34f39ef..b03f6836b 100644 --- a/docs/dashboards.md +++ b/docs/dashboards.md @@ -1,3 +1,9 @@ +--- +layout: page +nav_order: 20 +title: Operator dashboard +--- + # Deployment Operator Dashboards ### Dashboard UI now is deprecated and will be removed in next minor version diff --git a/docs/deployment-replication-resource-reference.md b/docs/deployment-replication-resource-reference.md index 0462a6e3f..5cfcb389c 100644 --- a/docs/deployment-replication-resource-reference.md +++ b/docs/deployment-replication-resource-reference.md @@ -1,3 +1,9 @@ +--- +layout: page +parent: Custom resources overview +title: ArangoDeploymentReplication +--- + # ArangoDeploymentReplication Custom Resource #### Enterprise Edition only @@ -90,10 +96,12 @@ running in Kubernetes: 2. Extract the access package from the source ArangoDB cluster. + ```bash kubectl get secret src-accesspackage --template='{{index .data "accessPackage.yaml"}}' | \ base64 -D > accessPackage.yaml ``` + 3. Configure the source DNS names. @@ -232,9 +240,12 @@ The process for creating and using an access package for authentication at the s - Wait for the `ArangoDeployment` operator to create a `Secret` named `my-access-package`. - Extract the access package from the Kubernetes source cluster using: + + ```bash kubectl get secret my-access-package --template='{{index .data "accessPackage.yaml"}}' | base64 -D > accessPackage.yaml ``` + - Insert the secrets found in the access package in the Kubernetes destination cluster using: diff --git a/docs/deployment-resource-reference.md b/docs/deployment-resource-reference.md index ab95b4452..d84998678 100644 --- a/docs/deployment-resource-reference.md +++ b/docs/deployment-resource-reference.md @@ -1,3 +1,9 @@ +--- +layout: page +parent: Custom resources overview +title: ArangoDeployment +--- + # ArangoDeployment Custom Resource Overview [Full CustomResourceDefinition reference ->](./api/ArangoDeployment.V1.md) diff --git a/docs/design/README.md b/docs/design/README.md index 094bf8fcc..cdbba2dfa 100644 --- a/docs/design/README.md +++ b/docs/design/README.md @@ -1,12 +1,7 @@ -# ArangoDB operator architecture overview +--- +layout: page +title: Design overview +has_children: true +nav_order: 5 +--- -- [Operator API](./api.md) -- [Backups](./backup.md) -- [Constraints for high-availability](./constraints.md) -- [ArangoDB Exporter](./exporter.md) -- [Health](./health.md) -- [Lifecycle hooks and Finalizers](./lifecycle_hooks_and_finalizers.md) -- [Pod eviction and replacement](./pod_eviction_and_replacement.md) -- [Kubernetes Pod name versus cluster ID](./pod_name_versus_cluster_id.md) -- [Resources & labels](./resources_and_labels.md) -- [Topology awareness](./topology_awareness.md) \ No newline at end of file diff --git a/docs/design/api.md b/docs/design/api.md index 87e1147bb..974c88fe4 100644 --- a/docs/design/api.md +++ b/docs/design/api.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Operator API +parent: Design overview +--- + # Operator API A running operator exposes HTTP and gRPC API listeners to allow retrieving and setting some configuration values programmatically. diff --git a/docs/design/backup.md b/docs/design/backup.md index c45b51dde..5bd903e19 100644 --- a/docs/design/backup.md +++ b/docs/design/backup.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Backups +parent: Design overview +--- + # ArangoBackup ## Lifetime diff --git a/docs/design/constraints.md b/docs/design/constraints.md index 1ca3aae25..9460ed611 100644 --- a/docs/design/constraints.md +++ b/docs/design/constraints.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Constraints +parent: Design overview +--- + # Constraints The ArangoDB operator tries to honor various constraints to support high availability of diff --git a/docs/design/exporter.md b/docs/design/exporter.md index 36ad84789..c232b1aae 100644 --- a/docs/design/exporter.md +++ b/docs/design/exporter.md @@ -1,3 +1,9 @@ +--- +layout: page +title: ArangoDB Metrics +parent: Design overview +--- + # ArangoDB Exporter for Prometheus This exporter exposes the statistics provided by a specific ArangoDB instance diff --git a/docs/design/health.md b/docs/design/health.md index ef5aa3051..17f6d32ef 100644 --- a/docs/design/health.md +++ b/docs/design/health.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Health checks +parent: Design overview +--- + # Health checks ## Liveness Probe diff --git a/docs/design/lifecycle_hooks_and_finalizers.md b/docs/design/lifecycle_hooks_and_finalizers.md index 778f705e3..f79f97ea9 100644 --- a/docs/design/lifecycle_hooks_and_finalizers.md +++ b/docs/design/lifecycle_hooks_and_finalizers.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Lifecycle hooks and Finalizers +parent: Design overview +--- + # Lifecycle hooks & Finalizers The ArangoDB operator expects full control of the `Pods` and `PersistentVolumeClaims` it creates. diff --git a/docs/design/pod_eviction_and_replacement.md b/docs/design/pod_eviction_and_replacement.md index 8a5fa5e94..d5b7a6803 100644 --- a/docs/design/pod_eviction_and_replacement.md +++ b/docs/design/pod_eviction_and_replacement.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Pod eviction and replacement +parent: Design overview +--- + # Pod Eviction & Replacement This chapter specifies the rules around evicting pods from nodes and diff --git a/docs/design/pod_name_versus_cluster_id.md b/docs/design/pod_name_versus_cluster_id.md index a55f32f3f..aec513559 100644 --- a/docs/design/pod_name_versus_cluster_id.md +++ b/docs/design/pod_name_versus_cluster_id.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Resource names +parent: Design overview +--- + # Kubernetes Pod name versus cluster ID All resources being created will get a name that contains diff --git a/docs/design/resources_and_labels.md b/docs/design/resources_and_labels.md index 467bb8dc2..2d4782ccf 100644 --- a/docs/design/resources_and_labels.md +++ b/docs/design/resources_and_labels.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Kubernetes resources +parent: Design overview +--- + # Resources and labels The ArangoDB operator will create the following Kubernetes resources for specified diff --git a/docs/design/topology_awareness.md b/docs/design/topology_awareness.md index 83402213a..504f7de51 100644 --- a/docs/design/topology_awareness.md +++ b/docs/design/topology_awareness.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Topology awareness +parent: Design overview +--- + # Topology awareness ## Table of contents diff --git a/docs/driver-configuration.md b/docs/driver-configuration.md index cfea7dfb4..f54289901 100644 --- a/docs/driver-configuration.md +++ b/docs/driver-configuration.md @@ -85,9 +85,11 @@ set automatically. Then fetch the CA secret using the following command (or use a Kubernetes client library to fetch it): + ```bash kubectl get secret -n --template='{{index .data "ca.crt"}}' | base64 -D > ca.crt ``` + This results in a file called `ca.crt` containing a PEM encoded, x509 CA certificate. diff --git a/docs/features/README.md b/docs/features/README.md index 496f96645..c5d87f1ba 100644 --- a/docs/features/README.md +++ b/docs/features/README.md @@ -1,3 +1,9 @@ +--- +layout: page +title: List of all features +nav_order: 10 +--- + ## List of Community Edition features | Feature | Operator Version | Introduced | ArangoDB Version | ArangoDB Edition | State | Enabled | Flag | Remarks | diff --git a/docs/features/deployment_spec_defaults.md b/docs/features/deployment_spec_defaults.md index c93c28e36..031184db2 100644 --- a/docs/features/deployment_spec_defaults.md +++ b/docs/features/deployment_spec_defaults.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Restore defaults from last accepted state of deployment +parent: List of all features +--- + # Restore defaults from last accepted state of deployment ## Overview diff --git a/docs/features/ephemeral_volumes.md b/docs/features/ephemeral_volumes.md index a941659fe..7400adaf8 100644 --- a/docs/features/ephemeral_volumes.md +++ b/docs/features/ephemeral_volumes.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Operator Ephemeral Volumes +parent: List of all features +--- + # Operator Ephemeral Volumes ## Overview diff --git a/docs/features/failover_leader_service.md b/docs/features/failover_leader_service.md index 98f43affd..998af64de 100644 --- a/docs/features/failover_leader_service.md +++ b/docs/features/failover_leader_service.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Failover Leader service +parent: List of all features +--- + # Failover Leader service ## Overview diff --git a/docs/features/rebalancer.md b/docs/features/rebalancer.md index 4c1cdfca5..5f0cdddfe 100644 --- a/docs/features/rebalancer.md +++ b/docs/features/rebalancer.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Rebalancer +parent: List of all features +--- + # ArangoDB Rebalancer Support ## How to use diff --git a/docs/features/rebalancer_v2.md b/docs/features/rebalancer_v2.md index e970f76b3..8fbb2ef6b 100644 --- a/docs/features/rebalancer_v2.md +++ b/docs/features/rebalancer_v2.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Rebalancer v2 +parent: List of all features +--- + # ArangoDB Rebalancer V2 Support ## Overview diff --git a/docs/features/rebuild_out_synced_shards.md b/docs/features/rebuild_out_synced_shards.md index a78006f09..f376d2775 100644 --- a/docs/features/rebuild_out_synced_shards.md +++ b/docs/features/rebuild_out_synced_shards.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Force rebuild out-synced Shards with broken Merkle Tree +parent: List of all features +--- + # Force rebuild out-synced Shards with broken Merkle Tree ## Overview diff --git a/docs/features/secured_containers.md b/docs/features/secured_containers.md index 08870c7cd..44cbac19c 100644 --- a/docs/features/secured_containers.md +++ b/docs/features/secured_containers.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Secured containers +parent: List of all features +--- + # Secured Containers ## Overview diff --git a/docs/generated/actions.md b/docs/generated/actions.md index b8677a808..fe0d2cd09 100644 --- a/docs/generated/actions.md +++ b/docs/generated/actions.md @@ -1,3 +1,9 @@ +--- +layout: page +title: List of Plan Actions +nav_order: 11 +--- + # ArangoDB Operator Actions ## List diff --git a/docs/generated/metrics/README.md b/docs/generated/metrics/README.md index bd42a348c..1a1e98b03 100644 --- a/docs/generated/metrics/README.md +++ b/docs/generated/metrics/README.md @@ -1,3 +1,11 @@ +--- +layout: page +title: List of available metrics +nav_order: 9 +has_children: true +has_toc: false +--- + # ArangoDB Operator Metrics ## List of the Operator metrics diff --git a/docs/generated/metrics/arangodb_operator_agency_cache_health_present.md b/docs/generated/metrics/arangodb_operator_agency_cache_health_present.md index 9d411a0dc..994245025 100644 --- a/docs/generated/metrics/arangodb_operator_agency_cache_health_present.md +++ b/docs/generated/metrics/arangodb_operator_agency_cache_health_present.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_agency_cache_health_present +parent: List of available metrics +--- + # arangodb_operator_agency_cache_health_present (Gauge) ## Description diff --git a/docs/generated/metrics/arangodb_operator_agency_cache_healthy.md b/docs/generated/metrics/arangodb_operator_agency_cache_healthy.md index 7247c91e4..53da88e7b 100644 --- a/docs/generated/metrics/arangodb_operator_agency_cache_healthy.md +++ b/docs/generated/metrics/arangodb_operator_agency_cache_healthy.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_agency_cache_healthy +parent: List of available metrics +--- + # arangodb_operator_agency_cache_healthy (Gauge) ## Description diff --git a/docs/generated/metrics/arangodb_operator_agency_cache_leaders.md b/docs/generated/metrics/arangodb_operator_agency_cache_leaders.md index c58ec73ff..534429709 100644 --- a/docs/generated/metrics/arangodb_operator_agency_cache_leaders.md +++ b/docs/generated/metrics/arangodb_operator_agency_cache_leaders.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_agency_cache_leaders +parent: List of available metrics +--- + # arangodb_operator_agency_cache_leaders (Gauge) ## Description diff --git a/docs/generated/metrics/arangodb_operator_agency_cache_member_commit_offset.md b/docs/generated/metrics/arangodb_operator_agency_cache_member_commit_offset.md index 7a00682d0..aeedb88b5 100644 --- a/docs/generated/metrics/arangodb_operator_agency_cache_member_commit_offset.md +++ b/docs/generated/metrics/arangodb_operator_agency_cache_member_commit_offset.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_agency_cache_member_commit_offset +parent: List of available metrics +--- + # arangodb_operator_agency_cache_member_commit_offset (Gauge) ## Description diff --git a/docs/generated/metrics/arangodb_operator_agency_cache_member_serving.md b/docs/generated/metrics/arangodb_operator_agency_cache_member_serving.md index cec191f74..c082fc3c0 100644 --- a/docs/generated/metrics/arangodb_operator_agency_cache_member_serving.md +++ b/docs/generated/metrics/arangodb_operator_agency_cache_member_serving.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_agency_cache_member_serving +parent: List of available metrics +--- + # arangodb_operator_agency_cache_member_serving (Gauge) ## Description diff --git a/docs/generated/metrics/arangodb_operator_agency_cache_present.md b/docs/generated/metrics/arangodb_operator_agency_cache_present.md index 5ecc6a270..c3c2ec52c 100644 --- a/docs/generated/metrics/arangodb_operator_agency_cache_present.md +++ b/docs/generated/metrics/arangodb_operator_agency_cache_present.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_agency_cache_present +parent: List of available metrics +--- + # arangodb_operator_agency_cache_present (Gauge) ## Description diff --git a/docs/generated/metrics/arangodb_operator_agency_cache_serving.md b/docs/generated/metrics/arangodb_operator_agency_cache_serving.md index 472e5206c..e6d05bf68 100644 --- a/docs/generated/metrics/arangodb_operator_agency_cache_serving.md +++ b/docs/generated/metrics/arangodb_operator_agency_cache_serving.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_agency_cache_serving +parent: List of available metrics +--- + # arangodb_operator_agency_cache_serving (Gauge) ## Description diff --git a/docs/generated/metrics/arangodb_operator_agency_errors.md b/docs/generated/metrics/arangodb_operator_agency_errors.md index c6746ac64..26b78aa74 100644 --- a/docs/generated/metrics/arangodb_operator_agency_errors.md +++ b/docs/generated/metrics/arangodb_operator_agency_errors.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_agency_errors +parent: List of available metrics +--- + # arangodb_operator_agency_errors (Counter) ## Description diff --git a/docs/generated/metrics/arangodb_operator_agency_fetches.md b/docs/generated/metrics/arangodb_operator_agency_fetches.md index c7139fea9..4c2b53826 100644 --- a/docs/generated/metrics/arangodb_operator_agency_fetches.md +++ b/docs/generated/metrics/arangodb_operator_agency_fetches.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_agency_fetches +parent: List of available metrics +--- + # arangodb_operator_agency_fetches (Counter) ## Description diff --git a/docs/generated/metrics/arangodb_operator_agency_index.md b/docs/generated/metrics/arangodb_operator_agency_index.md index a6ee5ade4..f60da240e 100644 --- a/docs/generated/metrics/arangodb_operator_agency_index.md +++ b/docs/generated/metrics/arangodb_operator_agency_index.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_agency_index +parent: List of available metrics +--- + # arangodb_operator_agency_index (Gauge) ## Description diff --git a/docs/generated/metrics/arangodb_operator_engine_assertions.md b/docs/generated/metrics/arangodb_operator_engine_assertions.md index 924697f20..86750fe54 100644 --- a/docs/generated/metrics/arangodb_operator_engine_assertions.md +++ b/docs/generated/metrics/arangodb_operator_engine_assertions.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_engine_assertions +parent: List of available metrics +--- + # arangodb_operator_engine_assertions (Counter) ## Description diff --git a/docs/generated/metrics/arangodb_operator_engine_ops_alerts.md b/docs/generated/metrics/arangodb_operator_engine_ops_alerts.md index 8901cace4..d9f461b3f 100644 --- a/docs/generated/metrics/arangodb_operator_engine_ops_alerts.md +++ b/docs/generated/metrics/arangodb_operator_engine_ops_alerts.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_engine_ops_alerts +parent: List of available metrics +--- + # arangodb_operator_engine_ops_alerts (Counter) ## Description diff --git a/docs/generated/metrics/arangodb_operator_engine_panics_recovered.md b/docs/generated/metrics/arangodb_operator_engine_panics_recovered.md index e67a5ddcf..7ae12248d 100644 --- a/docs/generated/metrics/arangodb_operator_engine_panics_recovered.md +++ b/docs/generated/metrics/arangodb_operator_engine_panics_recovered.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_engine_panics_recovered +parent: List of available metrics +--- + # arangodb_operator_engine_panics_recovered (Counter) ## Description diff --git a/docs/generated/metrics/arangodb_operator_kubernetes_client_request_errors.md b/docs/generated/metrics/arangodb_operator_kubernetes_client_request_errors.md index 877a01b6b..e2eaa331e 100644 --- a/docs/generated/metrics/arangodb_operator_kubernetes_client_request_errors.md +++ b/docs/generated/metrics/arangodb_operator_kubernetes_client_request_errors.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_kubernetes_client_request_errors +parent: List of available metrics +--- + # arangodb_operator_kubernetes_client_request_errors (Counter) ## Description diff --git a/docs/generated/metrics/arangodb_operator_kubernetes_client_requests.md b/docs/generated/metrics/arangodb_operator_kubernetes_client_requests.md index 2bd47740a..6b1e5a478 100644 --- a/docs/generated/metrics/arangodb_operator_kubernetes_client_requests.md +++ b/docs/generated/metrics/arangodb_operator_kubernetes_client_requests.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_kubernetes_client_requests +parent: List of available metrics +--- + # arangodb_operator_kubernetes_client_requests (Counter) ## Description diff --git a/docs/generated/metrics/arangodb_operator_kubernetes_events_created.md b/docs/generated/metrics/arangodb_operator_kubernetes_events_created.md deleted file mode 100644 index c7ca6476c..000000000 --- a/docs/generated/metrics/arangodb_operator_kubernetes_events_created.md +++ /dev/null @@ -1,13 +0,0 @@ -# arangodb_operator_kubernetes_events_created (Counter) - -## Description - -Counter for created events - -## Labels - -| Label | Description | -|:---------:|:---------------------| -| namespace | Deployment Namespace | -| name | Deployment Name | -| eventType | Event Type | diff --git a/docs/generated/metrics/arangodb_operator_members_unexpected_container_exit_codes.md b/docs/generated/metrics/arangodb_operator_members_unexpected_container_exit_codes.md index 73bbb8fbb..fd9d024ee 100644 --- a/docs/generated/metrics/arangodb_operator_members_unexpected_container_exit_codes.md +++ b/docs/generated/metrics/arangodb_operator_members_unexpected_container_exit_codes.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_members_unexpected_container_exit_codes +parent: List of available metrics +--- + # arangodb_operator_members_unexpected_container_exit_codes (Counter) ## Description diff --git a/docs/generated/metrics/arangodb_operator_rebalancer_enabled.md b/docs/generated/metrics/arangodb_operator_rebalancer_enabled.md index fdc513a7a..22e159143 100644 --- a/docs/generated/metrics/arangodb_operator_rebalancer_enabled.md +++ b/docs/generated/metrics/arangodb_operator_rebalancer_enabled.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_rebalancer_enabled +parent: List of available metrics +--- + # arangodb_operator_rebalancer_enabled (Gauge) ## Description diff --git a/docs/generated/metrics/arangodb_operator_rebalancer_moves_current.md b/docs/generated/metrics/arangodb_operator_rebalancer_moves_current.md index ab1c67038..fb3d54378 100644 --- a/docs/generated/metrics/arangodb_operator_rebalancer_moves_current.md +++ b/docs/generated/metrics/arangodb_operator_rebalancer_moves_current.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_rebalancer_moves_current +parent: List of available metrics +--- + # arangodb_operator_rebalancer_moves_current (Gauge) ## Description diff --git a/docs/generated/metrics/arangodb_operator_rebalancer_moves_failed.md b/docs/generated/metrics/arangodb_operator_rebalancer_moves_failed.md index 22ace44e2..21d173516 100644 --- a/docs/generated/metrics/arangodb_operator_rebalancer_moves_failed.md +++ b/docs/generated/metrics/arangodb_operator_rebalancer_moves_failed.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_rebalancer_moves_failed +parent: List of available metrics +--- + # arangodb_operator_rebalancer_moves_failed (Counter) ## Description diff --git a/docs/generated/metrics/arangodb_operator_rebalancer_moves_generated.md b/docs/generated/metrics/arangodb_operator_rebalancer_moves_generated.md index 9ae74acd6..48e63e604 100644 --- a/docs/generated/metrics/arangodb_operator_rebalancer_moves_generated.md +++ b/docs/generated/metrics/arangodb_operator_rebalancer_moves_generated.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_rebalancer_moves_generated +parent: List of available metrics +--- + # arangodb_operator_rebalancer_moves_generated (Counter) ## Description diff --git a/docs/generated/metrics/arangodb_operator_rebalancer_moves_succeeded.md b/docs/generated/metrics/arangodb_operator_rebalancer_moves_succeeded.md index c4ee3c5fc..4760b7011 100644 --- a/docs/generated/metrics/arangodb_operator_rebalancer_moves_succeeded.md +++ b/docs/generated/metrics/arangodb_operator_rebalancer_moves_succeeded.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_rebalancer_moves_succeeded +parent: List of available metrics +--- + # arangodb_operator_rebalancer_moves_succeeded (Counter) ## Description diff --git a/docs/generated/metrics/arangodb_operator_resources_arangodeployment_accepted.md b/docs/generated/metrics/arangodb_operator_resources_arangodeployment_accepted.md index c9e7c29f3..220548263 100644 --- a/docs/generated/metrics/arangodb_operator_resources_arangodeployment_accepted.md +++ b/docs/generated/metrics/arangodb_operator_resources_arangodeployment_accepted.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_resources_arangodeployment_accepted +parent: List of available metrics +--- + # arangodb_operator_resources_arangodeployment_accepted (Gauge) ## Description diff --git a/docs/generated/metrics/arangodb_operator_resources_arangodeployment_immutable_errors.md b/docs/generated/metrics/arangodb_operator_resources_arangodeployment_immutable_errors.md index 5fc4d07d5..74560e861 100644 --- a/docs/generated/metrics/arangodb_operator_resources_arangodeployment_immutable_errors.md +++ b/docs/generated/metrics/arangodb_operator_resources_arangodeployment_immutable_errors.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_resources_arangodeployment_immutable_errors +parent: List of available metrics +--- + # arangodb_operator_resources_arangodeployment_immutable_errors (Counter) ## Description diff --git a/docs/generated/metrics/arangodb_operator_resources_arangodeployment_propagated.md b/docs/generated/metrics/arangodb_operator_resources_arangodeployment_propagated.md index 6a9568f97..816c86cf6 100644 --- a/docs/generated/metrics/arangodb_operator_resources_arangodeployment_propagated.md +++ b/docs/generated/metrics/arangodb_operator_resources_arangodeployment_propagated.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_resources_arangodeployment_propagated +parent: List of available metrics +--- + # arangodb_operator_resources_arangodeployment_propagated (Gauge) ## Description diff --git a/docs/generated/metrics/arangodb_operator_resources_arangodeployment_status_restores.md b/docs/generated/metrics/arangodb_operator_resources_arangodeployment_status_restores.md index 04ef8c09b..1be9fff45 100644 --- a/docs/generated/metrics/arangodb_operator_resources_arangodeployment_status_restores.md +++ b/docs/generated/metrics/arangodb_operator_resources_arangodeployment_status_restores.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_resources_arangodeployment_status_restores +parent: List of available metrics +--- + # arangodb_operator_resources_arangodeployment_status_restores (Counter) ## Description diff --git a/docs/generated/metrics/arangodb_operator_resources_arangodeployment_uptodate.md b/docs/generated/metrics/arangodb_operator_resources_arangodeployment_uptodate.md index 6d4017a5b..82fc98c20 100644 --- a/docs/generated/metrics/arangodb_operator_resources_arangodeployment_uptodate.md +++ b/docs/generated/metrics/arangodb_operator_resources_arangodeployment_uptodate.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_resources_arangodeployment_uptodate +parent: List of available metrics +--- + # arangodb_operator_resources_arangodeployment_uptodate (Gauge) ## Description diff --git a/docs/generated/metrics/arangodb_operator_resources_arangodeployment_validation_errors.md b/docs/generated/metrics/arangodb_operator_resources_arangodeployment_validation_errors.md index fe38289cf..a6482ffb6 100644 --- a/docs/generated/metrics/arangodb_operator_resources_arangodeployment_validation_errors.md +++ b/docs/generated/metrics/arangodb_operator_resources_arangodeployment_validation_errors.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_resources_arangodeployment_validation_errors +parent: List of available metrics +--- + # arangodb_operator_resources_arangodeployment_validation_errors (Counter) ## Description diff --git a/docs/generated/metrics/arangodb_operator_resources_arangodeploymentreplication_active.md b/docs/generated/metrics/arangodb_operator_resources_arangodeploymentreplication_active.md index c8dff79e1..3770bdd2a 100644 --- a/docs/generated/metrics/arangodb_operator_resources_arangodeploymentreplication_active.md +++ b/docs/generated/metrics/arangodb_operator_resources_arangodeploymentreplication_active.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_resources_arangodeploymentreplication_active +parent: List of available metrics +--- + # arangodb_operator_resources_arangodeploymentreplication_active (Gauge) ## Description diff --git a/docs/generated/metrics/arangodb_operator_resources_arangodeploymentreplication_failed.md b/docs/generated/metrics/arangodb_operator_resources_arangodeploymentreplication_failed.md index ac22d18de..c8a8beb5f 100644 --- a/docs/generated/metrics/arangodb_operator_resources_arangodeploymentreplication_failed.md +++ b/docs/generated/metrics/arangodb_operator_resources_arangodeploymentreplication_failed.md @@ -1,3 +1,9 @@ +--- +layout: page +title: arangodb_operator_resources_arangodeploymentreplication_failed +parent: List of available metrics +--- + # arangodb_operator_resources_arangodeploymentreplication_failed (Gauge) ## Description diff --git a/docs/helm.md b/docs/helm.md index f0c29b79e..fb190c8b5 100644 --- a/docs/helm.md +++ b/docs/helm.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Usage instructions (Helm) +nav_order: 2 +--- + # Using the ArangoDB Kubernetes Operator with Helm [`Helm`](https://www.helm.sh/) is a package manager for Kubernetes, which enables diff --git a/docs/how-to/README.md b/docs/how-to/README.md index 77c28cb5a..611bf89b2 100644 --- a/docs/how-to/README.md +++ b/docs/how-to/README.md @@ -1,13 +1,6 @@ -## How-to... - -- [Set a license key](./set_license.md) -- [Pass additional params to operator](additional_configuration.md) -- [Set a root user password](./set_root_user_password.md) -- [Change architecture / enable ARM support](arch_change.md) -- [Configure timezone for cluster](configuring_tz.md) -- [Collect debug data for support case](debugging.md) -- [Configure logging](logging.md) -- [Enable maintenance mode](maintenance.md) -- [Override detected total memory](override_detected_memory.md) -- [Manually recover cluster if you still have volumes with data](recovery.md) -- [Rotate Pod](rotate-pod.md) +--- +layout: page +title: How to ... +nav_order: 6 +has_children: true +--- diff --git a/docs/how-to/additional_configuration.md b/docs/how-to/additional_configuration.md index b0bb35f69..a958b0e7f 100644 --- a/docs/how-to/additional_configuration.md +++ b/docs/how-to/additional_configuration.md @@ -1,3 +1,9 @@ +--- +layout: page +title: How to pass additional params to operator +parent: How to ... +--- + # How to pass additional params to operator It is possible to additionally fine-tune operator behavior by diff --git a/docs/how-to/arch_change.md b/docs/how-to/arch_change.md index 35ddea933..70086a415 100644 --- a/docs/how-to/arch_change.md +++ b/docs/how-to/arch_change.md @@ -1,3 +1,9 @@ +--- +layout: page +title: How to change architecture +parent: How to ... +--- + # How to change architecture / enable ARM support Currently `AMD64` is a default architecture in the operator diff --git a/docs/how-to/configuring_tz.md b/docs/how-to/configuring_tz.md index 127b605ed..233fceb97 100644 --- a/docs/how-to/configuring_tz.md +++ b/docs/how-to/configuring_tz.md @@ -1,3 +1,9 @@ +--- +layout: page +title: How to configure timezone +parent: How to ... +--- + # How to configure timezone To set timezone for cluster components, mount the required timezone into container diff --git a/docs/how-to/debugging.md b/docs/how-to/debugging.md index d54f1ab4c..8927410d7 100644 --- a/docs/how-to/debugging.md +++ b/docs/how-to/debugging.md @@ -1,3 +1,9 @@ +--- +layout: page +title: How to collect debug data +parent: How to ... +--- + # How to collect debug data ## Agency dump diff --git a/docs/how-to/logging.md b/docs/how-to/logging.md index 8825ba42f..809245b48 100644 --- a/docs/how-to/logging.md +++ b/docs/how-to/logging.md @@ -1,3 +1,9 @@ +--- +layout: page +title: How to configure logging +parent: How to ... +--- + # How to configure logging ## Operator logging diff --git a/docs/how-to/maintenance.md b/docs/how-to/maintenance.md index f878a19f9..22aa2c3ce 100644 --- a/docs/how-to/maintenance.md +++ b/docs/how-to/maintenance.md @@ -1,3 +1,9 @@ +--- +layout: page +title: How to use maintenance mode +parent: How to ... +--- + # How to use maintenance mode ## ArangoDeployment maintenance diff --git a/docs/how-to/override_detected_memory.md b/docs/how-to/override_detected_memory.md index d125ba930..9b90c8a77 100644 --- a/docs/how-to/override_detected_memory.md +++ b/docs/how-to/override_detected_memory.md @@ -1,3 +1,9 @@ +--- +layout: page +title: How to override detected total memory +parent: How to ... +--- + # How to override detected total memory ## overrideDetectedTotalMemory diff --git a/docs/how-to/recovery.md b/docs/how-to/recovery.md index ead3bb29a..f0444217e 100644 --- a/docs/how-to/recovery.md +++ b/docs/how-to/recovery.md @@ -1,3 +1,9 @@ +--- +layout: page +title: How to recover a destroyed deployment +parent: How to ... +--- + # How to recover a destroyed deployment ## Overview diff --git a/docs/how-to/rotate-pod.md b/docs/how-to/rotate-pod.md index 94264b7e7..64c638a26 100644 --- a/docs/how-to/rotate-pod.md +++ b/docs/how-to/rotate-pod.md @@ -1,3 +1,9 @@ +--- +layout: page +title: How to rotate Pod +parent: How to ... +--- + # How to rotate Pod Rotation of ArangoDeployment Pods can be triggered by Pod deletion or by annotation (safe way). diff --git a/docs/how-to/set_license.md b/docs/how-to/set_license.md index 83a78abb4..88145f5ce 100644 --- a/docs/how-to/set_license.md +++ b/docs/how-to/set_license.md @@ -1,3 +1,9 @@ +--- +layout: page +title: How to set a license key +parent: How to ... +--- + # How to set a license key After deploying the ArangoDB Kubernetes operator, use the command below to deploy your [license key](https://docs.arangodb.com/stable/operations/administration/license-management/) diff --git a/docs/how-to/set_root_user_password.md b/docs/how-to/set_root_user_password.md index df9ff540e..de6a6d820 100644 --- a/docs/how-to/set_root_user_password.md +++ b/docs/how-to/set_root_user_password.md @@ -1,3 +1,9 @@ +--- +layout: page +title: How to set root user password +parent: How to ... +--- + # How to set root user password 1) Create a kubernetes [Secret](https://kubernetes.io/docs/tasks/configmap-secret/managing-secret-using-kubectl/) with root password: diff --git a/docs/index.html b/docs/index.html new file mode 100644 index 000000000..2b21741c1 --- /dev/null +++ b/docs/index.html @@ -0,0 +1,4 @@ + + +Redirecting... + diff --git a/docs/providers/eks/README.md b/docs/providers/eks/README.md index 2a856a4fc..74ff8f131 100644 --- a/docs/providers/eks/README.md +++ b/docs/providers/eks/README.md @@ -1,3 +1,8 @@ +--- +layout: page +nav_exclude: true +--- + # Amazon AWS Remarks ## Elastic Block Storage diff --git a/docs/storage-resource.md b/docs/storage-resource.md index 5d63da7e0..084a68386 100644 --- a/docs/storage-resource.md +++ b/docs/storage-resource.md @@ -1,3 +1,9 @@ +--- +layout: page +parent: Custom resources overview +title: ArangoLocalStorage +--- + # ArangoLocalStorage Custom Resource [Full CustomResourceDefinition reference ->](./api/ArangoLocalStorage.V1Alpha.md) diff --git a/docs/tls.md b/docs/tls.md index 405823a89..003e31fc4 100644 --- a/docs/tls.md +++ b/docs/tls.md @@ -17,9 +17,11 @@ This process differs per operating system. To do so, you first have to fetch the CA certificate from its Kubernetes secret. + ```bash kubectl get secret -ca --template='{{index .data "ca.crt"}}' | base64 -D > ca.crt ``` + ### Windows diff --git a/docs/using-the-operator.md b/docs/using-the-operator.md index dc5fdecc4..fe7ea2d6b 100644 --- a/docs/using-the-operator.md +++ b/docs/using-the-operator.md @@ -1,3 +1,9 @@ +--- +layout: page +title: Usage instructions +nav_order: 1 +--- + # Using the ArangoDB Kubernetes Operator ## Installation diff --git a/internal/docs_test.go b/internal/docs_test.go index 74ba1b287..a6b804193 100644 --- a/internal/docs_test.go +++ b/internal/docs_test.go @@ -44,6 +44,11 @@ import ( "github.com/arangodb/kube-arangodb/pkg/util" ) +const ( + // title of docs/api/README.md page + apiIndexPageTitle = "CRD reference" +) + func (d DocDefinitions) RenderMarkdown(t *testing.T, repositoryPath string) []byte { out := bytes.NewBuffer(nil) @@ -183,7 +188,6 @@ func Test_GenerateAPIDocs(t *testing.T) { }, } - resultPaths := make(map[string]string) for apiDir, docs := range input { fields := parseSourceFiles(t, root, fset, apiDir) @@ -192,9 +196,8 @@ func Test_GenerateAPIDocs(t *testing.T) { fields[n] = f } - util.CopyMap(resultPaths, generateDocs(t, docs, fields, fset)) + generateDocs(t, docs, fields, fset) } - generateIndex(t, resultPaths) } func prepareGitHubTreePath(t *testing.T, root string) string { @@ -243,7 +246,13 @@ func generateDocs(t *testing.T, objects map[string]map[string]interface{}, field require.NoError(t, out.Close()) }() - write(t, out, "# API Reference for %s\n\n", strings.ReplaceAll(objectName, ".", " ")) + objName := strings.ReplaceAll(objectName, ".", " ") + writeFrontMatter(t, out, map[string]string{ + "layout": "page", + "title": objName, + "parent": apiIndexPageTitle, + }) + write(t, out, "# API Reference for %s\n\n", objName) util.IterateSorted(renderSections, func(name string, section []byte) { write(t, out, "## %s\n\n", name) @@ -256,26 +265,20 @@ func generateDocs(t *testing.T, objects map[string]map[string]interface{}, field return outPaths } -func generateIndex(t *testing.T, apiDocs map[string]string) { - root := os.Getenv("ROOT") - require.NotEmpty(t, root) - outPath := path.Join(root, "docs/api/README.md") - - out, err := os.OpenFile(outPath, os.O_CREATE|os.O_TRUNC|os.O_WRONLY, 0644) +func write(t *testing.T, out io.Writer, format string, args ...interface{}) { + _, err := out.Write([]byte(fmt.Sprintf(format, args...))) require.NoError(t, err) - defer func() { - require.NoError(t, out.Close()) - }() +} - write(t, out, "# Custom Resources API Reference\n\n") +func writeFrontMatter(t *testing.T, out io.Writer, keyVals map[string]string) { + fm := "" + for key, val := range keyVals { + fm += fmt.Sprintf("%s: %s\n", key, val) + } - util.IterateSorted(apiDocs, func(name string, filePath string) { - write(t, out, " - [%s](./%s)\n", name, filePath) - }) - write(t, out, "\n") -} + if fm != "" { + fm = "---\n" + fm + "---\n\n" + } -func write(t *testing.T, out io.Writer, format string, args ...interface{}) { - _, err := out.Write([]byte(fmt.Sprintf(format, args...))) - require.NoError(t, err) + write(t, out, fm) } diff --git a/internal/features_test.go b/internal/features_test.go index 3e8564609..0f4ce4d0d 100644 --- a/internal/features_test.go +++ b/internal/features_test.go @@ -41,6 +41,12 @@ func Test_GenerateFeaturesIndex(t *testing.T) { }() const basePath = "docs/features" + writeFrontMatter(t, out, map[string]string{ + "layout": "page", + "title": "List of all features", + "nav_order": "10", + }) + write(t, out, "## List of Community Edition features\n") section, err := GenerateReadmeFeatures(root, basePath, false) require.NoError(t, err) diff --git a/internal/metrics.item.tmpl b/internal/metrics.item.tmpl index 116c60656..5c6115484 100644 --- a/internal/metrics.item.tmpl +++ b/internal/metrics.item.tmpl @@ -1,3 +1,9 @@ +--- +layout: page +title: {{ .name }} +parent: List of available metrics +--- + # {{ .name }} ({{ .type }}) ## Description From 440507f9f952e03c2ff3e6cbbdeea47dafbeee26 Mon Sep 17 00:00:00 2001 From: Nikita Vaniasin Date: Wed, 3 Jan 2024 16:43:18 +0100 Subject: [PATCH 2/3] Update year in header --- internal/features_test.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/internal/features_test.go b/internal/features_test.go index 0f4ce4d0d..a8d3872e7 100644 --- a/internal/features_test.go +++ b/internal/features_test.go @@ -1,7 +1,7 @@ // // DISCLAIMER // -// Copyright 2016-2023 ArangoDB GmbH, Cologne, Germany +// Copyright 2016-2024 ArangoDB GmbH, Cologne, Germany // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. From 8da33299262e1dd5c03e00d97f45d130d0650649 Mon Sep 17 00:00:00 2001 From: Nikita Vaniasin Date: Mon, 8 Jan 2024 12:09:58 +0100 Subject: [PATCH 3/3] Fix front matter ordering + mod tidy --- docs/api/ArangoBackup.V1.md | 2 +- docs/api/ArangoDeployment.V1.md | 2 +- docs/api/ArangoMLBatchJob.V1Alpha1.md | 2 +- docs/api/ArangoMLCronJob.V1Alpha1.md | 2 +- docs/features/README.md | 2 +- go.sum | 7 ------- internal/docs_test.go | 4 ++-- 7 files changed, 7 insertions(+), 14 deletions(-) diff --git a/docs/api/ArangoBackup.V1.md b/docs/api/ArangoBackup.V1.md index d9236fa95..054e33fcc 100644 --- a/docs/api/ArangoBackup.V1.md +++ b/docs/api/ArangoBackup.V1.md @@ -1,7 +1,7 @@ --- -title: ArangoBackup V1 layout: page parent: CRD reference +title: ArangoBackup V1 --- # API Reference for ArangoBackup V1 diff --git a/docs/api/ArangoDeployment.V1.md b/docs/api/ArangoDeployment.V1.md index 31928a9df..a37245e40 100644 --- a/docs/api/ArangoDeployment.V1.md +++ b/docs/api/ArangoDeployment.V1.md @@ -1,7 +1,7 @@ --- -title: ArangoDeployment V1 layout: page parent: CRD reference +title: ArangoDeployment V1 --- # API Reference for ArangoDeployment V1 diff --git a/docs/api/ArangoMLBatchJob.V1Alpha1.md b/docs/api/ArangoMLBatchJob.V1Alpha1.md index e9d01049d..7059efac9 100644 --- a/docs/api/ArangoMLBatchJob.V1Alpha1.md +++ b/docs/api/ArangoMLBatchJob.V1Alpha1.md @@ -1,7 +1,7 @@ --- +layout: page parent: CRD reference title: ArangoMLBatchJob V1Alpha1 -layout: page --- # API Reference for ArangoMLBatchJob V1Alpha1 diff --git a/docs/api/ArangoMLCronJob.V1Alpha1.md b/docs/api/ArangoMLCronJob.V1Alpha1.md index f4ea8c8e7..bddc909aa 100644 --- a/docs/api/ArangoMLCronJob.V1Alpha1.md +++ b/docs/api/ArangoMLCronJob.V1Alpha1.md @@ -1,7 +1,7 @@ --- -title: ArangoMLCronJob V1Alpha1 layout: page parent: CRD reference +title: ArangoMLCronJob V1Alpha1 --- # API Reference for ArangoMLCronJob V1Alpha1 diff --git a/docs/features/README.md b/docs/features/README.md index c5d87f1ba..b80e54922 100644 --- a/docs/features/README.md +++ b/docs/features/README.md @@ -1,7 +1,7 @@ --- layout: page -title: List of all features nav_order: 10 +title: List of all features --- ## List of Community Edition features diff --git a/go.sum b/go.sum index b29103428..f7bfdebd4 100644 --- a/go.sum +++ b/go.sum @@ -196,7 +196,6 @@ github.com/go-kit/log v0.1.0/go.mod h1:zbhenjAZHb184qTLMA9ZjW7ThYL0H2mk7Q6pNt4vb github.com/go-logfmt/logfmt v0.3.0/go.mod h1:Qt1PoO58o5twSAckw1HlFXLmHsOX5/0LbT9GBnD5lWE= github.com/go-logfmt/logfmt v0.4.0/go.mod h1:3RMwSq7FuexP4Kalkev3ejPJsZTpXXBr9+V4qmtdjCk= github.com/go-logfmt/logfmt v0.5.0/go.mod h1:wCYkCAKZfumFQihp8CzCvQ3paCTfi41vtzG1KdI/P7A= -github.com/go-logfmt/logfmt v0.5.1/go.mod h1:WYhtIu8zTZfxdn5+rREduYbwxfcBr/Vr6KEVveWlfTs= github.com/go-logr/logr v0.1.0/go.mod h1:ixOQHD9gLJUVQQ2ZOR7zLEifBX6tGkNJF4QyIY7sIas= github.com/go-logr/logr v0.2.0/go.mod h1:z6/tIYblkpsD+a4lm/fGIIU9mZ+XfAiaFtq7xTgseGU= github.com/go-logr/logr v1.2.0/go.mod h1:jdQByPbusPIv2/zmleS9BjJVeZ6kBagPoEUsqbVz/1A= @@ -624,8 +623,6 @@ golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5y golang.org/x/crypto v0.0.0-20211215153901-e495a2d5b3d3/go.mod h1:IxCIyHEi3zRg3s0A5j5BB6A9Jmi73HwBIUl50j+osU4= golang.org/x/crypto v0.0.0-20220131195533-30dcbda58838/go.mod h1:IxCIyHEi3zRg3s0A5j5BB6A9Jmi73HwBIUl50j+osU4= golang.org/x/crypto v0.0.0-20220315160706-3147a52a75dd/go.mod h1:IxCIyHEi3zRg3s0A5j5BB6A9Jmi73HwBIUl50j+osU4= -golang.org/x/crypto v0.14.0 h1:wBqGXzWJW6m1XrIKlAH0Hs1JJ7+9KBwnIO8v66Q9cHc= -golang.org/x/crypto v0.14.0/go.mod h1:MVFd36DqK4CsrnJYDkBA3VC4m2GkXAM0PvzMCn4JQf4= golang.org/x/crypto v0.17.0 h1:r8bRNjWL3GshPW3gkd+RpvzWrZAwPS49OmTGZ/uhM4k= golang.org/x/crypto v0.17.0/go.mod h1:gCAAfMLgwOJRpTjQ2zCCt2OcSfYMTeZVSRtQlPC7Nq4= golang.org/x/exp v0.0.0-20190121172915-509febef88a4/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA= @@ -836,8 +833,6 @@ golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9sn golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k= golang.org/x/term v0.6.0/go.mod h1:m6U89DPEgQRMq3DNkDClhWw02AUbt2daBVO4cn4Hv9U= -golang.org/x/term v0.13.0 h1:bb+I9cTfFazGW51MZqBVmZy7+JEJMouUHTUSKVQLBek= -golang.org/x/term v0.13.0/go.mod h1:LTmsnFJwVN6bCy1rVCoS+qHT1HhALEFxKncY3WNNh4U= golang.org/x/term v0.15.0 h1:y/Oo/a/q3IXu26lQgl04j/gjuBDOBlx7X6Om1j2CPW4= golang.org/x/term v0.15.0/go.mod h1:BDl952bC7+uMoWR75FIrCDx79TPU9oHkTZ9yRbYOrX0= golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= @@ -851,8 +846,6 @@ golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ= golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= golang.org/x/text v0.8.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8= -golang.org/x/text v0.13.0 h1:ablQoSUd0tRdKxZewP80B+BaqeKJuVhuRxj/dkrun3k= -golang.org/x/text v0.13.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE= golang.org/x/text v0.14.0 h1:ScX5w1eTa3QqT8oi6+ziP7dTV1S2+ALU0bI+0zXKWiQ= golang.org/x/text v0.14.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU= golang.org/x/time v0.0.0-20181108054448-85acf8d2951c/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ= diff --git a/internal/docs_test.go b/internal/docs_test.go index a6b804193..eee440e76 100644 --- a/internal/docs_test.go +++ b/internal/docs_test.go @@ -272,9 +272,9 @@ func write(t *testing.T, out io.Writer, format string, args ...interface{}) { func writeFrontMatter(t *testing.T, out io.Writer, keyVals map[string]string) { fm := "" - for key, val := range keyVals { + util.IterateSorted(keyVals, func(key, val string) { fm += fmt.Sprintf("%s: %s\n", key, val) - } + }) if fm != "" { fm = "---\n" + fm + "---\n\n"