Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

vmm-cli: encrypted env vars fail in three ways that all surface as "variable is required"

Aberta
#832 0 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
4/5
Tempo estimado
3-5 dias
Facilidade para iniciantes
48/100
Tipo de issue
Bug
Clareza
Razoavelmente clara
Status de atividade
Pouca atividade
Stack de tecnologia
python
Domínio
backend, cli, security

Direção de pesquisa

Comece em vmm-cli.py, lendo parse_env_file, deploy, update_vm_env e o caminho de compose que grava o JSON gerado. Rastreie como allowed_envs e as URLs de KMS do host e do guest são preenchidos. A tarefa estará concluída quando arquivos env vazios ou inválidos falharem claramente, o compose puder definir allowed_envs e o deployment de env criptografado em uma única etapa preservar endpoints KMS separados.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

Hit all three while deploying a CVM whose app needs one encrypted environment
variable — a DNS provider token. Each failed in a way that pointed somewhere
other than the actual cause, and together they cost about an hour and three
redeploys. Filing as one issue since they are all the same feature.

1. --env-file accepts a file it cannot parse, silently

parse_env_file expects KEY=Value lines and skips everything else. Given a
JSON file it parses zero variables and returns an empty dict, and deploy
carries on as if no --env-file had been passed:

[{"key": "CLOUDFLARE_API_TOKEN", "value": "..."}]

Deploy prints nothing unusual. The VM boots, the app starts, and the failure
finally surfaces inside the container as

Error: CLOUDFLARE_API_TOKEN environment variable is required

which reads like an application bug. [{"key": …, "value": …}] is a reasonable
guess at the format, and it happens to be the shape deploy builds internally
before encrypting.

Rejecting a file that yields no variables would be enough — an --env-file that
sets nothing is never intentional.

2. compose cannot set allowed_envs

An encrypted variable is only injected if app_compose.allowed_envs names it,
but vmm-cli compose has no flag for that list, so it always writes
"allowed_envs": []. The only way to set it is to edit the generated JSON by
hand.

That is worse than it sounds, because the app id is derived from that file. So
adding a variable name changes the app id, which invalidates anything already
keyed to it — for a dstack-gateway app that means the
_dstack-app-address.<domain> TXT record has to be updated before traffic works
again.

The symptom is identical to #1 (… environment variable is required), so from
the container's point of view "wrong file format" and "variable not allowed" are
indistinguishable.

Something like compose --allowed-env NAME (repeatable), or defaulting the list
to the keys of --env-file when one is given, would remove the hand edit and the
app-id churn that follows it.

3. deploy --kms-url sets two different things at once

It is used both for the host-side call that fetches the app's env encryption key
and for params["kms_urls"], which is what the guest is configured to talk to.
Those are rarely the same address.

In a local lab the KMS listens on 127.0.0.1:13501 on the host, while the guest
reaches it via QEMU user networking as kms.1022.dstack.org → 10.0.2.2. The
vmm config already has both:

kms_url  = "https://localhost:13501"              # host side
kms_urls = ["https://kms.1022.dstack.org:13501"]  # guest side

Passing --kms-url https://localhost:13501 — the only value that works for the
encryption step — overwrites the guest's list too, and the CVM then reboot-loops:

dstack-prepare.sh[334]: Error: Failed to request app keys
  0: Failed to get app keys from KMS
  1: Failed to get temp ca cert
  ...
  6: Connection refused (os error 111)
[FAILED] Failed to start dstack-prepare.service

No message connects that to the flag; the VM simply cycles between booting and
requesting app keys until you read the console log.

The workaround is to deploy without --env-file, then

vmm-cli.py update-env <vm> --env-file env --kms-url https://localhost:13501

and restart, because update_vm_env uses the URL only to fetch the key and does
not write it into the VM config. It works, but it means the documented one-step
path is the broken one.

A separate flag for the encryption endpoint — or falling back to the vmm's own
kms_url when only the guest list should change — would fix it. Erroring when
the given URL is a loopback address would at least fail at the right moment.

Environment

vmm-cli.py from main, local lab (vmm + kms + gateway on one TDX host),
guest image dstack-0.6.0.

Linguagem predominante
Rust
Estrelas
551
Forks
97
Merge médio
1d 8h
PRs com merge (30d)
182

Guia de contribuição

Abrir o guia de contribuição

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de Dstack-TEE/dstack

Todas as issues de Dstack-TEE/dstack

Issues semelhantes

Mais issues de Rust

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.