Docker Commons API Plugin für Jenkins

API-Plugin, das die gemeinsame Funktionalität für verschiedene Docker-bezogene Plugins bereitstellt.

Zusammenfassung

• API zum Verwalten von Docker-Image- und Container-Fingerabdrücken
• Anmeldeinformationen und Standort der Docker-Registry
• Anmeldeinformationen und Standort des Docker-Daemons (auch Docker-Remote-API)
• ToolInstallation für Docker-CLI-Clients
• DockerImageExtractor-Erweiterungspunkt zum Abrufen von Docker-Image-Beziehungen aus Jobs
• Einfache Benutzeroberfläche, die zugehörige Image-Fingerabdrücke in Docker-Builds anzeigt
• usw.

Anwendungsfälle

Anmeldeinformationen und Standorte

Dies ermöglicht Benutzern, einen Satz Endpunkte/Anmeldeinformationen zu konfigurieren und ihn über alle Docker-bezogenen Plugins hinweg zu verwenden, wodurch die Konfiguration trockener (DRY) bleibt.

Siehe Docker Pipeline Plugin für die typische Verwendung.

Deklaratives Pipeline-Beispiel

Ein Beispiel, wie Docker-Host/Daemon-Anmeldeinformationen in einer deklarativen Pipeline gebunden werden:

pipeline {
  agent any
  tools {
    // a bit ugly because there is no `@Symbol` annotation for the DockerTool
    // see the discussion about this in PR 77 and PR 52: 
    // https://github.com/jenkinsci/docker-commons-plugin/pull/77#discussion_r280910822
    // https://github.com/jenkinsci/docker-commons-plugin/pull/52
    'org.jenkinsci.plugins.docker.commons.tools.DockerTool' '18.09'
  }
  environment {
    DOCKER_CERT_PATH = credentials('id-for-a-docker-cred')
  }
  stages {
    stage('foo') {
      steps {
        sh "docker version" // DOCKER_CERT_PATH is automatically picked up by the Docker client
      }
    }
  }
}

Lizenz

MIT-Lizenz

Änderungsprotokoll

• Siehe GitHub-Releases für die aktuellen Versionen
• Siehe das Release-Notes-Archiv für Version 1.15 und älter