Перевод проекта в Docker

Делает первую Docker-настройку проекта: .dockerignore, multi-stage Dockerfile и compose.yaml, где базы и кеши работают сервисами Compose, а не ставятся на машину. Для случаев, когда Docker в проекте ещё нет или нужна локальная база либо кеш.

DevOpsПак: Скиллы Docker125 строкdocker-project-foundations
Автор
Источник
docker/skills/skills/docker-project-foundations @ caeee20
Лицензия
Apache-2.0 · Copyright 2026 Docker, Inc.

Об этом скилле

Что делает

Скилл заводит в проекте Docker с нуля, и всегда тремя файлами, обычно в корне: сначала .dockerignore, потом Dockerfile, потом compose.yaml для локальной разработки. Даже черновик держит базовую планку: multi-stage сборка, если есть шаг сборки или установки зависимостей, базовый образ с закреплённой версией (node:22-slim), манифесты зависимостей копируются раньше исходников, в финальной стадии — не-root USER.

Базы, кеши и очереди становятся сервисами Compose на официальных образах; советовать пользователю brew install postgres или apt install redis скилл запрещает. Порты приложения по умолчанию публикуются на 127.0.0.1, хранилища без аутентификации остаются в сети Compose, а базу, к которой нужен доступ инструментам на машине, публикуют только на 127.0.0.1. Для приватного npm-реестра .npmrc исключается на любой глубине и передаётся как секрет BuildKit.

В папке: assets/Dockerfile.simple — шаблон для Node.js из четырёх стадий (deps, dev, build, production); assets/compose-dev.yaml — приложение с Postgres и Redis, проверками здоровья, bind mount для live reload и именованным томом; шаблон .dockerignore. Там же references/project-structure.md о раскладке файлов, когда сервисов несколько, и скрипт scripts/verify-setup.sh: он проверяет, что все три файла на месте, и запускает docker compose config --quiet. Есть и чек-лист проверки, и тестовые промпты.

Когда включать и когда не надо

Чтобы перевести в Docker проект, где его ещё нет, или добавить базу либо кеш, не устанавливая их на машину. Нужны Docker 20.10+ и Compose v2.

Не нужен, если пользователь не хочет Docker или в проекте уже есть рабочая настройка.

Как поставить и вызвать

Команда установки ниже скачивает всю папку. Агент сам подхватывает скилл по описанию. Вызвать вручную:

  • Claude Code: /docker-project-foundations или попросить скилл по имени.
  • Codex: $docker-project-foundations.
  • Cursor: наберите / в чате Agent и выберите docker-project-foundations.

Пример: /docker-project-foundations Переведи это Express-приложение в Docker вместе с Postgres для локальной разработки. Всё должно подниматься одной командой.

Скрипт запускается из корня проекта: bash "<skill-dir>/scripts/verify-setup.sh".

Чем отличается от похожих

Пакет делит работу: этот скилл пишет каркас и не усложняет его, Стратегии сборки Dockerfile потом доводят образ, а Паттерны Docker Compose отвечают за стек; ставьте их вместе. Ревью Dockerfile из нашего каталога пишет или проверяет Dockerfile, но по Compose и зависимым сервисам ничего не советует. От прототипа к продакшену готовит приложение к запуску — обработка ошибок, валидация, конфиг, тесты — и контейнеров не трогает.

Установка

Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.

Скилл написан на английском — агент поймёт его и ответит вам по-русски.

Claude Code — macOS, Linux
curl -fsSL --create-dirs -o ~/.claude/skills/docker-project-foundations/SKILL.md https://anymodel.org/en/skills/docker/docker-project-foundations/SKILL.md -o ~/.claude/skills/docker-project-foundations/LICENSE https://anymodel.org/en/skills/docker/docker-project-foundations/LICENSE -o ~/.claude/skills/docker-project-foundations/agents/openai.yaml https://anymodel.org/en/skills/docker/docker-project-foundations/agents/openai.yaml -o ~/.claude/skills/docker-project-foundations/assets/Dockerfile.simple https://anymodel.org/en/skills/docker/docker-project-foundations/assets/Dockerfile.simple -o ~/.claude/skills/docker-project-foundations/assets/compose-dev.yaml https://anymodel.org/en/skills/docker/docker-project-foundations/assets/compose-dev.yaml -o ~/.claude/skills/docker-project-foundations/assets/dockerignore-example https://anymodel.org/en/skills/docker/docker-project-foundations/assets/dockerignore-example -o ~/.claude/skills/docker-project-foundations/checks/verification.md https://anymodel.org/en/skills/docker/docker-project-foundations/checks/verification.md -o ~/.claude/skills/docker-project-foundations/evals/docker-project-foundations.md https://anymodel.org/en/skills/docker/docker-project-foundations/evals/docker-project-foundations.md -o ~/.claude/skills/docker-project-foundations/references/project-structure.md https://anymodel.org/en/skills/docker/docker-project-foundations/references/project-structure.md -o ~/.claude/skills/docker-project-foundations/scripts/verify-setup.sh https://anymodel.org/en/skills/docker/docker-project-foundations/scripts/verify-setup.sh -o ~/.claude/skills/docker-project-foundations/skill.yaml https://anymodel.org/en/skills/docker/docker-project-foundations/skill.yaml && chmod +x ~/.claude/skills/docker-project-foundations/scripts/verify-setup.sh
Codex, Cursor — macOS, Linux
curl -fsSL --create-dirs -o ~/.agents/skills/docker-project-foundations/SKILL.md https://anymodel.org/en/skills/docker/docker-project-foundations/SKILL.md -o ~/.agents/skills/docker-project-foundations/LICENSE https://anymodel.org/en/skills/docker/docker-project-foundations/LICENSE -o ~/.agents/skills/docker-project-foundations/agents/openai.yaml https://anymodel.org/en/skills/docker/docker-project-foundations/agents/openai.yaml -o ~/.agents/skills/docker-project-foundations/assets/Dockerfile.simple https://anymodel.org/en/skills/docker/docker-project-foundations/assets/Dockerfile.simple -o ~/.agents/skills/docker-project-foundations/assets/compose-dev.yaml https://anymodel.org/en/skills/docker/docker-project-foundations/assets/compose-dev.yaml -o ~/.agents/skills/docker-project-foundations/assets/dockerignore-example https://anymodel.org/en/skills/docker/docker-project-foundations/assets/dockerignore-example -o ~/.agents/skills/docker-project-foundations/checks/verification.md https://anymodel.org/en/skills/docker/docker-project-foundations/checks/verification.md -o ~/.agents/skills/docker-project-foundations/evals/docker-project-foundations.md https://anymodel.org/en/skills/docker/docker-project-foundations/evals/docker-project-foundations.md -o ~/.agents/skills/docker-project-foundations/references/project-structure.md https://anymodel.org/en/skills/docker/docker-project-foundations/references/project-structure.md -o ~/.agents/skills/docker-project-foundations/scripts/verify-setup.sh https://anymodel.org/en/skills/docker/docker-project-foundations/scripts/verify-setup.sh -o ~/.agents/skills/docker-project-foundations/skill.yaml https://anymodel.org/en/skills/docker/docker-project-foundations/skill.yaml && chmod +x ~/.agents/skills/docker-project-foundations/scripts/verify-setup.sh
Claude Code — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','agents/openai.yaml','assets/Dockerfile.simple','assets/compose-dev.yaml','assets/dockerignore-example','checks/verification.md','evals/docker-project-foundations.md','references/project-structure.md','scripts/verify-setup.sh','skill.yaml') { $p = Join-Path "$HOME\.claude\skills\docker-project-foundations" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/docker/docker-project-foundations/$f" -UseBasicParsing -OutFile $p }
Codex, Cursor — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','agents/openai.yaml','assets/Dockerfile.simple','assets/compose-dev.yaml','assets/dockerignore-example','checks/verification.md','evals/docker-project-foundations.md','references/project-structure.md','scripts/verify-setup.sh','skill.yaml') { $p = Join-Path "$HOME\.agents\skills\docker-project-foundations" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/docker/docker-project-foundations/$f" -UseBasicParsing -OutFile $p }

Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/docker/docker-project-foundations/SKILL.md

SKILL.md

Исходник

Docker Project Foundations

Overview

This skill guides you in Dockerizing a project from scratch. It focuses on creating the initial Docker file set, choosing a sane layout, and preferring containerized dependencies over host-level installs.

When to use this skill

Activate this skill when:

  • A user asks you to set up, initialize, or Dockerize a project
  • A project needs an initial Dockerfile, compose.yaml, or .dockerignore and does not have one
  • A user wants to add a service dependency (database, cache, message queue) to a project
  • A user asks how to run or develop a project locally and Docker is available

Do not use this skill when

Do not use this skill when:

  • The user explicitly wants to avoid Docker
  • The project already has a mature Docker setup and only needs minor edits
  • The main task is optimizing an existing Dockerfile
  • The main task is editing or debugging an existing Compose stack

Core guidance

Always create these three files

When Dockerizing a project, always produce all three:

  1. .dockerignore — Create this first so the initial build context is small and safe. See assets/dockerignore-example for a reference.
  2. Dockerfile — Create a working starter image definition that the project can build and run with. Start from assets/Dockerfile.simple and keep its baseline, even for a first scaffold:
    • multi-stage build (dependencies, build, and a separate runtime stage) whenever the project has a build or dependency-install step;
    • base image pinned to a specific version (e.g. node:22-slim), never latest;
    • dependency manifests (package.json + lockfile) copied before the source for layer caching;
    • a non-root USER set in the final stage before CMD/ENTRYPOINT.
  3. compose.yaml — Create a local development stack that includes the application service and any required dependencies. See assets/compose-dev.yaml.

npm registry credentials

  • Exclude .npmrc at every depth with **/.npmrc in .dockerignore; otherwise a broad source copy can persist credentials in image layers.
  • The Node.js starter mounts npmrc as a BuildKit secret for both npm ci steps. Public-package builds need no secret. For private registries, pass the config explicitly:
    DOCKER_BUILDKIT=1 docker build --secret id=npmrc,src="$HOME/.npmrc" .
    
    Use the actual config path if the project keeps it elsewhere. Never copy the credential file or pass its values through ARG or ENV. Dependency scripts run during installation can access the mounted secret; use trusted dependencies and a least-privilege registry token.
  • For private-registry builds through Compose, add this optional override as compose.npm.yaml alongside the starter's compose.yaml:
    services:
      app:
        build:
          secrets:
            - npmrc
    secrets:
      npmrc:
        file: ${NPMRC_PATH:?Set NPMRC_PATH to your npm config file}
    
    Build with NPMRC_PATH="$HOME/.npmrc" docker compose -f compose.yaml -f compose.npm.yaml build. This grants build-time access only, not a runtime secret. Public-package builds should omit the override so no credential file is required.

Prefer Dockerized dependencies over host installs

When a project needs a database (Postgres, MySQL, MongoDB), cache (Redis, Memcached), queue (RabbitMQ, Kafka), or any other infrastructure service:

  • Always define it as a service in compose.yaml instead of telling the user to install it on the host.
  • Never suggest brew install postgres, apt install redis, or similar host-level installs for development dependencies.
  • Use official Docker images from Docker Hub for these services.
  • Configure services with environment variables, not config files baked into images.

Bootstrap checklist

  • Name the file compose.yaml rather than legacy Compose filenames.
  • Put all three files at the project root unless there is a clear multi-service layout that justifies a docker/ subdirectory.
  • Ensure the initial setup can build and start locally with one command path.
  • Bind published application ports to loopback by default. Widen the host address only when another device must reach the development service.
  • Keep unauthenticated datastores on the Compose network instead of publishing their ports. If local host tools require database access, publish only to loopback.
  • If a development-only credential fallback enables one-command startup, label it clearly and document a .env override.
  • Use Compose services for local databases, caches, and queues instead of host installs.
  • Keep the first scaffold simple; defer detailed image optimization and advanced Compose tuning to the owning skills. "Simple" never means dropping the Dockerfile baseline above (multi-stage, pinned base, non-root USER).

Development vs production

  • Development: Use bind mounts for live reload, publish application ports on loopback by default, and enable verbose logging. Keep unauthenticated datastores on the Compose network; publish a datastore port only on loopback when local host tools require it.
  • Production: Use multi-stage builds, copy only built artifacts, do not mount source code, minimize image layers, set appropriate resource limits.
  • Keep a single Dockerfile that supports both via build stages and build arguments when possible.

File placement

  • Place Dockerfile at the project root (or in a docker/ subdirectory if the project has multiple services).
  • Place compose.yaml at the project root.
  • Place .dockerignore at the project root, next to the Dockerfile.
  • For Dockerfile optimization, cache strategy, advanced non-root hardening, and image hardening, use docker-build-strategies. The starter baseline above (including a non-root USER) still applies here.
  • For service dependencies, health checks, overrides, volumes, networks, and Compose debugging, use docker-compose-patterns.
  • For destructive Docker CLI commands (docker system prune, docker rm -f, image/network/builder pruning) and a cross-product index of destructive-command guardrails, use docker-destructive-guardrails.

References

  • references/project-structure.md — Detailed guidance on Docker project file organization, naming conventions, and multi-service layouts.

Assets

  • assets/dockerignore-example — A comprehensive .dockerignore for a typical project.
  • assets/compose-dev.yaml — A development-oriented Compose file with Dockerized dependencies.
  • assets/Dockerfile.simple — A basic multi-stage Dockerfile following best practices.

Scripts

  • scripts/verify-setup.sh — Checks that required files exist in the current directory and validates its compose.yaml. Run it from the project root, with the script path resolved under this skill's directory:
    bash "<skill-dir>/scripts/verify-setup.sh" [--help]
    
    Replace <skill-dir> with the absolute path of the folder that contains this SKILL.md; the scripts/ path is relative to that folder, not to the project. Do not change into the skill directory first: the script checks the current directory. If the skill directory cannot be resolved, check that .dockerignore, Dockerfile, and compose.yaml exist in the project root, then run docker compose config --quiet. Exit status is 0 when verification succeeds or help is requested, 1 when required files are missing or the Compose configuration is invalid, and 2 for invalid arguments.

Checks

  • checks/verification.md — Detailed verification checklist for manual review.

Подключить через AnyModel API

Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Скиллы Docker