PlumNotes

Appearance

gitlab-Runner ​

本工具主要用于支撑 gitlab ci,用于运行 ci 流水线

关于安装 ​

安装包 ​

可以使用官方打包好的安装包安装下载地址

官方仓库 ​

也可以使用官方仓库安装

对于 Debian/Ubuntu/Mint：
bash
curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" | sudo bash
sudo apt install gitlab-runner
对于 RHEL/CentOS/Fedora：
bash
curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh" | sudo bash
dnf install gitlab-runner
相对起来官方仓库支持update,更新较为方便

关于注册 ​

很简单,使用命令gitlab-runner register即可,token 和 url 请参考自己的 gitlab 服务器

bash
gitlab-runner register

具体关于 runner 之间的差别,请查阅官方文档

注册完毕后会在默认路径/etc/gitlab-runner/生成配置文件config.toml

TIP

默认的 runner 只能跑一个实例,可以从 config.toml 中修改 concurrent 默认的 docker 镜像建议自行编译 帐号密码建议使用 setting-CI/CD-变量进行配置

关于 tags ​

可以限制使用标签的 runner 用来合理分配资源去建立缓存

关于.gitlab-ci.yml ​

自动编译要用到的配置文件,详情官方介绍 关于到系统的自带变量 也可以访问自己搭建的 gitlab 服务器,help 页面,如http://10.100.23.60/help/ci/yaml/index查看

我自己的样例

yml
stages:
  - install
  - deploy

image: happyplum/node:latest

install-job:
  stage: install
  only:
    - master
  tags:
    - joyware
  artifacts:
    paths:
      - dist
  before_script:
    - echo "${WEB_JWENTRY_NAME}_${CI_COMMIT_REF_SLUG}"
    - echo "NPM Registry Server ${NPM_REG_SERVER}"
    - |
      echo -e "registry=${NPM_REG_SERVER}" >> .npmrc
      echo -e "npmRegistryServer: \"${NPM_REG_SERVEyarnR}\"" >> yarnrc.yml
    - yrm add jw ${NPM_REG_SERVER}
  script:
    - yrm use jw
    - yarn install
    - yarn run build

deploy-job:
  stage: deploy
  only:
    - master
  tags:
    - joyware
  before_script:
    - '[[ -f /.dockerenv ]] && echo -e "Host *\n\tStrictHostKeyChecking no\n\n" > ~/.ssh/config'
  script:
    - echo ${WEB_JWENTRY_NAME}_${CI_COMMIT_REF_SLUG}
    - echo ${WEB_DEV_SERVER_USER}@${WEB_DEV_SERVER}
    - mv ./dist ./${WEB_JWENTRY_NAME}_${CI_COMMIT_REF_SLUG}
    - sshpass -p ${WEB_DEV_SERVER_PASSWORD} ssh -t ${WEB_DEV_SERVER_USER}@${WEB_DEV_SERVER} "rm -rf /home/vcloud/web/${WEB_JWENTRY_NAME}_${CI_COMMIT_REF_SLUG}"
    - sshpass -p ${WEB_DEV_SERVER_PASSWORD} scp -r ./${WEB_JWENTRY_NAME}_${CI_COMMIT_REF_SLUG} ${WEB_DEV_SERVER_USER}@${WEB_DEV_SERVER}:/home/vcloud/web/

分为两个阶段,然后install阶段输出dist文件夹 deploy阶段其中before_script其实有些配置是无效的,但是为了能稳定使用 scp 先加上了

关于.gitlab-ci.yml2 ​

yml
stages:
  - build
  - docker

image: happyplum/deno:latest

build-job:
  stage: build
  only:
    - main
  artifacts:
    paths:
      - server
  before_script:
    - |
      echo "NPM Registry Server ${NPM_REG_SERVER}"
      rm -rf .npmrc
      echo -e "registry=${NPM_REG_SERVER}" >> .npmrc
  script:
    - deno task build

build-docker:
  stage: docker
  image: docker:latest
  only:
    - main
  when: manual
  artifacts:
    paths:
      - notes.docker.tar
  before_script:
    - unset DOCKER_HOST #fix Error dial tcp: lookup localhost on 8.8.8.8:53: no such host
  script:
    - docker build -t notes:latest .
    - docker save notes:latest > notes.docker.tar
    - ls -l
  needs:
    - build-job
    ```

分为两个阶段,然后install阶段输出server文件夹 build-docker阶段使用单独的docker:latest镜像,并且由于配置了when: manual需要在 gitlab CI/CD 上手动运行，手动运行后会生成 notes.docker.tar 为 docker 镜像，可以用 import 导入到 docker image。 关于unset DOCKER_HOST，必须设置，不然会尝试 ping docker 地址，或许需要设置 etc/host 中 localhost 为 127.0.0.1,未测试

关于 docker runnner 报错 ​

在 trueNas 中 docker runner 所建立的镜像都会提示

But, it's easier to create a docker network with IPv6 enabled, so that it doesn't need to be disabled on IPv4- only interfaces. It's now just --ipv6 in the network create command, or enable_ipv6: true in compose.

这是因为容器尝试禁用 ipv6，但是网络无法配置。 docker 大于 26.0.2 的版本会尝试设置 ipv6，但是 trueNas 并不能设置 net，请安装 26.0.1 版本的 docker 27 版本可以直接创建启用 v6 的网络，启用 v6 可能就不会去尝试禁用 v6 导致出错了

bash
apt-get install docker-ce=5:26.0.1-1~debian.12~bookworm docker-ce-cli=5:26.0.1-1~debian.12~bookworm