Plugin API Docker Commons per Jenkins

Plugin API che fornisce le funzionalità comuni condivise per vari plugin relativi a Docker.

Riepilogo

• API per la gestione delle impronte digitali (fingerprints) di immagini e container Docker
• Credenziali e posizione del Registry Docker
• Credenziali e posizione del Daemon Docker (alias Docker Remote API)
• ToolInstallation per client CLI Docker
• Punto di estensione DockerImageExtractor per ottenere le relazioni delle immagini Docker dai job
• Semplice interfaccia utente che fa riferimento alle impronte digitali delle immagini correlate nelle build Docker
• ecc.

Casi d'uso

Credenziali e posizioni

Ciò consente agli utenti di configurare un set di endpoint/credenziali e utilizzarlo su tutti i plugin correlati a Docker, mantenendo così la configurazione più DRY.

Vedi Docker Pipeline Plugin per l'uso tipico.

Esempio di pipeline dichiarativa

Un esempio su come associare le credenziali dell'host/daemon Docker in una pipeline dichiarativa:

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
      }
    }
  }
}

Licenza

Licenza MIT

Changelog

• Vedi GitHub Releases per le versioni recenti
• Vedi l'archivio delle note di rilascio per la versione 1.15 e precedenti