如何创建自定义 Docker 映像并将其用作 GitLab CI/CD 服务？答案

【问题标题】：How to create a custom Docker image and use it as a GitLab CI/CD Service?如何创建自定义 Docker 映像并将其用作 GitLab CI/CD 服务？
【发布时间】：2019-12-15 04:58:56
【问题描述】：

我正在使用 CloudFoundry 部署我的服务，我的 E2E 测试是使用 Postman（CLI 上的 Newman）完成的。情况是我无法直接从我的 GitLab CI/CD 访问某些服务，然后我需要创建一个 SSH 隧道 (cf ssh) 以便能够在 CI/CD 管道期间通过隧道执行 Postman 集合。

这是我的 Dockerfile：

FROM my-private-registry/cf-cli-image

COPY ./images/cf-ssh-tunnel-service/docker-entrypoint.sh /docker-entrypoint.sh

EXPOSE 9001

ENTRYPOINT ["/docker-entrypoint.sh"]

这是docker-entrypoint.sh：

#!/bin/bash
set -eo pipefail

# usage: file_env VAR [DEFAULT]
#    ie: file_env 'XYZ_DB_PASSWORD' 'example'
# (will allow for "$XYZ_DB_PASSWORD_FILE" to fill in the value of
#  "$XYZ_DB_PASSWORD" from a file, especially for Docker's secrets feature)
file_env() {
    local var="$1"
    local fileVar="${var}_FILE"
    local def="${2:-}"
    if [ "${!var:-}" ] && [ "${!fileVar:-}" ]; then
        echo >&2 "error: both $var and $fileVar are set (but are exclusive)"
        exit 1
    fi
    local val="$def"
    if [ "${!var:-}" ]; then
        val="${!var}"
    elif [ "${!fileVar:-}" ]; then
        val="$(< "${!fileVar}")"
    fi
    export "$var"="$val"
    unset "$fileVar"
}

file_env 'CF_SSH_SERVICE_APP_NAME'
file_env 'CF_SSH_SERVICE_REMOTE_PORT' 8080
CF_SSH_SERVICE_LOCAL_PORT=9001

echo "Logging in ..."
cf login -a $CF_URL -u $CF_DEPLOY_USER -p $CF_DEPLOY_PASSWORD -o $CF_ORG -s $CF_SPACE --skip-ssl-validation
cf target

echo "Creating the CF SSH Tunnel to $CF_SSH_SERVICE_APP_NAME:$CF_SSH_SERVICE_REMOTE_PORT though the local port $CF_SSH_SERVICE_LOCAL_PORT."
cf ssh -k -T -N $CF_SSH_SERVICE_APP_NAME -L $CF_SSH_SERVICE_LOCAL_PORT:0.0.0.0:$CF_SSH_SERVICE_REMOTE_PORT
echo "DONE!"

最后这就是我在 GitLab 管道中将图像用作服务的方式：

stages:
    - e2e-test

newman:test:development:
  image: my-private-registry/curl-image
  stage: e2e-test
  services:
    - name: my-private-registry/cf-ssh-tunnel-service:latest
      alias: cf-ssh-tunnel-service
  variables:
    CF_SSH_SERVICE_APP_NAME: $APP_NAME
  script:
    - curl http://cf-ssh-tunnel-service:9001/endpoint

如您所见，我正在基于该图像创建服务。然后当我运行管道时，curl 请求返回一个Could not resolve host: cf-ssh-tunnel-service。

问：如何创建 Docker 映像以用作 GitLab 中的服务？
问：我应该如何创建 CF SSH 隧道作为 GitLab 的监听服务？

【问题讨论】：

您能否更新您的帖子以包含失败的作业输出？这是否显示了您从服务中获得的一些“回声”声明？另外，鉴于入口点脚本中的所有环境变量，我假设您将 GitLab CI 中的这些环境变量设置为秘密变量？启用调试也可能会有所帮助 - docs.gitlab.com/ee/ci/variables/#debug-tracing

标签： docker gitlab gitlab-ci cloud-foundry ssh-tunnel

【解决方案1】：

除非您的图像存储在 GitLab container registry 中，否则您将无法访问您的自定义图像（因为它需要登录到私有存储库才能提取它）。

我可以考虑两种解决方案：

Creating a custom docker runner 在个人机器上：

sudo gitlab-runner register

Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com )
https://gitlab.com

Please enter the gitlab-ci token for this runner
xxx

Please enter the gitlab-ci description for this runner
[hostname] my-runner

Please enter the gitlab-ci tags for this runner (comma separated):
my-tag,another-tag

Please enter the executor: ssh, docker+machine, docker-ssh+machine, kubernetes, docker, parallels, virtualbox, docker-ssh, shell:
docker

Please enter the Docker image (eg. ruby:2.1):
alpine:latest

这里有几点说明：

您可以在您的项目中的 Settings > CI/CD > Runners 中找到您的 gitlab-ci 令牌
Gitlab-runner register 需要你指定一个默认的 docker 镜像（以防你在没有指定要使用的镜像的情况下调用运行器），但它会使用你告诉它使用的镜像。

如果您选择该选项，则必须将tags: [docker-runner-tag] 命令添加到.gitlab-ci.yml 中的作业中。不要忘记在您注册了自定义 docker runner 的机器上执行 docker login，否则 pull 仍然会失败。您也可能需要add gitlab-runner to the group of docker's authorized users：

sudo usermod -aG docker gitlab-runner

Create a GitLab container registry。我从未使用过该选项，因此我不会详细介绍，但您应该在项目的 Packages > Container Registry 部分找到创建全新容器注册表的说明。

我认为 Docker Hub 也提供私有注册表选项，但我不知道这些服务是否可以免费使用。

【讨论】：