File manager - Edit - /usr/local/CyberPanel/lib/python3.10/site-packages/docker/models/__pycache__/containers.cpython-310.pyc
Back
o �h�� � @ s� d dl Z d dlZd dlmZ ddlmZ ddlmZ ddlm Z m Z m Z m Z m Z ddlmZmZ ddlmZ d d lmZ d d lmZmZ G d d � d e�ZG dd� de�Zg d�Zg d�Zdd� Z dd� Z edd�Z dS )� N)� namedtuple� )� APIClient)�DEFAULT_DATA_CHUNK_SIZE)�ContainerError�DockerException� ImageNotFound�NotFound� create_unexpected_kwargs_error)� HostConfig�NetworkingConfig)� version_gte� )�Image)� Collection�Modelc @ s e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Zed d � �Z ed d � �Z dd� Z dd� Z d>dd�Z dd� Z d?dd�Zefd d �Zedfd d �Zd@d d!�Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Zd2d3� Z d4d5� Z d6d7� Z d8d9� Z d:d;� Z d<d=� Z!dS )A� ContaineraI Local representation of a container object. Detailed configuration may be accessed through the :py:attr:`attrs` attribute. Note that local attributes are cached; users may call :py:meth:`reload` to query the Docker daemon for the current properties, causing :py:attr:`attrs` to be refreshed. c C s$ | j �d�dur| j d �d�S dS )z, The name of the container. �NameN�/)�attrs�get�lstrip��self� r �N/usr/local/CyberPanel/lib/python3.10/site-packages/docker/models/containers.py�name s �zContainer.namec C s8 | j �d| j d �}|du rdS | jj�|�d�d �S )z- The image of the container. �ImageIDr N�:r )r r �client�images�split)r �image_idr r r �image$ s zContainer.imagec C s> z | j d �d�}|p i W S ty } ztd�|�d}~ww )z: The labels of a container as dictionary. �Config�LabelszYLabel data is not available for sparse objects. Call reload() to retrieve all informationN)r r �KeyErrorr )r �result�ker r r �labels. s ����zContainer.labelsc C s( t | jd t�r| jd d S | jd S )zW The status of the container. For example, ``running``, or ``exited``. �State�Status)� isinstancer �dictr r r r �status< s zContainer.statusc C s | j �di ��di ��dd�S )zm The healthcheck status of the container. For example, ``healthy`, or ``unhealthy`. r* �Healthr+ �unknown�r r r r r r �healthE s zContainer.healthc C s | j �di ��di �S )zG The ports that the container exposes as a dictionary. �NetworkSettings�Portsr1 r r r r �portsN s zContainer.portsc K � | j jj| jfi |��S )a Attach to this container. :py:meth:`logs` is a wrapper around this method, which you can use instead if you want to fetch/stream container output without first retrieving the entire backlog. Args: stdout (bool): Include stdout. stderr (bool): Include stderr. stream (bool): Return container output progressively as an iterator of strings, rather than a single string. logs (bool): Include the container's previous output. Returns: By default, the container's output as a single string. If ``stream=True``, an iterator of output strings. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )r �api�attach�id�r �kwargsr r r r8 U s zContainer.attachc K r6 )a� Like :py:meth:`attach`, but returns the underlying socket-like object for the HTTP request. Args: params (dict): Dictionary of request parameters (e.g. ``stdout``, ``stderr``, ``stream``). ws (bool): Use websockets instead of raw HTTP. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )r r7 � attach_socketr9 r: r r r r< o � zContainer.attach_socketNc K s0 | j jj| jf||d�|��}| j j�|d �S )a Commit a container to an image. Similar to the ``docker commit`` command. Args: repository (str): The repository to push the image to tag (str): The tag to push message (str): A commit message author (str): The name of the author pause (bool): Whether to pause the container before committing changes (str): Dockerfile instructions to apply while committing conf (dict): The configuration for the container. See the `Engine API documentation <https://docs.docker.com/reference/api/docker_remote_api/>`_ for full details. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )� repository�tag�Id)r r7 �commitr9 r r )r r> r? r; �respr r r rA s �zContainer.commitc C � | j j�| j�S )a' Inspect changes on a container's filesystem. Returns: (list) A list of dictionaries containing the attributes `Path` and `Kind`. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )r r7 �diffr9 r r r r rD � s zContainer.diffTF� c C sp | j jj| j|||||||| | d� }| j jj|d ||| | | d�}| s%| r*td|�S t| j j�|d �d |�S )a1 Run a command inside this container. Similar to ``docker exec``. Args: cmd (str or list): Command to be executed stdout (bool): Attach to stdout. Default: ``True`` stderr (bool): Attach to stderr. Default: ``True`` stdin (bool): Attach to stdin. Default: ``False`` tty (bool): Allocate a pseudo-TTY. Default: False privileged (bool): Run as privileged. user (str): User to execute command as. Default: root detach (bool): If true, detach from the exec command. Default: False stream (bool): Stream response data. Default: False socket (bool): Return the connection socket to allow custom read/write operations. Default: False environment (dict or list): A dictionary or a list of strings in the following format ``["PASSWORD=xxx"]`` or ``{"PASSWORD": "xxx"}``. workdir (str): Path to working directory for this exec session demux (bool): Return stdout and stderr separately Returns: (ExecResult): A tuple of (exit_code, output) exit_code: (int): Exit code for the executed command or ``None`` if either ``stream`` or ``socket`` is ``True``. output: (generator, bytes, or tuple): If ``stream=True``, a generator yielding response chunks. If ``socket=True``, a socket object for the connection. If ``demux=True``, a tuple of two bytes: stdout and stderr. A bytestring containing response data otherwise. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )�stdout�stderr�stdin�tty� privileged�user� environment�workdirr@ )�detachrI �stream�socket�demuxN�ExitCode)r r7 � exec_creater9 � exec_start� ExecResult� exec_inspect)r �cmdrF rG rH rI rJ rK rN rO rP rL rM rQ rB � exec_outputr r r �exec_run� s )�� �zContainer.exec_runc C � | j j�| j|�S )a� Export the contents of the container's filesystem as a tar archive. Args: chunk_size (int): The number of bytes returned by each iteration of the generator. If ``None``, data will be streamed as it is received. Default: 2 MB Returns: (str): The filesystem tar archive Raises: :py:class:`docker.errors.APIError` If the server returns an error. )r r7 �exportr9 )r � chunk_sizer r r r[ � s zContainer.exportc C s | j j�| j|||�S )a� Retrieve a file or folder from the container in the form of a tar archive. Args: path (str): Path to the file or folder to retrieve chunk_size (int): The number of bytes returned by each iteration of the generator. If ``None``, data will be streamed as it is received. Default: 2 MB encode_stream (bool): Determines if data should be encoded (gzip-compressed) during transmission. Default: False Returns: (tuple): First element is a raw tar data stream. Second element is a dict containing ``stat`` information on the specified ``path``. Raises: :py:class:`docker.errors.APIError` If the server returns an error. Example: >>> f = open('./sh_bin.tar', 'wb') >>> bits, stat = container.get_archive('/bin/sh') >>> print(stat) {'name': 'sh', 'size': 1075464, 'mode': 493, 'mtime': '2018-10-01T15:37:48-07:00', 'linkTarget': ''} >>> for chunk in bits: ... f.write(chunk) >>> f.close() )r r7 � get_archiver9 )r �pathr\ � encode_streamr r r r] � s !�zContainer.get_archivec C s | j jj| j|d�S )a Kill or send a signal to the container. Args: signal (str or int): The signal to send. Defaults to ``SIGKILL`` Raises: :py:class:`docker.errors.APIError` If the server returns an error. )�signal)r r7 �killr9 )r r` r r r ra � zContainer.killc K r6 )a Get logs from this container. Similar to the ``docker logs`` command. The ``stream`` parameter makes the ``logs`` function return a blocking generator you can iterate over to retrieve log output as it happens. Args: stdout (bool): Get ``STDOUT``. Default ``True`` stderr (bool): Get ``STDERR``. Default ``True`` stream (bool): Stream the response. Default ``False`` timestamps (bool): Show timestamps. Default ``False`` tail (str or int): Output specified number of lines at the end of logs. Either an integer of number of lines or the string ``all``. Default ``all`` since (datetime, int, or float): Show logs since a given datetime, integer epoch (in seconds) or float (in nanoseconds) follow (bool): Follow log output. Default ``False`` until (datetime, int, or float): Show logs that occurred before the given datetime, integer epoch (in seconds), or float (in nanoseconds) Returns: (generator of bytes or bytes): Logs from the container. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )r r7 �logsr9 r: r r r rc % s zContainer.logsc C rC )z� Pauses all processes within this container. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )r r7 �pauser9 r r r r rd D � zContainer.pausec C � | j j�| j||�S )a� Insert a file or folder in this container using a tar archive as source. Args: path (str): Path inside the container where the file(s) will be extracted. Must exist. data (bytes or stream): tar data to be extracted Returns: (bool): True if the call succeeds. Raises: :py:class:`~docker.errors.APIError` If an error occurs. )r r7 � put_archiver9 )r r^ �datar r r rg N s zContainer.put_archivec K r6 )a� Remove this container. Similar to the ``docker rm`` command. Args: v (bool): Remove the volumes associated with the container link (bool): Remove the specified link and not the underlying container force (bool): Force the removal of a running container (uses ``SIGKILL``) Raises: :py:class:`docker.errors.APIError` If the server returns an error. )r r7 �remove_containerr9 r: r r r �remove` s zContainer.removec C rZ )a Rename this container. Similar to the ``docker rename`` command. Args: name (str): New name for the container Raises: :py:class:`docker.errors.APIError` If the server returns an error. )r r7 �renamer9 )r r r r r rk q s zContainer.renamec C rf )a Resize the tty session. Args: height (int): Height of tty session width (int): Width of tty session Raises: :py:class:`docker.errors.APIError` If the server returns an error. )r r7 �resizer9 )r �height�widthr r r rl ~ rb zContainer.resizec K r6 )a� Restart this container. Similar to the ``docker restart`` command. Args: timeout (int): Number of seconds to try to stop for before killing the container. Once killed it will then be restarted. Default is 10 seconds. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )r r7 �restartr9 r: r r r ro � s zContainer.restartc K r6 )z� Start this container. Similar to the ``docker start`` command, but doesn't support attach options. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )r r7 �startr9 r: r r r rp � s zContainer.startc K r6 )a# Stream statistics for this container. Similar to the ``docker stats`` command. Args: decode (bool): If set to true, stream will be decoded into dicts on the fly. Only applicable if ``stream`` is True. False by default. stream (bool): If set to false, only the current stats will be returned instead of a stream. True by default. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )r r7 �statsr9 r: r r r rq � s zContainer.statsc K r6 )aU Stops a container. Similar to the ``docker stop`` command. Args: timeout (int): Timeout in seconds to wait for the container to stop before sending a ``SIGKILL``. Default: 10 Raises: :py:class:`docker.errors.APIError` If the server returns an error. )r r7 �stopr9 r: r r r rr � s zContainer.stopc K r6 )aH Display the running processes of the container. Args: ps_args (str): An optional arguments passed to ps (e.g. ``aux``) Returns: (str): The output of the top Raises: :py:class:`docker.errors.APIError` If the server returns an error. )r r7 �topr9 r: r r r rs � r= z Container.topc C rC )z� Unpause all processes within the container. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )r r7 �unpauser9 r r r r rt � re zContainer.unpausec K r6 )a Update resource configuration of the containers. Args: blkio_weight (int): Block IO (relative weight), between 10 and 1000 cpu_period (int): Limit CPU CFS (Completely Fair Scheduler) period cpu_quota (int): Limit CPU CFS (Completely Fair Scheduler) quota cpu_shares (int): CPU shares (relative weight) cpuset_cpus (str): CPUs in which to allow execution cpuset_mems (str): MEMs in which to allow execution mem_limit (int or str): Memory limit mem_reservation (int or str): Memory soft limit memswap_limit (int or str): Total memory (memory + swap), -1 to disable swap kernel_memory (int or str): Kernel memory limit restart_policy (dict): Restart policy dictionary Returns: (dict): Dictionary containing a ``Warnings`` key. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )r r7 �update_containerr9 r: r r r �update� s zContainer.updatec K r6 )a� Block until the container stops, then return its exit code. Similar to the ``docker wait`` command. Args: timeout (int): Request timeout condition (str): Wait until a container state reaches the given condition, either ``not-running`` (default), ``next-exit``, or ``removed`` Returns: (dict): The API's response as a Python dictionary, including the container's exit code under the ``StatusCode`` attribute. Raises: :py:class:`requests.exceptions.ReadTimeout` If the timeout is exceeded. :py:class:`docker.errors.APIError` If the server returns an error. )r r7 �waitr9 r: r r r rw � s zContainer.wait)NN) TTFFFrE FFFNNF�N)"�__name__� __module__� __qualname__�__doc__�propertyr r# r) r. r2 r5 r8 r< rA rD rY r r[ r] ra rc rd rg rj rk rl ro rp rq rr rs rt rv rw r r r r r sR � : � $ r c @ sR e Zd ZeZ ddd�Zddd�Zdd � Z dd d �Zdd d�Z e j j e _ dS )�ContainerCollectionNTFc K s� t |t�r|j}|�dd�}|�dd�}|�dd�} |r/|r/t| jjjd�r+d|d< nt d ��|�d �r=|�d �r=t d ��|�d �rK|�d �sKt d��z| j d|||d�|��} W n t yw | jj j || d� | j d|||d�|��} Y nw | �� |r�| S | jd d d } d} | dks�| dkr�| j||ddd�} | �� d } | dkr�d} |�d�s�| jddd�} |r�| �� | dkr�t| | ||| ��|s�| du r�| S d�| �S ) a�A Run a container. By default, it will wait for the container to finish and return its logs, similar to ``docker run``. If the ``detach`` argument is ``True``, it will start the container and immediately return a :py:class:`Container` object, similar to ``docker run -d``. Example: Run a container and get its output: >>> import docker >>> client = docker.from_env() >>> client.containers.run('alpine', 'echo hello world') b'hello world\n' Run a container and detach: >>> container = client.containers.run('bfirsh/reticulate-splines', detach=True) >>> container.logs() 'Reticulating spline 1...\nReticulating spline 2...\n' Args: image (str): The image to run. command (str or list): The command to run in the container. auto_remove (bool): enable auto-removal of the container on daemon side when the container's process exits. blkio_weight_device: Block IO weight (relative device weight) in the form of: ``[{"Path": "device_path", "Weight": weight}]``. blkio_weight: Block IO weight (relative weight), accepts a weight value between 10 and 1000. cap_add (list of str): Add kernel capabilities. For example, ``["SYS_ADMIN", "MKNOD"]``. cap_drop (list of str): Drop kernel capabilities. cgroup_parent (str): Override the default parent cgroup. cgroupns (str): Override the default cgroup namespace mode for the container. One of: - ``private`` the container runs in its own private cgroup namespace. - ``host`` use the host system's cgroup namespace. cpu_count (int): Number of usable CPUs (Windows only). cpu_percent (int): Usable percentage of the available CPUs (Windows only). cpu_period (int): The length of a CPU period in microseconds. cpu_quota (int): Microseconds of CPU time that the container can get in a CPU period. cpu_rt_period (int): Limit CPU real-time period in microseconds. cpu_rt_runtime (int): Limit CPU real-time runtime in microseconds. cpu_shares (int): CPU shares (relative weight). cpuset_cpus (str): CPUs in which to allow execution (``0-3``, ``0,1``). cpuset_mems (str): Memory nodes (MEMs) in which to allow execution (``0-3``, ``0,1``). Only effective on NUMA systems. detach (bool): Run container in the background and return a :py:class:`Container` object. device_cgroup_rules (:py:class:`list`): A list of cgroup rules to apply to the container. device_read_bps: Limit read rate (bytes per second) from a device in the form of: `[{"Path": "device_path", "Rate": rate}]` device_read_iops: Limit read rate (IO per second) from a device. device_write_bps: Limit write rate (bytes per second) from a device. device_write_iops: Limit write rate (IO per second) from a device. devices (:py:class:`list`): Expose host devices to the container, as a list of strings in the form ``<path_on_host>:<path_in_container>:<cgroup_permissions>``. For example, ``/dev/sda:/dev/xvda:rwm`` allows the container to have read-write access to the host's ``/dev/sda`` via a node named ``/dev/xvda`` inside the container. device_requests (:py:class:`list`): Expose host resources such as GPUs to the container, as a list of :py:class:`docker.types.DeviceRequest` instances. dns (:py:class:`list`): Set custom DNS servers. dns_opt (:py:class:`list`): Additional options to be added to the container's ``resolv.conf`` file. dns_search (:py:class:`list`): DNS search domains. domainname (str or list): Set custom DNS search domains. entrypoint (str or list): The entrypoint for the container. environment (dict or list): Environment variables to set inside the container, as a dictionary or a list of strings in the format ``["SOMEVARIABLE=xxx"]``. extra_hosts (dict): Additional hostnames to resolve inside the container, as a mapping of hostname to IP address. group_add (:py:class:`list`): List of additional group names and/or IDs that the container process will run as. healthcheck (dict): Specify a test to perform to check that the container is healthy. The dict takes the following keys: - test (:py:class:`list` or str): Test to perform to determine container health. Possible values: - Empty list: Inherit healthcheck from parent image - ``["NONE"]``: Disable healthcheck - ``["CMD", args...]``: exec arguments directly. - ``["CMD-SHELL", command]``: Run command in the system's default shell. If a string is provided, it will be used as a ``CMD-SHELL`` command. - interval (int): The time to wait between checks in nanoseconds. It should be 0 or at least 1000000 (1 ms). - timeout (int): The time to wait before considering the check to have hung. It should be 0 or at least 1000000 (1 ms). - retries (int): The number of consecutive failures needed to consider a container as unhealthy. - start_period (int): Start period for the container to initialize before starting health-retries countdown in nanoseconds. It should be 0 or at least 1000000 (1 ms). hostname (str): Optional hostname for the container. init (bool): Run an init inside the container that forwards signals and reaps processes init_path (str): Path to the docker-init binary ipc_mode (str): Set the IPC mode for the container. isolation (str): Isolation technology to use. Default: `None`. kernel_memory (int or str): Kernel memory limit labels (dict or list): A dictionary of name-value labels (e.g. ``{"label1": "value1", "label2": "value2"}``) or a list of names of labels to set with empty values (e.g. ``["label1", "label2"]``) links (dict): Mapping of links using the ``{'container': 'alias'}`` format. The alias is optional. Containers declared in this dict will be linked to the new container using the provided alias. Default: ``None``. log_config (LogConfig): Logging configuration. lxc_conf (dict): LXC config. mac_address (str): MAC address to assign to the container. mem_limit (int or str): Memory limit. Accepts float values (which represent the memory limit of the created container in bytes) or a string with a units identification char (``100000b``, ``1000k``, ``128m``, ``1g``). If a string is specified without a units character, bytes are assumed as an intended unit. mem_reservation (int or str): Memory soft limit. mem_swappiness (int): Tune a container's memory swappiness behavior. Accepts number between 0 and 100. memswap_limit (str or int): Maximum amount of memory + swap a container is allowed to consume. mounts (:py:class:`list`): Specification for mounts to be added to the container. More powerful alternative to ``volumes``. Each item in the list is expected to be a :py:class:`docker.types.Mount` object. name (str): The name for this container. nano_cpus (int): CPU quota in units of 1e-9 CPUs. network (str): Name of the network this container will be connected to at creation time. You can connect to additional networks using :py:meth:`Network.connect`. Incompatible with ``network_mode``. network_disabled (bool): Disable networking. network_mode (str): One of: - ``bridge`` Create a new network stack for the container on the bridge network. - ``none`` No networking for this container. - ``container:<name|id>`` Reuse another container's network stack. - ``host`` Use the host network stack. This mode is incompatible with ``ports``. Incompatible with ``network``. networking_config (Dict[str, EndpointConfig]): Dictionary of EndpointConfig objects for each container network. The key is the name of the network. Defaults to ``None``. Used in conjuction with ``network``. Incompatible with ``network_mode``. oom_kill_disable (bool): Whether to disable OOM killer. oom_score_adj (int): An integer value containing the score given to the container in order to tune OOM killer preferences. pid_mode (str): If set to ``host``, use the host PID namespace inside the container. pids_limit (int): Tune a container's pids limit. Set ``-1`` for unlimited. platform (str): Platform in the format ``os[/arch[/variant]]``. Only used if the method needs to pull the requested image. ports (dict): Ports to bind inside the container. The keys of the dictionary are the ports to bind inside the container, either as an integer or a string in the form ``port/protocol``, where the protocol is either ``tcp``, ``udp``, or ``sctp``. The values of the dictionary are the corresponding ports to open on the host, which can be either: - The port number, as an integer. For example, ``{'2222/tcp': 3333}`` will expose port 2222 inside the container as port 3333 on the host. - ``None``, to assign a random host port. For example, ``{'2222/tcp': None}``. - A tuple of ``(address, port)`` if you want to specify the host interface. For example, ``{'1111/tcp': ('127.0.0.1', 1111)}``. - A list of integers, if you want to bind multiple host ports to a single container port. For example, ``{'1111/tcp': [1234, 4567]}``. Incompatible with ``host`` network mode. privileged (bool): Give extended privileges to this container. publish_all_ports (bool): Publish all ports to the host. read_only (bool): Mount the container's root filesystem as read only. remove (bool): Remove the container when it has finished running. Default: ``False``. restart_policy (dict): Restart the container when it exits. Configured as a dictionary with keys: - ``Name`` One of ``on-failure``, or ``always``. - ``MaximumRetryCount`` Number of times to restart the container on failure. For example: ``{"Name": "on-failure", "MaximumRetryCount": 5}`` runtime (str): Runtime to use with this container. security_opt (:py:class:`list`): A list of string values to customize labels for MLS systems, such as SELinux. shm_size (str or int): Size of /dev/shm (e.g. ``1G``). stdin_open (bool): Keep ``STDIN`` open even if not attached. stdout (bool): Return logs from ``STDOUT`` when ``detach=False``. Default: ``True``. stderr (bool): Return logs from ``STDERR`` when ``detach=False``. Default: ``False``. stop_signal (str): The stop signal to use to stop the container (e.g. ``SIGINT``). storage_opt (dict): Storage driver options per container as a key-value mapping. stream (bool): If true and ``detach`` is false, return a log generator instead of a string. Ignored if ``detach`` is true. Default: ``False``. sysctls (dict): Kernel parameters to set in the container. tmpfs (dict): Temporary filesystems to mount, as a dictionary mapping a path inside the container to options for that path. For example: .. code-block:: python { '/mnt/vol2': '', '/mnt/vol1': 'size=3G,uid=1000' } tty (bool): Allocate a pseudo-TTY. ulimits (:py:class:`list`): Ulimits to set inside the container, as a list of :py:class:`docker.types.Ulimit` instances. use_config_proxy (bool): If ``True``, and if the docker client configuration file (``~/.docker/config.json`` by default) contains a proxy configuration, the corresponding environment variables will be set in the container being built. user (str or int): Username or UID to run commands as inside the container. userns_mode (str): Sets the user namespace mode for the container when user namespace remapping option is enabled. Supported values are: ``host`` uts_mode (str): Sets the UTS namespace mode for the container. Supported values are: ``host`` version (str): The version of the API to use. Set to ``auto`` to automatically detect the server's version. Default: ``1.35`` volume_driver (str): The name of a volume driver/plugin. volumes (dict or list): A dictionary to configure volumes mounted inside the container. The key is either the host path or a volume name, and the value is a dictionary with the keys: - ``bind`` The path to mount the volume inside the container - ``mode`` Either ``rw`` to mount the volume read/write, or ``ro`` to mount it read-only. For example: .. code-block:: python {'/home/user1/': {'bind': '/mnt/vol2', 'mode': 'rw'}, '/var/www': {'bind': '/mnt/vol1', 'mode': 'ro'}} Or a list of strings which each one of its elements specifies a mount volume. For example: .. code-block:: python ['/home/user1/:/mnt/vol2','/var/www:/mnt/vol1'] volumes_from (:py:class:`list`): List of container names or IDs to get volumes from. working_dir (str): Path to the working directory. Returns: The container logs, either ``STDOUT``, ``STDERR``, or both, depending on the value of the ``stdout`` and ``stderr`` arguments. ``STDOUT`` and ``STDERR`` may be read only if either ``json-file`` or ``journald`` logging driver used. Thus, if you are using none of these drivers, a ``None`` object is returned instead. See the `Engine API documentation <https://docs.docker.com/engine/api/v1.30/#operation/ContainerLogs/>`_ for full details. If ``detach`` is ``True``, a :py:class:`Container` object is returned instead. Raises: :py:class:`docker.errors.ContainerError` If the container exits with a non-zero exit code and ``detach`` is ``False``. :py:class:`docker.errors.ImageNotFound` If the specified image does not exist. :py:class:`docker.errors.APIError` If the server returns an error. rO FrN �platformNz1.25T� auto_removezQThe options 'detach' and 'remove' cannot be used together in api versions < 1.25.�network� network_modezBThe options "network" and "network_mode" can not be used together.�networking_configzAThe option "networking_config" can not be used without "network".)r# �commandrN )r r � LogConfig�Typez json-file�journald)rF rG rO �follow� StatusCoder )rF rG � r )r, r r9 �popr r r r7 �_version� RuntimeError�creater r �pullrp r rc rw rj r �join)r r# r� rF rG rj r; rO rN r � container�logging_driver�out� exit_statusr r r �run sp > �� � � � ��� � zContainerCollection.runc K sX t |t�r|j}||d< ||d< | jjj|d< t|�}| jjjdi |��}| �|d �S )a� Create a container without starting it. Similar to ``docker create``. Takes the same arguments as :py:meth:`run`, except for ``stdout``, ``stderr``, and ``remove``. Returns: A :py:class:`Container` object. Raises: :py:class:`docker.errors.ImageNotFound` If the specified image does not exist. :py:class:`docker.errors.APIError` If the server returns an error. r# r� �versionr@ Nr ) r, r r9 r r7 r� �_create_container_args�create_containerr )r r# r� r; � create_kwargsrB r r r r� � s zContainerCollection.createc C s | j j�|�}| �|�S )a� Get a container by name or ID. Args: container_id (str): Container name or ID. Returns: A :py:class:`Container` object. Raises: :py:class:`docker.errors.NotFound` If the container does not exist. :py:class:`docker.errors.APIError` If the server returns an error. )r r7 �inspect_container� prepare_model)r � container_idrB r r r r � s zContainerCollection.get���c sp � j jj|||||d�}|r� fdd�|D �S g } |D ]} z | �� �| d �� W q ty5 |s3� Y qw | S )af List containers. Similar to the ``docker ps`` command. Args: all (bool): Show all containers. Only running containers are shown by default since (str): Show only containers created since Id or Name, include non-running ones before (str): Show only container created before Id or Name, include non-running ones limit (int): Show `limit` last created containers, include non-running ones filters (dict): Filters to be processed on the image list. Available filters: - `exited` (int): Only containers with specified exit code - `status` (str): One of ``restarting``, ``running``, ``paused``, ``exited`` - `label` (str|list): format either ``"key"``, ``"key=value"`` or a list of such. - `id` (str): The id of the container. - `name` (str): The name of the container. - `ancestor` (str): Filter by container ancestor. Format of ``<image-name>[:tag]``, ``<image-id>``, or ``<image@digest>``. - `before` (str): Only containers created before a particular container. Give the container name or id. - `since` (str): Only containers created after a particular container. Give container name or id. A comprehensive list can be found in the documentation for `docker ps <https://docs.docker.com/engine/reference/commandline/ps>`_. sparse (bool): Do not inspect containers. Returns partial information, but guaranteed not to block. Use :py:meth:`Container.reload` on resulting objects to retrieve all attributes. Default: ``False`` ignore_removed (bool): Ignore failures due to missing containers when attempting to inspect containers from the original list. Set to ``True`` if race conditions are likely. Has no effect if ``sparse=True``. Default: ``False`` Returns: (list of :py:class:`Container`) Raises: :py:class:`docker.errors.APIError` If the server returns an error. )�all�before�filters�limit�sincec s g | ]}� � |��qS r )r� )�.0�rr r r � <listcomp>� s z,ContainerCollection.list.<locals>.<listcomp>r@ )r r7 � containers�appendr r ) r r� r� r� r� r� �sparse�ignore_removedrB r� r� r r r �list� s 4� ��zContainerCollection.listc C s | j jj|d�S )N)r� )r r7 �prune_containers)r r� r r r �prune s zContainerCollection.prune)NTFFrx )FNNr� NFF) ry rz r{ r �modelr� r� r r� r� r r� r| r r r r r~ s � } � Dr~ )r� rN � domainname� entrypointrL � healthcheck�hostnamer# r) � mac_addressr �network_disabledr � stdin_open� stop_signalrI �use_config_proxyrK � working_dir)?r� �blkio_weight_device� blkio_weight�cap_add�cap_drop� cgroup_parent�cgroupns� cpu_count� cpu_percent� cpu_period� cpu_quota� cpu_shares� cpuset_cpus� cpuset_mems� cpu_rt_period�cpu_rt_runtime�device_cgroup_rules�device_read_bps�device_read_iops�device_write_bps�device_write_iops�devices�device_requests�dns_opt� dns_search�dns� extra_hosts� group_add�init� init_path�ipc_mode� isolation� kernel_memory�links� log_config�lxc_conf� mem_limit�mem_reservation�mem_swappiness� memswap_limit�mounts� nano_cpusr� �oom_kill_disable� oom_score_adj�pid_mode� pids_limitrJ �publish_all_ports� read_only�restart_policy� security_opt�shm_size� storage_opt�sysctls�tmpfs�ulimits� userns_mode�uts_moder� � volume_driver� volumes_from�runtimec C sZ i }t � | �D ] }|tv r| �|�||< qi }t � | �D ] }|tv r)| �|�||< q | �di �}|r6||d< | �di �}|rB||d< | �dd�}| �dd�}|rh|rX||vrXd}|r^t|�n|di|d< ||d< | rotd | ��tdi |��|d < |d �d �}|r�d d � t|� � �D �|d< |r�t |t �r�dd � |� � D �|d< |S dd � |D �|d< |S )zK Convert arguments to create() to arguments to create_container(). r5 � port_bindings�volumes�bindsr� Nr� r� r� � host_config� PortBindingsc S s g | ] }t |�d d���qS )r r )�tupler! )r� �pr r r r� � s �z*_create_container_args.<locals>.<listcomp>c S s g | ]}|� d ��qS )�bind)r �r� �vr r r r� � s �c S s g | ]}t |��qS r )�_host_volume_from_bindr� r r r r� � s �r ) �copy�RUN_CREATE_KWARGSr� �RUN_HOST_CONFIG_KWARGSr r r r �sorted�keysr, r- �values) r; r� �key�host_config_kwargsr5 r� r� r� r� r r r r� b s^ �� ��� � �� �r� c C sr t �| �\}}|�dd�}t|�dks|d dv r ||d S |d �d�s-|d �d�r5|d d d� S |d S )Nr r )�ro�rwr z:roz:rw���)�ntpath� splitdriver! �len�endswith)r� �drive�rest�bitsr r r r� � s r� rU zexit_code,output) r� r � collectionsr r7 r � constantsr �errorsr r r r r �typesr r �utilsr r r �resourcer r r r~ r� r r� r� rU r r r r �<module> s2 xC>
| ver. 1.4 |
Github
|
.
| PHP 8.2.28 | Generation time: 0.02 |
proxy
|
phpinfo
|
Settings