使用Docker-Compose构建镜像并推送至GitLab容器仓库遇到的两类问题解决求助

让我们逐个拆解并解决你遇到的问题：

1. 构建参数PORT未被消耗的警告 #

问题根源 #

你的Dockerfile里仅声明了ARG GITLAB_ACCESS_TOKEN来接收构建参数，但docker-compose的build配置里传递了PORT参数。Docker在构建时发现这个参数没有被Dockerfile的任何阶段接收，因此抛出了警告。本地测试没出现这个提示，大概率是你本地构建时没有传递该参数，或者本地Docker版本的警告逻辑存在差异。

修复方案 #

在Dockerfile的base阶段添加ARG PORT声明，让Docker识别并接收这个参数，就能消除警告：

FROM node:17.0-alpine AS base
ARG GITLAB_ACCESS_TOKEN
ARG PORT  # 添加这一行接收PORT构建参数
WORKDIR /usr/src/app
COPY .npmrc ./
COPY package*.json ./
RUN npm i
COPY . .

FROM base AS production
RUN npm run build

如果你的production阶段也需要使用PORT参数，可以在该阶段也添加ARG PORT（ARG是阶段级别的，不会自动跨阶段继承）；但如果只是为了消除警告，仅在base阶段声明就足够了。

2. 推送镜像时提示"No such service: aaa-bbb/ccc:1.0.0" #

问题根源 #

你用错了docker-compose push的命令格式：这个命令需要指定服务名，而非完整的镜像名加标签。你的docker-compose配置中服务名是aaa-bbb，但你传入了aaa-bbb/ccc:${TAG_VERSION}，导致docker-compose找不到对应服务。另外，当前镜像名没有包含GitLab容器仓库的前缀，就算推送成功，也只会推送到本地镜像库，而非你的GitLab仓库。

修复方案 #

步骤1：修正docker-compose的镜像地址

修改docker-compose.yml和docker-compose.prod.yml中的image字段，加入GitLab容器仓库的前缀（直接用GitLab CI提供的CI_REGISTRY环境变量即可）：

# 在两个compose文件中更新image字段
image: ${CI_REGISTRY}/aaa-bbb/ccc:${TAG_VERSION}

这样构建出来的镜像会直接关联到你的GitLab容器仓库地址。

步骤2：修正docker-compose push命令

将推送命令改为指定服务名aaa-bbb，而非镜像名：

docker-compose --env-file ./config/.production.env -f docker-compose.yml -f docker-compose.prod.yml push aaa-bbb

docker-compose push会自动根据服务配置中的image字段推送对应镜像，无需手动指定标签。

最终修正后的GitLab流水线步骤 #

调整后的create_image任务如下：

create_image:
  image: docker
  stage: create-image
  services:
    - docker:dind
  before_script:
    - TAG_VERSION=$(awk -F= '$1 == "TAG_VERSION" { print $2 }' ./config/.production.env)
    - apk add --no-cache docker-compose
    - docker image prune -f
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
  script:
    - echo " Image creation started..."
    - docker-compose --env-file ./config/.production.env -f docker-compose.yml -f docker-compose.prod.yml build --no-cache
    - docker-compose --env-file ./config/.production.env -f docker-compose.yml -f docker-compose.prod.yml push aaa-bbb
    - echo " Image created successfully!"

这样就能同时解决两个问题：消除PORT参数的警告，成功将镜像推送到GitLab容器仓库。

内容的提问来源于stack exchange，提问作者th3g3ntl3man