basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Токен для сборки — через --secret, а не ARG

    ARG и ENV для секретов не годятся: значение остаётся в образе, и его видит каждый, кто образ скачал. Токен, нужный только на время сборки, — к закрытому npm-реестру, приватному репозиторию — передаём docker build --secret: он появляется в одном RUN и в слоях не остаётся.

    Как утекает

    FROM node:24.22.1-alpine
    WORKDIR /app
    COPY package.json package-lock.json ./
    ARG NPM_TOKEN
    RUN echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" > .npmrc \
     && npm ci --omit=dev \
     && rm .npmrc
    COPY . .
    CMD ["node", "server.js"]

    rm .npmrc в том же RUN — файла в слое нет. Но значение ARG Docker записывает в историю образа вместе со строкой RUN, где оно используется: docker history --no-trunc показывает NPM_TOKEN=npm_… любому, кто скачал образ1. С ENV NPM_TOKEN=… ещё проще: его печатает docker inspect --format '{{.Config.Env}}'.

    Многоступенчатая сборка («Многоступенчатая сборка») прикрывает лишь отчасти: история стадии сборки в итоговый образ не попадает. Но стоит собрать эту стадию отдельно, --target build, — и токен снова в образе.

    Как передаём

    FROM node:24.22.1-alpine
    WORKDIR /app
    COPY package.json package-lock.json ./
    RUN --mount=type=secret,id=npmrc,target=/root/.npmrc,required=true npm ci --omit=dev
    COPY . .
    CMD ["node", "server.js"]
    docker build --secret id=npmrc,src=$HOME/.npmrc -t app:dev .

    На время одного RUN файл ~/.npmrc с машины сборки появляется в контейнере по пути /root/.npmrc — там npm ищет настройки пользователя root. После RUN файла нет ни в слое, ни в истории образа.

    В GitHub Actions то же самое — входом secrets у docker/build-push-action, а содержимое .npmrc лежит в секретах репозитория:

    - uses: docker/build-push-action@v7
      with:
        secrets: npmrc=${{ secrets.NPMRC }}

    Через ARG оставляем то, что и так публично: версию, адрес API, id сайта в счётчике посещений — он всё равно стоит в коде каждой страницы.

    Если не работает

    npm ci в сборке падает на закрытом пакете: 404 Not Found или 401 Unauthorized

    Причина
    Секрет не дошёл до RUN: в docker build нет --secret, или id в нём не совпадает с id в RUN --mount. Без required=true пропавший секрет молча пропускается.
    Делаем
    Одинаковый id в обоих местах и required=true в RUN --mount: тогда сборка падает сразу и с понятной ошибкой.

    Токен уже собирали через ARG, и образ лежит в реестре

    Причина
    Значение записано в историю образа.
    Делаем
    Пересобираем через --secret, старые теги удаляем из реестра, токен отзываем и выпускаем новый («Секрет в коммите» — тот же порядок).

    Как проверить

    Токенов npm (они начинаются с npm_) в истории образа нет:

    docker history --no-trunc app:dev | grep -c 'npm_'
    # 0

    Ещё не проверено

    1. BuildKit в Docker 29 пишет значение ARG в историю образа у строки RUN, где ARG используется ↑