|View source on GitHub|
A model server runner that runs in a local docker runtime.
tfx.components.infra_validator.model_server_runners.local_docker_runner.LocalDockerRunner( model, serving_binary, serving_spec )
You need to pre-install docker in the machine that is running InfraValidator component. For that reason, it is recommended to use this runner only for testing purpose.
model: A model artifact to infra validate.
serving_binary: A ServingBinary to run.
serving_spec: A ServingSpec instance.
Get an endpoint to the model server to connect to.
Endpoint will be available after the model server job has reached the Running state.
AssertionError: if runner hasn't reached the Running state.
Start the model server in non-blocking manner.
Start() will transition the job state from Initial to Scheduled. Serving
platform will turn the job into Running state in the future.
Start(), model server runner should prepare the resources model server
requires including config files, environment variables, volumes, proper
authentication, computing resource allocation, etc.. Cleanup for the
resources does not happen automatically, and you should call
Stop() to do
that if you have ever called
It is not allowed to run
Start() twice. If you need to restart the job,
you should create another model server runner instance.
Stop the model server in blocking manner.
Model server job would be gracefully stopped once infra validation logic is
done. Here is the place you need to cleanup every resources you've created
Start(). It is recommended not to raise error during the
as it will usually be called in the
Stop() is always called if
Start() is ever called, even if error has
been raised during the
Start() without completing it.
implementation should take into account the case where
Start() has not
WaitUntilRunning( deadline )
Wait until model server job is running.
When this method is returned without error, the model server job is in the Running state where you can perform all the infra validation logic. It does not guarantee that model server job would remain in the Running state forever, (e.g. preemption could happen in some serving platform) and any kind of infra validation logic failure can be caused from model server job not being in the Running state. Still, it is a validation failure and we blame model for this.
deadline: A deadline time in UTC timestamp (in seconds).
Whether the model is available or not.