Cicd¶

CICD — mvp.cicd

Cluster: Uncategorised | Type: base | MCP Tools: None

Overview¶

End-to-end deployment pipeline base that orchestrates the full build → push → deploy → health-check lifecycle for any G6 base. Composes a ContainerRuntime (Docker or Podman) with an InfraTarget (AWS, GCP, bare metal, K8s) selected at runtime from PipelineConfig, generates git-SHA-tagged image versions, and provides blue/green rollout, staging gates, quality gates, and alert hooks. Exposes a CLI entrypoint for operator use.

When to use:

• Running a complete CI/CD pipeline for a G6 REST, gRPC, or MCP base from a single config file
• Wiring blue/green deployments with configurable staging promotion and automatic rollback
• Triggering deployment pipelines programmatically from an agent or GitHub Actions workflow

Example:

from mvp.cicd.config import PipelineConfig
from mvp.cicd.pipeline import run_pipeline

config = PipelineConfig(base="rest", runtime="docker", target="aws", dry_run=True)
result = run_pipeline(config)
# result.ok → True; each stage logs a DeployResult

Works well with: deploy_docker, deploy_aws, deploy_k8s, observability

Public API¶

AlertDispatcher¶

Methods:

dispatch(alert: Alert) -> DeployResult¶

BlueGreenManager¶

Methods:

deploy(image_tag: str) -> DeployResult¶

rollback() -> DeployResult¶

status() -> DeployResult¶

PipelineConfig¶

Deployment pipeline configuration.

Methods:

all_base_names() -> list[str]¶

from_yaml(path: str) -> PipelineConfig¶

QualityGateRunner¶

Methods:

run_gate(gate: QualityGate) -> DeployResult¶

Run a single quality gate.

run_group(group_name: str, gates: list[QualityGate]) -> list[DeployResult]¶

Run gates sequentially (parallel execution delegated to CI matrix).

run_tier(tier: int) -> DeployResult¶

Run all gates in a tier. Fails if any required gate fails.

report(results: list[DeployResult]) -> str¶

Format results as a summary table.

run_release_gate(stages: list[QualityGate] | None = None) -> tuple[list[DeployResult], 'ReleaseGateVerdict']¶

Run the full local release gate and return (results, tri-state verdict).

HealthChecker¶

Methods:

check_endpoint(url: str) -> DeployResult¶

HTTP GET with retries. Expects 200.

check_endpoints(endpoints: list[str]) -> DeployResult¶

Check multiple endpoints. ALL must pass.

check_container(host: str, ssh_config: BareMetalConfig, container_name: str) -> DeployResult¶

Check Docker container health status via SSH.

check_end_to_end(public_url: str, expected_status: int = 200) -> DeployResult¶

Hit public URL through nginx/TLS.

full_check(host: str, ssh_config: BareMetalConfig, slot: str, endpoints: list[str], public_url: str | None = None) -> DeployResult¶

Run all three levels sequentially. Stops on first failure.

DeployPipeline¶

Constructor:

Methods:

run() -> list[DeployResult]¶

StagingManager¶

Methods:

deploy(image_tag: str) -> DeployResult¶

run_smoke_tests() -> DeployResult¶

teardown() -> DeployResult¶

promote(image_tag: str, bluegreen_manager = None) -> DeployResult¶

Deploy to staging, run smoke tests, optionally teardown, then hand off to blue-green.