Infra nav after the deprecation of the cert-based integration with K8s (3rd iteration)
NOTE: THIS PROPOSAL IS A WORK IN PROGRESS AND SUBJECT TO CHANGE. MOVING DOCS TO OTHER DIRECTORIES IS NOT A HIGH PRIORITY.
Follows !2249 (merged), #1105 (closed).
Once we settle the deprecation of the certificate-based integration (gitlab-org/configure&8), we need to prepare a new directory structure and a new nav only for the Agent-based features and their relative docs. We'll keep the deprecated features in the nav as they are for now.
In a recent meeting with ~"group::configure"'s EM and PM (notes), we decided to keep the current workflow-based structure for the nav.
New proposal
The nav itself will remain pretty much the same, but the directory structure will be updated accordingly.
For clusters deployment, @nagyv-gitlab suggested:
I recently realized that documentation about targeting Kubernetes with a deployment should go under https://docs.gitlab.com/ee/topics/release_your_application.html
Taking that into account:
- We'd remove the deployment part from the K8s nav and put it underneath "Deploy and release your application".
- Maintain the cluster deployment and related files under the same directory as the other cluster-related docs (I think):
.
+-- Deploy and release your application
| +-- Environments and deployments
| +-- Deploy to Kubernetes clusters
| +-- Auto Deploy
| +-- Releases
| +-- Feature flags
.
+-- Manage your infrastructure
| +-- IaC
| +-- Terraform integrations
| +-- Terraform state
| +-- Kubernetes clusters (infra/clusters/index.md)
| +-- Install the GitLab Agent for Kubernetes (infra/clusters/install/index.md)
| +-- Configure the agent (agent/repository.md => infra/clusters/configure/index.md)
| +-- Manage clusters (infra/clusters/manage/index.md)
| +-- Clusters applications (user/clusters/management_project_template.md => infra/clusters/manage/applications.md
| +-- Inventory Objects (/user/infrastructure/clusters/deploy/inventory_object.md => infra/clusters/manage/inventory_objects.md)
| +-- Protect deployed applications (user/project/clusters/protect/* => infra/clusters/protect/*)
| +-- (DEPRECATED) Certificate-based clusters
| +-- List all the deprecated features
| +-- Runbooks
If we want to leave everything under infra:
.
+-- Manage your infrastructure
| +-- IaC
| +-- Terraform integrations
| +-- Terraform state
| +-- Kubernetes clusters (infra/clusters/index.md)
| +-- Install the Kubernetes Agent (infra/clusters/install/index.md)
| +-- Configure the agent (agent/repository.md => infra/clusters/configure/index.md)
| +-- Manage clusters (infra/clusters/manage/index.md)
| +-- Inventory Objects (/user/infrastructure/clusters/deploy/inventory_object.md => infra/clusters/manage/inventory_objects.md)
| +-- Clusters applications (user/clusters/management_project_template.md => infra/clusters/manage/applications.md
| +-- Deploy to Kubernetes clusters (ee/user/clusters/agent/ci_cd_tunnel.md => infra/clusters/deploy/index.md)
| +-- Protect deployed applications (user/project/clusters/protect/* => infra/clusters/protect/*)
| +-- (DEPRECATED) Certificate-based clusters
| +-- List all the deprecated features
| +-- Runbooks