Gitlab Runner的使用(涵盖gitlab-page)

#gitlab-runner 的简单安装和部署
##背景 因为公司要使用CI 功能,已经使用gitlab-page的功能能,所以这里记录一下

###安装步骤:
    参考官方文档:https://docs.gitlab.com/runner/install/linux-repository.html
    找到自己的系统,然后执行一下即可:
    curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh | sudo bash
    sudo yum install gitlab-runner
    提示:gitlab-runner-11.0.2-1 安装成功

###注册runner
    1、Runner需要注册到Gitlab才可以被项目所使用,一个gitlab-ci-multi-runner服务可以注册多个Runner。
    gitlab-ci-multi-runner register
    2、我们登录到git的项目-->setting-->CI/CD-->Runners settings,这里有操作步骤(How to setup a specific Runner for a new project),这里我们注册Specific Runners,如果要用Shared Runner 我们要使用管理员的账号
    Overview--->Runners,使用这个token
    3、gitlab-page 的部署参考文章:https://www.chenxuefei.com/2017/build-gitlab-pages/
    Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com/):
    http://git.xxx.com/
    Please enter the gitlab-ci token for this runner:
    NC9rhjfklasGqWcXQjflaZf
    Please enter the gitlab-ci description for this runner:
    [git]: yuanxing
    Please enter the gitlab-ci tags for this runner (comma separated):
    yuanxing
    Registering runner... succeeded                     runner=NC9rdds6
    Please enter the executor: docker+machine, kubernetes, docker, docker-ssh, parallels, virtualbox, shell, ssh, docker-ssh+machine:
    shell
    Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!
    You have new mail in /var/spool/mail/wwwad

    4、执行gitlab-runner list 可以看到你刚刚注册的runner
    5、登录域名管理后台做一下解析(泛域名解析)
        *.page.xxx.com 192.168.22.33
        添加泛域名解析A记录到你的Gitlab服务器公网地址,这样的话,每个用户就可以使用username.page.xxx.com访问他的pages地址
    6、vim /etc/gitlab/gitlab.rb
        pages_external_url "http://page.xxx.com/"
        gitlab_pages['enable'] = true
        然后reconfigure服务,这样进入Admin页面,就会发现Gitlab服务已经启用pages服务
    7、然后就是在你的项目下面编写.gitlab-ci.yml 文件了

<think>我们正在解决安装gitlab-runner时出现的依赖问题,具体错误是dpkg报告依赖错误:gitlab-runner-helper-images未安装。 根据Debian/Ubuntu的包管理机制,这个错误通常意味着gitlab-runner包依赖的另一个包(gitlab-runner-helper-images)没有安装或安装失败。 解决方案步骤: 1. 尝试修复依赖关系:使用`apt`或`apt-get`命令修复依赖关系。 2. 手动安装缺失的依赖包(gitlab-runner-helper-images)。 3. 重新安装gitlab-runner。 由于gitlab-runner-helper-images包可能是一个独立的包,我们可以尝试单独安装它,或者从GitLab官方仓库下载。 注意:gitlab-runner-helper-images是一个用于构建和运行CI/CD作业的辅助工具,它通常包含在gitlab-runner的安装包中,但有时可能会被单独处理。 参考GitLab官方文档:https://docs.gitlab.com/runner/install/linux-repository.html 具体步骤: 步骤1:更新软件包列表 ``` sudo apt update ``` 步骤2:尝试修复损坏的依赖关系 ``` sudo apt --fix-broken install ``` 步骤3:如果步骤2没有解决问题,尝试手动安装gitlab-runner-helper-images。但是,通常这个包并不单独提供,而是作为gitlab-runner的一部分。因此,我们可能需要重新安装gitlab-runner。 先卸载gitlab-runner: ``` sudo apt remove gitlab-runner ``` 步骤4:清理残留 ``` sudo apt autoremove ``` 步骤5:重新添加GitLab官方仓库并安装(确保使用正确的仓库) 添加仓库: ``` curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" | sudo bash ``` 安装: ``` sudo apt install gitlab-runner ``` 如果上述步骤仍然失败,我们可以尝试直接下载.deb包进行安装。 步骤6:手动下载并安装 访问GitLab的包仓库:https://packages.gitlab.com/runner/gitlab-runner 选择适合你系统的版本(例如Ubuntu 20.04),下载最新的gitlab-runner包和gitlab-runner-helper-images包(如果有的话)。 实际上,gitlab-runner-helper-images并不是一个单独的.deb包,它是gitlab-runner运行时下载的镜像。因此,错误可能是由于网络问题导致下载失败。 我们可以尝试手动下载helper镜像: 步骤7:手动下载helper镜像(可选,如果安装后运行runner时无法下载) 参考:https://docs.gitlab.com/runner/configuration/advanced-configuration.html#helper-image 但根据错误信息,是在安装阶段就报告了依赖问题。所以更可能是安装脚本或包依赖设置的问题。 另一种可能:你使用GitLab Runner版本可能有问题,尝试安装旧版本。 步骤8:安装特定版本的gitlab-runner 例如,安装13.12.0版本: ``` sudo apt install gitlab-runner=13.12.0 ``` 注意:版本号需要根据实际情况选择。 如果以上步骤都不能解决,可能需要检查系统环境(如网络、代理设置)或者查看GitLab Runner的安装日志。 由于错误信息明确提到了`gitlab-runner-helper-images not installed`,这可能是由于包维护脚本(postinst)执行失败导致的。我们可以查看安装日志,通常在`/var/log/apt/term.log`中。 步骤9:查看安装日志 ``` cat /var/log/apt/term.log | grep gitlab-runner ``` 根据日志中的错误信息进一步排查。 另外,注意gitlab-runner包在安装过程中会尝试下载helper镜像,如果网络不通或者DNS问题,可能导致下载失败。因此,确保网络畅通,或者配置代理(如果必要)。 配置代理的方法(如果使用代理): 在/etc/gitlab-runner/config.toml中配置,但这是在runner注册之后。在安装阶段,我们可以通过系统代理环境变量: ``` export HTTP_PROXY=http://yourproxy:port export HTTPS_PROXY=http://yourproxy:port ``` 然后再次运行安装命令。 总结:优先尝试重新安装,并确保网络正常。 如果问题仍然存在,请提供你的操作系统版本和安装的gitlab-runner版本,以便进一步分析。</think>### 解决 GitLab Runner 安装依赖错误 安装 GitLab Runner 时出现 `gitlab-runner-helper-images not installed` 错误,通常是由于软件源配置或依赖关系问题导致。以下是完整的解决方案: #### 1. **修复依赖关系** ```bash sudo apt --fix-broken install sudo apt install -f ``` 此命令会尝试自动修复损坏的依赖链[^1]。 #### 2. **清理并更新软件源** ```bash sudo apt clean sudo rm -rf /var/lib/apt/lists/* sudo apt update ``` 清除缓存可解决因元数据损坏导致的依赖问题[^1]。 #### 3. **手动安装缺失组件** 若报错明确指向 `gitlab-runner-helper-images`: ```bash # 下载最新版 helper-images curl -LJO "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-helper_$(uname -m)" # 安装到系统路径 sudo mv gitlab-runner-helper_* /usr/lib/gitlab-runner-helper sudo chmod +x /usr/lib/gitlab-runner-helper ``` #### 4. **重新安装 GitLab Runner** ```bash sudo apt reinstall gitlab-runner # 或强制安装 sudo dpkg -i --force-all /var/cache/apt/archives/gitlab-runner_*.deb ``` #### 5. **验证安装** ```bash sudo gitlab-runner status gitlab-runner --version ``` ### 常见问题排查 - **网络问题**:确保能访问 `https://packages.gitlab.com` - **代理配置**:若有代理,在 `/etc/apt/apt.conf` 添加: ``` Acquire::http::Proxy "http://proxy-ip:port"; ``` - **系统架构匹配**:确认下载的包与系统架构一致(x86_64/arm64) > **注意**:GitLab Runner 依赖 Docker 运行作业,需预先安装 Docker 环境[^1]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值