CI/CD Integration

Jenkins Integration | CodeSync

Fast, GDPR-compliant package infrastructure for Germany. Integrate CodeSync into your Jenkins pipelines with zero configuration overhead.

Start Integration View Plugin Source

Pipeline Setup

Connect your Jenkins instance to the Frankfurt-1 mirror endpoint. The process takes under three minutes and requires only read access to your repository credentials.

1. Configure Global Tool Settings

Navigate to Manage Jenkins > System > Global Properties. Set the default package registry to registry.codesync.de:443. Ensure TLS 1.2+ is enabled in your Jenkins master configuration.

2. Install Credentials Plugin

Add your CodeSync API key as a Secret Text credential. Use the identifier CODESYNC_API_TOKEN so the Jenkins plugin can automatically resolve it during the build phase.

3. Verify Connectivity

Run curl -I https://registry.codesync.de:443/v2/_ping from your Jenkins agent. A 200 OK response with X-Region: eu-central-1 confirms successful routing through our German edge nodes.

CodeSync Jenkins Plugin

The official codesync-mirror plugin v2.4.1 automates dependency resolution, cache warming, and compliance auditing directly inside your Jenkinsfile.

Core Features

Automatic fallback to primary registries when latency exceeds 120ms. Built-in SBOM generation aligned with BSI TR-02102-2 standards. Native support for Maven, Gradle, npm, and PyPI workloads.

Installation

Available via the Jenkins Update Center under the name CodeSync Mirror. Alternatively, drop the codesync-mirror.hpi file into your JENKINS_HOME/plugins directory and restart the daemon.

Security & Compliance

All artifact transfers are encrypted with AES-256-GCM. Audit logs are retained for 730 days and exported to your designated SIEM via Syslog RFC 5424. Fully compliant with EU GDPR Article 30.

Download Plugin

Jenkinsfile Configuration

Drop this snippet into your existing pipeline to enable mirror routing, parallel cache warming, and automated vulnerability scanning.

Declarative Pipeline Snippet

pipeline {
  agent any
  options {
    codesyncMirror(endpoint: 'https://registry.codesync.de:443', cacheTTL: '24h')
  }
  stages {
    stage('Resolve Dependencies') {
      steps {
        sh 'mvn dependency:resolve -DaltDeploymentRepository=codeSync::default::https://registry.codesync.de:443/maven-releases'
      }
    }
    stage('Build & Scan') {
      steps {
        sh 'mvn clean package'
        codesyncScan(type: 'SBOM', output: 'target/cyclonedx.json')
      }
    }
  }
}

The codesyncMirror directive automatically injects the correct registry URL into your build environment. Replace mvn with gradle, npm, or pip commands as needed. The plugin handles credential injection and retry logic (max 3 attempts, 5-second backoff) out of the box.

Advanced Configuration Guide