`up`: Compose `build:` service with no Features still builds a label-only stage; put the metadata on the container instead, as for `image:`
Mantenedores costumam responder em até 1 dia
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 3/5
- Tempo estimado
- 1-2 dias
- Facilidade para iniciantes
- 45/100
- Tipo de issue
- Refatoração
- Clareza
- Razoavelmente clara
- Status de atividade
- Ativa
- Stack de tecnologia
- docker, docker-compose, typescript
- Domínio
- build-system, cli
Direção de pesquisa
The condition canAddLabelsToContainer && !imageBuildInfo.dockerfile in src/spec-node/containerFeatures.ts (around line 153) decides whether the label stage is generated. Check how buildAndExtendDockerCompose in src/spec-node/dockerCompose.ts writes the build override. Done when up on a Compose build: service with no Features puts the metadata label on the container and runs a plain docker compose build, and devcontainer build behaves as before.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
Identity: TBaltensperger @ nuitio/devcontainer
This comes from nuitio/devcontainer, a private repository that ships a dev-container template on the Compose build: route; the measurements below are from its CI runners.
What happens
With a Docker Compose config whose service uses build: (a Dockerfile) and a devcontainer.json that declares no Features, devcontainer up creating a new container does not run the service's Dockerfile as written. It writes a copy, Dockerfile-with-features, to a temp folder with one more stage that only adds the devcontainer.metadata label, and builds that copy with BUILDKIT_INLINE_CACHE=1.
For an image: service with no Features the CLI skips that stage and puts the metadata on the container as a label (#267). The build: route is left out of that only because of the !imageBuildInfo.dockerfile condition.
Code at v0.89.0 (the latest on npm; these files are unchanged on main at 155f8b2):
- No Features: labels go on the container only when there is no Dockerfile; otherwise the label stage is built.
containerFeatures.ts#L152-L160if (!featuresConfig) { if (canAddLabelsToContainer && !imageBuildInfo.dockerfile) { return { labels: { [imageMetadataLabel]: JSON.stringify(getDevcontainerMetadata(...).raw) } }; } return { featureBuildInfo: await getImageBuildOptions(params, config, dstFolder, baseName, imageBuildInfo) }; } - The label stage itself,
FROM $_DEV_CONTAINERS_BASE_IMAGE AS dev_containers_target_stageplusLABEL devcontainer.metadata=...:
containerFeatures.ts#L199-L217 - A
build:service always carriesimageBuildInfo.dockerfile:
dockerCompose.ts#L167-L184and
imageMetadata.ts,internalGetImageBuildInfoFromDockerfile - The Compose build override with
Dockerfile-with-featuresandBUILDKIT_INLINE_CACHE=1:
dockerCompose.ts#L197-L246(inline cache at L230-L234) docker compose buildruns whenever no container exists yet (noBuild = !!container), passingcanAddLabelsToContainer = true:
dockerCompose.ts#L394-L399and
dockerCompose.ts#L267-L297.
For animage:service with no Features the override has nobuild:section, so this build does nothing.- The labels-on-the-container path already exists for Compose: the labels go into the start override's
labels:
(dockerCompose.ts#L411-L412,
#L565-L567), and a laterupreads the metadata from the container's labels
(imageMetadata.ts#L441-L445).
Measurement
Dev Containers CLI 0.89.0, Docker 29.8.2, 12-CPU Linux runner. Each figure is the median of three devcontainer up runs that create a new container, timed from --log-level trace. No Features in either config, and every layer of the Dockerfile is cached.
| Compose service | up total |
build step |
|---|---|---|
image: |
12.7 s | 0.4 s (nothing to build) |
build: (Dockerfile) |
14.5 s | 3.3 s (range 2.6–4.0 s) |
Each new container on the Dockerfile route spends about 3 s more in the build step. Part of that is the cached rebuild of the service's own Dockerfile, which still has to run so that changes to it are picked up. The rest is the generated Dockerfile, the extra stage and the inline-cache export.
Why build: was left out, as far as I can tell
In #267, @chrmarti explained the split: LABEL allows larger values than --label (about 1.3 MB against 0.5 MB in testing), so --label is used "when adding metadata is the only reason for using an additional (or modified) Dockerfile". With a Dockerfile there is a build anyway, so the stage looked free. devcontainer build passes canAddLabelsToContainer = false and still bakes the label into the image, which is right.
Nothing in up needs the label on the image: a later up reads it from the container, and the image: route already depends on that. The metadata for a config with no Features is the same size on both routes, so the image: route already accepts the --label size limit.
The stage is not free either. Besides the time, building a generated copy of the Dockerfile from a temp folder causes trouble of its own:
- #969: a
Dockerfile.dockerignorenext to the original Dockerfile is ignored. - #1320: Buildx 0.37.2 bake refuses a Dockerfile that is outside the build context. That report is for
devcontainer buildwith animage:service; thisuppath generates the same kind of override.
Request
On up, for a Compose build: service with no Features, put the metadata on the container as a label, as for an image: service, and build the service as written with a plain docker compose build, with no generated Dockerfile, no extra stage and no extra build args.
The smallest change I can see: drop && !imageBuildInfo.dockerfile from the condition in containerFeatures.ts#L153. devcontainer build stays as it is, because it passes canAddLabelsToContainer = false. Then buildAndExtendDockerCompose writes no build override for the service, and the existing docker compose build builds the user's Dockerfile unchanged. The single-container Dockerfile route passes false explicitly in singleContainer.ts#L150 and could get the same treatment from up.
If the label size limit is the concern, one option is to keep the stage only when the serialized metadata is close to the --label limit.
- Linguagem predominante
- TypeScript
- Estrelas
- 3k
- Forks
- 466
- Merge médio
- 13h 28min
- PRs com merge (30d)
- 2
Preparar o ambiente
Inicia o contêiner de desenvolvimento do projeto no navegador, com a sua própria conta do GitHub.
- Sem Dockerfile nem arquivo Docker Compose
- Sem modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de devcontainers/cli
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 82/100
devcontainers/cli#1325 ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 92/100
devcontainers/cli#1203 ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 1/5 1-3 horas Facilidade para iniciantes 68/100
devcontainers/cli#1178 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 5/5 Mais de uma semana Facilidade para iniciantes 12/100
devcontainers/cli#1328 ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 3/5 Meio dia Facilidade para iniciantes 45/100
devcontainers/cli#1324 ·
Mantenedores costumam responder em até 1 dia
Todas as issues de devcontainers/cli
Issues semelhantes
-
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 65/100
521xueweihan/HelloGitHub#4025 ·
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 82/100
voidzero-dev/void#478 ·
Mantenedores costumam responder em até 1 dia
-
bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 69/100
Small-tailqwq/dsh-deep-whale#207 ·
Mantenedores costumam responder em até 1 dia
-
The inspector never shows the instances field, so scaling out is unreachableTalvez já em andamento @Mrkewl assumiu hoje. Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 76/100
xevrion/breakscale#96 ·
Mantenedores costumam responder em até 4 dias
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 70/100
Flux159/mcp-server-kubernetes#384 ·