A admissão é definida pelo domínio, pelo repositório e pelos testes de integração. O manifesto e o JUnit registram a execução de 22/09/2026.
O pacote portátil contém somente manifesto, dump, metadados e, por opção explícita, archive da imagem de aplicação. Ele exclui secrets, env, certificados privados, estado do runtime e inspect bruto. Dump e metadados podem conter dados dos jobs; exportação/importação usam destinos novos privados, POSIX 0700/0600 ou DACL Windows limitada ao operador e SYSTEM. ACL não é criptografia.
Importação confere chaves/tipos, datas, schema, ferramenta, origem, conjunto permitido, tamanhos e SHA-256 em streaming. Recusa links/reparse points, JSON duplicado, itens extras, destinos existentes e mudanças durante a cópia. Referências externas não definem caminhos de destino. Restore seleciona somente um ID catalogado no runtime reservado; importar não restaura nem carrega imagens.
As leituras comparam identidade, tamanho e mtime antes/depois e calculam o hash
do conteúdo lido. No Windows,
a assinatura usa st_birthtime_ns quando disponível: ctime é depreciado nessa
plataforma e pode divergir entre stat e fstat após uma gravação comum. No POSIX,
o ctime continua detectando mudanças de metadados. Os testes de identidade do
arquivo cobrem uma gravação concluída antes da
leitura; os testes de catálogo mantêm as recusas por corrupção e plano obsoleto.
Veja o contrato de stat do Python.
Se a publicação do pacote concluir e a gravação do catálogo falhar, o pacote
portátil sem registro continua classificado como importado e protegido. A ausência
do registro não concede confiança local. Essa regra também cobre pacotes portáteis
colocados manualmente no runtime; backups legados sem manifesto mantêm a política
de compatibilidade anterior. backups protect --backup <id> valida e persiste a
classificação conservadora; não retira a exigência de --trusted-source.
Hash detecta corrupção, mas não autentica um conjunto adulterado de dump e
manifesto. O PostgreSQL documenta
que restore executa código escolhido pela origem. --trusted-source declara
explicitamente confiança ao restaurar uma cópia importada. O banco permanece
descartável, com papéis e credenciais próprios, redes/mounts atuais e volume novo.
Esse isolamento não torna seguro um dump de origem desconhecida.
backup-image-load --trusted-image-source exige archive conferido e sessão
ativa. Exportação usa ImageID sem tags de substituição; carregamento aplica
somente uma tag exclusiva da sessão e recusa colisão com conteúdo diferente.
Config digest, ImageID e manifesto OCI são conferidos separadamente. A confiança
na imagem continua necessária; validação de hashes não substitui auditoria ou
política de vulnerabilidades.
CONTAINEROPS_SESSION limita o runtime a sessions/<slug> na raiz reservada,
com validação de cada ancestral e recusa de links/junções/traversal. Lock,
secrets, temporários, artefatos, cache e evidências usam o mesmo contexto. Tags e
builder derivados impedem substituição acidental das identidades da demonstração;
o daemon e os recursos do host continuam compartilhados.
Retenção atua sobre IDs internos exatos, com plano identificado e aplicação explícita sob lock. Latest, marcas, última cópia válida e último restore verificado por origem permanecem; cópias desconhecidas não são candidatas. Alteração desde o plano ou conteúdo inesperado interrompe a exclusão. Um journal permite retomar somente a tentativa aprovada. Os testes destrutivos usam fixtures temporárias; nenhum pruning dos backups existentes é necessário para validar a funcionalidade. A política dos dumps é separada da retenção de jobs no banco.
Os JSONs operacionais locais, incluindo backup.json e restore.json, podem
conter caminhos absolutos e são vinculados pelo relatório HTML. Nas cópias desses
registros do cenário operations e da prova de transferência, public_record
substitui o prefixo literal do runtime por <runtime>. O cenário full arquiva
os registros originais. Confira as evidências antes de compartilhá-las.
O HTML escapa os campos do catálogo e apresenta comandos locais; abrir a página não chama backup/restore. Uma cópia no mesmo host continua exposta à perda física dessa máquina.
A revisão local encontrou um problema de disponibilidade: um Bearer válido podia criar os 100 jobs pendentes permitidos e fazer outro proprietário receber 429. No Compose, o atraso de demonstração aceita até 15 segundos por trabalho. A seleção FIFO global ainda deixava o segundo proprietário atrás de todo o backlog do primeiro, mesmo quando havia espaço para admitir seu pedido.
A correção mantém a demo e atua nos dois pontos:
- A transação de admissão conta queued/running globais e do proprietário. O limite é 100 globais e 20 por proprietário, sob o mesmo lock da inserção. Réplicas da API não conseguem ultrapassar o limite por uma corrida entre contagem e gravação.
- O despacho prioriza o proprietário sem execução anterior ou menos recentemente ativo. A escolha fica persistida antes do próximo despacho concorrente. Dentro da prioridade, o job mais antigo é escolhido. O cálculo continua fora do lock.
- Replay idempotente é resolvido antes das quotas: permanece 200 no limite; conteúdo conflitante permanece 409. Excesso novo é 429 com Retry-After 2.
- Jobs running consomem quota. Conclusão/falha terminal libera a vaga. Tentativas, lease, proteção contra worker antigo e o teto global permanecem ativos.
Não há migração de schema. API e worker precisam executar a imagem com a correção; retornar a uma imagem anterior também retorna ao comportamento anterior de fila.
A suíte completa com PostgreSQL real passou: 188 testes e 99 subtests, sem
casos pulados. São 116 testes da aplicação (18 integrações), 30 da operação e
42 do relatório. Ruff, formatação e mypy estrito passaram. Os comandos executaram
o código do checkout montado em /audit, com a imagem local de ferramentas
containerops-test:local; não houve reconstrução das imagens de release nesta
validação. Resultado JUnit e
saída. O
manifesto registra imagens,
comando, hashes das fontes/locks e resultados. Permanecem duas advertências de
depreciação de Starlette/httpx e AnyIO, sem falhas ou casos pulados.
As quatro regressões novas em app/tests/test_integration.py cobrem:
- Oito admissões simultâneas disputam a última vaga de Alice: uma cria, sete recebem limite; um job running é contado e sua conclusão libera uma vaga.
- Alice envia 20 trabalhos de demo de 15 s e recebe 429 no seguinte; Bob ainda recebe 201. Replay/conflict de Alice continuam 200/409. Bob é escolhido no segundo despacho, antes dos outros 19 jobs de Alice.
- Quatro workers disputam a fila: quatro leases distintas, duas para cada owner, mesmo quando todos os jobs de Alice são mais antigos.
- Despachos e conclusões sucessivos alternam entre dois backlogs, sem processar todos os jobs do primeiro proprietário antes do segundo.
O teste global existente agora preenche 99 vagas com vários proprietários e mantém a disputa atômica da centésima. Os testes anteriores de lease obsoleta, expiração, exaustão, pausa, retenção e schema compatível também passaram. A duração 15 s foi validada como entrada e persistência; estes testes não esperam 15 s por job nem constituem um teste de carga ou medição de latência.
Para repetir pela operação suportada: python scripts/ops.py build seguido de
python scripts/ops.py verify. Isso cria a imagem atual e executa os testes de
integração em banco descartável. Nunca configure CONTAINEROPS_TEST_DATABASE=1
contra o banco da demonstração: a fixture limpa seus dados.
Na revisão de 03/10/2026, /v1/ recebeu limite de 100 requisições/s por peer, com rajada de 200, e Bearers válidos receberam 20/s por proprietário, com rajada de 40. A recepção do corpo tem prazo total de 3 s. Exceções inesperadas recebem resposta genérica, com categoria e ID no log. A revisão dos 18 itens registra os testes e o alcance desses controles.
O Compose mantém DEMO_MODE=true; definir false recusa durações positivas, mas
não é necessário para que quota e distribuição funcionem. A fila não faz
preempção: se todos os workers já executam jobs, um novo proprietário aguarda
uma vaga de execução. A política baseada em atividade recente não é um SLA de
latência nem garantia de pesos iguais; renovação/conclusão também contam como
atividade, e o histórico some após a retenção de 24 horas.
Cinco owners podem consumir os 100 lugares juntos. A quota não é um limitador de requisições por segundo e não impede abuso com várias credenciais administradas fora da aplicação. Os tokens são locais e estáticos, o host é único, não há RLS nem transporte TLS na rede interna, e o backup local não cobre perda da máquina. Exposição pública exige revisar esses pressupostos, medir contenção no banco e definir política de identidade/admissão compatível com o uso real.
Esta revisão não substitui a evidência de build, recuperação e imagens em verification.md; aquela execução tem outro fingerprint e continua identificada como histórica.