o 2.a8@stddlZddlZddlZddlZddlmZddlmZddlmZddlmZe e Z GdddZ d d Z dS) N)auth) constants)errors)utilsc@s@eZdZ        d ddZedddZd d ZdS) BuildApiMixinNFTc( Csd}}i}| p i} |p i}|dur|durtd|r%| dur%td| D]}|tjvr8td|q)|rD|sAtd|}ne|durNt|}n[|drV|}nSt j |s`tdt j |d}d} t j |rt|}!ttd d d d |!D} Wdn1swYt| |} tj|| | |d }|rdn| } |d}"|||||| | | d}#|#| |r|j}$|$D] \}%}&||%|&q|r|#dt|i|rt|jdr|#d|intd|rt|jdr |#dt|intd|r,t|jdr'|#dt|intd|rDt|jdr?|#d|intd|r\t|jdrW|#d|intd|rtt|jdro|#d |intd!|durt |jd"rtd#t!|t"rt#|}|#d$|i|durt |jd%rtd&||#d'<|durt |jd(rtd)||#d*<|durd+d,i}| r| |d-<|$||j%|"||#|d.|d/}'|dur|s|&|j'|'|d0S)1a Similar to the ``docker build`` command. Either ``path`` or ``fileobj`` needs to be set. ``path`` can be a local path (to a directory containing a Dockerfile) or a remote URL. ``fileobj`` must be a readable file-like object to a Dockerfile. If you have a tar file for the Docker build context (including a Dockerfile) already, pass a readable file-like object to ``fileobj`` and also pass ``custom_context=True``. If the stream is compressed also, set ``encoding`` to the correct value (e.g ``gzip``). Example: >>> from io import BytesIO >>> from docker import APIClient >>> dockerfile = ''' ... # Shared Volume ... FROM busybox:buildroot-2014.02 ... VOLUME /data ... CMD ["/bin/sh"] ... ''' >>> f = BytesIO(dockerfile.encode('utf-8')) >>> cli = APIClient(base_url='tcp://127.0.0.1:2375') >>> response = [line for line in cli.build( ... fileobj=f, rm=True, tag='yourname/volume' ... )] >>> response ['{"stream":" ---\u003e a9eb17255234\n"}', '{"stream":"Step 1 : VOLUME /data\n"}', '{"stream":" ---\u003e Running in abdc1e6896c6\n"}', '{"stream":" ---\u003e 713bca62012e\n"}', '{"stream":"Removing intermediate container abdc1e6896c6\n"}', '{"stream":"Step 2 : CMD [\"/bin/sh\"]\n"}', '{"stream":" ---\u003e Running in dba30f2a1a7e\n"}', '{"stream":" ---\u003e 032b8b2855fc\n"}', '{"stream":"Removing intermediate container dba30f2a1a7e\n"}', '{"stream":"Successfully built 032b8b2855fc\n"}'] Args: path (str): Path to the directory containing the Dockerfile fileobj: A file object to use as the Dockerfile. (Or a file-like object) tag (str): A tag to add to the final image quiet (bool): Whether to return the status nocache (bool): Don't use the cache when set to ``True`` rm (bool): Remove intermediate containers. The ``docker build`` command now defaults to ``--rm=true``, but we have kept the old default of `False` to preserve backward compatibility timeout (int): HTTP timeout custom_context (bool): Optional if using ``fileobj`` encoding (str): The encoding for a stream. Set to ``gzip`` for compressing pull (bool): Downloads any updates to the FROM image in Dockerfiles forcerm (bool): Always remove intermediate containers, even after unsuccessful builds dockerfile (str): path within the build context to the Dockerfile buildargs (dict): A dictionary of build arguments container_limits (dict): A dictionary of limits applied to each container created by the build process. Valid keys: - memory (int): set memory limit for build - memswap (int): Total memory (memory + swap), -1 to disable swap - cpushares (int): CPU shares (relative weight) - cpusetcpus (str): CPUs in which to allow execution, e.g., ``"0-3"``, ``"0,1"`` decode (bool): If set to ``True``, the returned stream will be decoded into dicts on the fly. Default ``False`` shmsize (int): Size of `/dev/shm` in bytes. The size must be greater than 0. If omitted the system uses 64MB labels (dict): A dictionary of labels to set on the image cache_from (:py:class:`list`): A list of images used for build cache resolution target (str): Name of the build-stage to build in a multi-stage Dockerfile network_mode (str): networking mode for the run commands during build squash (bool): Squash the resulting images layers into a single layer. extra_hosts (dict): Extra hosts to add to /etc/hosts in building containers, as a mapping of hostname to IP address. platform (str): Platform in the format ``os[/arch[/variant]]`` isolation (str): Isolation technology used during build. Default: `None`. 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. Returns: A generator for the build output. Raises: :py:class:`docker.errors.APIError` If the server returns an error. ``TypeError`` If neither ``path`` nor ``fileobj`` is specified. Nz,Either path or fileobj needs to be provided.z.Can not use custom encoding if gzip is enabledzInvalid container_limits key z,You must specify fileobj with custom_context)zhttp://zhttps://zgit://z github.com/zgit@z-You must specify a directory to build in pathz .dockerignorecSs|dko |ddkS)Nr#)xr r 2/usr/lib/python3/dist-packages/docker/api/build.pyz%BuildApiMixin.build..cSsg|]}|qSr )strip).0lr r r rz'BuildApiMixin.build..)exclude dockerfilegziprz/build)tremoteqnocachermforcermpullr buildargsz1.22shmsizez/shmsize was only introduced in API version 1.22z1.23labelsz.labels was only introduced in API version 1.23z1.25 cachefromz2cache_from was only introduced in API version 1.25z1.29targetz.target was only introduced in API version 1.29 networkmodez4network_mode was only introduced in API version 1.25squashz.squash was only introduced in API version 1.25z1.27z3extra_hosts was only introduced in API version 1.27 extrahostsz1.32z0platform was only introduced in API version 1.32platformz1.24z1isolation was only introduced in API version 1.24 isolationz Content-Typezapplication/tarzContent-EncodingT)dataparamsheadersstreamtimeout)decode)( TypeErrorrDockerExceptionkeysrCONTAINER_LIMITS_KEYSrmkbuildcontext startswithospathisdirjoinexistsopenlistfilterread splitlinesprocess_dockerfiletar_urlupdate_proxy_configsget_environmentitems setdefaultjsondumps version_gte_versionInvalidVersion version_lt isinstancedictformat_extra_hosts_set_auth_headers_postclose_stream_helper)(selfr4tagquietfileobjrrr+custom_contextencodingrrrcontainer_limitsr,rrrr cache_fromr! network_moder# extra_hostsr%r&use_config_proxyrcontextr)key dockerignorerfur( proxy_argskvresponser r r buildsi                     zBuildApiMixin.buildz1.31cCs|d}|||dS)a| Delete the builder cache Returns: (dict): A dictionary containing information about the operation's result. The ``SpaceReclaimed`` key indicates the amount of bytes of disk space reclaimed. Raises: :py:class:`docker.errors.APIError` If the server returns an error. z /build/pruneT)r?_resultrO)rRurlr r r prune_buildss zBuildApiMixin.prune_buildsc Cstd|jr |jjrtdtj|jd|_|jrT|j}tj|vr5tj |vr5| tj i|tj<td d dd| D|rRt||d<dSdStd dS) NzLooking for auth configz2No auth config in memory - loading from filesystem) credstore_envzSending auth config ({})z, css|]}t|VqdS)N)repr)rrcr r r =sz2BuildApiMixin._set_auth_headers..zX-Registry-ConfigzNo auth config found)logdebug _auth_configsis_emptyr load_configrjget_all_credentials INDEX_URL INDEX_NAMEgetformatr6r/ encode_header)rRr) auth_datar r r rN&s,      zBuildApiMixin._set_auth_headers)NNFNFFNFNFFNNFNFNNNNNNNNNT)__name__ __module__ __qualname__rfrminimum_versionrirNr r r r rs   rcCs|sdS|}tj|s.tj||}tjr.|tjr.dtjtj |t tjd}tj |dtj |dksHtj ||drit |}dtdd|fWdS1sdwY||krttj ||}|dfS)N)NNz{}{}rz..z .dockerfile.r )r3r4isabsr6rIS_WINDOWS_PLATFORMr2WINDOWS_LONGPATH_PREFIXrvnormpathlen splitdriverelpathr8random getrandbitsr;)rr4abs_dockerfiledfr r r r=Is2     r=)rEloggingr3rrrrrr getLoggerryrmrr=r r r r s      <