Check artifact identity and model readiness separately
Model artifact: the bundle of files, such as the weights, tokenizer, and config, that makes a particular model reproducibly runnable.
A model artifact is more than the weights file. The tokenizer, configuration, chat template, and any required preprocessing rules must also be present for the same input to become the same tokens and tensors. The combination of runtime image and driver also affects execution results and supported formats.
A Triton model repository links numeric version directories and configuration under a model name. Even when the server is running, if a particular backend cannot read a model, that model is not ready. vLLM's API compatibility likewise does not mean every model supports the same features and templates.
In the fixture, model 1 is ready while model 2 failed to load because a tokenizer file is missing. Shifting traffic to model 2 just because the server liveness check returns 200 makes real requests fail. The deployment manifest must preserve both the file checksums and the runtime image digest.
In the fixture below, a successful live check and a model ready failure appear together. Decide whether to switch traffic and which load log to read next.
- Why does this happen?
- A Triton model repository ties numbered version directories and a configuration to each model name. Even if the server is running, a model is not ready when its backend cannot load it. Likewise, vLLM API compatibility does not mean that every model supports the same features and templates.
- When is it a problem?
- If you see a digest mismatch or a model load failure, there are insufficient grounds to proceed.
- Common beginner misconceptions
- Do not run a model's remote code without review, and do not record a deployment as reproducible based on a mutable tag alone. The HTTP codes in the text come from fixtures, so confirm the actual failure codes for your implementation and version.
- How to verify it yourself
- Compare the checksums of the weights, tokenizer, and config against the release manifest. Record the runtime image digest, backend, and supported GPU range.