Features: - Automated datacenter documentation generation - MCP integration for device connectivity - Auto-remediation engine with safety checks - Multi-factor reliability scoring (0-100%) - Human feedback learning loop - Pattern recognition and continuous improvement - Agentic chat support with AI - API for ticket resolution - Frontend React with Material-UI - CI/CD pipelines (GitLab + Gitea) - Docker & Kubernetes deployment - Complete documentation and guides v2.0 Highlights: - Auto-remediation with write operations (disabled by default) - Reliability calculator with 4-factor scoring - Human feedback system for continuous learning - Pattern-based progressive automation - Approval workflow for critical actions - Full audit trail and rollback capability
269 lines
6.5 KiB
YAML
269 lines
6.5 KiB
YAML
# GitLab CI/CD Pipeline for Datacenter Documentation System
|
|
|
|
stages:
|
|
- lint
|
|
- test
|
|
- build
|
|
- deploy
|
|
- docs
|
|
|
|
variables:
|
|
POETRY_VERSION: "1.7.1"
|
|
PYTHON_VERSION: "3.10"
|
|
DOCKER_DRIVER: overlay2
|
|
DOCKER_TLS_CERTDIR: "/certs"
|
|
PIP_CACHE_DIR: "$CI_PROJECT_DIR/.cache/pip"
|
|
|
|
cache:
|
|
key: ${CI_COMMIT_REF_SLUG}
|
|
paths:
|
|
- .cache/pip
|
|
- .venv/
|
|
|
|
# Template for Python jobs
|
|
.python-base:
|
|
image: python:${PYTHON_VERSION}
|
|
before_script:
|
|
- pip install poetry==${POETRY_VERSION}
|
|
- poetry config virtualenvs.in-project true
|
|
- poetry install --no-root
|
|
|
|
# Lint stage
|
|
lint:black:
|
|
extends: .python-base
|
|
stage: lint
|
|
script:
|
|
- poetry run black --check src/ tests/
|
|
only:
|
|
- merge_requests
|
|
- main
|
|
- develop
|
|
|
|
lint:ruff:
|
|
extends: .python-base
|
|
stage: lint
|
|
script:
|
|
- poetry run ruff check src/ tests/
|
|
only:
|
|
- merge_requests
|
|
- main
|
|
- develop
|
|
|
|
lint:mypy:
|
|
extends: .python-base
|
|
stage: lint
|
|
script:
|
|
- poetry run mypy src/
|
|
allow_failure: true
|
|
only:
|
|
- merge_requests
|
|
- main
|
|
- develop
|
|
|
|
# Test stage
|
|
test:unit:
|
|
extends: .python-base
|
|
stage: test
|
|
services:
|
|
- redis:7-alpine
|
|
- postgres:15-alpine
|
|
variables:
|
|
POSTGRES_DB: testdb
|
|
POSTGRES_USER: test
|
|
POSTGRES_PASSWORD: test
|
|
REDIS_URL: redis://redis:6379/0
|
|
DATABASE_URL: postgresql://test:test@postgres:5432/testdb
|
|
script:
|
|
- poetry run pytest tests/unit -v --cov --cov-report=xml --cov-report=term
|
|
coverage: '/(?i)total.*? (100(?:\.0+)?\%|[1-9]?\d(?:\.\d+)?\%)$/'
|
|
artifacts:
|
|
reports:
|
|
coverage_report:
|
|
coverage_format: cobertura
|
|
path: coverage.xml
|
|
paths:
|
|
- htmlcov/
|
|
expire_in: 30 days
|
|
only:
|
|
- merge_requests
|
|
- main
|
|
- develop
|
|
|
|
test:integration:
|
|
extends: .python-base
|
|
stage: test
|
|
services:
|
|
- redis:7-alpine
|
|
- postgres:15-alpine
|
|
variables:
|
|
POSTGRES_DB: testdb
|
|
POSTGRES_USER: test
|
|
POSTGRES_PASSWORD: test
|
|
REDIS_URL: redis://redis:6379/0
|
|
DATABASE_URL: postgresql://test:test@postgres:5432/testdb
|
|
script:
|
|
- poetry run pytest tests/integration -v
|
|
only:
|
|
- merge_requests
|
|
- main
|
|
- develop
|
|
when: manual
|
|
|
|
# Security scanning
|
|
security:bandit:
|
|
extends: .python-base
|
|
stage: test
|
|
script:
|
|
- poetry add --group dev bandit
|
|
- poetry run bandit -r src/ -f json -o bandit-report.json
|
|
artifacts:
|
|
paths:
|
|
- bandit-report.json
|
|
expire_in: 30 days
|
|
allow_failure: true
|
|
only:
|
|
- merge_requests
|
|
- main
|
|
|
|
security:safety:
|
|
extends: .python-base
|
|
stage: test
|
|
script:
|
|
- poetry export -f requirements.txt --output requirements.txt --without-hashes
|
|
- poetry add --group dev safety
|
|
- poetry run safety check --file requirements.txt
|
|
allow_failure: true
|
|
only:
|
|
- merge_requests
|
|
- main
|
|
|
|
# Build stage
|
|
build:docker:api:
|
|
stage: build
|
|
image: docker:24.0.5
|
|
services:
|
|
- docker:24.0.5-dind
|
|
before_script:
|
|
- docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
|
|
script:
|
|
- docker build -f deploy/docker/Dockerfile.api -t $CI_REGISTRY_IMAGE/api:$CI_COMMIT_SHORT_SHA .
|
|
- docker build -f deploy/docker/Dockerfile.api -t $CI_REGISTRY_IMAGE/api:latest .
|
|
- docker push $CI_REGISTRY_IMAGE/api:$CI_COMMIT_SHORT_SHA
|
|
- docker push $CI_REGISTRY_IMAGE/api:latest
|
|
only:
|
|
- main
|
|
- tags
|
|
|
|
build:docker:chat:
|
|
stage: build
|
|
image: docker:24.0.5
|
|
services:
|
|
- docker:24.0.5-dind
|
|
before_script:
|
|
- docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
|
|
script:
|
|
- docker build -f deploy/docker/Dockerfile.chat -t $CI_REGISTRY_IMAGE/chat:$CI_COMMIT_SHORT_SHA .
|
|
- docker build -f deploy/docker/Dockerfile.chat -t $CI_REGISTRY_IMAGE/chat:latest .
|
|
- docker push $CI_REGISTRY_IMAGE/chat:$CI_COMMIT_SHORT_SHA
|
|
- docker push $CI_REGISTRY_IMAGE/chat:latest
|
|
only:
|
|
- main
|
|
- tags
|
|
|
|
build:docker:worker:
|
|
stage: build
|
|
image: docker:24.0.5
|
|
services:
|
|
- docker:24.0.5-dind
|
|
before_script:
|
|
- docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
|
|
script:
|
|
- docker build -f deploy/docker/Dockerfile.worker -t $CI_REGISTRY_IMAGE/worker:$CI_COMMIT_SHORT_SHA .
|
|
- docker build -f deploy/docker/Dockerfile.worker -t $CI_REGISTRY_IMAGE/worker:latest .
|
|
- docker push $CI_REGISTRY_IMAGE/worker:$CI_COMMIT_SHORT_SHA
|
|
- docker push $CI_REGISTRY_IMAGE/worker:latest
|
|
only:
|
|
- main
|
|
- tags
|
|
|
|
build:frontend:
|
|
stage: build
|
|
image: node:20-alpine
|
|
script:
|
|
- cd frontend
|
|
- npm ci
|
|
- npm run build
|
|
artifacts:
|
|
paths:
|
|
- frontend/dist/
|
|
expire_in: 7 days
|
|
only:
|
|
- main
|
|
- tags
|
|
|
|
# Deploy stage
|
|
deploy:staging:
|
|
stage: deploy
|
|
image: bitnami/kubectl:latest
|
|
script:
|
|
- kubectl config use-context staging
|
|
- kubectl set image deployment/api api=$CI_REGISTRY_IMAGE/api:$CI_COMMIT_SHORT_SHA -n datacenter-docs
|
|
- kubectl set image deployment/chat chat=$CI_REGISTRY_IMAGE/chat:$CI_COMMIT_SHORT_SHA -n datacenter-docs
|
|
- kubectl set image deployment/worker worker=$CI_REGISTRY_IMAGE/worker:$CI_COMMIT_SHORT_SHA -n datacenter-docs
|
|
- kubectl rollout status deployment/api -n datacenter-docs
|
|
- kubectl rollout status deployment/chat -n datacenter-docs
|
|
- kubectl rollout status deployment/worker -n datacenter-docs
|
|
environment:
|
|
name: staging
|
|
url: https://staging-docs.company.local
|
|
only:
|
|
- main
|
|
when: manual
|
|
|
|
deploy:production:
|
|
stage: deploy
|
|
image: bitnami/kubectl:latest
|
|
script:
|
|
- kubectl config use-context production
|
|
- kubectl set image deployment/api api=$CI_REGISTRY_IMAGE/api:$CI_COMMIT_SHORT_SHA -n datacenter-docs
|
|
- kubectl set image deployment/chat chat=$CI_REGISTRY_IMAGE/chat:$CI_COMMIT_SHORT_SHA -n datacenter-docs
|
|
- kubectl set image deployment/worker worker=$CI_REGISTRY_IMAGE/worker:$CI_COMMIT_SHORT_SHA -n datacenter-docs
|
|
- kubectl rollout status deployment/api -n datacenter-docs
|
|
- kubectl rollout status deployment/chat -n datacenter-docs
|
|
- kubectl rollout status deployment/worker -n datacenter-docs
|
|
environment:
|
|
name: production
|
|
url: https://docs.company.local
|
|
only:
|
|
- tags
|
|
when: manual
|
|
|
|
# Documentation generation
|
|
docs:generate:
|
|
extends: .python-base
|
|
stage: docs
|
|
script:
|
|
- poetry run python -m datacenter_docs.cli generate-all --dry-run
|
|
artifacts:
|
|
paths:
|
|
- output/
|
|
expire_in: 7 days
|
|
only:
|
|
- schedules
|
|
- main
|
|
|
|
docs:publish:
|
|
stage: docs
|
|
image: node:20-alpine
|
|
script:
|
|
- npm install -g @gitbook/cli
|
|
- gitbook build ./docs
|
|
- gitbook pdf ./docs ./datacenter-docs.pdf
|
|
artifacts:
|
|
paths:
|
|
- _book/
|
|
- datacenter-docs.pdf
|
|
expire_in: 30 days
|
|
only:
|
|
- tags
|