mirror of
https://github.com/jupyter/docker-stacks.git
synced 2025-10-07 10:04:03 +00:00
97 lines
3.0 KiB
Python
97 lines
3.0 KiB
Python
# Copyright (c) Jupyter Development Team.
|
|
# Distributed under the terms of the Modified BSD License.
|
|
import logging
|
|
from typing import Any
|
|
|
|
import docker
|
|
from docker.models.containers import Container
|
|
|
|
LOGGER = logging.getLogger(__name__)
|
|
|
|
|
|
class TrackedContainer:
|
|
"""Wrapper that collects docker container configuration and delays
|
|
container creation/execution.
|
|
|
|
Parameters
|
|
----------
|
|
docker_client: docker.DockerClient
|
|
Docker client instance
|
|
image_name: str
|
|
Name of the docker image to launch
|
|
**kwargs: dict, optional
|
|
Default keyword arguments to pass to docker.DockerClient.containers.run
|
|
"""
|
|
|
|
def __init__(
|
|
self,
|
|
docker_client: docker.DockerClient,
|
|
image_name: str,
|
|
**kwargs: Any,
|
|
):
|
|
self.container: Container | None = None
|
|
self.docker_client: docker.DockerClient = docker_client
|
|
self.image_name: str = image_name
|
|
self.kwargs: Any = kwargs
|
|
|
|
def run_detached(self, **kwargs: Any) -> Container:
|
|
"""Runs a docker container using the pre-configured image name
|
|
and a mix of the pre-configured container options and those passed
|
|
to this method.
|
|
|
|
Keeps track of the docker.Container instance spawned to kill it
|
|
later.
|
|
|
|
Parameters
|
|
----------
|
|
**kwargs: dict, optional
|
|
Keyword arguments to pass to docker.DockerClient.containers.run
|
|
extending and/or overriding key/value pairs passed to the constructor
|
|
|
|
Returns
|
|
-------
|
|
docker.Container
|
|
"""
|
|
all_kwargs = self.kwargs | kwargs
|
|
LOGGER.info(f"Running {self.image_name} with args {all_kwargs} ...")
|
|
self.container = self.docker_client.containers.run(
|
|
self.image_name,
|
|
**all_kwargs,
|
|
)
|
|
return self.container
|
|
|
|
def run_and_wait(
|
|
self,
|
|
timeout: int,
|
|
no_warnings: bool = True,
|
|
no_errors: bool = True,
|
|
no_failure: bool = True,
|
|
**kwargs: Any,
|
|
) -> str:
|
|
running_container = self.run_detached(**kwargs)
|
|
rv = running_container.wait(timeout=timeout)
|
|
logs = running_container.logs().decode("utf-8")
|
|
assert isinstance(logs, str)
|
|
LOGGER.debug(logs)
|
|
assert no_warnings == (not self.get_warnings(logs))
|
|
assert no_errors == (not self.get_errors(logs))
|
|
assert no_failure == (rv["StatusCode"] == 0)
|
|
return logs
|
|
|
|
@staticmethod
|
|
def get_errors(logs: str) -> list[str]:
|
|
return TrackedContainer._lines_starting_with(logs, "ERROR")
|
|
|
|
@staticmethod
|
|
def get_warnings(logs: str) -> list[str]:
|
|
return TrackedContainer._lines_starting_with(logs, "WARNING")
|
|
|
|
@staticmethod
|
|
def _lines_starting_with(logs: str, pattern: str) -> list[str]:
|
|
return [line for line in logs.splitlines() if line.startswith(pattern)]
|
|
|
|
def remove(self) -> None:
|
|
"""Kills and removes the tracked docker container."""
|
|
if self.container:
|
|
self.container.remove(force=True)
|