Перейти к основному содержимому

CLAUDE.md

Это репозиторий документации инфраструктуры платформы — Kubernetes-кластеры, окружения, деплой, сети, данные и облачные ресурсы.

URL: https://rr-git.gitlab.yandexcloud.net/infrastructure/documentation.git

Структура документации​

documentation/
├── intro.md                        # Обзор инфраструктуры
├── environments/
│   └── overview.md                 # Все окружения (Media dev/prod, Witisi, Scount dev/prod)
├── kubernetes/
│   └── clusters.md                 # K8s кластеры, node groups
├── deployment/
│   ├── argocd.md                   # ArgoCD GitOps деплой
│   └── ci-cd.md                    # CI/CD пайплайны GitLab
├── networking/
│   ├── domains.md                  # Домены, IP, TLS сертификаты
│   └── ingress-gateway.md          # Миграция Ingress → Gateway API
├── data/
│   └── databases.md                # PostgreSQL, Redis, S3
└── cloud/
    └── yandex-cloud.md             # Yandex Cloud ресурсы, Terragrunt

Деплой документации​

При пуше в master CI автоматически копирует файлы в common/docusaurus/docs/infrastructure/ и триггерит пересборку Docusaurus.

Переменные окружения в GitLab CI/CD Settings:

  • DEPLOY_DOCS_REPO_TOKEN_NAME
  • DEPLOY_DOCS_REPO_TOKEN_KEY
  • DEPLOY_DOCS_REPO_URL

Формат документов​

Markdown с frontmatter:

---
sidebar_position: 1
---
# Заголовок

Контекст​

  • Облако: Yandex Cloud, регион ru-central1
  • IaC: Terraform + Terragrunt (infrastructure/terragrant)
  • Деплой: ArgoCD GitOps, deployment-репозитории media/deployment, scount/deployment
  • Инфра-репозитории: infrastructure/media, infrastructure/scount, infrastructure/helm-charts
  • 4 K8s кластера: media-dev, media-prod (включает witisi-prod namespace), scount-dev, scount-prod
  • Документация пишется на русском языке