Plugin de API Commons de Docker para Jenkins

Plugin de API que proporciona la funcionalidad común compartida para varios plugins relacionados con Docker.

Resumen

• API para gestionar huellas digitales de imágenes y contenedores Docker
• Credenciales y ubicación del Registro Docker
• Credenciales y ubicación del Daemon Docker (también conocido como API Remota de Docker)
• ToolInstallation para clientes CLI de Docker
• Punto de extensión DockerImageExtractor para obtener relaciones de imágenes Docker desde trabajos
• UI simple que referencia huellas digitales de imágenes relacionadas en builds Docker
• etc.

Casos de uso

Credenciales y ubicaciones

Esto permite a los usuarios configurar un conjunto de endpoint/credenciales y usarlo en todos los plugins relacionados con Docker, manteniendo así la configuración más DRY.

Consulte el Plugin de Docker Pipeline para el uso típico.

Ejemplo de pipeline declarativo

Un ejemplo de cómo vincular las credenciales del host/daemon Docker en un pipeline declarativo:

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

Licencia

MIT License

Registro de cambios

• Consulte GitHub Releases para las versiones recientes
• Consulte el archivo de notas de la versión para la versión 1.15 y anteriores