jenkins配置docker镜像凭据
时间: 2025-03-26 10:05:48 浏览: 36
### 如何在 Jenkins 中配置 Docker 镜像凭证
为了使 Jenkins 能够安全地拉取私有仓库中的 Docker 镜像或推送自定义构建的镜像至 Harbor 或其他注册中心,正确配置 Docker 凭证至关重要。
#### 创建凭据条目
在 Jenkins 主界面左侧导航栏找到“Credentials”,点击进入全局域下的系统设置部分。这里可以创建新的凭据条目用于存储访问 Docker 注册表所需的用户名和密码组合[^4]。
#### 添加 Docker Registry 凭据
选择添加凭据,在Kind字段中挑选`Username with password`选项来适应大多数场景的需求;对于更复杂的认证机制,则可能需要用到其他的凭据类型如SSH Username with private key等。Scope保持默认Global(全局),这样任何Job都可以调用此凭据。ID可选填入唯一标识符以便后续引用,Description填写描述帮助识别该组凭据用途。最为重要的一步是在Username输入框里录入Docker Hub账号名或者企业内部Registry服务端指定的身份验证账户名称,并于Password处键入对应的登录密钥。
#### 应用凭据到 Pipeline Job
当上述准备工作完成后,在Pipeline脚本编写环节便可以通过如下方式引入已保存好的凭据:
```groovy
pipeline {
agent any
environment {
DOCKER_CREDENTIALS = credentials('your-docker-credentials-id')
}
stages {
stage('Build') {
steps {
script {
docker.withRegistry('https://registry.example.com', 'DOCKER_CREDENTIALS') {
// 构建并推送到远程仓库的操作...
}
}
}
}
}
}
```
这段 Groovy 代码展示了怎样利用 `withRegistry()` 方法结合之前设定的环境变量完成对特定 Docker registry 的身份验证过程。
阅读全文
相关推荐
















