From 1c3c744ad5df8f383020f41a4c3a068daf2d9185 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cain=C3=A3=20Costa?= Date: Tue, 19 May 2020 14:04:59 -0300 Subject: [PATCH 01/11] Move each version outside of archive --- content/documentation/_index.adoc | 9 +++++---- content/documentation/archive/_index.adoc | 7 ------- content/documentation/edge/_index.adoc | 6 ++++++ content/documentation/{ => edge}/architecture.adoc | 0 .../{archive/v1.0 => edge}/developer-api/.gitignore | 0 .../v1.18 => edge}/distributed-tracing/index.adoc | 0 .../{archive/v1.14 => edge}/extensions/index.adoc | 0 .../{archive/v1.18 => edge}/features/index.adoc | 0 .../documentation/{ => edge}/getting-started/index.adoc | 0 .../{archive/v1.10 => edge}/glossary/_index.adoc | 0 .../{archive/v1.18 => edge}/glossary/concepts/index.adoc | 0 .../v1.18 => edge}/glossary/networking/index.adoc | 0 .../v1.18 => edge}/glossary/observability/index.adoc | 0 .../v1.18 => edge}/runtimes-monitoring/index.adoc | 0 .../{archive/v1.18 => edge}/validations/index.adoc | 0 content/documentation/{archive => }/v1.0/_index.adoc | 0 .../documentation/{archive => }/v1.0/architecture.adoc | 0 .../{archive/v1.1 => v1.0}/developer-api/.gitignore | 0 .../{archive => }/v1.0/distributed-tracing/index.adoc | 0 .../documentation/{archive => }/v1.0/features/index.adoc | 0 .../{archive => }/v1.0/getting-started/index.adoc | 0 .../{archive => }/v1.0/glossary/_index.adoc | 0 .../{archive => }/v1.0/glossary/concepts/index.adoc | 0 .../{archive => }/v1.0/glossary/networking/index.adoc | 0 .../{archive => }/v1.0/glossary/observability/index.adoc | 0 .../{archive => }/v1.0/known-issues/index.adoc | 0 .../{archive => }/v1.0/prerequisites/index.adoc | 0 .../{archive => }/v1.0/runtimes-monitoring/index.adoc | 0 content/documentation/{archive => }/v1.1/_index.adoc | 0 .../documentation/{archive => }/v1.1/architecture.adoc | 0 .../{archive/v1.10 => v1.1}/developer-api/.gitignore | 0 .../{archive => }/v1.1/distributed-tracing/index.adoc | 0 .../documentation/{archive => }/v1.1/features/index.adoc | 0 .../{archive => }/v1.1/getting-started/index.adoc | 0 .../{archive => }/v1.1/glossary/_index.adoc | 0 .../{archive => }/v1.1/glossary/concepts/index.adoc | 0 .../{archive => }/v1.1/glossary/networking/index.adoc | 0 .../{archive => }/v1.1/glossary/observability/index.adoc | 0 .../{archive => }/v1.1/known-issues/index.adoc | 0 .../{archive => }/v1.1/prerequisites/index.adoc | 0 .../{archive => }/v1.1/runtimes-monitoring/index.adoc | 0 content/documentation/{archive => }/v1.10/_index.adoc | 0 .../documentation/{archive => }/v1.10/architecture.adoc | 0 .../{archive/v1.11 => v1.10}/developer-api/.gitignore | 0 .../{archive => }/v1.10/distributed-tracing/index.adoc | 0 .../{archive => }/v1.10/features/index.adoc | 0 .../{archive => }/v1.10/getting-started/index.adoc | 0 .../{archive/v1.11 => v1.10}/glossary/_index.adoc | 0 .../{archive => }/v1.10/glossary/concepts/index.adoc | 0 .../{archive => }/v1.10/glossary/networking/index.adoc | 0 .../v1.10/glossary/observability/index.adoc | 0 .../{archive => }/v1.10/runtimes-monitoring/index.adoc | 0 .../{archive => }/v1.10/validations/index.adoc | 0 content/documentation/{archive => }/v1.11/_index.adoc | 0 .../documentation/{archive => }/v1.11/architecture.adoc | 0 .../{archive/v1.12 => v1.11}/developer-api/.gitignore | 0 .../{archive => }/v1.11/distributed-tracing/index.adoc | 0 .../{archive => }/v1.11/features/index.adoc | 0 .../{archive => }/v1.11/getting-started/index.adoc | 0 .../{archive/v1.12 => v1.11}/glossary/_index.adoc | 0 .../{archive => }/v1.11/glossary/concepts/index.adoc | 0 .../{archive => }/v1.11/glossary/networking/index.adoc | 0 .../v1.11/glossary/observability/index.adoc | 0 .../{archive => }/v1.11/runtimes-monitoring/index.adoc | 0 .../{archive => }/v1.11/validations/index.adoc | 0 content/documentation/{archive => }/v1.12/_index.adoc | 0 .../documentation/{archive => }/v1.12/architecture.adoc | 0 .../{archive/v1.13 => v1.12}/developer-api/.gitignore | 0 .../{archive => }/v1.12/distributed-tracing/index.adoc | 0 .../{archive => }/v1.12/features/index.adoc | 0 .../{archive => }/v1.12/getting-started/index.adoc | 0 .../{archive/v1.13 => v1.12}/glossary/_index.adoc | 0 .../{archive => }/v1.12/glossary/concepts/index.adoc | 0 .../{archive => }/v1.12/glossary/networking/index.adoc | 0 .../v1.12/glossary/observability/index.adoc | 0 .../{archive => }/v1.12/runtimes-monitoring/index.adoc | 0 .../{archive => }/v1.12/validations/index.adoc | 0 content/documentation/{archive => }/v1.13/_index.adoc | 0 .../documentation/{archive => }/v1.13/architecture.adoc | 0 .../{archive/v1.14 => v1.13}/developer-api/.gitignore | 0 .../{archive => }/v1.13/distributed-tracing/index.adoc | 0 .../{archive => }/v1.13/features/index.adoc | 0 .../{archive => }/v1.13/getting-started/index.adoc | 0 .../{archive/v1.14 => v1.13}/glossary/_index.adoc | 0 .../{archive => }/v1.13/glossary/concepts/index.adoc | 0 .../{archive => }/v1.13/glossary/networking/index.adoc | 0 .../v1.13/glossary/observability/index.adoc | 0 .../{archive => }/v1.13/runtimes-monitoring/index.adoc | 0 .../{archive => }/v1.13/validations/index.adoc | 0 content/documentation/{archive => }/v1.14/_index.adoc | 0 .../documentation/{archive => }/v1.14/architecture.adoc | 0 .../{archive/v1.15 => v1.14}/developer-api/.gitignore | 0 .../{archive => }/v1.14/distributed-tracing/index.adoc | 0 .../{archive/v1.15 => v1.14}/extensions/index.adoc | 0 .../{archive => }/v1.14/features/index.adoc | 0 .../{archive => }/v1.14/getting-started/index.adoc | 0 .../{archive/v1.15 => v1.14}/glossary/_index.adoc | 0 .../{archive => }/v1.14/glossary/concepts/index.adoc | 0 .../{archive => }/v1.14/glossary/networking/index.adoc | 0 .../v1.14/glossary/observability/index.adoc | 0 .../{archive => }/v1.14/runtimes-monitoring/index.adoc | 0 .../{archive => }/v1.14/validations/index.adoc | 0 content/documentation/{archive => }/v1.15/_index.adoc | 0 .../documentation/{archive => }/v1.15/architecture.adoc | 0 .../{archive/v1.16 => v1.15}/developer-api/.gitignore | 0 .../{archive => }/v1.15/distributed-tracing/index.adoc | 0 .../{archive/v1.16 => v1.15}/extensions/index.adoc | 0 .../{archive => }/v1.15/features/index.adoc | 0 .../{archive => }/v1.15/getting-started/index.adoc | 0 .../{archive/v1.16 => v1.15}/glossary/_index.adoc | 0 .../{archive => }/v1.15/glossary/concepts/index.adoc | 0 .../{archive => }/v1.15/glossary/networking/index.adoc | 0 .../v1.15/glossary/observability/index.adoc | 0 .../{archive => }/v1.15/runtimes-monitoring/index.adoc | 0 .../{archive => }/v1.15/validations/index.adoc | 0 content/documentation/{archive => }/v1.16/_index.adoc | 0 .../documentation/{archive => }/v1.16/architecture.adoc | 0 .../{archive/v1.17 => v1.16}/developer-api/.gitignore | 0 .../{archive => }/v1.16/distributed-tracing/index.adoc | 0 .../{archive/v1.17 => v1.16}/extensions/index.adoc | 0 .../{archive => }/v1.16/features/index.adoc | 0 .../{archive => }/v1.16/getting-started/index.adoc | 0 .../{archive/v1.17 => v1.16}/glossary/_index.adoc | 0 .../{archive => }/v1.16/glossary/concepts/index.adoc | 0 .../{archive => }/v1.16/glossary/networking/index.adoc | 0 .../v1.16/glossary/observability/index.adoc | 0 .../{archive => }/v1.16/runtimes-monitoring/index.adoc | 0 .../{archive => }/v1.16/validations/index.adoc | 0 content/documentation/{archive => }/v1.17/_index.adoc | 0 .../documentation/{archive => }/v1.17/architecture.adoc | 0 .../{archive/v1.18 => v1.17}/developer-api/.gitignore | 0 .../{archive => }/v1.17/distributed-tracing/index.adoc | 0 .../{archive/v1.18 => v1.17}/extensions/index.adoc | 0 .../{archive => }/v1.17/features/index.adoc | 0 .../{archive => }/v1.17/getting-started/index.adoc | 0 .../{archive/v1.18 => v1.17}/glossary/_index.adoc | 0 .../{archive => }/v1.17/glossary/concepts/index.adoc | 0 .../{archive => }/v1.17/glossary/networking/index.adoc | 0 .../v1.17/glossary/observability/index.adoc | 0 .../{archive => }/v1.17/runtimes-monitoring/index.adoc | 0 .../{archive => }/v1.17/validations/index.adoc | 0 content/documentation/{archive => }/v1.18/_index.adoc | 0 .../documentation/{archive => }/v1.18/architecture.adoc | 0 .../{archive/v1.2 => v1.18}/developer-api/.gitignore | 0 .../{ => v1.18}/distributed-tracing/index.adoc | 0 content/documentation/{ => v1.18}/extensions/index.adoc | 0 content/documentation/{ => v1.18}/features/index.adoc | 0 .../{archive => }/v1.18/getting-started/index.adoc | 0 .../{archive/v1.3 => v1.18}/glossary/_index.adoc | 0 .../{ => v1.18}/glossary/concepts/index.adoc | 0 .../{ => v1.18}/glossary/networking/index.adoc | 0 .../{ => v1.18}/glossary/observability/index.adoc | 0 .../{ => v1.18}/runtimes-monitoring/index.adoc | 0 content/documentation/{ => v1.18}/validations/index.adoc | 0 content/documentation/{archive => }/v1.2/_index.adoc | 0 .../documentation/{archive => }/v1.2/architecture.adoc | 0 .../{archive/v1.3 => v1.2}/developer-api/.gitignore | 0 .../{archive => }/v1.2/distributed-tracing/index.adoc | 0 .../documentation/{archive => }/v1.2/features/index.adoc | 0 .../{archive => }/v1.2/getting-started/index.adoc | 0 .../{archive => }/v1.2/glossary/_index.adoc | 0 .../{archive => }/v1.2/glossary/concepts/index.adoc | 0 .../{archive => }/v1.2/glossary/networking/index.adoc | 0 .../{archive => }/v1.2/glossary/observability/index.adoc | 0 .../{archive => }/v1.2/runtimes-monitoring/index.adoc | 0 .../{archive => }/v1.2/validations/index.adoc | 0 content/documentation/{archive => }/v1.3/_index.adoc | 0 .../documentation/{archive => }/v1.3/architecture.adoc | 0 .../{archive/v1.4 => v1.3}/developer-api/.gitignore | 0 .../{archive => }/v1.3/distributed-tracing/index.adoc | 0 .../documentation/{archive => }/v1.3/features/index.adoc | 0 .../{archive => }/v1.3/getting-started/index.adoc | 0 .../{archive/v1.4 => v1.3}/glossary/_index.adoc | 0 .../{archive => }/v1.3/glossary/concepts/index.adoc | 0 .../{archive => }/v1.3/glossary/networking/index.adoc | 0 .../{archive => }/v1.3/glossary/observability/index.adoc | 0 .../{archive => }/v1.3/runtimes-monitoring/index.adoc | 0 .../{archive => }/v1.3/validations/index.adoc | 0 content/documentation/{archive => }/v1.4/_index.adoc | 0 .../documentation/{archive => }/v1.4/architecture.adoc | 0 .../{archive/v1.5 => v1.4}/developer-api/.gitignore | 0 .../{archive => }/v1.4/distributed-tracing/index.adoc | 0 .../documentation/{archive => }/v1.4/features/index.adoc | 0 .../{archive => }/v1.4/getting-started/index.adoc | 0 .../{archive/v1.5 => v1.4}/glossary/_index.adoc | 0 .../{archive => }/v1.4/glossary/concepts/index.adoc | 0 .../{archive => }/v1.4/glossary/networking/index.adoc | 0 .../{archive => }/v1.4/glossary/observability/index.adoc | 0 .../{archive => }/v1.4/runtimes-monitoring/index.adoc | 0 .../{archive => }/v1.4/validations/index.adoc | 0 content/documentation/{archive => }/v1.5/_index.adoc | 0 .../documentation/{archive => }/v1.5/architecture.adoc | 0 .../{archive/v1.6 => v1.5}/developer-api/.gitignore | 0 .../{archive => }/v1.5/distributed-tracing/index.adoc | 0 .../documentation/{archive => }/v1.5/features/index.adoc | 0 .../{archive => }/v1.5/getting-started/index.adoc | 0 .../{archive/v1.6 => v1.5}/glossary/_index.adoc | 0 .../{archive => }/v1.5/glossary/concepts/index.adoc | 0 .../{archive => }/v1.5/glossary/networking/index.adoc | 0 .../{archive => }/v1.5/glossary/observability/index.adoc | 0 .../{archive => }/v1.5/runtimes-monitoring/index.adoc | 0 .../{archive => }/v1.5/validations/index.adoc | 0 content/documentation/{archive => }/v1.6/_index.adoc | 0 .../documentation/{archive => }/v1.6/architecture.adoc | 0 .../{archive/v1.7 => v1.6}/developer-api/.gitignore | 0 .../{archive => }/v1.6/distributed-tracing/index.adoc | 0 .../documentation/{archive => }/v1.6/features/index.adoc | 0 .../{archive => }/v1.6/getting-started/index.adoc | 0 .../{archive/v1.7 => v1.6}/glossary/_index.adoc | 0 .../{archive => }/v1.6/glossary/concepts/index.adoc | 0 .../{archive => }/v1.6/glossary/networking/index.adoc | 0 .../{archive => }/v1.6/glossary/observability/index.adoc | 0 .../{archive => }/v1.6/runtimes-monitoring/index.adoc | 0 .../{archive => }/v1.6/validations/index.adoc | 0 content/documentation/{archive => }/v1.7/_index.adoc | 0 .../documentation/{archive => }/v1.7/architecture.adoc | 0 .../{archive/v1.8 => v1.7}/developer-api/.gitignore | 0 .../{archive => }/v1.7/distributed-tracing/index.adoc | 0 .../documentation/{archive => }/v1.7/features/index.adoc | 0 .../{archive => }/v1.7/getting-started/index.adoc | 0 .../{archive/v1.8 => v1.7}/glossary/_index.adoc | 0 .../{archive => }/v1.7/glossary/concepts/index.adoc | 0 .../{archive => }/v1.7/glossary/networking/index.adoc | 0 .../{archive => }/v1.7/glossary/observability/index.adoc | 0 .../{archive => }/v1.7/runtimes-monitoring/index.adoc | 0 .../{archive => }/v1.7/validations/index.adoc | 0 content/documentation/{archive => }/v1.8/_index.adoc | 0 .../documentation/{archive => }/v1.8/architecture.adoc | 0 .../{archive/v1.9 => v1.8}/developer-api/.gitignore | 0 .../{archive => }/v1.8/distributed-tracing/index.adoc | 0 .../documentation/{archive => }/v1.8/features/index.adoc | 0 .../{archive => }/v1.8/getting-started/index.adoc | 0 .../{archive/v1.9 => v1.8}/glossary/_index.adoc | 0 .../{archive => }/v1.8/glossary/concepts/index.adoc | 0 .../{archive => }/v1.8/glossary/networking/index.adoc | 0 .../{archive => }/v1.8/glossary/observability/index.adoc | 0 .../{archive => }/v1.8/runtimes-monitoring/index.adoc | 0 .../{archive => }/v1.8/validations/index.adoc | 0 content/documentation/{archive => }/v1.9/_index.adoc | 0 .../documentation/{archive => }/v1.9/architecture.adoc | 0 .../documentation/{ => v1.9}/developer-api/.gitignore | 0 .../{archive => }/v1.9/distributed-tracing/index.adoc | 0 .../documentation/{archive => }/v1.9/features/index.adoc | 0 .../{archive => }/v1.9/getting-started/index.adoc | 0 content/documentation/{ => v1.9}/glossary/_index.adoc | 0 .../{archive => }/v1.9/glossary/concepts/index.adoc | 0 .../{archive => }/v1.9/glossary/networking/index.adoc | 0 .../{archive => }/v1.9/glossary/observability/index.adoc | 0 .../{archive => }/v1.9/runtimes-monitoring/index.adoc | 0 .../{archive => }/v1.9/validations/index.adoc | 0 250 files changed, 11 insertions(+), 11 deletions(-) delete mode 100644 content/documentation/archive/_index.adoc create mode 100644 content/documentation/edge/_index.adoc rename content/documentation/{ => edge}/architecture.adoc (100%) rename content/documentation/{archive/v1.0 => edge}/developer-api/.gitignore (100%) rename content/documentation/{archive/v1.18 => edge}/distributed-tracing/index.adoc (100%) rename content/documentation/{archive/v1.14 => edge}/extensions/index.adoc (100%) rename content/documentation/{archive/v1.18 => edge}/features/index.adoc (100%) rename content/documentation/{ => edge}/getting-started/index.adoc (100%) rename content/documentation/{archive/v1.10 => edge}/glossary/_index.adoc (100%) rename content/documentation/{archive/v1.18 => edge}/glossary/concepts/index.adoc (100%) rename content/documentation/{archive/v1.18 => edge}/glossary/networking/index.adoc (100%) rename content/documentation/{archive/v1.18 => edge}/glossary/observability/index.adoc (100%) rename content/documentation/{archive/v1.18 => edge}/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive/v1.18 => edge}/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.0/_index.adoc (100%) rename content/documentation/{archive => }/v1.0/architecture.adoc (100%) rename content/documentation/{archive/v1.1 => v1.0}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.0/distributed-tracing/index.adoc (100%) rename content/documentation/{archive => }/v1.0/features/index.adoc (100%) rename content/documentation/{archive => }/v1.0/getting-started/index.adoc (100%) rename content/documentation/{archive => }/v1.0/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.0/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.0/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.0/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.0/known-issues/index.adoc (100%) rename content/documentation/{archive => }/v1.0/prerequisites/index.adoc (100%) rename content/documentation/{archive => }/v1.0/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.1/_index.adoc (100%) rename content/documentation/{archive => }/v1.1/architecture.adoc (100%) rename content/documentation/{archive/v1.10 => v1.1}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.1/distributed-tracing/index.adoc (100%) rename content/documentation/{archive => }/v1.1/features/index.adoc (100%) rename content/documentation/{archive => }/v1.1/getting-started/index.adoc (100%) rename content/documentation/{archive => }/v1.1/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.1/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.1/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.1/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.1/known-issues/index.adoc (100%) rename content/documentation/{archive => }/v1.1/prerequisites/index.adoc (100%) rename content/documentation/{archive => }/v1.1/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.10/_index.adoc (100%) rename content/documentation/{archive => }/v1.10/architecture.adoc (100%) rename content/documentation/{archive/v1.11 => v1.10}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.10/distributed-tracing/index.adoc (100%) rename content/documentation/{archive => }/v1.10/features/index.adoc (100%) rename content/documentation/{archive => }/v1.10/getting-started/index.adoc (100%) rename content/documentation/{archive/v1.11 => v1.10}/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.10/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.10/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.10/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.10/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.10/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.11/_index.adoc (100%) rename content/documentation/{archive => }/v1.11/architecture.adoc (100%) rename content/documentation/{archive/v1.12 => v1.11}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.11/distributed-tracing/index.adoc (100%) rename content/documentation/{archive => }/v1.11/features/index.adoc (100%) rename content/documentation/{archive => }/v1.11/getting-started/index.adoc (100%) rename content/documentation/{archive/v1.12 => v1.11}/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.11/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.11/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.11/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.11/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.11/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.12/_index.adoc (100%) rename content/documentation/{archive => }/v1.12/architecture.adoc (100%) rename content/documentation/{archive/v1.13 => v1.12}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.12/distributed-tracing/index.adoc (100%) rename content/documentation/{archive => }/v1.12/features/index.adoc (100%) rename content/documentation/{archive => }/v1.12/getting-started/index.adoc (100%) rename content/documentation/{archive/v1.13 => v1.12}/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.12/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.12/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.12/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.12/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.12/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.13/_index.adoc (100%) rename content/documentation/{archive => }/v1.13/architecture.adoc (100%) rename content/documentation/{archive/v1.14 => v1.13}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.13/distributed-tracing/index.adoc (100%) rename content/documentation/{archive => }/v1.13/features/index.adoc (100%) rename content/documentation/{archive => }/v1.13/getting-started/index.adoc (100%) rename content/documentation/{archive/v1.14 => v1.13}/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.13/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.13/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.13/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.13/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.13/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.14/_index.adoc (100%) rename content/documentation/{archive => }/v1.14/architecture.adoc (100%) rename content/documentation/{archive/v1.15 => v1.14}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.14/distributed-tracing/index.adoc (100%) rename content/documentation/{archive/v1.15 => v1.14}/extensions/index.adoc (100%) rename content/documentation/{archive => }/v1.14/features/index.adoc (100%) rename content/documentation/{archive => }/v1.14/getting-started/index.adoc (100%) rename content/documentation/{archive/v1.15 => v1.14}/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.14/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.14/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.14/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.14/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.14/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.15/_index.adoc (100%) rename content/documentation/{archive => }/v1.15/architecture.adoc (100%) rename content/documentation/{archive/v1.16 => v1.15}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.15/distributed-tracing/index.adoc (100%) rename content/documentation/{archive/v1.16 => v1.15}/extensions/index.adoc (100%) rename content/documentation/{archive => }/v1.15/features/index.adoc (100%) rename content/documentation/{archive => }/v1.15/getting-started/index.adoc (100%) rename content/documentation/{archive/v1.16 => v1.15}/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.15/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.15/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.15/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.15/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.15/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.16/_index.adoc (100%) rename content/documentation/{archive => }/v1.16/architecture.adoc (100%) rename content/documentation/{archive/v1.17 => v1.16}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.16/distributed-tracing/index.adoc (100%) rename content/documentation/{archive/v1.17 => v1.16}/extensions/index.adoc (100%) rename content/documentation/{archive => }/v1.16/features/index.adoc (100%) rename content/documentation/{archive => }/v1.16/getting-started/index.adoc (100%) rename content/documentation/{archive/v1.17 => v1.16}/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.16/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.16/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.16/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.16/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.16/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.17/_index.adoc (100%) rename content/documentation/{archive => }/v1.17/architecture.adoc (100%) rename content/documentation/{archive/v1.18 => v1.17}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.17/distributed-tracing/index.adoc (100%) rename content/documentation/{archive/v1.18 => v1.17}/extensions/index.adoc (100%) rename content/documentation/{archive => }/v1.17/features/index.adoc (100%) rename content/documentation/{archive => }/v1.17/getting-started/index.adoc (100%) rename content/documentation/{archive/v1.18 => v1.17}/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.17/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.17/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.17/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.17/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.17/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.18/_index.adoc (100%) rename content/documentation/{archive => }/v1.18/architecture.adoc (100%) rename content/documentation/{archive/v1.2 => v1.18}/developer-api/.gitignore (100%) rename content/documentation/{ => v1.18}/distributed-tracing/index.adoc (100%) rename content/documentation/{ => v1.18}/extensions/index.adoc (100%) rename content/documentation/{ => v1.18}/features/index.adoc (100%) rename content/documentation/{archive => }/v1.18/getting-started/index.adoc (100%) rename content/documentation/{archive/v1.3 => v1.18}/glossary/_index.adoc (100%) rename content/documentation/{ => v1.18}/glossary/concepts/index.adoc (100%) rename content/documentation/{ => v1.18}/glossary/networking/index.adoc (100%) rename content/documentation/{ => v1.18}/glossary/observability/index.adoc (100%) rename content/documentation/{ => v1.18}/runtimes-monitoring/index.adoc (100%) rename content/documentation/{ => v1.18}/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.2/_index.adoc (100%) rename content/documentation/{archive => }/v1.2/architecture.adoc (100%) rename content/documentation/{archive/v1.3 => v1.2}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.2/distributed-tracing/index.adoc (100%) rename content/documentation/{archive => }/v1.2/features/index.adoc (100%) rename content/documentation/{archive => }/v1.2/getting-started/index.adoc (100%) rename content/documentation/{archive => }/v1.2/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.2/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.2/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.2/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.2/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.2/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.3/_index.adoc (100%) rename content/documentation/{archive => }/v1.3/architecture.adoc (100%) rename content/documentation/{archive/v1.4 => v1.3}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.3/distributed-tracing/index.adoc (100%) rename content/documentation/{archive => }/v1.3/features/index.adoc (100%) rename content/documentation/{archive => }/v1.3/getting-started/index.adoc (100%) rename content/documentation/{archive/v1.4 => v1.3}/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.3/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.3/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.3/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.3/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.3/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.4/_index.adoc (100%) rename content/documentation/{archive => }/v1.4/architecture.adoc (100%) rename content/documentation/{archive/v1.5 => v1.4}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.4/distributed-tracing/index.adoc (100%) rename content/documentation/{archive => }/v1.4/features/index.adoc (100%) rename content/documentation/{archive => }/v1.4/getting-started/index.adoc (100%) rename content/documentation/{archive/v1.5 => v1.4}/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.4/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.4/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.4/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.4/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.4/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.5/_index.adoc (100%) rename content/documentation/{archive => }/v1.5/architecture.adoc (100%) rename content/documentation/{archive/v1.6 => v1.5}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.5/distributed-tracing/index.adoc (100%) rename content/documentation/{archive => }/v1.5/features/index.adoc (100%) rename content/documentation/{archive => }/v1.5/getting-started/index.adoc (100%) rename content/documentation/{archive/v1.6 => v1.5}/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.5/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.5/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.5/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.5/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.5/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.6/_index.adoc (100%) rename content/documentation/{archive => }/v1.6/architecture.adoc (100%) rename content/documentation/{archive/v1.7 => v1.6}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.6/distributed-tracing/index.adoc (100%) rename content/documentation/{archive => }/v1.6/features/index.adoc (100%) rename content/documentation/{archive => }/v1.6/getting-started/index.adoc (100%) rename content/documentation/{archive/v1.7 => v1.6}/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.6/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.6/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.6/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.6/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.6/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.7/_index.adoc (100%) rename content/documentation/{archive => }/v1.7/architecture.adoc (100%) rename content/documentation/{archive/v1.8 => v1.7}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.7/distributed-tracing/index.adoc (100%) rename content/documentation/{archive => }/v1.7/features/index.adoc (100%) rename content/documentation/{archive => }/v1.7/getting-started/index.adoc (100%) rename content/documentation/{archive/v1.8 => v1.7}/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.7/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.7/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.7/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.7/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.7/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.8/_index.adoc (100%) rename content/documentation/{archive => }/v1.8/architecture.adoc (100%) rename content/documentation/{archive/v1.9 => v1.8}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.8/distributed-tracing/index.adoc (100%) rename content/documentation/{archive => }/v1.8/features/index.adoc (100%) rename content/documentation/{archive => }/v1.8/getting-started/index.adoc (100%) rename content/documentation/{archive/v1.9 => v1.8}/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.8/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.8/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.8/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.8/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.8/validations/index.adoc (100%) rename content/documentation/{archive => }/v1.9/_index.adoc (100%) rename content/documentation/{archive => }/v1.9/architecture.adoc (100%) rename content/documentation/{ => v1.9}/developer-api/.gitignore (100%) rename content/documentation/{archive => }/v1.9/distributed-tracing/index.adoc (100%) rename content/documentation/{archive => }/v1.9/features/index.adoc (100%) rename content/documentation/{archive => }/v1.9/getting-started/index.adoc (100%) rename content/documentation/{ => v1.9}/glossary/_index.adoc (100%) rename content/documentation/{archive => }/v1.9/glossary/concepts/index.adoc (100%) rename content/documentation/{archive => }/v1.9/glossary/networking/index.adoc (100%) rename content/documentation/{archive => }/v1.9/glossary/observability/index.adoc (100%) rename content/documentation/{archive => }/v1.9/runtimes-monitoring/index.adoc (100%) rename content/documentation/{archive => }/v1.9/validations/index.adoc (100%) diff --git a/content/documentation/_index.adoc b/content/documentation/_index.adoc index 64af4aea6..a938c4c0a 100644 --- a/content/documentation/_index.adoc +++ b/content/documentation/_index.adoc @@ -1,6 +1,7 @@ --- -title: "Documentation" -date: 2018-06-20T19:04:38+02:00 +title: "Archive" +date: 2020-04-03T01:05:25-03:00 draft: false -type: "documentation" ---- \ No newline at end of file +--- + +Here you can find the documentation for older versions of Kiali. diff --git a/content/documentation/archive/_index.adoc b/content/documentation/archive/_index.adoc deleted file mode 100644 index a938c4c0a..000000000 --- a/content/documentation/archive/_index.adoc +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: "Archive" -date: 2020-04-03T01:05:25-03:00 -draft: false ---- - -Here you can find the documentation for older versions of Kiali. diff --git a/content/documentation/edge/_index.adoc b/content/documentation/edge/_index.adoc new file mode 100644 index 000000000..64af4aea6 --- /dev/null +++ b/content/documentation/edge/_index.adoc @@ -0,0 +1,6 @@ +--- +title: "Documentation" +date: 2018-06-20T19:04:38+02:00 +draft: false +type: "documentation" +--- \ No newline at end of file diff --git a/content/documentation/architecture.adoc b/content/documentation/edge/architecture.adoc similarity index 100% rename from content/documentation/architecture.adoc rename to content/documentation/edge/architecture.adoc diff --git a/content/documentation/archive/v1.0/developer-api/.gitignore b/content/documentation/edge/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.0/developer-api/.gitignore rename to content/documentation/edge/developer-api/.gitignore diff --git a/content/documentation/archive/v1.18/distributed-tracing/index.adoc b/content/documentation/edge/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.18/distributed-tracing/index.adoc rename to content/documentation/edge/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.14/extensions/index.adoc b/content/documentation/edge/extensions/index.adoc similarity index 100% rename from content/documentation/archive/v1.14/extensions/index.adoc rename to content/documentation/edge/extensions/index.adoc diff --git a/content/documentation/archive/v1.18/features/index.adoc b/content/documentation/edge/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.18/features/index.adoc rename to content/documentation/edge/features/index.adoc diff --git a/content/documentation/getting-started/index.adoc b/content/documentation/edge/getting-started/index.adoc similarity index 100% rename from content/documentation/getting-started/index.adoc rename to content/documentation/edge/getting-started/index.adoc diff --git a/content/documentation/archive/v1.10/glossary/_index.adoc b/content/documentation/edge/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.10/glossary/_index.adoc rename to content/documentation/edge/glossary/_index.adoc diff --git a/content/documentation/archive/v1.18/glossary/concepts/index.adoc b/content/documentation/edge/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.18/glossary/concepts/index.adoc rename to content/documentation/edge/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.18/glossary/networking/index.adoc b/content/documentation/edge/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.18/glossary/networking/index.adoc rename to content/documentation/edge/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.18/glossary/observability/index.adoc b/content/documentation/edge/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.18/glossary/observability/index.adoc rename to content/documentation/edge/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.18/runtimes-monitoring/index.adoc b/content/documentation/edge/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.18/runtimes-monitoring/index.adoc rename to content/documentation/edge/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.18/validations/index.adoc b/content/documentation/edge/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.18/validations/index.adoc rename to content/documentation/edge/validations/index.adoc diff --git a/content/documentation/archive/v1.0/_index.adoc b/content/documentation/v1.0/_index.adoc similarity index 100% rename from content/documentation/archive/v1.0/_index.adoc rename to content/documentation/v1.0/_index.adoc diff --git a/content/documentation/archive/v1.0/architecture.adoc b/content/documentation/v1.0/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.0/architecture.adoc rename to content/documentation/v1.0/architecture.adoc diff --git a/content/documentation/archive/v1.1/developer-api/.gitignore b/content/documentation/v1.0/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.1/developer-api/.gitignore rename to content/documentation/v1.0/developer-api/.gitignore diff --git a/content/documentation/archive/v1.0/distributed-tracing/index.adoc b/content/documentation/v1.0/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.0/distributed-tracing/index.adoc rename to content/documentation/v1.0/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.0/features/index.adoc b/content/documentation/v1.0/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.0/features/index.adoc rename to content/documentation/v1.0/features/index.adoc diff --git a/content/documentation/archive/v1.0/getting-started/index.adoc b/content/documentation/v1.0/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.0/getting-started/index.adoc rename to content/documentation/v1.0/getting-started/index.adoc diff --git a/content/documentation/archive/v1.0/glossary/_index.adoc b/content/documentation/v1.0/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.0/glossary/_index.adoc rename to content/documentation/v1.0/glossary/_index.adoc diff --git a/content/documentation/archive/v1.0/glossary/concepts/index.adoc b/content/documentation/v1.0/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.0/glossary/concepts/index.adoc rename to content/documentation/v1.0/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.0/glossary/networking/index.adoc b/content/documentation/v1.0/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.0/glossary/networking/index.adoc rename to content/documentation/v1.0/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.0/glossary/observability/index.adoc b/content/documentation/v1.0/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.0/glossary/observability/index.adoc rename to content/documentation/v1.0/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.0/known-issues/index.adoc b/content/documentation/v1.0/known-issues/index.adoc similarity index 100% rename from content/documentation/archive/v1.0/known-issues/index.adoc rename to content/documentation/v1.0/known-issues/index.adoc diff --git a/content/documentation/archive/v1.0/prerequisites/index.adoc b/content/documentation/v1.0/prerequisites/index.adoc similarity index 100% rename from content/documentation/archive/v1.0/prerequisites/index.adoc rename to content/documentation/v1.0/prerequisites/index.adoc diff --git a/content/documentation/archive/v1.0/runtimes-monitoring/index.adoc b/content/documentation/v1.0/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.0/runtimes-monitoring/index.adoc rename to content/documentation/v1.0/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.1/_index.adoc b/content/documentation/v1.1/_index.adoc similarity index 100% rename from content/documentation/archive/v1.1/_index.adoc rename to content/documentation/v1.1/_index.adoc diff --git a/content/documentation/archive/v1.1/architecture.adoc b/content/documentation/v1.1/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.1/architecture.adoc rename to content/documentation/v1.1/architecture.adoc diff --git a/content/documentation/archive/v1.10/developer-api/.gitignore b/content/documentation/v1.1/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.10/developer-api/.gitignore rename to content/documentation/v1.1/developer-api/.gitignore diff --git a/content/documentation/archive/v1.1/distributed-tracing/index.adoc b/content/documentation/v1.1/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.1/distributed-tracing/index.adoc rename to content/documentation/v1.1/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.1/features/index.adoc b/content/documentation/v1.1/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.1/features/index.adoc rename to content/documentation/v1.1/features/index.adoc diff --git a/content/documentation/archive/v1.1/getting-started/index.adoc b/content/documentation/v1.1/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.1/getting-started/index.adoc rename to content/documentation/v1.1/getting-started/index.adoc diff --git a/content/documentation/archive/v1.1/glossary/_index.adoc b/content/documentation/v1.1/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.1/glossary/_index.adoc rename to content/documentation/v1.1/glossary/_index.adoc diff --git a/content/documentation/archive/v1.1/glossary/concepts/index.adoc b/content/documentation/v1.1/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.1/glossary/concepts/index.adoc rename to content/documentation/v1.1/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.1/glossary/networking/index.adoc b/content/documentation/v1.1/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.1/glossary/networking/index.adoc rename to content/documentation/v1.1/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.1/glossary/observability/index.adoc b/content/documentation/v1.1/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.1/glossary/observability/index.adoc rename to content/documentation/v1.1/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.1/known-issues/index.adoc b/content/documentation/v1.1/known-issues/index.adoc similarity index 100% rename from content/documentation/archive/v1.1/known-issues/index.adoc rename to content/documentation/v1.1/known-issues/index.adoc diff --git a/content/documentation/archive/v1.1/prerequisites/index.adoc b/content/documentation/v1.1/prerequisites/index.adoc similarity index 100% rename from content/documentation/archive/v1.1/prerequisites/index.adoc rename to content/documentation/v1.1/prerequisites/index.adoc diff --git a/content/documentation/archive/v1.1/runtimes-monitoring/index.adoc b/content/documentation/v1.1/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.1/runtimes-monitoring/index.adoc rename to content/documentation/v1.1/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.10/_index.adoc b/content/documentation/v1.10/_index.adoc similarity index 100% rename from content/documentation/archive/v1.10/_index.adoc rename to content/documentation/v1.10/_index.adoc diff --git a/content/documentation/archive/v1.10/architecture.adoc b/content/documentation/v1.10/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.10/architecture.adoc rename to content/documentation/v1.10/architecture.adoc diff --git a/content/documentation/archive/v1.11/developer-api/.gitignore b/content/documentation/v1.10/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.11/developer-api/.gitignore rename to content/documentation/v1.10/developer-api/.gitignore diff --git a/content/documentation/archive/v1.10/distributed-tracing/index.adoc b/content/documentation/v1.10/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.10/distributed-tracing/index.adoc rename to content/documentation/v1.10/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.10/features/index.adoc b/content/documentation/v1.10/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.10/features/index.adoc rename to content/documentation/v1.10/features/index.adoc diff --git a/content/documentation/archive/v1.10/getting-started/index.adoc b/content/documentation/v1.10/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.10/getting-started/index.adoc rename to content/documentation/v1.10/getting-started/index.adoc diff --git a/content/documentation/archive/v1.11/glossary/_index.adoc b/content/documentation/v1.10/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.11/glossary/_index.adoc rename to content/documentation/v1.10/glossary/_index.adoc diff --git a/content/documentation/archive/v1.10/glossary/concepts/index.adoc b/content/documentation/v1.10/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.10/glossary/concepts/index.adoc rename to content/documentation/v1.10/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.10/glossary/networking/index.adoc b/content/documentation/v1.10/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.10/glossary/networking/index.adoc rename to content/documentation/v1.10/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.10/glossary/observability/index.adoc b/content/documentation/v1.10/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.10/glossary/observability/index.adoc rename to content/documentation/v1.10/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.10/runtimes-monitoring/index.adoc b/content/documentation/v1.10/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.10/runtimes-monitoring/index.adoc rename to content/documentation/v1.10/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.10/validations/index.adoc b/content/documentation/v1.10/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.10/validations/index.adoc rename to content/documentation/v1.10/validations/index.adoc diff --git a/content/documentation/archive/v1.11/_index.adoc b/content/documentation/v1.11/_index.adoc similarity index 100% rename from content/documentation/archive/v1.11/_index.adoc rename to content/documentation/v1.11/_index.adoc diff --git a/content/documentation/archive/v1.11/architecture.adoc b/content/documentation/v1.11/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.11/architecture.adoc rename to content/documentation/v1.11/architecture.adoc diff --git a/content/documentation/archive/v1.12/developer-api/.gitignore b/content/documentation/v1.11/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.12/developer-api/.gitignore rename to content/documentation/v1.11/developer-api/.gitignore diff --git a/content/documentation/archive/v1.11/distributed-tracing/index.adoc b/content/documentation/v1.11/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.11/distributed-tracing/index.adoc rename to content/documentation/v1.11/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.11/features/index.adoc b/content/documentation/v1.11/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.11/features/index.adoc rename to content/documentation/v1.11/features/index.adoc diff --git a/content/documentation/archive/v1.11/getting-started/index.adoc b/content/documentation/v1.11/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.11/getting-started/index.adoc rename to content/documentation/v1.11/getting-started/index.adoc diff --git a/content/documentation/archive/v1.12/glossary/_index.adoc b/content/documentation/v1.11/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.12/glossary/_index.adoc rename to content/documentation/v1.11/glossary/_index.adoc diff --git a/content/documentation/archive/v1.11/glossary/concepts/index.adoc b/content/documentation/v1.11/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.11/glossary/concepts/index.adoc rename to content/documentation/v1.11/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.11/glossary/networking/index.adoc b/content/documentation/v1.11/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.11/glossary/networking/index.adoc rename to content/documentation/v1.11/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.11/glossary/observability/index.adoc b/content/documentation/v1.11/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.11/glossary/observability/index.adoc rename to content/documentation/v1.11/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.11/runtimes-monitoring/index.adoc b/content/documentation/v1.11/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.11/runtimes-monitoring/index.adoc rename to content/documentation/v1.11/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.11/validations/index.adoc b/content/documentation/v1.11/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.11/validations/index.adoc rename to content/documentation/v1.11/validations/index.adoc diff --git a/content/documentation/archive/v1.12/_index.adoc b/content/documentation/v1.12/_index.adoc similarity index 100% rename from content/documentation/archive/v1.12/_index.adoc rename to content/documentation/v1.12/_index.adoc diff --git a/content/documentation/archive/v1.12/architecture.adoc b/content/documentation/v1.12/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.12/architecture.adoc rename to content/documentation/v1.12/architecture.adoc diff --git a/content/documentation/archive/v1.13/developer-api/.gitignore b/content/documentation/v1.12/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.13/developer-api/.gitignore rename to content/documentation/v1.12/developer-api/.gitignore diff --git a/content/documentation/archive/v1.12/distributed-tracing/index.adoc b/content/documentation/v1.12/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.12/distributed-tracing/index.adoc rename to content/documentation/v1.12/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.12/features/index.adoc b/content/documentation/v1.12/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.12/features/index.adoc rename to content/documentation/v1.12/features/index.adoc diff --git a/content/documentation/archive/v1.12/getting-started/index.adoc b/content/documentation/v1.12/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.12/getting-started/index.adoc rename to content/documentation/v1.12/getting-started/index.adoc diff --git a/content/documentation/archive/v1.13/glossary/_index.adoc b/content/documentation/v1.12/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.13/glossary/_index.adoc rename to content/documentation/v1.12/glossary/_index.adoc diff --git a/content/documentation/archive/v1.12/glossary/concepts/index.adoc b/content/documentation/v1.12/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.12/glossary/concepts/index.adoc rename to content/documentation/v1.12/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.12/glossary/networking/index.adoc b/content/documentation/v1.12/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.12/glossary/networking/index.adoc rename to content/documentation/v1.12/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.12/glossary/observability/index.adoc b/content/documentation/v1.12/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.12/glossary/observability/index.adoc rename to content/documentation/v1.12/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.12/runtimes-monitoring/index.adoc b/content/documentation/v1.12/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.12/runtimes-monitoring/index.adoc rename to content/documentation/v1.12/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.12/validations/index.adoc b/content/documentation/v1.12/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.12/validations/index.adoc rename to content/documentation/v1.12/validations/index.adoc diff --git a/content/documentation/archive/v1.13/_index.adoc b/content/documentation/v1.13/_index.adoc similarity index 100% rename from content/documentation/archive/v1.13/_index.adoc rename to content/documentation/v1.13/_index.adoc diff --git a/content/documentation/archive/v1.13/architecture.adoc b/content/documentation/v1.13/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.13/architecture.adoc rename to content/documentation/v1.13/architecture.adoc diff --git a/content/documentation/archive/v1.14/developer-api/.gitignore b/content/documentation/v1.13/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.14/developer-api/.gitignore rename to content/documentation/v1.13/developer-api/.gitignore diff --git a/content/documentation/archive/v1.13/distributed-tracing/index.adoc b/content/documentation/v1.13/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.13/distributed-tracing/index.adoc rename to content/documentation/v1.13/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.13/features/index.adoc b/content/documentation/v1.13/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.13/features/index.adoc rename to content/documentation/v1.13/features/index.adoc diff --git a/content/documentation/archive/v1.13/getting-started/index.adoc b/content/documentation/v1.13/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.13/getting-started/index.adoc rename to content/documentation/v1.13/getting-started/index.adoc diff --git a/content/documentation/archive/v1.14/glossary/_index.adoc b/content/documentation/v1.13/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.14/glossary/_index.adoc rename to content/documentation/v1.13/glossary/_index.adoc diff --git a/content/documentation/archive/v1.13/glossary/concepts/index.adoc b/content/documentation/v1.13/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.13/glossary/concepts/index.adoc rename to content/documentation/v1.13/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.13/glossary/networking/index.adoc b/content/documentation/v1.13/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.13/glossary/networking/index.adoc rename to content/documentation/v1.13/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.13/glossary/observability/index.adoc b/content/documentation/v1.13/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.13/glossary/observability/index.adoc rename to content/documentation/v1.13/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.13/runtimes-monitoring/index.adoc b/content/documentation/v1.13/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.13/runtimes-monitoring/index.adoc rename to content/documentation/v1.13/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.13/validations/index.adoc b/content/documentation/v1.13/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.13/validations/index.adoc rename to content/documentation/v1.13/validations/index.adoc diff --git a/content/documentation/archive/v1.14/_index.adoc b/content/documentation/v1.14/_index.adoc similarity index 100% rename from content/documentation/archive/v1.14/_index.adoc rename to content/documentation/v1.14/_index.adoc diff --git a/content/documentation/archive/v1.14/architecture.adoc b/content/documentation/v1.14/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.14/architecture.adoc rename to content/documentation/v1.14/architecture.adoc diff --git a/content/documentation/archive/v1.15/developer-api/.gitignore b/content/documentation/v1.14/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.15/developer-api/.gitignore rename to content/documentation/v1.14/developer-api/.gitignore diff --git a/content/documentation/archive/v1.14/distributed-tracing/index.adoc b/content/documentation/v1.14/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.14/distributed-tracing/index.adoc rename to content/documentation/v1.14/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.15/extensions/index.adoc b/content/documentation/v1.14/extensions/index.adoc similarity index 100% rename from content/documentation/archive/v1.15/extensions/index.adoc rename to content/documentation/v1.14/extensions/index.adoc diff --git a/content/documentation/archive/v1.14/features/index.adoc b/content/documentation/v1.14/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.14/features/index.adoc rename to content/documentation/v1.14/features/index.adoc diff --git a/content/documentation/archive/v1.14/getting-started/index.adoc b/content/documentation/v1.14/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.14/getting-started/index.adoc rename to content/documentation/v1.14/getting-started/index.adoc diff --git a/content/documentation/archive/v1.15/glossary/_index.adoc b/content/documentation/v1.14/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.15/glossary/_index.adoc rename to content/documentation/v1.14/glossary/_index.adoc diff --git a/content/documentation/archive/v1.14/glossary/concepts/index.adoc b/content/documentation/v1.14/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.14/glossary/concepts/index.adoc rename to content/documentation/v1.14/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.14/glossary/networking/index.adoc b/content/documentation/v1.14/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.14/glossary/networking/index.adoc rename to content/documentation/v1.14/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.14/glossary/observability/index.adoc b/content/documentation/v1.14/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.14/glossary/observability/index.adoc rename to content/documentation/v1.14/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.14/runtimes-monitoring/index.adoc b/content/documentation/v1.14/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.14/runtimes-monitoring/index.adoc rename to content/documentation/v1.14/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.14/validations/index.adoc b/content/documentation/v1.14/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.14/validations/index.adoc rename to content/documentation/v1.14/validations/index.adoc diff --git a/content/documentation/archive/v1.15/_index.adoc b/content/documentation/v1.15/_index.adoc similarity index 100% rename from content/documentation/archive/v1.15/_index.adoc rename to content/documentation/v1.15/_index.adoc diff --git a/content/documentation/archive/v1.15/architecture.adoc b/content/documentation/v1.15/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.15/architecture.adoc rename to content/documentation/v1.15/architecture.adoc diff --git a/content/documentation/archive/v1.16/developer-api/.gitignore b/content/documentation/v1.15/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.16/developer-api/.gitignore rename to content/documentation/v1.15/developer-api/.gitignore diff --git a/content/documentation/archive/v1.15/distributed-tracing/index.adoc b/content/documentation/v1.15/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.15/distributed-tracing/index.adoc rename to content/documentation/v1.15/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.16/extensions/index.adoc b/content/documentation/v1.15/extensions/index.adoc similarity index 100% rename from content/documentation/archive/v1.16/extensions/index.adoc rename to content/documentation/v1.15/extensions/index.adoc diff --git a/content/documentation/archive/v1.15/features/index.adoc b/content/documentation/v1.15/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.15/features/index.adoc rename to content/documentation/v1.15/features/index.adoc diff --git a/content/documentation/archive/v1.15/getting-started/index.adoc b/content/documentation/v1.15/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.15/getting-started/index.adoc rename to content/documentation/v1.15/getting-started/index.adoc diff --git a/content/documentation/archive/v1.16/glossary/_index.adoc b/content/documentation/v1.15/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.16/glossary/_index.adoc rename to content/documentation/v1.15/glossary/_index.adoc diff --git a/content/documentation/archive/v1.15/glossary/concepts/index.adoc b/content/documentation/v1.15/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.15/glossary/concepts/index.adoc rename to content/documentation/v1.15/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.15/glossary/networking/index.adoc b/content/documentation/v1.15/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.15/glossary/networking/index.adoc rename to content/documentation/v1.15/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.15/glossary/observability/index.adoc b/content/documentation/v1.15/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.15/glossary/observability/index.adoc rename to content/documentation/v1.15/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.15/runtimes-monitoring/index.adoc b/content/documentation/v1.15/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.15/runtimes-monitoring/index.adoc rename to content/documentation/v1.15/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.15/validations/index.adoc b/content/documentation/v1.15/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.15/validations/index.adoc rename to content/documentation/v1.15/validations/index.adoc diff --git a/content/documentation/archive/v1.16/_index.adoc b/content/documentation/v1.16/_index.adoc similarity index 100% rename from content/documentation/archive/v1.16/_index.adoc rename to content/documentation/v1.16/_index.adoc diff --git a/content/documentation/archive/v1.16/architecture.adoc b/content/documentation/v1.16/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.16/architecture.adoc rename to content/documentation/v1.16/architecture.adoc diff --git a/content/documentation/archive/v1.17/developer-api/.gitignore b/content/documentation/v1.16/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.17/developer-api/.gitignore rename to content/documentation/v1.16/developer-api/.gitignore diff --git a/content/documentation/archive/v1.16/distributed-tracing/index.adoc b/content/documentation/v1.16/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.16/distributed-tracing/index.adoc rename to content/documentation/v1.16/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.17/extensions/index.adoc b/content/documentation/v1.16/extensions/index.adoc similarity index 100% rename from content/documentation/archive/v1.17/extensions/index.adoc rename to content/documentation/v1.16/extensions/index.adoc diff --git a/content/documentation/archive/v1.16/features/index.adoc b/content/documentation/v1.16/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.16/features/index.adoc rename to content/documentation/v1.16/features/index.adoc diff --git a/content/documentation/archive/v1.16/getting-started/index.adoc b/content/documentation/v1.16/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.16/getting-started/index.adoc rename to content/documentation/v1.16/getting-started/index.adoc diff --git a/content/documentation/archive/v1.17/glossary/_index.adoc b/content/documentation/v1.16/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.17/glossary/_index.adoc rename to content/documentation/v1.16/glossary/_index.adoc diff --git a/content/documentation/archive/v1.16/glossary/concepts/index.adoc b/content/documentation/v1.16/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.16/glossary/concepts/index.adoc rename to content/documentation/v1.16/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.16/glossary/networking/index.adoc b/content/documentation/v1.16/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.16/glossary/networking/index.adoc rename to content/documentation/v1.16/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.16/glossary/observability/index.adoc b/content/documentation/v1.16/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.16/glossary/observability/index.adoc rename to content/documentation/v1.16/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.16/runtimes-monitoring/index.adoc b/content/documentation/v1.16/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.16/runtimes-monitoring/index.adoc rename to content/documentation/v1.16/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.16/validations/index.adoc b/content/documentation/v1.16/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.16/validations/index.adoc rename to content/documentation/v1.16/validations/index.adoc diff --git a/content/documentation/archive/v1.17/_index.adoc b/content/documentation/v1.17/_index.adoc similarity index 100% rename from content/documentation/archive/v1.17/_index.adoc rename to content/documentation/v1.17/_index.adoc diff --git a/content/documentation/archive/v1.17/architecture.adoc b/content/documentation/v1.17/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.17/architecture.adoc rename to content/documentation/v1.17/architecture.adoc diff --git a/content/documentation/archive/v1.18/developer-api/.gitignore b/content/documentation/v1.17/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.18/developer-api/.gitignore rename to content/documentation/v1.17/developer-api/.gitignore diff --git a/content/documentation/archive/v1.17/distributed-tracing/index.adoc b/content/documentation/v1.17/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.17/distributed-tracing/index.adoc rename to content/documentation/v1.17/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.18/extensions/index.adoc b/content/documentation/v1.17/extensions/index.adoc similarity index 100% rename from content/documentation/archive/v1.18/extensions/index.adoc rename to content/documentation/v1.17/extensions/index.adoc diff --git a/content/documentation/archive/v1.17/features/index.adoc b/content/documentation/v1.17/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.17/features/index.adoc rename to content/documentation/v1.17/features/index.adoc diff --git a/content/documentation/archive/v1.17/getting-started/index.adoc b/content/documentation/v1.17/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.17/getting-started/index.adoc rename to content/documentation/v1.17/getting-started/index.adoc diff --git a/content/documentation/archive/v1.18/glossary/_index.adoc b/content/documentation/v1.17/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.18/glossary/_index.adoc rename to content/documentation/v1.17/glossary/_index.adoc diff --git a/content/documentation/archive/v1.17/glossary/concepts/index.adoc b/content/documentation/v1.17/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.17/glossary/concepts/index.adoc rename to content/documentation/v1.17/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.17/glossary/networking/index.adoc b/content/documentation/v1.17/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.17/glossary/networking/index.adoc rename to content/documentation/v1.17/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.17/glossary/observability/index.adoc b/content/documentation/v1.17/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.17/glossary/observability/index.adoc rename to content/documentation/v1.17/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.17/runtimes-monitoring/index.adoc b/content/documentation/v1.17/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.17/runtimes-monitoring/index.adoc rename to content/documentation/v1.17/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.17/validations/index.adoc b/content/documentation/v1.17/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.17/validations/index.adoc rename to content/documentation/v1.17/validations/index.adoc diff --git a/content/documentation/archive/v1.18/_index.adoc b/content/documentation/v1.18/_index.adoc similarity index 100% rename from content/documentation/archive/v1.18/_index.adoc rename to content/documentation/v1.18/_index.adoc diff --git a/content/documentation/archive/v1.18/architecture.adoc b/content/documentation/v1.18/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.18/architecture.adoc rename to content/documentation/v1.18/architecture.adoc diff --git a/content/documentation/archive/v1.2/developer-api/.gitignore b/content/documentation/v1.18/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.2/developer-api/.gitignore rename to content/documentation/v1.18/developer-api/.gitignore diff --git a/content/documentation/distributed-tracing/index.adoc b/content/documentation/v1.18/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/distributed-tracing/index.adoc rename to content/documentation/v1.18/distributed-tracing/index.adoc diff --git a/content/documentation/extensions/index.adoc b/content/documentation/v1.18/extensions/index.adoc similarity index 100% rename from content/documentation/extensions/index.adoc rename to content/documentation/v1.18/extensions/index.adoc diff --git a/content/documentation/features/index.adoc b/content/documentation/v1.18/features/index.adoc similarity index 100% rename from content/documentation/features/index.adoc rename to content/documentation/v1.18/features/index.adoc diff --git a/content/documentation/archive/v1.18/getting-started/index.adoc b/content/documentation/v1.18/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.18/getting-started/index.adoc rename to content/documentation/v1.18/getting-started/index.adoc diff --git a/content/documentation/archive/v1.3/glossary/_index.adoc b/content/documentation/v1.18/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.3/glossary/_index.adoc rename to content/documentation/v1.18/glossary/_index.adoc diff --git a/content/documentation/glossary/concepts/index.adoc b/content/documentation/v1.18/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/glossary/concepts/index.adoc rename to content/documentation/v1.18/glossary/concepts/index.adoc diff --git a/content/documentation/glossary/networking/index.adoc b/content/documentation/v1.18/glossary/networking/index.adoc similarity index 100% rename from content/documentation/glossary/networking/index.adoc rename to content/documentation/v1.18/glossary/networking/index.adoc diff --git a/content/documentation/glossary/observability/index.adoc b/content/documentation/v1.18/glossary/observability/index.adoc similarity index 100% rename from content/documentation/glossary/observability/index.adoc rename to content/documentation/v1.18/glossary/observability/index.adoc diff --git a/content/documentation/runtimes-monitoring/index.adoc b/content/documentation/v1.18/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/runtimes-monitoring/index.adoc rename to content/documentation/v1.18/runtimes-monitoring/index.adoc diff --git a/content/documentation/validations/index.adoc b/content/documentation/v1.18/validations/index.adoc similarity index 100% rename from content/documentation/validations/index.adoc rename to content/documentation/v1.18/validations/index.adoc diff --git a/content/documentation/archive/v1.2/_index.adoc b/content/documentation/v1.2/_index.adoc similarity index 100% rename from content/documentation/archive/v1.2/_index.adoc rename to content/documentation/v1.2/_index.adoc diff --git a/content/documentation/archive/v1.2/architecture.adoc b/content/documentation/v1.2/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.2/architecture.adoc rename to content/documentation/v1.2/architecture.adoc diff --git a/content/documentation/archive/v1.3/developer-api/.gitignore b/content/documentation/v1.2/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.3/developer-api/.gitignore rename to content/documentation/v1.2/developer-api/.gitignore diff --git a/content/documentation/archive/v1.2/distributed-tracing/index.adoc b/content/documentation/v1.2/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.2/distributed-tracing/index.adoc rename to content/documentation/v1.2/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.2/features/index.adoc b/content/documentation/v1.2/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.2/features/index.adoc rename to content/documentation/v1.2/features/index.adoc diff --git a/content/documentation/archive/v1.2/getting-started/index.adoc b/content/documentation/v1.2/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.2/getting-started/index.adoc rename to content/documentation/v1.2/getting-started/index.adoc diff --git a/content/documentation/archive/v1.2/glossary/_index.adoc b/content/documentation/v1.2/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.2/glossary/_index.adoc rename to content/documentation/v1.2/glossary/_index.adoc diff --git a/content/documentation/archive/v1.2/glossary/concepts/index.adoc b/content/documentation/v1.2/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.2/glossary/concepts/index.adoc rename to content/documentation/v1.2/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.2/glossary/networking/index.adoc b/content/documentation/v1.2/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.2/glossary/networking/index.adoc rename to content/documentation/v1.2/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.2/glossary/observability/index.adoc b/content/documentation/v1.2/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.2/glossary/observability/index.adoc rename to content/documentation/v1.2/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.2/runtimes-monitoring/index.adoc b/content/documentation/v1.2/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.2/runtimes-monitoring/index.adoc rename to content/documentation/v1.2/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.2/validations/index.adoc b/content/documentation/v1.2/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.2/validations/index.adoc rename to content/documentation/v1.2/validations/index.adoc diff --git a/content/documentation/archive/v1.3/_index.adoc b/content/documentation/v1.3/_index.adoc similarity index 100% rename from content/documentation/archive/v1.3/_index.adoc rename to content/documentation/v1.3/_index.adoc diff --git a/content/documentation/archive/v1.3/architecture.adoc b/content/documentation/v1.3/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.3/architecture.adoc rename to content/documentation/v1.3/architecture.adoc diff --git a/content/documentation/archive/v1.4/developer-api/.gitignore b/content/documentation/v1.3/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.4/developer-api/.gitignore rename to content/documentation/v1.3/developer-api/.gitignore diff --git a/content/documentation/archive/v1.3/distributed-tracing/index.adoc b/content/documentation/v1.3/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.3/distributed-tracing/index.adoc rename to content/documentation/v1.3/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.3/features/index.adoc b/content/documentation/v1.3/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.3/features/index.adoc rename to content/documentation/v1.3/features/index.adoc diff --git a/content/documentation/archive/v1.3/getting-started/index.adoc b/content/documentation/v1.3/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.3/getting-started/index.adoc rename to content/documentation/v1.3/getting-started/index.adoc diff --git a/content/documentation/archive/v1.4/glossary/_index.adoc b/content/documentation/v1.3/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.4/glossary/_index.adoc rename to content/documentation/v1.3/glossary/_index.adoc diff --git a/content/documentation/archive/v1.3/glossary/concepts/index.adoc b/content/documentation/v1.3/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.3/glossary/concepts/index.adoc rename to content/documentation/v1.3/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.3/glossary/networking/index.adoc b/content/documentation/v1.3/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.3/glossary/networking/index.adoc rename to content/documentation/v1.3/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.3/glossary/observability/index.adoc b/content/documentation/v1.3/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.3/glossary/observability/index.adoc rename to content/documentation/v1.3/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.3/runtimes-monitoring/index.adoc b/content/documentation/v1.3/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.3/runtimes-monitoring/index.adoc rename to content/documentation/v1.3/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.3/validations/index.adoc b/content/documentation/v1.3/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.3/validations/index.adoc rename to content/documentation/v1.3/validations/index.adoc diff --git a/content/documentation/archive/v1.4/_index.adoc b/content/documentation/v1.4/_index.adoc similarity index 100% rename from content/documentation/archive/v1.4/_index.adoc rename to content/documentation/v1.4/_index.adoc diff --git a/content/documentation/archive/v1.4/architecture.adoc b/content/documentation/v1.4/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.4/architecture.adoc rename to content/documentation/v1.4/architecture.adoc diff --git a/content/documentation/archive/v1.5/developer-api/.gitignore b/content/documentation/v1.4/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.5/developer-api/.gitignore rename to content/documentation/v1.4/developer-api/.gitignore diff --git a/content/documentation/archive/v1.4/distributed-tracing/index.adoc b/content/documentation/v1.4/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.4/distributed-tracing/index.adoc rename to content/documentation/v1.4/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.4/features/index.adoc b/content/documentation/v1.4/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.4/features/index.adoc rename to content/documentation/v1.4/features/index.adoc diff --git a/content/documentation/archive/v1.4/getting-started/index.adoc b/content/documentation/v1.4/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.4/getting-started/index.adoc rename to content/documentation/v1.4/getting-started/index.adoc diff --git a/content/documentation/archive/v1.5/glossary/_index.adoc b/content/documentation/v1.4/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.5/glossary/_index.adoc rename to content/documentation/v1.4/glossary/_index.adoc diff --git a/content/documentation/archive/v1.4/glossary/concepts/index.adoc b/content/documentation/v1.4/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.4/glossary/concepts/index.adoc rename to content/documentation/v1.4/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.4/glossary/networking/index.adoc b/content/documentation/v1.4/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.4/glossary/networking/index.adoc rename to content/documentation/v1.4/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.4/glossary/observability/index.adoc b/content/documentation/v1.4/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.4/glossary/observability/index.adoc rename to content/documentation/v1.4/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.4/runtimes-monitoring/index.adoc b/content/documentation/v1.4/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.4/runtimes-monitoring/index.adoc rename to content/documentation/v1.4/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.4/validations/index.adoc b/content/documentation/v1.4/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.4/validations/index.adoc rename to content/documentation/v1.4/validations/index.adoc diff --git a/content/documentation/archive/v1.5/_index.adoc b/content/documentation/v1.5/_index.adoc similarity index 100% rename from content/documentation/archive/v1.5/_index.adoc rename to content/documentation/v1.5/_index.adoc diff --git a/content/documentation/archive/v1.5/architecture.adoc b/content/documentation/v1.5/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.5/architecture.adoc rename to content/documentation/v1.5/architecture.adoc diff --git a/content/documentation/archive/v1.6/developer-api/.gitignore b/content/documentation/v1.5/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.6/developer-api/.gitignore rename to content/documentation/v1.5/developer-api/.gitignore diff --git a/content/documentation/archive/v1.5/distributed-tracing/index.adoc b/content/documentation/v1.5/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.5/distributed-tracing/index.adoc rename to content/documentation/v1.5/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.5/features/index.adoc b/content/documentation/v1.5/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.5/features/index.adoc rename to content/documentation/v1.5/features/index.adoc diff --git a/content/documentation/archive/v1.5/getting-started/index.adoc b/content/documentation/v1.5/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.5/getting-started/index.adoc rename to content/documentation/v1.5/getting-started/index.adoc diff --git a/content/documentation/archive/v1.6/glossary/_index.adoc b/content/documentation/v1.5/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.6/glossary/_index.adoc rename to content/documentation/v1.5/glossary/_index.adoc diff --git a/content/documentation/archive/v1.5/glossary/concepts/index.adoc b/content/documentation/v1.5/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.5/glossary/concepts/index.adoc rename to content/documentation/v1.5/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.5/glossary/networking/index.adoc b/content/documentation/v1.5/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.5/glossary/networking/index.adoc rename to content/documentation/v1.5/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.5/glossary/observability/index.adoc b/content/documentation/v1.5/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.5/glossary/observability/index.adoc rename to content/documentation/v1.5/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.5/runtimes-monitoring/index.adoc b/content/documentation/v1.5/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.5/runtimes-monitoring/index.adoc rename to content/documentation/v1.5/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.5/validations/index.adoc b/content/documentation/v1.5/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.5/validations/index.adoc rename to content/documentation/v1.5/validations/index.adoc diff --git a/content/documentation/archive/v1.6/_index.adoc b/content/documentation/v1.6/_index.adoc similarity index 100% rename from content/documentation/archive/v1.6/_index.adoc rename to content/documentation/v1.6/_index.adoc diff --git a/content/documentation/archive/v1.6/architecture.adoc b/content/documentation/v1.6/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.6/architecture.adoc rename to content/documentation/v1.6/architecture.adoc diff --git a/content/documentation/archive/v1.7/developer-api/.gitignore b/content/documentation/v1.6/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.7/developer-api/.gitignore rename to content/documentation/v1.6/developer-api/.gitignore diff --git a/content/documentation/archive/v1.6/distributed-tracing/index.adoc b/content/documentation/v1.6/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.6/distributed-tracing/index.adoc rename to content/documentation/v1.6/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.6/features/index.adoc b/content/documentation/v1.6/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.6/features/index.adoc rename to content/documentation/v1.6/features/index.adoc diff --git a/content/documentation/archive/v1.6/getting-started/index.adoc b/content/documentation/v1.6/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.6/getting-started/index.adoc rename to content/documentation/v1.6/getting-started/index.adoc diff --git a/content/documentation/archive/v1.7/glossary/_index.adoc b/content/documentation/v1.6/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.7/glossary/_index.adoc rename to content/documentation/v1.6/glossary/_index.adoc diff --git a/content/documentation/archive/v1.6/glossary/concepts/index.adoc b/content/documentation/v1.6/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.6/glossary/concepts/index.adoc rename to content/documentation/v1.6/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.6/glossary/networking/index.adoc b/content/documentation/v1.6/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.6/glossary/networking/index.adoc rename to content/documentation/v1.6/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.6/glossary/observability/index.adoc b/content/documentation/v1.6/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.6/glossary/observability/index.adoc rename to content/documentation/v1.6/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.6/runtimes-monitoring/index.adoc b/content/documentation/v1.6/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.6/runtimes-monitoring/index.adoc rename to content/documentation/v1.6/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.6/validations/index.adoc b/content/documentation/v1.6/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.6/validations/index.adoc rename to content/documentation/v1.6/validations/index.adoc diff --git a/content/documentation/archive/v1.7/_index.adoc b/content/documentation/v1.7/_index.adoc similarity index 100% rename from content/documentation/archive/v1.7/_index.adoc rename to content/documentation/v1.7/_index.adoc diff --git a/content/documentation/archive/v1.7/architecture.adoc b/content/documentation/v1.7/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.7/architecture.adoc rename to content/documentation/v1.7/architecture.adoc diff --git a/content/documentation/archive/v1.8/developer-api/.gitignore b/content/documentation/v1.7/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.8/developer-api/.gitignore rename to content/documentation/v1.7/developer-api/.gitignore diff --git a/content/documentation/archive/v1.7/distributed-tracing/index.adoc b/content/documentation/v1.7/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.7/distributed-tracing/index.adoc rename to content/documentation/v1.7/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.7/features/index.adoc b/content/documentation/v1.7/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.7/features/index.adoc rename to content/documentation/v1.7/features/index.adoc diff --git a/content/documentation/archive/v1.7/getting-started/index.adoc b/content/documentation/v1.7/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.7/getting-started/index.adoc rename to content/documentation/v1.7/getting-started/index.adoc diff --git a/content/documentation/archive/v1.8/glossary/_index.adoc b/content/documentation/v1.7/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.8/glossary/_index.adoc rename to content/documentation/v1.7/glossary/_index.adoc diff --git a/content/documentation/archive/v1.7/glossary/concepts/index.adoc b/content/documentation/v1.7/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.7/glossary/concepts/index.adoc rename to content/documentation/v1.7/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.7/glossary/networking/index.adoc b/content/documentation/v1.7/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.7/glossary/networking/index.adoc rename to content/documentation/v1.7/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.7/glossary/observability/index.adoc b/content/documentation/v1.7/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.7/glossary/observability/index.adoc rename to content/documentation/v1.7/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.7/runtimes-monitoring/index.adoc b/content/documentation/v1.7/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.7/runtimes-monitoring/index.adoc rename to content/documentation/v1.7/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.7/validations/index.adoc b/content/documentation/v1.7/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.7/validations/index.adoc rename to content/documentation/v1.7/validations/index.adoc diff --git a/content/documentation/archive/v1.8/_index.adoc b/content/documentation/v1.8/_index.adoc similarity index 100% rename from content/documentation/archive/v1.8/_index.adoc rename to content/documentation/v1.8/_index.adoc diff --git a/content/documentation/archive/v1.8/architecture.adoc b/content/documentation/v1.8/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.8/architecture.adoc rename to content/documentation/v1.8/architecture.adoc diff --git a/content/documentation/archive/v1.9/developer-api/.gitignore b/content/documentation/v1.8/developer-api/.gitignore similarity index 100% rename from content/documentation/archive/v1.9/developer-api/.gitignore rename to content/documentation/v1.8/developer-api/.gitignore diff --git a/content/documentation/archive/v1.8/distributed-tracing/index.adoc b/content/documentation/v1.8/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.8/distributed-tracing/index.adoc rename to content/documentation/v1.8/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.8/features/index.adoc b/content/documentation/v1.8/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.8/features/index.adoc rename to content/documentation/v1.8/features/index.adoc diff --git a/content/documentation/archive/v1.8/getting-started/index.adoc b/content/documentation/v1.8/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.8/getting-started/index.adoc rename to content/documentation/v1.8/getting-started/index.adoc diff --git a/content/documentation/archive/v1.9/glossary/_index.adoc b/content/documentation/v1.8/glossary/_index.adoc similarity index 100% rename from content/documentation/archive/v1.9/glossary/_index.adoc rename to content/documentation/v1.8/glossary/_index.adoc diff --git a/content/documentation/archive/v1.8/glossary/concepts/index.adoc b/content/documentation/v1.8/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.8/glossary/concepts/index.adoc rename to content/documentation/v1.8/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.8/glossary/networking/index.adoc b/content/documentation/v1.8/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.8/glossary/networking/index.adoc rename to content/documentation/v1.8/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.8/glossary/observability/index.adoc b/content/documentation/v1.8/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.8/glossary/observability/index.adoc rename to content/documentation/v1.8/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.8/runtimes-monitoring/index.adoc b/content/documentation/v1.8/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.8/runtimes-monitoring/index.adoc rename to content/documentation/v1.8/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.8/validations/index.adoc b/content/documentation/v1.8/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.8/validations/index.adoc rename to content/documentation/v1.8/validations/index.adoc diff --git a/content/documentation/archive/v1.9/_index.adoc b/content/documentation/v1.9/_index.adoc similarity index 100% rename from content/documentation/archive/v1.9/_index.adoc rename to content/documentation/v1.9/_index.adoc diff --git a/content/documentation/archive/v1.9/architecture.adoc b/content/documentation/v1.9/architecture.adoc similarity index 100% rename from content/documentation/archive/v1.9/architecture.adoc rename to content/documentation/v1.9/architecture.adoc diff --git a/content/documentation/developer-api/.gitignore b/content/documentation/v1.9/developer-api/.gitignore similarity index 100% rename from content/documentation/developer-api/.gitignore rename to content/documentation/v1.9/developer-api/.gitignore diff --git a/content/documentation/archive/v1.9/distributed-tracing/index.adoc b/content/documentation/v1.9/distributed-tracing/index.adoc similarity index 100% rename from content/documentation/archive/v1.9/distributed-tracing/index.adoc rename to content/documentation/v1.9/distributed-tracing/index.adoc diff --git a/content/documentation/archive/v1.9/features/index.adoc b/content/documentation/v1.9/features/index.adoc similarity index 100% rename from content/documentation/archive/v1.9/features/index.adoc rename to content/documentation/v1.9/features/index.adoc diff --git a/content/documentation/archive/v1.9/getting-started/index.adoc b/content/documentation/v1.9/getting-started/index.adoc similarity index 100% rename from content/documentation/archive/v1.9/getting-started/index.adoc rename to content/documentation/v1.9/getting-started/index.adoc diff --git a/content/documentation/glossary/_index.adoc b/content/documentation/v1.9/glossary/_index.adoc similarity index 100% rename from content/documentation/glossary/_index.adoc rename to content/documentation/v1.9/glossary/_index.adoc diff --git a/content/documentation/archive/v1.9/glossary/concepts/index.adoc b/content/documentation/v1.9/glossary/concepts/index.adoc similarity index 100% rename from content/documentation/archive/v1.9/glossary/concepts/index.adoc rename to content/documentation/v1.9/glossary/concepts/index.adoc diff --git a/content/documentation/archive/v1.9/glossary/networking/index.adoc b/content/documentation/v1.9/glossary/networking/index.adoc similarity index 100% rename from content/documentation/archive/v1.9/glossary/networking/index.adoc rename to content/documentation/v1.9/glossary/networking/index.adoc diff --git a/content/documentation/archive/v1.9/glossary/observability/index.adoc b/content/documentation/v1.9/glossary/observability/index.adoc similarity index 100% rename from content/documentation/archive/v1.9/glossary/observability/index.adoc rename to content/documentation/v1.9/glossary/observability/index.adoc diff --git a/content/documentation/archive/v1.9/runtimes-monitoring/index.adoc b/content/documentation/v1.9/runtimes-monitoring/index.adoc similarity index 100% rename from content/documentation/archive/v1.9/runtimes-monitoring/index.adoc rename to content/documentation/v1.9/runtimes-monitoring/index.adoc diff --git a/content/documentation/archive/v1.9/validations/index.adoc b/content/documentation/v1.9/validations/index.adoc similarity index 100% rename from content/documentation/archive/v1.9/validations/index.adoc rename to content/documentation/v1.9/validations/index.adoc From 89afb482e3fbc7ceba4fcaadfad9037af34d4444 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cain=C3=A3=20Costa?= Date: Tue, 26 May 2020 14:08:21 -0300 Subject: [PATCH 02/11] Adjust files and links to the new format --- config.toml | 76 +-------------- content/documentation/_index.adoc | 14 ++- content/documentation/edge/_index.adoc | 4 +- content/documentation/latest | 1 + content/faq/general/how-do-i-access-kiai.adoc | 2 +- scripts/build-archive.sh | 96 +++++-------------- themes/kiali/layouts/_default/list.html.html | 2 +- 7 files changed, 44 insertions(+), 151 deletions(-) create mode 120000 content/documentation/latest diff --git a/config.toml b/config.toml index d900b3bab..1a8b28e00 100644 --- a/config.toml +++ b/config.toml @@ -15,7 +15,7 @@ relativeURLs = true [[menu.main]] identifier = "main_features" name = "Features" - url = "/documentation/features" + url = "/documentation/latest/features" weight = 1 [[menu.main]] identifier = "main_news" @@ -37,7 +37,7 @@ relativeURLs = true [[menu.main]] identifier = "main_gettingstarted" name = "Getting Started" - url = "/documentation/getting-started" + url = "/documentation/latest/getting-started" weight = 3 [[menu.main]] identifier = "main_contribute" @@ -49,78 +49,6 @@ relativeURLs = true name = "Documentation" url = "/documentation" weight = 5 - [[menu.main]] - identifier = "doc_features" - name = "Features" - url = "/documentation/features" - weight = 1 - parent="main_doc" - [[menu.main]] - identifier = "validation" - name = "Validation" - url = "/documentation/validations" - weight = 1 - parent="doc_features" - [[menu.main]] - identifier = "doc_gettingstarted" - name = "Getting Started" - url = "/documentation/getting-started" - weight = 2 - parent="main_doc" - [[menu.main]] - identifier = "doc_architecture" - name = "Architecture" - url = "/documentation/architecture" - weight = 3 - parent="main_doc" - [[menu.main]] - identifier = "doc_runtimes" - name = "Custom Dashboards" - url = "/documentation/runtimes-monitoring" - weight = 4 - parent="main_doc" - [[menu.main]] - identifier = "doc_tracing" - name = "Distributed Tracing" - url = "/documentation/distributed-tracing" - weight = 5 - parent="main_doc" - [[menu.main]] - identifier = "doc_extensions" - name = "Extensions" - url = "/documentation/extensions" - weight = 6 - parent="main_doc" - [[menu.main]] - identifier = "doc_swagger" - name = "Developer API" - url = "/documentation/developer-api" - weight = 7 - parent="main_doc" - [[menu.main]] - identifier = "doc_glossary" - name = "Glossary" - url = "/documentation/glossary" - weight = 8 - parent="main_doc" - [[menu.main]] - identifier = "concepts" - name = "Concepts" - url = "/documentation/glossary/concepts" - weight = 1 - parent="doc_glossary" - [[menu.main]] - identifier = "observability" - name = "Observability" - url = "/documentation/glossary/observability" - weight = 2 - parent="doc_glossary" - [[menu.main]] - identifier = "networking" - name = "Networking" - url = "/documentation/glossary/networking" - weight = 3 - parent="doc_glossary" [[menu.main]] identifier = "main_faq" name = "FAQ" diff --git a/content/documentation/_index.adoc b/content/documentation/_index.adoc index a938c4c0a..b9bed09e0 100644 --- a/content/documentation/_index.adoc +++ b/content/documentation/_index.adoc @@ -1,7 +1,17 @@ --- -title: "Archive" +title: "Documentation" date: 2020-04-03T01:05:25-03:00 draft: false +indexTitle: "Documentation for Older Versions" --- -Here you can find the documentation for older versions of Kiali. +Here you can find all the documentation for Kiali. You can see +the documentation for the latest released version link:/documentation/latest[here]. + +Check the link:/documentation/latest/getting-started[Getting +Started] section of the documentation to get up to speed. If you +are thinking of contributing, check our +link:https://github.com/kiali/kiali[Github repo] +for more information on how to setup your own machine and +contribute. + diff --git a/content/documentation/edge/_index.adoc b/content/documentation/edge/_index.adoc index 64af4aea6..ae6892460 100644 --- a/content/documentation/edge/_index.adoc +++ b/content/documentation/edge/_index.adoc @@ -1,6 +1,6 @@ --- -title: "Documentation" +title: "Edge" date: 2018-06-20T19:04:38+02:00 draft: false type: "documentation" ---- \ No newline at end of file +--- diff --git a/content/documentation/latest b/content/documentation/latest new file mode 120000 index 000000000..5b364900a --- /dev/null +++ b/content/documentation/latest @@ -0,0 +1 @@ +v1.18 \ No newline at end of file diff --git a/content/faq/general/how-do-i-access-kiai.adoc b/content/faq/general/how-do-i-access-kiai.adoc index e3a4acaca..0477d1d0f 100644 --- a/content/faq/general/how-do-i-access-kiai.adoc +++ b/content/faq/general/how-do-i-access-kiai.adoc @@ -5,7 +5,7 @@ weight: 10 :icons: font *_This assumes that you have used the -link:{{< ref "/documentation/getting-started" >}}[Getting started instructions] to +link:{{< ref "/documentation/latest/getting-started" >}}[Getting started instructions] to install Kiali._* *If you are using OpenShift*, installation exposes Kiali through a route. The diff --git a/scripts/build-archive.sh b/scripts/build-archive.sh index 48ee0b5aa..ac7befc61 100755 --- a/scripts/build-archive.sh +++ b/scripts/build-archive.sh @@ -1,90 +1,44 @@ #!/bin/bash -color() { - local color="\e[3${1}m" - local reset="\e[0m" +set -xe - shift - - if [[ "${COLOR}" == "never" ]]; then - echo -en "${@}" - else - echo -en "${color}${@}${reset}" - fi -} - -log_prefix() { - echo -n "::" -} - -die() { - error ${@} - exit 1 -} - -error() { - echo "$(color 1 "$(log_prefix) ERROR:") ${@}" -} - -warn() { - echo "$(color 3 "$(log_prefix) WARN:") ${@}" -} - -info() { - echo "$(color 2 "$(log_prefix)") ${@}" -} - -[[ -z $(git status -s) ]] || die "The working tree is dirty. Please make sure it is clean before running." - -set -e +[[ -z $(git status -s) ]] || (echo "The working tree is dirty. Please make sure it is clean before running."; exit 1) GIT="git -c advice.detachedHead=false" current_branch=$(git rev-parse --abbrev-ref HEAD) -trap "{ ${GIT} checkout ${current_branch}; }" EXIT - -tempdir=$(mktemp -d) -trap "{ rm -rf ${tempdir}; }" EXIT - -destination="content/documentation/archive" -cp "${destination}/_index.adoc" "${tempdir}" -rm -rf "${destination}/v*" +trap '{ ${GIT} checkout ${current_branch}; }' EXIT -info "Making sure we have all the latest tags..." +echo "Making sure we have all the latest tags..." git fetch --all --tags +temp="$(mktemp -d)" + generate() { tag="${1%.0}" + root="$(pwd)/content/documentation" - info "Preparing documentation for version ${tag}" - ${GIT} checkout ${1} - mkdir ${tempdir}/${tag} - cp -r content/documentation/* "${tempdir}/${tag}/" - rm -rf "${tempdir}/${tag}/archive" + echo "Preparing documentation for version ${tag}" - find ${tempdir}/${tag} -type f -name "*.adoc" -exec sed -i -e "s/ main:/ $(echo ${tag} | tr "." "-"):/" "{}" \; - sed -i "s/Documentation/${tag}/g" "${tempdir}/${tag}/_index.adoc" + ${GIT} checkout "${1}" + mkdir "${temp}/${tag}" - ${GIT} checkout ${current_branch} -} + cp -r "${root}"/edge/* "${temp}/${tag}/" -if [ "${1}" = "all" ]; then - info "Running for versions: $(git tag --list | paste -sd "," -)" - for tag in $(git tag --list); do - generate ${tag} - done -else - info "Running for version ${1}..." + find "${temp}/${tag}" -type f -name "*.adoc" -exec sed -i -e "s/ main:/ $(echo "${tag}" | tr "." "-"):/" "{}" \; + sed -i "s/: (Edge|Documentation)/: ${tag}/g" "${temp}/${tag}/_index.adoc" - if git tag --list | grep "${1}" &>/dev/null; then - generate ${1} - else - die "Tag ${1} could not be found" - fi -fi + ${GIT} checkout "${current_branch}" + + mkdir "${root}/${tag}" + cp -r "${temp}/${tag}/*" "${root}/" +} -cp -rf ${tempdir}/* ${destination} +echo "Running for version ${1}..." -chmod 755 ${destination} -find ${destination} -type d -exec chmod 755 "{}" \; -find ${destination} -type f -exec chmod 644 "{}" \; +if git tag --list | grep "${1}" &>/dev/null; then + generate "${1}" +else + echo "Tag ${1} could not be found" + exit 1 +fi diff --git a/themes/kiali/layouts/_default/list.html.html b/themes/kiali/layouts/_default/list.html.html index c3b65c763..0cb8c2406 100644 --- a/themes/kiali/layouts/_default/list.html.html +++ b/themes/kiali/layouts/_default/list.html.html @@ -8,7 +8,7 @@

{{ .Name }}

{{ .Content }} {{ if ne .Params.hideIndex true }} -

Index

+

{{ default "Index" .Params.indexTitle }}

{{ end }} From 65425f7e7093bd24467ec523eccd2b9a4045cc1c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cain=C3=A3=20Costa?= Date: Mon, 1 Jun 2020 15:58:42 -0300 Subject: [PATCH 05/11] Fix some versioned links on documentation pages --- content/documentation/edge/features/index.adoc | 6 +++--- content/documentation/v1.0/features/index.adoc | 2 +- content/documentation/v1.0/getting-started/index.adoc | 2 +- content/documentation/v1.1/features/index.adoc | 2 +- content/documentation/v1.1/getting-started/index.adoc | 2 +- content/documentation/v1.10/features/index.adoc | 6 +++--- content/documentation/v1.11/features/index.adoc | 6 +++--- content/documentation/v1.12/features/index.adoc | 6 +++--- content/documentation/v1.13/features/index.adoc | 6 +++--- content/documentation/v1.14/features/index.adoc | 6 +++--- content/documentation/v1.15/features/index.adoc | 6 +++--- content/documentation/v1.16/features/index.adoc | 6 +++--- content/documentation/v1.17/features/index.adoc | 6 +++--- content/documentation/v1.18/features/index.adoc | 6 +++--- content/documentation/v1.2/features/index.adoc | 4 ++-- content/documentation/v1.3/features/index.adoc | 4 ++-- content/documentation/v1.4/features/index.adoc | 4 ++-- content/documentation/v1.5/features/index.adoc | 4 ++-- content/documentation/v1.6/features/index.adoc | 4 ++-- content/documentation/v1.7/features/index.adoc | 4 ++-- content/documentation/v1.8/features/index.adoc | 6 +++--- content/documentation/v1.9/features/index.adoc | 6 +++--- 22 files changed, 52 insertions(+), 52 deletions(-) diff --git a/content/documentation/edge/features/index.adoc b/content/documentation/edge/features/index.adoc index 485627a68..7d0b7bb16 100644 --- a/content/documentation/edge/features/index.adoc +++ b/content/documentation/edge/features/index.adoc @@ -186,7 +186,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain YAML or JSON files, so it's easy to keep them in source control like Git, track their changes, and share them. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/edge/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -219,7 +219,7 @@ Kiali performs a set of validations to the most common Istio Objects such as Des Galley validations are mostly syntactic validations based on the object syntax analysis of Istio objects while Kiali validations are mostly semantic validations between different Istio objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/edge/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by wizards. These are located in the *Actions* menu on the Service Details page. @@ -284,7 +284,7 @@ The following article https://medium.com/kialiproject/kiali-observability-in-act == Multi-cluster support Istio provides https://istio.io/docs/setup/install/multicluster/[installation instructions] for three different multi-cluster scenarios: replicated control planes, shared control plane with single-network, and shared control plane with multi-network. -Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. +Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/edge/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. The shared control plane scenarios are currently not supported by Kiali. diff --git a/content/documentation/v1.0/features/index.adoc b/content/documentation/v1.0/features/index.adoc index 4db61dedc..13200e845 100644 --- a/content/documentation/v1.0/features/index.adoc +++ b/content/documentation/v1.0/features/index.adoc @@ -189,7 +189,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain _yaml_ or _json_ files, it's a perfect fit for keeping under source control like GIT, track changes, share, etc. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.0/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ diff --git a/content/documentation/v1.0/getting-started/index.adoc b/content/documentation/v1.0/getting-started/index.adoc index 975f8f8c3..fd74bab0c 100644 --- a/content/documentation/v1.0/getting-started/index.adoc +++ b/content/documentation/v1.0/getting-started/index.adoc @@ -42,7 +42,7 @@ icon:lightbulb[size=1x]{nbsp}For several commands listed on this page, the OpenS == Installing Kiali -Kiali can be installed in an OpenShift or Kubernetes cluster environment. For OpenShift only, a minimal preparation is necessary. See link:/documentation/prerequisites[Prerequisites] for environment requirements. +Kiali can be installed in an OpenShift or Kubernetes cluster environment. For OpenShift only, a minimal preparation is necessary. See link:/documentation/v1.0/prerequisites[Prerequisites] for environment requirements. === OpenShift Preparation diff --git a/content/documentation/v1.1/features/index.adoc b/content/documentation/v1.1/features/index.adoc index 468925237..974d625be 100644 --- a/content/documentation/v1.1/features/index.adoc +++ b/content/documentation/v1.1/features/index.adoc @@ -189,7 +189,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain _yaml_ or _json_ files, it's a perfect fit for keeping under source control like GIT, track changes, share, etc. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.1/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ diff --git a/content/documentation/v1.1/getting-started/index.adoc b/content/documentation/v1.1/getting-started/index.adoc index 268269f89..1dfb95a20 100644 --- a/content/documentation/v1.1/getting-started/index.adoc +++ b/content/documentation/v1.1/getting-started/index.adoc @@ -42,7 +42,7 @@ icon:lightbulb[size=1x]{nbsp}For several commands listed on this page, the OpenS == Installing Kiali -Kiali can be installed in an OpenShift or Kubernetes cluster environment. For OpenShift only, a minimal preparation is necessary. See link:/documentation/prerequisites[Prerequisites] for environment requirements. +Kiali can be installed in an OpenShift or Kubernetes cluster environment. For OpenShift only, a minimal preparation is necessary. See link:/documentation/v1.1/prerequisites[Prerequisites] for environment requirements. === OpenShift Preparation diff --git a/content/documentation/v1.10/features/index.adoc b/content/documentation/v1.10/features/index.adoc index 8b800ef4a..9ab027887 100644 --- a/content/documentation/v1.10/features/index.adoc +++ b/content/documentation/v1.10/features/index.adoc @@ -189,7 +189,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain YAML or JSON files, so it's easy to keep them in source control like Git, track their changes, and share them. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.10/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -222,7 +222,7 @@ Kiali performs a set of validations to the most common Istio Objects such as Des Galley validations are mostly syntactic validations based on the object syntax analysis of Istio objects while Kiali validations are mostly semantic validations between different Istio objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.10/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by wizards. These are located in the *Actions* menu on the Service Details page. @@ -287,7 +287,7 @@ The following article https://medium.com/kialiproject/kiali-observability-in-act == Multi-cluster support Istio provides https://istio.io/docs/setup/install/multicluster/[installation instructions] for three different multi-cluster scenarios: replicated control planes, shared control plane with single-network, and shared control plane with multi-network. -Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. +Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/v1.10/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. The shared control plane scenarios are currently not supported by Kiali. diff --git a/content/documentation/v1.11/features/index.adoc b/content/documentation/v1.11/features/index.adoc index fe2ba4da4..b611d5bf2 100644 --- a/content/documentation/v1.11/features/index.adoc +++ b/content/documentation/v1.11/features/index.adoc @@ -189,7 +189,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain YAML or JSON files, so it's easy to keep them in source control like Git, track their changes, and share them. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.11/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -222,7 +222,7 @@ Kiali performs a set of validations to the most common Istio Objects such as Des Galley validations are mostly syntactic validations based on the object syntax analysis of Istio objects while Kiali validations are mostly semantic validations between different Istio objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.11/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by wizards. These are located in the *Actions* menu on the Service Details page. @@ -287,7 +287,7 @@ The following article https://medium.com/kialiproject/kiali-observability-in-act == Multi-cluster support Istio provides https://istio.io/docs/setup/install/multicluster/[installation instructions] for three different multi-cluster scenarios: replicated control planes, shared control plane with single-network, and shared control plane with multi-network. -Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. +Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/v1.11/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. The shared control plane scenarios are currently not supported by Kiali. diff --git a/content/documentation/v1.12/features/index.adoc b/content/documentation/v1.12/features/index.adoc index fb3fcf1c8..7c7c790cd 100644 --- a/content/documentation/v1.12/features/index.adoc +++ b/content/documentation/v1.12/features/index.adoc @@ -190,7 +190,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain YAML or JSON files, so it's easy to keep them in source control like Git, track their changes, and share them. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.12/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -223,7 +223,7 @@ Kiali performs a set of validations to the most common Istio Objects such as Des Galley validations are mostly syntactic validations based on the object syntax analysis of Istio objects while Kiali validations are mostly semantic validations between different Istio objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.12/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by wizards. These are located in the *Actions* menu on the Service Details page. @@ -288,7 +288,7 @@ The following article https://medium.com/kialiproject/kiali-observability-in-act == Multi-cluster support Istio provides https://istio.io/docs/setup/install/multicluster/[installation instructions] for three different multi-cluster scenarios: replicated control planes, shared control plane with single-network, and shared control plane with multi-network. -Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. +Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/v1.12/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. The shared control plane scenarios are currently not supported by Kiali. diff --git a/content/documentation/v1.13/features/index.adoc b/content/documentation/v1.13/features/index.adoc index 06aecc7aa..fb7e6a1c5 100644 --- a/content/documentation/v1.13/features/index.adoc +++ b/content/documentation/v1.13/features/index.adoc @@ -190,7 +190,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain YAML or JSON files, so it's easy to keep them in source control like Git, track their changes, and share them. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.13/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -223,7 +223,7 @@ Kiali performs a set of validations to the most common Istio Objects such as Des Galley validations are mostly syntactic validations based on the object syntax analysis of Istio objects while Kiali validations are mostly semantic validations between different Istio objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.13/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by wizards. These are located in the *Actions* menu on the Service Details page. @@ -288,7 +288,7 @@ The following article https://medium.com/kialiproject/kiali-observability-in-act == Multi-cluster support Istio provides https://istio.io/docs/setup/install/multicluster/[installation instructions] for three different multi-cluster scenarios: replicated control planes, shared control plane with single-network, and shared control plane with multi-network. -Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. +Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/v1.13/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. The shared control plane scenarios are currently not supported by Kiali. diff --git a/content/documentation/v1.14/features/index.adoc b/content/documentation/v1.14/features/index.adoc index 464483762..613216b25 100644 --- a/content/documentation/v1.14/features/index.adoc +++ b/content/documentation/v1.14/features/index.adoc @@ -190,7 +190,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain YAML or JSON files, so it's easy to keep them in source control like Git, track their changes, and share them. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.14/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -223,7 +223,7 @@ Kiali performs a set of validations to the most common Istio Objects such as Des Galley validations are mostly syntactic validations based on the object syntax analysis of Istio objects while Kiali validations are mostly semantic validations between different Istio objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.14/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by wizards. These are located in the *Actions* menu on the Service Details page. @@ -288,7 +288,7 @@ The following article https://medium.com/kialiproject/kiali-observability-in-act == Multi-cluster support Istio provides https://istio.io/docs/setup/install/multicluster/[installation instructions] for three different multi-cluster scenarios: replicated control planes, shared control plane with single-network, and shared control plane with multi-network. -Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. +Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/v1.14/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. The shared control plane scenarios are currently not supported by Kiali. diff --git a/content/documentation/v1.15/features/index.adoc b/content/documentation/v1.15/features/index.adoc index a09a4715c..4b9504afe 100644 --- a/content/documentation/v1.15/features/index.adoc +++ b/content/documentation/v1.15/features/index.adoc @@ -190,7 +190,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain YAML or JSON files, so it's easy to keep them in source control like Git, track their changes, and share them. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.15/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -223,7 +223,7 @@ Kiali performs a set of validations to the most common Istio Objects such as Des Galley validations are mostly syntactic validations based on the object syntax analysis of Istio objects while Kiali validations are mostly semantic validations between different Istio objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.15/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by wizards. These are located in the *Actions* menu on the Service Details page. @@ -288,7 +288,7 @@ The following article https://medium.com/kialiproject/kiali-observability-in-act == Multi-cluster support Istio provides https://istio.io/docs/setup/install/multicluster/[installation instructions] for three different multi-cluster scenarios: replicated control planes, shared control plane with single-network, and shared control plane with multi-network. -Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. +Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/v1.15/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. The shared control plane scenarios are currently not supported by Kiali. diff --git a/content/documentation/v1.16/features/index.adoc b/content/documentation/v1.16/features/index.adoc index 505cef9e4..d69885640 100644 --- a/content/documentation/v1.16/features/index.adoc +++ b/content/documentation/v1.16/features/index.adoc @@ -186,7 +186,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain YAML or JSON files, so it's easy to keep them in source control like Git, track their changes, and share them. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.16/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -219,7 +219,7 @@ Kiali performs a set of validations to the most common Istio Objects such as Des Galley validations are mostly syntactic validations based on the object syntax analysis of Istio objects while Kiali validations are mostly semantic validations between different Istio objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.16/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by wizards. These are located in the *Actions* menu on the Service Details page. @@ -284,7 +284,7 @@ The following article https://medium.com/kialiproject/kiali-observability-in-act == Multi-cluster support Istio provides https://istio.io/docs/setup/install/multicluster/[installation instructions] for three different multi-cluster scenarios: replicated control planes, shared control plane with single-network, and shared control plane with multi-network. -Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. +Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/v1.16/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. The shared control plane scenarios are currently not supported by Kiali. diff --git a/content/documentation/v1.17/features/index.adoc b/content/documentation/v1.17/features/index.adoc index 505cef9e4..9f300aceb 100644 --- a/content/documentation/v1.17/features/index.adoc +++ b/content/documentation/v1.17/features/index.adoc @@ -186,7 +186,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain YAML or JSON files, so it's easy to keep them in source control like Git, track their changes, and share them. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.17/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -219,7 +219,7 @@ Kiali performs a set of validations to the most common Istio Objects such as Des Galley validations are mostly syntactic validations based on the object syntax analysis of Istio objects while Kiali validations are mostly semantic validations between different Istio objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.17/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by wizards. These are located in the *Actions* menu on the Service Details page. @@ -284,7 +284,7 @@ The following article https://medium.com/kialiproject/kiali-observability-in-act == Multi-cluster support Istio provides https://istio.io/docs/setup/install/multicluster/[installation instructions] for three different multi-cluster scenarios: replicated control planes, shared control plane with single-network, and shared control plane with multi-network. -Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. +Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/v1.17/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. The shared control plane scenarios are currently not supported by Kiali. diff --git a/content/documentation/v1.18/features/index.adoc b/content/documentation/v1.18/features/index.adoc index 485627a68..e06da3faa 100644 --- a/content/documentation/v1.18/features/index.adoc +++ b/content/documentation/v1.18/features/index.adoc @@ -186,7 +186,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain YAML or JSON files, so it's easy to keep them in source control like Git, track their changes, and share them. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.18/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -219,7 +219,7 @@ Kiali performs a set of validations to the most common Istio Objects such as Des Galley validations are mostly syntactic validations based on the object syntax analysis of Istio objects while Kiali validations are mostly semantic validations between different Istio objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.18/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by wizards. These are located in the *Actions* menu on the Service Details page. @@ -284,7 +284,7 @@ The following article https://medium.com/kialiproject/kiali-observability-in-act == Multi-cluster support Istio provides https://istio.io/docs/setup/install/multicluster/[installation instructions] for three different multi-cluster scenarios: replicated control planes, shared control plane with single-network, and shared control plane with multi-network. -Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. +Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/v1.18/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. The shared control plane scenarios are currently not supported by Kiali. diff --git a/content/documentation/v1.2/features/index.adoc b/content/documentation/v1.2/features/index.adoc index 1b35c26be..71d43f740 100644 --- a/content/documentation/v1.2/features/index.adoc +++ b/content/documentation/v1.2/features/index.adoc @@ -189,7 +189,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain _yaml_ or _json_ files, it's a perfect fit for keeping under source control like GIT, track changes, share, etc. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.2/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -222,7 +222,7 @@ Kiali performs a set of validations to the most common Istio Objects (Destinatio Galley validation are mostly syntactic validations based on the object syntax analysis of Istio Objects while Kiali validations are mostly semantic validations between different Istio Objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.2/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by Wizards. These are located in the *Actions* menu on the Service Details page. diff --git a/content/documentation/v1.3/features/index.adoc b/content/documentation/v1.3/features/index.adoc index f7f33e653..e58aab03c 100644 --- a/content/documentation/v1.3/features/index.adoc +++ b/content/documentation/v1.3/features/index.adoc @@ -189,7 +189,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain _yaml_ or _json_ files, it's a perfect fit for keeping under source control like GIT, track changes, share, etc. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.3/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -222,7 +222,7 @@ Kiali performs a set of validations to the most common Istio Objects (Destinatio Galley validation are mostly syntactic validations based on the object syntax analysis of Istio Objects while Kiali validations are mostly semantic validations between different Istio Objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.3/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by Wizards. These are located in the *Actions* menu on the Service Details page. diff --git a/content/documentation/v1.4/features/index.adoc b/content/documentation/v1.4/features/index.adoc index d6e80f239..679837bce 100644 --- a/content/documentation/v1.4/features/index.adoc +++ b/content/documentation/v1.4/features/index.adoc @@ -189,7 +189,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain _yaml_ or _json_ files, it's a perfect fit for keeping under source control like GIT, track changes, share, etc. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.4/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -222,7 +222,7 @@ Kiali performs a set of validations to the most common Istio Objects (Destinatio Galley validation are mostly syntactic validations based on the object syntax analysis of Istio Objects while Kiali validations are mostly semantic validations between different Istio Objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.4/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by Wizards. These are located in the *Actions* menu on the Service Details page. diff --git a/content/documentation/v1.5/features/index.adoc b/content/documentation/v1.5/features/index.adoc index 210befc79..b92b8046c 100644 --- a/content/documentation/v1.5/features/index.adoc +++ b/content/documentation/v1.5/features/index.adoc @@ -189,7 +189,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain _yaml_ or _json_ files, it's a perfect fit for keeping under source control like GIT, track changes, share, etc. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.5/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -222,7 +222,7 @@ Kiali performs a set of validations to the most common Istio Objects (Destinatio Galley validation are mostly syntactic validations based on the object syntax analysis of Istio Objects while Kiali validations are mostly semantic validations between different Istio Objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.5/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by Wizards. These are located in the *Actions* menu on the Service Details page. diff --git a/content/documentation/v1.6/features/index.adoc b/content/documentation/v1.6/features/index.adoc index 44d842c54..e2c751efd 100644 --- a/content/documentation/v1.6/features/index.adoc +++ b/content/documentation/v1.6/features/index.adoc @@ -189,7 +189,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain _yaml_ or _json_ files, it's a perfect fit for keeping under source control like GIT, track changes, share, etc. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.6/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -222,7 +222,7 @@ Kiali performs a set of validations to the most common Istio Objects (Destinatio Galley validation are mostly syntactic validations based on the object syntax analysis of Istio Objects while Kiali validations are mostly semantic validations between different Istio Objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.6/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by Wizards. These are located in the *Actions* menu on the Service Details page. diff --git a/content/documentation/v1.7/features/index.adoc b/content/documentation/v1.7/features/index.adoc index dbc15d49f..8448d1409 100644 --- a/content/documentation/v1.7/features/index.adoc +++ b/content/documentation/v1.7/features/index.adoc @@ -189,7 +189,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain _yaml_ or _json_ files, it's a perfect fit for keeping under source control like GIT, track changes, share, etc. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.7/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -222,7 +222,7 @@ Kiali performs a set of validations to the most common Istio Objects (Destinatio Galley validation are mostly syntactic validations based on the object syntax analysis of Istio Objects while Kiali validations are mostly semantic validations between different Istio Objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.7/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by Wizards. These are located in the *Actions* menu on the Service Details page. diff --git a/content/documentation/v1.8/features/index.adoc b/content/documentation/v1.8/features/index.adoc index eb96a6a69..a2c626f9c 100644 --- a/content/documentation/v1.8/features/index.adoc +++ b/content/documentation/v1.8/features/index.adoc @@ -189,7 +189,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain YAML or JSON files, so it's easy to keep them in source control like Git, track their changes, and share them. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.8/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -222,7 +222,7 @@ Kiali performs a set of validations to the most common Istio Objects such as Des Galley validations are mostly syntactic validations based on the object syntax analysis of Istio objects while Kiali validations are mostly semantic validations between different Istio objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.8/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by wizards. These are located in the *Actions* menu on the Service Details page. @@ -287,7 +287,7 @@ The following article https://medium.com/kialiproject/kiali-observability-in-act == Multi-cluster support Istio provides https://istio.io/docs/setup/install/multicluster/[installation instructions] for three different multi-cluster scenarios: replicated control planes, shared control plane with single-network, and shared control plane with multi-network. -Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. +Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/v1.8/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. The shared control plane scenarios are currently not supported by Kiali. diff --git a/content/documentation/v1.9/features/index.adoc b/content/documentation/v1.9/features/index.adoc index b2667e426..eebe4c0b4 100644 --- a/content/documentation/v1.9/features/index.adoc +++ b/content/documentation/v1.9/features/index.adoc @@ -189,7 +189,7 @@ Kiali comes with default dashboards for several runtimes, including Go, Node.js, These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. As they are defined as plain YAML or JSON files, so it's easy to keep them in source control like Git, track their changes, and share them. -Check out the link:/documentation/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +Check out the link:/documentation/v1.9/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. ++++ @@ -222,7 +222,7 @@ Kiali performs a set of validations to the most common Istio Objects such as Des Galley validations are mostly syntactic validations based on the object syntax analysis of Istio objects while Kiali validations are mostly semantic validations between different Istio objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. -Check the complete link:/documentation/validations/[list of validations] for further information. +Check the complete link:/documentation/v1.9/validations/[list of validations] for further information. === Istio Wizards Kiali provides different actions to create, update and delete Istio configuration driven by wizards. These are located in the *Actions* menu on the Service Details page. @@ -287,7 +287,7 @@ The following article https://medium.com/kialiproject/kiali-observability-in-act == Multi-cluster support Istio provides https://istio.io/docs/setup/install/multicluster/[installation instructions] for three different multi-cluster scenarios: replicated control planes, shared control plane with single-network, and shared control plane with multi-network. -Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. +Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/v1.9/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. The shared control plane scenarios are currently not supported by Kiali. From 20ca3d801f551a804015d99e6c6c1b97f0a83852 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cain=C3=A3=20Costa?= Date: Mon, 1 Jun 2020 16:07:56 -0300 Subject: [PATCH 06/11] Remove backwards compatibility for the archive script and prepare for CI --- scripts/build-archive.sh | 44 +++++++--------------------------------- 1 file changed, 7 insertions(+), 37 deletions(-) diff --git a/scripts/build-archive.sh b/scripts/build-archive.sh index ac7befc61..f711f3796 100755 --- a/scripts/build-archive.sh +++ b/scripts/build-archive.sh @@ -2,43 +2,13 @@ set -xe -[[ -z $(git status -s) ]] || (echo "The working tree is dirty. Please make sure it is clean before running."; exit 1) +tag="${1%.0}" +root="$(pwd)/content/documentation" -GIT="git -c advice.detachedHead=false" +echo "Preparing documentation for version ${tag}" -current_branch=$(git rev-parse --abbrev-ref HEAD) -trap '{ ${GIT} checkout ${current_branch}; }' EXIT +cp -r "${root}"/edge "${root}"/${tag} -echo "Making sure we have all the latest tags..." -git fetch --all --tags - -temp="$(mktemp -d)" - -generate() { - tag="${1%.0}" - root="$(pwd)/content/documentation" - - echo "Preparing documentation for version ${tag}" - - ${GIT} checkout "${1}" - mkdir "${temp}/${tag}" - - cp -r "${root}"/edge/* "${temp}/${tag}/" - - find "${temp}/${tag}" -type f -name "*.adoc" -exec sed -i -e "s/ main:/ $(echo "${tag}" | tr "." "-"):/" "{}" \; - sed -i "s/: (Edge|Documentation)/: ${tag}/g" "${temp}/${tag}/_index.adoc" - - ${GIT} checkout "${current_branch}" - - mkdir "${root}/${tag}" - cp -r "${temp}/${tag}/*" "${root}/" -} - -echo "Running for version ${1}..." - -if git tag --list | grep "${1}" &>/dev/null; then - generate "${1}" -else - echo "Tag ${1} could not be found" - exit 1 -fi +find "${root}/${tag}" -type f -name "*.adoc" -exec sed -i -e "s/ main:/ $(echo "${tag}" | tr "." "-"):/" "{}" \; +find "${root}/${tag}" -type f -name "*.adoc" -exec sed -i -e "s;documentation/edge;documentation/${tag};g" "{}" \; +sed -i -r "s/: \"(Edge|Documentation)\"/: ${tag}/g" "${root}/${tag}/_index.adoc" From 4dddb44fdc5d740874f69015a05d72bff63e2bf8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cain=C3=A3=20Costa?= Date: Mon, 1 Jun 2020 16:10:15 -0300 Subject: [PATCH 07/11] Fix alias for documentation overview page --- content/documentation/edge/features/index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/documentation/edge/features/index.adoc b/content/documentation/edge/features/index.adoc index 7d0b7bb16..06a7b7fdf 100644 --- a/content/documentation/edge/features/index.adoc +++ b/content/documentation/edge/features/index.adoc @@ -2,7 +2,7 @@ title: "Features" aliases: - /features/ -- /documentation/overview/ +- /documentation/edge/overview/ date: 2018-06-20T19:04:38+02:00 draft: false type: "features" From 9e100c594d5a292e7776ec15370d29259b8cd8c2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cain=C3=A3=20Costa?= Date: Mon, 1 Jun 2020 16:12:36 -0300 Subject: [PATCH 08/11] Handle `latest` link with the release script --- scripts/build-archive.sh | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/scripts/build-archive.sh b/scripts/build-archive.sh index f711f3796..06825aded 100755 --- a/scripts/build-archive.sh +++ b/scripts/build-archive.sh @@ -12,3 +12,9 @@ cp -r "${root}"/edge "${root}"/${tag} find "${root}/${tag}" -type f -name "*.adoc" -exec sed -i -e "s/ main:/ $(echo "${tag}" | tr "." "-"):/" "{}" \; find "${root}/${tag}" -type f -name "*.adoc" -exec sed -i -e "s;documentation/edge;documentation/${tag};g" "{}" \; sed -i -r "s/: \"(Edge|Documentation)\"/: ${tag}/g" "${root}/${tag}/_index.adoc" + +rm "${root}/latest" +cd "${root}" + +ln -s ${tag} latest + From 95f81eef562f3bb4fd61cf6dfd223d2899a6a65a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cain=C3=A3=20Costa?= Date: Tue, 2 Jun 2020 11:48:44 -0300 Subject: [PATCH 09/11] Change home links to the correct ones --- .../partials/home/features-section.html | 14 +++++----- .../layouts/partials/home/hero-section.html | 28 +++++++++---------- 2 files changed, 21 insertions(+), 21 deletions(-) diff --git a/themes/kiali/layouts/partials/home/features-section.html b/themes/kiali/layouts/partials/home/features-section.html index a8600a832..f8d4d6c07 100644 --- a/themes/kiali/layouts/partials/home/features-section.html +++ b/themes/kiali/layouts/partials/home/features-section.html @@ -2,49 +2,49 @@

Features

- +

Topology

See your services
communicate

- +

Health

Quickly identify
issues

- +

Metrics

Chart Istio and App
performance

- +

Tracing

Follow requests with
Jaeger Distributed Tracing

- +

Validations

Detect advanced
misconfigurations

- +

Wizards

Easily configure Istio
routing

- +

Configuration

See and edit Istio
custom resource YAML

diff --git a/themes/kiali/layouts/partials/home/hero-section.html b/themes/kiali/layouts/partials/home/hero-section.html index 8e8395f72..bdb01eddf 100644 --- a/themes/kiali/layouts/partials/home/hero-section.html +++ b/themes/kiali/layouts/partials/home/hero-section.html @@ -1,29 +1,29 @@ -
-

Service mesh management
for Istio

+
+

Service mesh management
for Istio

-

+

Kiali answers the questions:
Which microservices are part of my service mesh?
How are they connected?
How are they performing?
How can I operate on them?
-

+

-

- +

+ Get started See latest blog posts and videos -

+

-

+

- - "This is the kind of tool that you really need" — David Gageot, Google - + + "This is the kind of tool that you really need" — David Gageot, + Google + -

-
- +

+
From 750d5f84978611ef663985e88d03317339d57a39 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cain=C3=A3=20Costa?= Date: Fri, 5 Jun 2020 02:37:13 -0300 Subject: [PATCH 10/11] Bring back menu items pointing to latest --- config.toml | 78 +++++++++++++++++++++++++++++++ content/documentation/_index.adoc | 2 +- 2 files changed, 79 insertions(+), 1 deletion(-) diff --git a/config.toml b/config.toml index 1a8b28e00..7decdb9b9 100644 --- a/config.toml +++ b/config.toml @@ -49,6 +49,84 @@ relativeURLs = true name = "Documentation" url = "/documentation" weight = 5 + [[menu.main]] + identifier = "doc_features" + name = "Features" + url = "/documentation/latest/features" + weight = 1 + parent="main_doc" + [[menu.main]] + identifier = "validation" + name = "Validation" + url = "/documentation/latest/validations" + weight = 1 + parent="doc_features" + [[menu.main]] + identifier = "doc_gettingstarted" + name = "Getting Started" + url = "/documentation/latest/getting-started" + weight = 2 + parent="main_doc" + [[menu.main]] + identifier = "doc_architecture" + name = "Architecture" + url = "/documentation/latest/architecture" + weight = 3 + parent="main_doc" + [[menu.main]] + identifier = "doc_runtimes" + name = "Custom Dashboards" + url = "/documentation/latest/runtimes-monitoring" + weight = 4 + parent="main_doc" + [[menu.main]] + identifier = "doc_tracing" + name = "Distributed Tracing" + url = "/documentation/latest/distributed-tracing" + weight = 5 + parent="main_doc" + [[menu.main]] + identifier = "doc_extensions" + name = "Extensions" + url = "/documentation/latest/extensions" + weight = 6 + parent="main_doc" + [[menu.main]] + identifier = "doc_swagger" + name = "Developer API" + url = "/documentation/latest/developer-api" + weight = 7 + parent="main_doc" + [[menu.main]] + identifier = "doc_glossary" + name = "Glossary" + url = "/documentation/latest/glossary" + weight = 8 + parent="main_doc" + [[menu.main]] + identifier = "concepts" + name = "Concepts" + url = "/documentation/latest/glossary/concepts" + weight = 1 + parent="doc_glossary" + [[menu.main]] + identifier = "observability" + name = "Observability" + url = "/documentation/latest/glossary/observability" + weight = 2 + parent="doc_glossary" + [[menu.main]] + identifier = "networking" + name = "Networking" + url = "/documentation/latest/glossary/networking" + weight = 3 + parent="doc_glossary" + [[menu.main]] + identifier = "doc_archive" + name = "Older Releases" + url = "/documentation" + weight = 9 + parent="main_doc" [[menu.main]] identifier = "main_faq" name = "FAQ" diff --git a/content/documentation/_index.adoc b/content/documentation/_index.adoc index b9bed09e0..1e510c605 100644 --- a/content/documentation/_index.adoc +++ b/content/documentation/_index.adoc @@ -2,7 +2,7 @@ title: "Documentation" date: 2020-04-03T01:05:25-03:00 draft: false -indexTitle: "Documentation for Older Versions" +indexTitle: "Older Releases" --- Here you can find all the documentation for Kiali. You can see From 966f59153e9510d53dd36e0843e2e23045302b27 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cain=C3=A3=20Costa?= Date: Mon, 8 Jun 2020 12:08:22 -0300 Subject: [PATCH 11/11] Add release v1.19.0 --- content/documentation/latest | 2 +- content/documentation/v1.19/_index.adoc | 6 + content/documentation/v1.19/architecture.adoc | 124 ++ .../v1.19/developer-api/.gitignore | 2 + .../v1.19/distributed-tracing/index.adoc | 91 ++ .../documentation/v1.19/extensions/index.adoc | 160 +++ .../documentation/v1.19/features/index.adoc | 307 +++++ .../v1.19/getting-started/index.adoc | 524 ++++++++ .../documentation/v1.19/glossary/_index.adoc | 6 + .../v1.19/glossary/concepts/index.adoc | 93 ++ .../v1.19/glossary/networking/index.adoc | 63 + .../v1.19/glossary/observability/index.adoc | 41 + .../v1.19/runtimes-monitoring/index.adoc | 329 +++++ .../v1.19/validations/index.adoc | 1057 +++++++++++++++++ 14 files changed, 2804 insertions(+), 1 deletion(-) create mode 100644 content/documentation/v1.19/_index.adoc create mode 100644 content/documentation/v1.19/architecture.adoc create mode 100644 content/documentation/v1.19/developer-api/.gitignore create mode 100644 content/documentation/v1.19/distributed-tracing/index.adoc create mode 100644 content/documentation/v1.19/extensions/index.adoc create mode 100644 content/documentation/v1.19/features/index.adoc create mode 100644 content/documentation/v1.19/getting-started/index.adoc create mode 100644 content/documentation/v1.19/glossary/_index.adoc create mode 100644 content/documentation/v1.19/glossary/concepts/index.adoc create mode 100644 content/documentation/v1.19/glossary/networking/index.adoc create mode 100644 content/documentation/v1.19/glossary/observability/index.adoc create mode 100644 content/documentation/v1.19/runtimes-monitoring/index.adoc create mode 100644 content/documentation/v1.19/validations/index.adoc diff --git a/content/documentation/latest b/content/documentation/latest index 5b364900a..d118301ba 120000 --- a/content/documentation/latest +++ b/content/documentation/latest @@ -1 +1 @@ -v1.18 \ No newline at end of file +v1.19 \ No newline at end of file diff --git a/content/documentation/v1.19/_index.adoc b/content/documentation/v1.19/_index.adoc new file mode 100644 index 000000000..d37d49c00 --- /dev/null +++ b/content/documentation/v1.19/_index.adoc @@ -0,0 +1,6 @@ +--- +title: v1.19 +date: 2018-06-20T19:04:38+02:00 +draft: false +type: "documentation" +--- diff --git a/content/documentation/v1.19/architecture.adoc b/content/documentation/v1.19/architecture.adoc new file mode 100644 index 000000000..f27cf4ba5 --- /dev/null +++ b/content/documentation/v1.19/architecture.adoc @@ -0,0 +1,124 @@ +--- +title: "Architecture" +date: 2018-09-03T14:39:48-05:00 +draft: false +weight: 4 +--- + +:sectlinks: + += Kiali architecture +:imagesdir: /images/documentation/architecture + +Kiali is composed of two components: a back-end application running in the +container application platform, and a user-facing front-end application. +Kiali depends on external services and components provided by the +container application platform and Istio. + +The following diagram illustrates the components involved in Kiali and its +interactions: + +image::architecture.png[Kiali architecture] + +== Kiali back-end + +The back-end is the application that runs in the container application platform. +It's written in http://golang.org/[Go]. The code can be found at +https://github.com/kiali/kiali[kiali/kiali GitHub repository]. + +This is the component that communicates with Istio parts, retrieves and +processes data, and exposes this data to the front-end. + +The back-end doesn't need storage. When running the back-end locally (which +is for development purposes only), configurations are set in either a config +file or environment variables, including the user name +and password used for authentication. When deploying the back-end to a cluster +using the docker images (the typical production deployment model), +a configmap and secrets are used to set the configurations. + +== Kiali front-end + +The front-end is a single page web application, built with React and written in +Typescript. The code can be found at +https://github.com/kiali/kiali-ui[kiali/kiali-ui GitHub repository]. + +In a standard deployment, the back-end serves the front-end. Then, the front-end +queries the Kiali back-end in order to get data and present it to the user. + +Since, currently, there are no options for personalizations, it's mainly +stateless. Some data may be persisted, such as session credentials, but this +data is stored in the browser and won't be available in other browsers nor +other devices. + +== Istio + +Istio is a Kiali requirement. It provides and controls the +service mesh. Although Kiali and Istio can be installed separately, Kiali +depends on Istio and won't work if it's not present. + +Kiali needs to retrieve Istio data and configurations, which are exposed +through Prometheus and the cluster API. This is the reason the diagram shows a +dashed line: to denote indirect dependency. + +== Prometheus + +Prometheus is an Istio dependency. When Istio telemetry is enabled, metrics +data is stored in Prometheus. Kiali uses the data stored in Prometheus to +figure out the mesh topology, show metrics, calculate health, show possible +problems, etc. + +Kiali communicates directly with Prometheus and assumes the data schema used by +Istio Telemetery. It's a hard dependency for Kiali, and most of it's +features do not work without it. + +Currently, Kiali relies on +https://istio.io/docs/reference/config/policy-and-telemetry/metrics/[Istio's +default metrics] set. Make sure that these default metrics are always in place. +Custom metrics are not supported by Kiali. If you need custom metrics or a +variant of the default ones, create new Istio metrics with custom names. + +== Cluster API + +Kiali uses the API of the container application platform (cluster API) in order +to fetch and resolve service mesh configurations. + +Container application platforms where Kiali is known to work are +http://www.okd.io/[OKD] and http://kubernetes.io/[Kubernetes]. Kiali shoud also +work on the derivatives of these platforms. If you want to learn the cluster +API, check the https://docs.okd.io/latest/rest_api/index.html[OKD REST API +reference] and the +https://kubernetes.io/docs/reference/kubernetes-api/[Kubernetes API reference]. + +Kiali queries the cluster API to retrieve, for example, definitions for +namespaces, services, deployments, pods, and other entities. Kiali also makes +queries to resolve relationships between the different cluster entities. + +The cluster API is also queried to retrieve Istio configurations like virtual +services, destination rules, route rules, gateways, and quotas. + +== Jaeger + +Jaeger is optional. When available, Kiali will be able to direct the user to +Jaeger's tracing data. If you need this feature, make sure Kiali is +https://github.com/kiali/kiali#jaeger[properly configured for Jaeger +integration]. + +Tracing data will be available only if +https://istio.io/docs/tasks/telemetry/distributed-tracing/[Istio's distributed +tracing] is enabled. + + +== Grafana + +Grafana is optional. When available, the metrics pages of Kiali will show a +link to direct the user to the same metric in Grafana. If you need this +feature, make sure Kiali is https://github.com/kiali/kiali#grafana[properly +configured for Grafana integration]. + +Kiali has basic metric capabilities. It can show the default Istio metrics for +workloads, apps and services. It allows to apply some groupings to the provided +metrics and fetch metrics for different time ranges. However, Kiali doesn't +allow to customize the views nor customize the Prometheus queries. If you need +these capabilities, you'll want to install Grafana. Follow the Istio +documentation to install Grafana if you need it. + diff --git a/content/documentation/v1.19/developer-api/.gitignore b/content/documentation/v1.19/developer-api/.gitignore new file mode 100644 index 000000000..7368eea1d --- /dev/null +++ b/content/documentation/v1.19/developer-api/.gitignore @@ -0,0 +1,2 @@ +*.md + diff --git a/content/documentation/v1.19/distributed-tracing/index.adoc b/content/documentation/v1.19/distributed-tracing/index.adoc new file mode 100644 index 000000000..2d50cd7a2 --- /dev/null +++ b/content/documentation/v1.19/distributed-tracing/index.adoc @@ -0,0 +1,91 @@ +--- +title: "Distributed Tracing" +date: 2019-05-23T11:20:21+02:00 +draft: false +type: "documentation" +weight: 6 +--- + +:linkattrs: +:sectlinks: + += Tracing your application in Kiali +:sectnums: +:toc: left +toc::[] +:toc-title: Distributed Tracing +:keywords: Kiali Documentation Distributed Tracing +:icons: font +:imagesdir: /images/documentation/tracing/ + + + +Kiali shows tracing of your applications. We currently support link:https://www.jaegertracing.io[Jaeger, window="_blank"] version 1.9 and newer. + + + +== Configuration + +=== In cluster URL + +In order to fetch data from Jaeger, Kiali needs to get an URL that can be resolved from inside the cluster, typically using Kubernetes DNS. This is the `in_cluster_url` configuration. For instance, for a Jaeger service named `tracing` within `istio-system` namespace, Kiali config would be: + +```yaml + external_services: + tracing: + in_cluster_url: 'http://tracing.istio-system/jaeger' +``` + +icon:bullhorn[size=2x]{nbsp} If you use the Kiali operator (recommended), this config can be set in the Kiali CR. But in most cases, the Kiali operator will set a valid default `in_cluster_url` so you wouldn't have to change anything. If you don't use the Kiali operator, this config can be set in Kiali config map. + + + + + +=== External URL + +Configuring an external URL for Jaeger will enable links from Kiali to Jaeger UI. This URL needs to be accessible from the browser (it's used for links generation). Example: + +```yaml + external_services: + tracing: + in_cluster_url: 'http://tracing.istio-system/jaeger' + url: 'http://my-jaeger-host/jaeger' +``` + +Once this URL is set, Kiali will show an additional item to the main menu: + +image::menu_external_link.png[Distributed Tracing View] + +icon:bullhorn[size=2x]{nbsp} You may have `url` configured and not `in_cluster_url`, for instance, if Jaeger is not accessible from Kiali pod. In this situation, Kiali will not show its own traces chart but will display external links to the Jaeger UI instead. + +=== Other configuration + +For advanced configuration on Jaeger integration, please refer to link:https://github.com/kiali/kiali-operator/blob/master/deploy/kiali/kiali_cr.yaml[the Kiali CR 'external_services.tracing' section, window="_blank"]. It is relevant for config map as well, if you don't use the Kiali operator. + +== Tracing View + +The tracing view is accessible if the in-cluster URL is correctly configured. Each service page will show the Traces tab where a scatter plot is displayed with its related traces. + +image::service_traces_tab.png[Service View] + +Kiali allows interactions with Jaeger UI via external links: For example, "View Trace in Tracing" goes to the Jaeger UI trace view. + +image::trace_view_jaeger.png[Trace View] + +== Tracing Toolbar + +The tracing toolbar offers some control over the data to fetch, to facilitate the user experience. In the tracing view, as shown in the image below, it's possible to select the traces interval, results limit, status code, errors, adjust time (expand results on time), last Xm traffic (Traces from last minutes) and refresh interval. + +image::form.png[Form Tracing View] + + +=== Tracing Results + +After selecting a trace, Kiali shows the information related to that trace like number of spans, spans grouped by operation name, duration, date... + +image::kiali_trace.png[Trace view] + +In each span, tags and processes are displayed. + +image::span_view.png[Span view] diff --git a/content/documentation/v1.19/extensions/index.adoc b/content/documentation/v1.19/extensions/index.adoc new file mode 100644 index 000000000..6fdfed264 --- /dev/null +++ b/content/documentation/v1.19/extensions/index.adoc @@ -0,0 +1,160 @@ +--- +title: "Extensions" +date: 2020-02-10T11:20:21+02:00 +draft: false +type: "documentation" +weight: 7 +--- + +:linkattrs: +:sectlinks: + += Extensions +:sectnums: +:toc: left +toc::[] +:toc-title: Extensions +:keywords: Kiali Documentation Extensions Addons +:icons: font +:imagesdir: /images/documentation/extensions + +== What is a Kiali Extension ? + +The Istio ecosystem is expanding and there are an increasing number of components providing additional functionality to enrich Service Mesh technology. + +Additionally, Kiali project is adding features in the areas of Observability, Analysis, Validation and Management of Istio. + +An Extension is a mechanism and guideline to integrate third party components inside Kiali. + +== Examples of Kiali Extensions + +Imagine that you develop a new project to provide extra capabilities on top of Istio. +Your project deploys extra components into the Istio Control Plane and the typical way to interact with your project is via the CLI. + +A Kiali Extension could be used to: + +- Manage specific configuration of your project in a separate section. +- Enrich Kiali Actions adding new operations for your project. +- Augment Kiali views to include specific results on graph, metrics or details. +- Integrate your project in the Istio ecosystem using Kiali as first class User Interface dashboard. + +Kiali currently offers integration for 3scale API Management. +In the following sections we will illustrate the guidelines using Kiali 3scale extension as an example. + +== Kiali Back-End Guideline + +An Extension will typically require changes in the Kiali back-end and front-end. + +=== Update Kiali Configuration + +An Extension should always be enabled/disabled via Kiali configuration. + +Add your new Extension config in Kiali: + +image::config_go.png[Kiali config.go] +{nbsp} + +Document the config in the operator: + +image::kiali_cr_yaml.png[Kiali CR yaml] +{nbsp} + +Don't forget to add the default values: + +image::main_yaml.png[Kiali CR Defaults yaml] +{nbsp} + +Add the Extension to the Public Config that will be read by the Kiali front-end: + +image::public_config_yaml.png[Kiali Public config.go] +{nbsp} + +icon:lightbulb[size=1x]{nbsp}Kiali config is private to the back-end process, only a few values are needed in the front-end project. + +An Extension will implement a "feature flag" pattern, so an "enabled" field is needed to implement a conditional render. + +=== Add Extension logic + +Implement the extension logic under the business package (including tests). + +Existing extensions can be good templates for naming examples and code organization. + +Also under the business package you will find examples about how to interact with the Kubernetes API and other external services. + +image::business_go.png[Business package] +{nbsp} + +Expose the business package with handlers to wrap HTTP requests/responses. + +image::handlers_go.png[Handlers package] +{nbsp} + +Update new routes for the Extension handlers. + +image::routes_go.png[Kiali Routes.go] +{nbsp} + +icon:lightbulb[size=1x]{nbsp}Update swagger doc for the new routes. Otherwise Kiali CI prevents merging code without proper documentation. + +== Kiali Front-End Guideline + +An Extension may add a new section to Kiali or augment an existing feature. We use the 3scale extension as an example of both use cases. + +=== Map Back-End Services into Front-End + +To make them available to the front-end code, add the Extension's endpoints into the API mapping. + +image::api_ts.png[API.ts] +{nbsp} + +Map the models returned by the back-end into UI types: + +image::model_ts.png[Extension Model.ts] + +=== Add Extension Pages + +Extension Pages should be added under the pages/extensions folder: + +image::extensions_organization.png[Extensions pages] +{nbsp} + +A list/detail pattern is being implemented with the 3scale example extension. It can be used as template for other extensions. + +List pattern: + +image::list_page.png[List Page] +{nbsp} + +Details pattern: + +image::details_page.png[Details Page] +{nbsp} + +=== Enable Extension in Navigation + +Add Extension Menu Items and Routes: + +image::extension_menu.png[Extension Menu and Routes] +{nbsp} + +And add logic to enable the Extension in Kiali Menu and RenderPage component: + +image::enable_extension_menu.png[Enable Extension Menu] +{nbsp} + +image::render_page.png[RenderPage Component] +{nbsp} + +=== Augment Kiali Features + +Actions or Tabs on existing features should always be rendered conditionally based on the configuration. Backend calls should be made only if the extension is enabled. + +image::extension_call.png[Conditional Extension Call] + +== Refactoring + +Kiali is an active project and is constantly evolving. +Adding a new Extension may trigger the need to refactor existing code in order to accommodate new use cases, or provide a more robust abstraction. Do not hesitate to contact a Kiali maintainer with your proposal! It will help to understand the scenario and how we can coordinate best to include your work. + + + diff --git a/content/documentation/v1.19/features/index.adoc b/content/documentation/v1.19/features/index.adoc new file mode 100644 index 000000000..d91648fca --- /dev/null +++ b/content/documentation/v1.19/features/index.adoc @@ -0,0 +1,307 @@ +--- +title: "Features" +aliases: +- /features/ +- /documentation/v1.19/overview/ +date: 2018-06-20T19:04:38+02:00 +draft: false +type: "features" +--- + +:sectlinks: +:linkattrs: +:toc: macro +:toc-title: Kiali Features +:toclevels: 4 +:keywords: Kiali Features +:icons: font +:imagesdir: /images/documentation/features/ + +== Overview + +Kiali helps you define, validate, and observe the connections and microservices of your Istio service mesh. + +Kiali works with Istio in OpenShift or Kubernetes. It visualizes the service mesh topology and provides visibility into features like request routing, circuit breakers, request rates, latency and more. Kiali offers insights about the mesh components at different levels, from abstract Applications to Services and Workloads. + +icon:lightbulb[size=2x] {nbsp}{nbsp}{nbsp}{nbsp} Kiali also includes Jaeger Tracing to provide distributed tracing by default. + +toc::[] + +== Observability Features + +The following observability features help you ensure your mesh is healthy or to quickly identify problem areas in operation. It combines topology, telemetry, traces, logs, events and definitions in a holistic view of your system. + + +=== Graph +The graph provides a powerful way to visualize the topology of your service mesh. It shows you which services communicate with each other and the traffic rates and latencies between them, which helps you visually identify problem areas and quickly pinpoint issues. Kiali provides graphs that show a high-level view of service interactions, a low level view of workloads, or a logical view of applications. + +The graph also shows which services are configured with virtual services and circuit breakers. It identifies security issues by identifying traffic not configured as expected. You can observe the traffic flow between components by watching the animation or viewing the metrics. + +You can configure the graph to show the namespaces and data that are important to you, and display it in the way that best meets your needs. +++++ + + + +++++ + +{empty} + + +==== Graph: Health +Colors in the graph represent the health of your service mesh. A node colored red or orange might need attention. The color of an edge between components represents the health of the requests between those components. The node shape indicates the type of component such as services, workloads, or apps. + +The health of nodes and edges is refreshed automatically based on the user's preference. The graph can also be paused to examine a particular state. +++++ + + + +++++ + +{empty} + + +==== Graph: Drill-Down +You can focus the app graph on just one component, whether it's a service, a workload, or an application. Kiali offers detail graphs for any component you choose. + +Double click on a graph node and you can see a detailed view centered on that component. It shows you only the incoming requests being served and the outgoing requests being made - all from the point-of-view of that component's telemetry. + +You can jump back to the main graph and continue where you left off. +++++ + + + +++++ + +{empty} + + +==== Graph: Side-Panel +Want to get a quick summary of anything in the graph? Select any node with a single-click and the side panel provides a brief summary for that component. This includes: + +* **Charts** showing traffic and response times +* **Health** details +* **Links** to fully-detailed pages +* **Response Code** breakdowns. + +Or, click the graph background and the side panel to view an overall summary for the entire graph. +++++ + + + +++++ + +{empty} + + +==== Graph: Traffic Animation +Kiali offers several display options for the graph, including traffic animation. + +For HTTP traffic, circles represent successful requests while red diamonds represent errors. The more dense the circles and diamonds the higher the request rate. The faster the animation the faster the response times. + +TCP traffic is represented by offset circles where the speed of the circles indicates the traffic speed. +++++ + + +++++ + +{empty} + + +==== Graph: Graph Types +Kiali offers four different graph renderings of the mesh telemetry. Each graph type provides a different view of the traffic. + +* The **workload** graph provides the a detailed view of communication between workloads. + +* The **app** graph aggregates the workloads with the same app labeling, which provides a more logical view. + +* The **versioned app** graph aggregates by app, but breaks out the different versions providing traffic breakdowns that are version-specific. + +* The **service** graph provides a high-level view, which aggregates all traffic for defined services. +++++ + + + +++++ + +{empty} + + +=== Detail Views +Kiali provides filtered list views of all your service mesh definitions. Each view provides health, details, YAML definitions and links to help you visualize your mesh. There are list and detail views for: + +* Services +* Applications +* Workloads +* Istio Configurations (Virtual Services, Gateways, etc) +++++ + + +++++ + +{empty} + + +==== Detail: Metrics +Each detail view provides predefined metric dashboards. The metric dashboards provided are tailored to the relevant application, workload or service level. + +Application and workload detail views show request and response metrics such as volume, duration, size, or tcp traffic. The traffic can also be viewed for either inbound or outbound traffic. + +The service detail view shows request and response metrics for inbound traffic. +++++ + + +++++ + +{empty} + + +==== Detail: Services +The service detail view shows the user the workloads running the service. It also shows the Istio traffic routing configuration, VirtualServices and DestinationRules, associated with the service. + +Kiali provides access to YAML definitions and allows modification and deletion access for authorized users. It provides wizards to assist in common configurations and performs additional validation on VirtualServices to detect misconfigured routes. +++++ + + +++++ + +{empty} + + +==== Detail: Workloads +Kiali performs several validations on workload configuration: + +* Are Istio sidecars deployed? + +* Are proper *app* and *version* labels assigned? + +Workload detail shows you the services for which the workload is handling requests, and the pods backing the workload. + +Workload detail also allows access to the pod logs, and provides detailed traffic breakdown. +++++ + + + +++++ + +{empty} + + +==== Detail: Custom Dashboards +Kiali comes with default dashboards for several runtimes, including Go, Node.js, Spring Boot, Thorntail, and Vert.x. + +These dashboards are simple Kubernetes resources, so you can use your favorite tool to create, modify or delete them. +As they are defined as plain YAML or JSON files, so it's easy to keep them in source control like Git, track their changes, and share them. + +Check out the link:/documentation/v1.19/runtimes-monitoring/[documentation page, window=_blank] to learn more about it. +++++ + + + +++++ + +{empty} + + +=== Distributed Tracing +Click the Distributed Tracing menu item for tracing services https://www.jaegertracing.io/[Jaeger, window=_blank]. + +{empty} + + +== Configuration and Validation Features + +Kiali is more than observability, it also helps you to configure, update and validate your Istio service mesh. + + +=== Istio Configuration +The Istio configuration view provides advanced filtering and navigation for Istio configuration objects such as Virtual Services and Gateways. +Kiali provides inline config edition and powerful semantic validation for Istio resources. +++++ + + +++++ + +=== Validations +Kiali performs a set of validations to the most common Istio Objects such as Destination Rules, Service Entries, and Virtual Services. Those validations are done in addition to the existing ones performed by Istio's Galley component. Most validations are done inside a single namespace only, any exceptions, such as gateways, are properly documented. + +Galley validations are mostly syntactic validations based on the object syntax analysis of Istio objects while Kiali validations are mostly semantic validations between different Istio objects. Kiali validations are based on the runtime status of your service mesh, Galley validations are static ones and doesn't take into account what is configured in the mesh. + +Check the complete link:/documentation/v1.19/validations/[list of validations] for further information. + +=== Istio Wizards +Kiali provides different actions to create, update and delete Istio configuration driven by wizards. These are located in the *Actions* menu on the Service Details page. +++++ + + + +++++ +{nbsp} + +These actions are enabled by default. + +Kiali can also be installed in *view only* mode to restrict any write operation on Istio configuration. + +Check https://github.com/kiali/kiali-operator/blob/master/deploy/kiali/kiali_cr.yaml[Kiali Operator CR, window=_blank] to get more details about how to configure this option. + +==== Weighted Routing Wizard +With this wizard, you can select the percentage of traffic that is routed to a specific workload. +++++ + + + +++++ +Kiali creates a pair of Istio resources, VirtualService and DestinationRule, with a single routing rule using the selected weights for the destination workloads. + +==== Matching Routing Wizard +The Matching Routing Wizard allows to create multiple routing rules. + +* Every rule is composed by a Matching and a Routes section. +* The Matching section can add multiple filters using HEADERS, URI, SCHEME, METHOD or AUTHORITY Http parameters. +* The Matching section can be empty, on this case, any http request received is matched against this rule. +* The Routes section can select one or multiple Workloads. + +Istio applies routing rules in order, meaning that first rule that matches an HTTP request, it is responsible to perform the routing. The Matching Routing Wizard allows to change order of rules. +++++ + + + +++++ +In the same way as the previous wizard, Kiali creates a pair of Istio resources mapping the routing rules defined into the generated VirtualService. + +==== Suspend Traffic Wizard +This wizard helps user to partially or totally stop traffic for a service. You can define which workloads receive traffic. + +When traffic is suspended for all workloads, Istio returns an error code to any service request. +++++ + + + +++++ +When there is traffic for some workload, the wizard maps a weighted rule; when there is not traffic, an abort rule is coded in the pair of Istio resources VirtualService and DestinationRule generated. + +==== Advanced Options +All previous wizards have an Advanced Options section where user can define specific configuration for TLS and LoadBalancing. +++++ + + + +++++ +When mTLS is enabled by default in the global cluster or namespace this option is selected by default. + +==== More Wizard examples +The following article https://medium.com/kialiproject/kiali-observability-in-action-for-istio-service-mesh-69127f792103[Kiali: Observability in Action for Istio Service Mesh, window=_blank] describes more examples of how to use the Kiali Wizards to configure Istio configuration. + +== Multi-cluster support +Istio provides https://istio.io/docs/setup/install/multicluster/[installation instructions] for three different multi-cluster scenarios: replicated control planes, shared control plane with single-network, and shared control plane with multi-network. + +Currently, Kiali only works with Istio's replicated control planes scenario. You will need to install Kiali aside each Istio's control plane; i.e. you will need one Kiali instance per Istio's control plane you want to monitor. Install instructions for Kiali are the same as for the single cluster scenario, so following the link:/documentation/v1.19/getting-started/[Getting started guide] is enough. Kiali will let you observe the mesh portion that is managed by the adjacent control plane. + +The shared control plane scenarios are currently not supported by Kiali. + +== Useful resources + +.Kiali +* https://github.com/kiali/kiali/blob/master/README.adoc[Kiali Readme, window=_blank] +* https://github.com/kiali/kiali-ui/blob/master/README.adoc[Kiali-ui Readme, window=_blank] +* https://github.com/kiali/kiali-test-mesh[Kiali-test-mesh, window=_blank] + +.Istio +* https://istio.io/[Istio, window=_blank] + - https://istio.io/docs/concepts/what-is-istio/[What is Istio?, window=_blank] + - https://istio.io/docs/concepts/traffic-management/[Traffic Management, window=_blank] + - https://istio.io/docs/examples/[Examples, window=_blank] + +.Jaeger +* https://www.jaegertracing.io/[Jaeger, window=_blank] + + diff --git a/content/documentation/v1.19/getting-started/index.adoc b/content/documentation/v1.19/getting-started/index.adoc new file mode 100644 index 000000000..11172f989 --- /dev/null +++ b/content/documentation/v1.19/getting-started/index.adoc @@ -0,0 +1,524 @@ +--- +title: "Getting started" +aliases: +- /gettingstarted/ +- /prerequisites/ +date: 2019-03-20T09:04:38+02:00 +draft: false +--- + +:toc: macro +:toclevels: 4 +:toc-title: Table of Contents +:keywords: Kiali Getting Started +:icons: font +:imagesdir: /images/gettingstarted/ +:sectlinks: + +toc::[] + +== Prerequisites + +=== Kiali Version Requirements + +Kiali requires a supported version of Istio. link:https://istio.io/news/[The Istio news page] posts end-of-support (EOL) dates. Supported Kiali versions include only the Kiali version bundled with Istio, or newer. + +==== Version Compatibility + +[cols="15%,15%,70%",options="header"] +|=== +|Istio +|Kiali +|Notes + +| 1.5.1+ +| 1.15.2+ +| Avoid Istio v1.5.0 for security reasons. + +| 1.4.7+ +| 1.15.2+ +| Avoid Istio v1.4.0 - v1.4.6 for security reasons. + +| <= 1.3 +| n/a +| Out of support, users should use Istio >= 1.4 + +|=== + +icon:lightbulb[size=1x]{nbsp}If you are running Red Hat OpenShift Service Mesh (RH OSSM) then use only the bundled version of Kiali. + + +=== Browser Version Requirements + +Kiali requires a modern web browser and supports the last two versions of Chrome, Firefox, Safari or Edge. + + +=== Hardware Requirements + +Any machine capable of running link:https://www.openshift.com/[Red Hat OpenShift]/link:https://okd.io[OKD] should also be able to run Kiali. For production environments this usually means: + +* For masters: 16GB RAM, 4vCPUs, 40GB of hard disk space. +* For nodes: 8GB RAM, 1vCPU, 16GB of hard disk space. + +For development the requirements are lower, depending on how demanding your applications are, and how many services you're planning on running at the same time on your machine. Of course, your situation may vary, so plan accordingly. Keep in mind that Kiali is not especially demanding of your machine resources and, as an isolated part of your environment, should not affect your applications throughput or latency. + +For more, see the link:https://docs.okd.io/latest/welcome/index.html[OKD install documentation]. + + +== Installation + +Kiali can be installed in an OpenShift or Kubernetes cluster environment. For OpenShift only, a minimal preparation is necessary. + +icon:lightbulb[size=1x]{nbsp}For several commands listed on this page, the OpenShift CLI command `oc` is used to interact with the cluster environment. If you are on Kubernetes, simply replace `oc` with `kubectl` unless otherwise noted. + + +=== OpenShift Preparation + +If you are installing on OpenShift, you must grant the `cluster-admin` role to the user that is installing Istio and Kiali. If OpenShift is installed locally on the machine you are using, the following command should log you in as user `system:admin` which has this `cluster-admin` role: + +[source,bash] +---- + oc login -u system:admin +---- + + +== Install Kiali via Istio or Maistra + +icon:lightbulb[size=1x]{nbsp} Both Istio and Maistra include Kiali distributions. + +If you prefer to use the latest Kiali version, complete the Istio or Maistra installation and then link:#_install_kiali_latest[Install Kiali Latest]. + +To install Kiali as part of the Istio installation just follow the link:https://istio.io/docs/setup/[Istio Setup docs]. If you are running on OpenShift and prefer Maistra, see link:https://maistra.io/docs/installation/[Maistra Setup docs]. You may then continue to link:#_open_the_ui[Open the UI]. + + +=== Upgrade the Istio or Maistra Version of Kiali + +The version of Kiali packaged with Istio or Maistra may not contain the most recent features and fixes. To upgrade to the latest version of Kiali first link:#_uninstall_kiali_operator_and_kiali[Uninstall Kiali Operator and Kiali] and then proceed to link:#_install_kiali_latest[Install Kiali Latest]. + + +== Install Kiali Latest + +Installing the latest version of Kiali is done using the Kiali Operator. The Kiali Operator is a link:https://coreos.com/operators/[Kubernetes Operator]. The Kiali Operator manages your Kiali installation. The Kiali Operator watches the Kiali Custom Resource (CR), a YAML file that holds the Kiali configuration. When you modify the Kiali CR, the operator installs, updates, or uninstalls Kiali as needed. + +Below are three options for installing the Kiali Operator. If you're replacing an existing Kiali Operator you will be prompted for confirmation. Depending on the installation option the operator may then install Kiali. If you're replacing an existing Kiali you will be prompted for confirmation. For new Kiali installations, you will be prompted for the authentication strategy. See link:#_login_options[Login Options] for more on the `login`, `anonymous`, `ldap`, `openshift`, `token` and `openid` authentication strategies. Depending on the chosen strategy, the installation may prompt for additional information. + +icon:bullhorn[size=1x]{nbsp} It is only necessary to install the Kiali Operator one time. After the operator is installed you need only create or edit the Kiali CR (see link:#_create_or_edit_the_kiali_cr[Create or Edit the Kiali CR]). The Kiali config map will be managed by the Kiali Operator and should *not* be manually edited. There is no need to again perform one of the bash installations below. + + +=== Quick Install + +This option installs the Kiali Operator and the Kiali CR with default options. If you are running with an https://github.com/istio/istio/releases[upstream Istio release], you will probably want to pass in _--accessible_names="**"_ since that is the typical way Kiali is expected to run within an upstream Istio environment. + + +When the Kiali CR is created it triggers the operator to then install Kiali. Kiali is able to access existing namespaces, but it required a CR update to access future namespaces. See link:#_namespace_management[Namespace Management] for more information. Run the install script via this command: + +[source,bash] +---- + bash <(curl -L https://kiali.io/getLatestKialiOperator) --accessible-namespaces '**' +---- + + +=== Development Install + +This option installs the Kiali Operator and the Kiali CR. It uses a non-default setting for accessible-namespaces making all current and future namespaces accessible to Kiali. This option is good for demo and development installations. This option grants special cluster role permissions and is not recommended for production. See link:#_namespace_management[Namespace Management] for more information. + +When the Kiali CR is created it triggers the operator to then install Kiali. Run the install script via this command: + +[source,bash] +---- + bash <(curl -L https://kiali.io/getLatestKialiOperator) --accessible-namespaces '**' -oiv latest -kiv latest +---- + +icon:bullhorn[size=1x]{nbsp} The above options install the _latest_ operator and Kiali from stable master. + +=== Advanced Install (Operator-Only) + +This option installs only the Kiali Operator. This option is good when you plan to customize the Kiali CR. + +Run the install script via this command (replacing the CR filename as needed): + +[source,bash] +---- + bash <(curl -L https://kiali.io/getLatestKialiOperator) --operator-install-kiali false +---- + +When the Kiali Operator is installed go to link:#_create_or_edit_the_kiali_cr[Create or Edit the Kiali CR] for the customized Kiali installation. + + +==== Kiali Operator Install Script + +It is not usually necessary to explicitly execute the link:https://github.com/kiali/kiali-operator/blob/master/deploy/deploy-kiali-operator.sh[Kiali Operator install script] but it does offer a variety of options. To learn more about the script, and the available options, run the command: + +[source,bash] +---- + bash <(curl -L https://kiali.io/getLatestKialiOperator) --help +---- + +icon:bullhorn[size=1x]{nbsp} The install script requires `envsubst` installed and in your PATH; you can get it via the GNU `gettext` package. + + +=== Create or Edit the Kiali CR + +The Kiali Operator watches the Kiali CR (Custom Resource). Create, update, or removal of the Kiali CR will trigger the Kiali Operator to install, update, or remove Kiali. This assumes the Kiali Operator has already been installed. See link:#_advanced_install_operator_only[Advanced Install (Operator-Only)] if you need to install the Kiali Operator. + +To create an initial Kiali CR file it is recommended to copy the fully documented link:https://github.com/kiali/kiali-operator/blob/master/deploy/kiali/kiali_cr.yaml[example Kiali CR YAML file]. Edit the file, being careful to maintain proper formatting, and save it to a local file such as `my-kiali-cr.yaml`. + +icon:lightbulb[size=1x]{nbsp} It is important to understand the `deployment:accessible_namespaces` setting in the CR. See link:#_accessible_namespaces[Accessible Namespaces] for more information. + +icon:bullhorn[size=1x]{nbsp} The Kiali config map will be managed by the Kiali Operator and should *not* be manually edited. + +To install Kiali create the Kiali CR using the local file. To create the Kiali CR run the command: + +[source,bash] +---- + oc apply -f my-kiali-cr.yaml -n kiali-operator +---- + +To update Kiali, edit and save the existing the Kiali CR. To edit the Kiali CR run the command. In this example, the default Kiali CR name is `kiali`: + +[source,bash] +---- + oc edit kiali -n kiali-operator +---- + +=== Open the UI + +Once Istio, Maistra or the Kiali Operator has installed Kiali, and the Kiali pod has successfully started, you can access the UI. Please, check the link:{{< ref "/faq/general#how-do-i-access-kiai" >}}[FAQ: How do I access Kiali UI?] + +icon:bullhorn[size=1x]{nbsp} The credentials you use on the login screen depend on the authentication strategy that was configured for Kiali. See link:#_login_options[Login Options] for more details. + +== Uninstall + +=== Uninstall Kiali Only + +To remove Kiali is simple - just delete the Kiali CR. To trigger the Kiali Operator to uninstall Kiali run the command (note: the default Kiali CR name is `kiali`): + +[source,bash] +---- + oc delete kiali -n kiali-operator +---- + +At this point, you have no Kiali installed, but you still have the Kiali Operator running. You could create another Kiali CR with potentially different configuration settings to install a new Kiali instance. + +=== Uninstall Kiali Operator and Kiali + +To uninstall *everything* related to Kiali (Kiali Operator, Kiali, etc) run the command: + +[source,bash] +---- + bash <(curl -L https://kiali.io/getLatestKialiOperator) --uninstall-mode true +---- + + +==== Known Problem: Uninstall Hangs + +In Kiali < 0.22 using Kubernetes versions < 0.14 (OpenShift version 3), there is an operator-sdk bug that can hang uninstall. This can happen when uninstalling Kiali via the Kiali Operator, or occasionally when trying to delete the namespace in which Kiali is installed. This is due to a kubernetes bug detecting finalizer completion. If you get into this hung state the following command may resolve the problem: + +icon:lightbulb[size=1x]{nbsp} If you installed the Kiali CR in a different namespace (via -own, --operator-watch-namespace), replace "kiali-operator" in the command with the namespace in which the Kiali CR is located. + +[source,bash] +---- + oc patch kiali kiali -n kiali-operator -p '{"metadata":{"finalizers": []}}' --type=merge +---- + +== Additional Notes + +=== Customize the Kiali UI web context root + +By default, when installed on OpenShift, the Kiali UI is deployed to the root context path of "/", for example `https://kiali-istio-system./`. In some situations, such as when you want to serve the Kiali UI along with other apps under the same host name, for example, `example.com/kiali`, `example.com/app1`, you can edit the Kiali CR and provide a different value for `web_root`. The path must begin with a `/` and not end with a `/` (e.g. `/kiali` or `/mykiali`). + +An example of custom web root: + +[source,yaml] +---- +server: + web_root: /kiali + ... +---- + +The above is the default when Kiali is installed on Kubernetes - so to access the Kiali UI on Kubernetes you access it at the root context path of "/kiali". + +=== Login Options + +Kiali supports several different login options. + +*login*: This option allows a user to log in to Kiali using a username and password. This is the default option if using Kubernetes. + +icon:bullhorn[size=2x]{nbsp} The _login_ strategy is deprecated and it will be removed in a following release. As an alternative, use the _token_ strategy, which provides similar authentication experience to the link:https://github.com/kubernetes/dashboard[Kubernetes Dashboard]. + +*anonymous*: This option removes any login requirement. A user will not be presented the login page and will automatically have access to Kiali without having to present any credentials. + +*ldap*: This option allows a user to log in to Kiali using a username and passphrase that is authenticated via a backend LDAP server. This option requires that you configure additional settings in the Kiali CR under `auth.ldap` - see below for an example. If you want to use this option, you cannot use the operator deploy script to configure Kiali for you - you must create the Kiali CR and either pass it to the deploy script via `--kiali-cr` or do not have the script deploy a Kiali CR (`--operator-install-kiali=false`) but instead deploy the Kiali CR directly into your cluster yourself. + +icon:bullhorn[size=2x]{nbsp} The _ldap_ strategy is deprecated and it will be removed in a following release. As an alternative, use the _openid_ strategy and use an OpenID provider that supports LDAP integration. + +*openshift*: If you have deployed Kiali on OpenShift you can use this option (this is the default option if you're using OpenShift). With this option, users log in to Kiali with the OpenShift OAuth login. What users can access in Kiali will now be based on their user roles in OpenShift using the Kubernetes RBAC. + +*token*: This option allows a user to log in to Kiali using a Service Account token. This is similar to the link:https://github.com/kubernetes/dashboard/blob/master/docs/user/access-control/README.md#login-view[login view of Kubernetes Dashboard]. When using this option, the cluser RBAC will take effect and users can access only what is allowed to the Service Account. + +*openid*: This option allows a user to log in to Kiali using an external identity provider that implements link:https://openid.net/connect/[OpenID Connect]. When using this option, the cluser RBAC will take effect and users can access only what is allowed via the link:https://kubernetes.io/docs/reference/access-authn-authz/rbac/[cluster's authorization mechanisms]. This strategy requires that your link:https://kubernetes.io/docs/reference/access-authn-authz/authentication/#openid-connect-tokens[Kubernetes cluster is configured to accept tokens issued from your identity provider]. See the dedicated link:#_openid_connect[OpenID section of this page] for more information. + +icon:bullhorn[size=1x]{nbsp} Using the *anonymous* option will leave Kiali unsecured. Anyone who can access the console will have full access to Kiali. If you are using this option you will need to make sure that it is only available on a trusted network and that only trusted users can access it. + +If `login` strategy is selected during the installation, a secret containing Kiali login credentials is required to be deployed along with Kiali. In this case, the install script will prompt you to enter a username and passphrase for the credentials that you want users to enter in order to log in successfully to Kiali. The install script will store those credentials in a secret that is deployed in the same namespace where Kiali is installed. + +icon:bullhorn[size=1x]{nbsp} If you configured the install script not to install a Kiali CR (and thus not have Kiali installed yet) via the `operator-install-kiali=false` option, you are responsible for creating this secret if you wish to install Kiali with the authentication strategy of "login". A secret is not required if your authentication strategy is not "login". The following command is a simple way to create a secret for Kiali whose user name is "admin" and password is "admin": +[source,bash] +---- + oc create secret generic kiali -n istio-system --from-literal "username=admin" --from-literal "passphrase=admin" +---- + +For the `login`, `anonymous`, and `ldap` login options, the content displayed in Kiali is based on the permissions of the Kiali service account. On Kubernetes, the Kiali service account has cluster wide access and will be able to display everything in the cluster. By default, in OpenShift the service account will also have access to everything in the cluster but this can be customized by following the link:#_reducing_permissions_in_openshift[instructions below]. + +For the `openshift` login option, the content displayed in Kiali is based on the permissions of the user who logged in via the OpenShift OAuth login page. This means that individual users will be shown different content based on their roles within OpenShift. See the link:#openshift_user_permissions[section] below for how to grant or remove a user's access to specific namespaces. + +The login option can be specified in the Kiali CR when installing Kiali. For instance, to use the `openshift` login option, the Kiali CR should contain the following in the `auth` section: + +[source,yaml] +---- +auth: + strategy: openshift +---- + +==== LDAP + +icon:bullhorn[size=2x]{nbsp} The _ldap_ strategy is deprecated and it will be removed in a following release. As an alternative, use the _openid_ strategy and use an OpenID provider that supports LDAP integration. + +The `ldap` login option requires additional settings in the `auth.ldap` section. For example: + +[source,yaml] +---- +auth: + strategy: ldap + ldap: + ldap_base: "DC=example,DC=com" + ldap_bind_dn: "CN={USERID},OU=xyz,OU=Users,OU=Accounts,DC=example,DC=com" + ldap_group_filter: "(cn=%s)" + ldap_host: "ldap-service.ldap-namespace" + ldap_insecure_skip_verify: true + ldap_mail_id_key: "mail" + ldap_member_of_key: "memberOf" + ldap_port: 123 + ldap_role_filter: ".*xyz.*" + ldap_search_filter: "(&(name={USERID}))" + ldap_use_ssl: false + ldap_user_filter: "(cn=%s)" + ldap_user_id_key: "cn" +---- + +An expanation for those LDAP configuration settings are given below: + +* `ldap_base`: The starting point from where Kiali will search for users. +* `ldap_bind_dn`: The template used to try to authenticate a user. There must be a user ID to match this template in order to be able to log in to Kiali. +* `ldap_group_filter`: This is used to get the groups of the user. If the group is part of Common Name (CN), the filter will be something like `(cn=%s)`. +* `ldap_host`: The host IP of the LDAP server. +* `ldap_insecure_skip_verify`: If true, Kiali will not attempt to verify the LDAP server's certificate when using SSL. +* `ldap_mail_id_key`: The attribute that is used to retrieve the mail id of the user from the LDAP server. +* `ldap_member_of_key`: The attribute that is used to retrieve the member groups of the user from the LDAP server. +* `ldap_port`: The port that the LDAP server is listening to. +* `ldap_role_filter`: Used to filter the user roles based on the regular expression provided. +* `ldap_search_filter`: Used to get the user details from LDAP. +* `ldap_use_ssl`: When true, Kiali will send requests to the LDAP server using the secure SSL protocol. +* `ldap_user_filter`: Used to search for the given user name. +* `ldap_user_id_key`: The attribute that is used to retrieve the user ID of the user from the LDAP server. + +The configuration settings that are required to be set in order to use the LDAP authentication strategy are: + +* ldap_base +* ldap_bind_dn +* ldap_host +* ldap_port + +Kiali will not start if those settings are not present. + +==== OpenID Connect + +The `openid` login strategy requires additional settings in the `auth.openid` section. The minimal required attributes are `client_id` and `issuer_uri`. For example: + +[source,yaml] +---- +auth: + strategy: openid + openid: + client_id: "kiali-client" + issuer_uri: "https://openid.issuer.com" +---- + +Please, check the +link:https://github.com/kiali/kiali-operator/blob/8f2329c17d67d9a22c9fc1a50b468a7e80df72e6/deploy/kiali/kiali_cr.yaml#L173-L206[kiali_cr.yaml] +file of the Kiali operator repository to learn about all available options for +configuring the `openid` strategy. + +The `openid` strategy requires that your +link:https://kubernetes.io/docs/reference/access-authn-authz/authentication/#openid-connect-tokens[Kubernetes +cluster is configured to accept tokens generated by your identity provider]. If +your cluster is not properly configured, authentication will fail and users +won't be able to log in to Kiali. Because of this, the value of `client-id`, +`issuer_uri` and `username_claim` configuration options in Kiali are required +to match the `--oidc-client-id`, `--oidc-issuer-url` and +`--oidc-username-claim` flags +link:https://kubernetes.io/docs/reference/access-authn-authz/authentication/#configuring-the-api-server[used +to start the cluster API server]. If one or more of these values don't match, +users might fail to log in to Kiali. + +Kiali uses the OpenID identity of the logged in user to make calls to the +cluster API. Because of this, the `openid` strategy is RBAC-enabled and only +users with privileges on the cluster will be able to log in to Kiali. +Depending on the options you provided in the Kiali operator CR, there will be a +ClusterRole named either `kiali` or `kiali-viewer` that you can use to assign +privileges. For example, to assign privileges to the `john@example.com` OpenId +user in the `testing` namespace, you could run the following command: + +[source,bash] +---- +kubectl create rolebinding john-openid-binding --clusterrole=kiali --user="john@example.com" --namespace=testing +---- + +By assigning privileges this way, the user will be able to use Kiali and +inspect only the `testing` namespace. If you need to assign cluster-wide +permissions, assign privileges using a ClusterRoleBinding: + +[source,bash] +---- +kubectl create clusterrolebinding john-openid-clusterbinding --clusterrole=kiali --user="john@example.com" +---- + +icon:bullhorn[size=1x]{nbsp} If you need to assign a more limited set of +privileges, it's possible to use the `kiali` or `kiali-viewer` ClusterRoles as +a base for creating your own customized Roles or ClusterRoles. Then, bind the +users these customized roles. Do not edit the `kiali` nor the `kiali-viewer` +ClusterRoles becuase they are binded to the Kiali ServiceAccount and editing +them may lead to Kiali not working properly. + +[#openshift_user_permissions] +==== OpenShift User Permissions + +If you are running with the `openshift` login option you will need to grant a user the 'kiali' role for them to be able to properly access a namespace in Kiali. + +For instance, to grant the user 'developer' access to the 'myproject' namespace, you could run the following command: + +[source,bash] +---- + oc adm policy add-role-to-user kiali developer -n myproject +---- + +To remove the 'kiali' role from the user 'developer' in the 'myproject' namespace you can run the following command: + +[source,bash] +---- + oc adm policy remove-role-from-user kiali developer -n myproject +---- + +=== Namespace Management + +==== Accessible Namespaces + +The Kiali custom resource (CR) tells the Kiali Operator which namespaces are accessible to Kiali. It is specified in the CR via the `accessible_namespaces` setting under the main `deployment` section. + +The specified namespaces are those that have service mesh components to be observed by Kiali. Additionally, the namespace to which Kiali is installed must be accessible (typically the same namespace as Istio). Each list entry can be a regex matched against all namespaces the operator can see. If not set the default makes all namespaces accessible except for some internal namespaces that should typically be ignored. + +As an example, if Kiali is to be installed in the istio-system namespace, and is expected to monitor all namespaces prefixed with `mycorp_` the setting would be: + +[source,yaml] +---- +deployment: + accessible_namespaces: + - istio-system + - mycorp_.* +---- + +icon:lightbulb[size=1x]{nbsp} If `accessible_namespaces` has an entry with the special value of `+++**+++` (two asterisks), it denotes that Kiali be given access to all namespaces via a single cluster role (if using this special value of `+++**+++`, you are required to have already granted the operator permissions to create cluster roles and cluster role bindings). It is not recommended for production but the following command will create both the Kiali operator and the Kiali CR, configured for full cluster access to current and new namespaces: + +icon:bullhorn[size=1x]{nbsp} If the operator was not originally installed with --accessible_namespaces set to `+++**+++`, you cannot later edit the Kiali CR and change accessible_namespaces to `+++**+++`. You must use the bash command below to reinstall the operator so that it can be granted the additional permissions required. + +[source,bash] +---- + bash <(curl -L https://kiali.io/getLatestKialiOperator) -an '**' +---- + +Maistra supports multi-tenancy and the `accessible_namespaces` extends that feature to Kiali. However, explicit naming of accessible namespaces can benefit non-Maistra installations as well, with it Kiali does not need cluster roles and the Kiali Operator does not need permissions to create cluster roles. + + +==== Excluded Namespaces + +The Kiali custom resource (CR) tells the Kiali Operator which accessible namespaces should be excluded from the list of namespaces provided by the API and UI. This can be useful if wildcards are used when specifying link:#_accessible_namespaces[Accessible Namespaces]. This setting has no effect on namespace accessibility. It is only a filter, not security-related. + +For example, if my accessible_namespaces include "mycorp_.*" but I don't want to see test namespaces, I could add to the default entries: + +[source,yaml] +---- +namespaces: + exclude: + - istio-operator + - kiali-operator + - ibm.* + - kube.* + - openshift.* + - mycorp_test.* +---- + +==== Namespace Selectors + +Kiali supports an optional label selector for namespaces which is used to fetch a subset of the available namespaces. + +The label selector is defined under the namespaces definition. + +The example below selects all namespaces that have a label `kiali-enabled: true`: + +[source,yaml] +---- +namespaces: + label_selector: kiali-enabled=true +---- + +For further information on how the `label_selector` interacts with `deployment.accessible_namespaces` read the https://github.com/kiali/kiali-operator/blob/master/deploy/kiali/kiali_cr.yaml[technical documentation]. + +To label a namespace, you can use the following command, for more information see the :link:https://kubernetes.io/docs/concepts/overview/working-with-objects/labels[official documentation] + +[source,bash] +---- + kubectl label namespace xxx kiali-enabled=true +---- + +Note that when using multiple service meshes (i.e. multiple control planes) in the same cluster, you will want to set the label selector's value to a value unique to each mesh. + +This is so each mesh's Kiali instance will only select those namespaces within that mesh. + +For an example of using Kiali in this kind of soft multi-tenancy mode, see the [Maistra](https://github.com/Maistra/istio-operator) project. + +This is the reason why this `label_selector` will be defined by default to the value of `kiali.io/member-of: ` if the `deployment.accessible_namespaces` is set to something other than the "all namespaces" value `['**']`. + +This allows you to have multiple control planes in the same cluster and have each control plane contain its own Kiali instance. + +=== Reducing Permissions in OpenShift + +By default, Kiali will run with its cluster role named `kiali`. It provides some read-write capabilities so Kiali can add, modify, or delete some service mesh resources to perform tasks such as adding and modifying Istio destination rules in any namespace. + +If you prefer not to run Kiali with this read-write role across the cluster, it is possible to reduce these permissions to individual namespaces. + +icon:lightbulb[size=1x]{nbsp} This only works for OpenShift since it can return a list of namespaces that a user has access to. Know how to make this work with Kubernetes? Awesome, please let us know in this https://issues.jboss.org/browse/KIALI-1675[issue]. + +The first thing you will need to do is to remove the cluster-wide permissions that are granted to Kiali by default: + +[source,bash] +---- + oc delete clusterrolebindings kiali +---- + +Then you will need to grant the `kiali` role in the namespace of your choosing: + +[source,bash] +---- + oc adm policy add-role-to-user kiali system:serviceaccount:istio-system:kiali-service-account -n ${NAMESPACE} +---- + +You can alternatively tell the Kiali Operator to install Kiali in "view only" mode (this does work for either OpenShift or Kubernetes). You do this by setting the `view_only_mode` to `true` in the Kiali CR: + +[source,yaml] +---- +deployment: + view_only_mode: true + ... +---- + +This allows Kiali to read service mesh resources found in the cluster, but it does not allow Kiali to add, modify, or delete them. diff --git a/content/documentation/v1.19/glossary/_index.adoc b/content/documentation/v1.19/glossary/_index.adoc new file mode 100644 index 000000000..4e90862cf --- /dev/null +++ b/content/documentation/v1.19/glossary/_index.adoc @@ -0,0 +1,6 @@ +--- +title: "Glossary" +date: 2018-06-20T19:04:38+02:00 +draft: false +weight: 9 +--- diff --git a/content/documentation/v1.19/glossary/concepts/index.adoc b/content/documentation/v1.19/glossary/concepts/index.adoc new file mode 100644 index 000000000..39083c9e2 --- /dev/null +++ b/content/documentation/v1.19/glossary/concepts/index.adoc @@ -0,0 +1,93 @@ +--- +title: "Concepts" +date: 2018-06-20T19:04:38+02:00 +draft: false +--- + +:sectlinks: + += Kiali Concepts Glossary +:sectnums: +:toc: left +toc::[] +:toc-title: Terminology Content +:keywords: Kiali Documentation +:icons: font +:imagesdir: /images/documentation/terminology/ + +== Application + +Is a logical grouping of <>s defined by the application labels that users apply to an object. In Istio it is defined by the <