All integrations
CI/CD Integration
GitLab + Archyl

Architecture documentation in your GitLab workflow

Integrate Archyl with GitLab for architecture drift checks in CI/CD pipelines, webhooks for architecture changes, and Architecture as Code in your GitLab repositories. Keep architecture documentation synchronized with every merge request.

Explore features
GitLab
Archyl
GitLab CI/CD· CI/CD drift checks
How it works

Three moving parts, zero glue code

01

Connect your GitLab repositories

Link your GitLab repos to Archyl. The platform scans your codebase to map your actual architecture.

02

Architecture as Code in your repo

Declare your C4 model in archyl.yaml alongside your code. It versions and deploys with your application.

03

CI/CD drift checks on every MR

Add drift checks to your GitLab CI pipeline. Merge requests are checked against architecture conformance rules.

See it in action

What it looks like in practice

gitlab.com · Merge request !418

Extract Payments API from Checkout

kenji wants to merge 7 commits into main

archyl / drift score96% (minimum 90%)
archyl / conformance12 rules · all passing
build:test2m 14s

archyl-botcommented

This change adds Payments API and a relationship from Checkout API. Architecture Change Request ACR-42 is ready for review.

What you get

Everything the integration unlocks

Drift Checks in GitLab CI

Add architecture drift checks to your .gitlab-ci.yml pipeline. Fail builds when drift exceeds your threshold.

Architecture as Code

Store archyl.yaml in your GitLab repository. Architecture documentation deploys with your code through CI/CD.

Webhooks for Architecture Events

Push architecture change notifications to GitLab issues, Slack, or any webhook endpoint.

Merge Request Architecture Validation

Validate that code changes conform to architecture rules before merging.

Repository Scanning

Archyl scans your GitLab repos to discover architecture from code and detect drift.

Multi-Repository Support

Connect multiple GitLab repositories to a single Archyl project for monorepo or polyrepo setups.

Setup

Up and running in minutes

  1. 1

    Connect your GitLab repository

    Add your GitLab repo to Archyl using a project access token or personal access token.

  2. 2

    Add drift check to CI pipeline

    Add an architecture drift check step to your .gitlab-ci.yml configuration.

  3. 3

    Configure webhooks

    Set up webhooks to notify your team about architecture changes and drift score changes.

Frequently asked questions

Does Archyl support GitLab self-managed?

Contact us to discuss GitLab self-managed support for your organization.

Can I use Archyl with GitLab CI/CD?

Yes. Add architecture drift checks to your .gitlab-ci.yml pipeline to enforce architecture conformance on every merge request.

Free plan forever

Ready to connect GitLab?

Start on the free plan and plug GitLab into your architecture in minutes.

  • No credit card
  • Set up in five minutes
  • Viewers are always free

GitLab Integration: Architecture Docs in CI/CD

Integrate Archyl with GitLab for architecture drift checks in CI/CD, webhooks for changes, and Architecture as Code in your repositories.

Architecture documentation in your GitLab workflow

Integrate Archyl with GitLab for architecture drift checks in CI/CD pipelines, webhooks for architecture changes, and Architecture as Code in your GitLab repositories. Keep architecture documentation synchronized with every merge request.

GitLab + Archyl: Architecture Documentation in Your Workflow | CI/CD

Integrate Archyl with GitLab for architecture drift checks in CI/CD, webhooks for changes, and Architecture as Code in your repositories.

GitLab architecture documentation, GitLab CI/CD architecture, architecture drift GitLab, Architecture as Code GitLab, GitLab integration Archyl

Connect your GitLab repositories

Link your GitLab repos to Archyl. The platform scans your codebase to map your actual architecture.

Architecture as Code in your repo

Declare your C4 model in archyl.yaml alongside your code. It versions and deploys with your application.

CI/CD drift checks on every MR

Add drift checks to your GitLab CI pipeline. Merge requests are checked against architecture conformance rules.

Drift Checks in GitLab CI

Add architecture drift checks to your .gitlab-ci.yml pipeline. Fail builds when drift exceeds your threshold.

Store archyl.yaml in your GitLab repository. Architecture documentation deploys with your code through CI/CD.

Webhooks for Architecture Events

Push architecture change notifications to GitLab issues, Slack, or any webhook endpoint.

Merge Request Architecture Validation

Validate that code changes conform to architecture rules before merging.

Archyl scans your GitLab repos to discover architecture from code and detect drift.

Multi-Repository Support

Connect multiple GitLab repositories to a single Archyl project for monorepo or polyrepo setups.

Connect your GitLab repository

Add your GitLab repo to Archyl using a project access token or personal access token.

Add drift check to CI pipeline

Add an architecture drift check step to your .gitlab-ci.yml configuration.

Set up webhooks to notify your team about architecture changes and drift score changes.

Does Archyl support GitLab self-managed?

Contact us to discuss GitLab self-managed support for your organization.

Can I use Archyl with GitLab CI/CD?

Yes. Add architecture drift checks to your .gitlab-ci.yml pipeline to enforce architecture conformance on every merge request.