Metadata-Version: 1.1
Name: paclair
Version: 2.1.0
Summary: Push and Analyse containers with Clair
Home-page: https://github.com/yebinama/paclair
Author: Grégoire UNBEKANDT
Author-email: UNKNOWN
License: UNKNOWN
Description: Paclair
        =======
        
        Paclair is a Python3 Cli tool to interact with `Coreos's Clair <https://github.com/coreos/clair>`_.
        
        Features:
        
        - Now compatible with Clair V3 (delete is not available)
        - No need to have docker installed since Paclair interacts directly with the registries.
        - Compatible with all registries.
        - Simple to use.
        - Easy integration in a CI job thanks to a lightweight output mode.
        
        Installation
        ------------
        
        To install Paclair, simply use `pipenv <http://pipenv.org/>`_ (or pip, of course):
        
        .. code-block:: bash
        
            $ pipenv install paclair
            ✨🍰✨
        
        Voilà!
        
        Configuration
        -------------
        
        Example
        ~~~~~~~
        
        An example configuration file is available in the conf directory
        
        ::
        
            General:
              clair_url: 'https://localhost:6060'
              verify: "/etc/ssl/certs/my_custom_ca.crt"
            Plugins:
              Docker:
                class: paclair.plugins.docker_plugin.DockerPlugin
                registries:
                  registry.gitlab.domain.com:
                    auth:
                      - "*****"
                      - "*****"
                    verify: "/etc/ssl/certs/ca-certificates.crt"
        
        Plugins are dynamically loaded during execution. That's why you have to specify the class of the
        plugins you want to use.
        
        We have various plugins to interact with different sources (ex: docker registry, Elasticsearch)
        because we use a custom variant of Clair which can analyse more than Docker images.
        
        If you want to use Paclair only to analyse docker images, don't bother with others plugins.
        
        Options
        ~~~~~~~
        
        +-----------------------------------+-----------------------------------+
        | Config Option                     | Description                       |
        +===================================+===================================+
        | General::clair_url                | url of the Clair Server           |
        +-----------------------------------+-----------------------------------+
        | General::verify                   | Either a boolean, in which case   |
        |                                   | it controls whether we verify the |
        |                                   | server’s TLS certificate, or a    |
        |                                   | string, in which case it must be  |
        |                                   | a path to a CA bundle to use.     |
        +-----------------------------------+-----------------------------------+
        | General::clair_api_version        | Clair Api Version                 |
        |                                   | If different from 3, will be set  |
        |                                   | to default.                       |
        |                                   | Default to 1.                     |
        +-----------------------------------+-----------------------------------+
        | Plugins                           | List of plugins to use. If you    |
        |                                   | only want to analyse docker       |
        |                                   | images, keep the default          |
        |                                   | configuration                     |
        +-----------------------------------+-----------------------------------+
        | Plugins::Docker::class            | Class for the docker plugin       |
        +-----------------------------------+-----------------------------------+
        | Plugins::Docker::registries       | You can specify configuration for |
        |                                   | registries (authentification, …)  |
        |                                   | if needed                         |
        +-----------------------------------+-----------------------------------+
        | Plugins::Docker::registries::regi | login/password                    |
        | stry1::auth                       |                                   |
        +-----------------------------------+-----------------------------------+
        | Plugins::Docker::registries::regi | Either a boolean, in which case   |
        | stry1::verify                     | it controls whether we verify the |
        |                                   | server’s TLS certificate, or a    |
        |                                   | string, in which case it must be  |
        |                                   | a path to a CA bundle to use.     |
        +-----------------------------------+-----------------------------------+
        | Plugins::Docker::registries::regi | Protocol to use (http or https).  |
        | stry1::protocol                   | Default to https                  |
        +-----------------------------------+-----------------------------------+
        
        Running the tests
        -----------------
        
        Launch tox.
        
        .. code-block:: bash
        
            $ tox
        
        Usage
        -----
        
        .. code-block:: bash
        
            usage: paclair [-h] [--debug] [--syslog] [--conf CONF]
                           plugin hosts [hosts ...] {push,delete,analyse} ...
        
            positional arguments:
              plugin                Plugin to launch
              hosts                 Image/hostname to analyse
              {push,delete,analyse}
                                    Command to launch
                push                Push images/hosts to Clair
                delete              Delete images/hosts from Clair
                analyse             Analyse images/hosts already pushed to Clair
        
            optional arguments:
              -h, --help            show this help message and exit
              --debug               Debug mode
              --syslog              Log to syslog
              --conf CONF           Conf file
        
        
        Examples
        ~~~~~~~~
        
        Push ubuntu image to Clair
        
        .. code-block:: bash
        
            $ paclair --conf conf/conf.yml Docker ubuntu push
            Pushed ubuntu to Clair.
        
        Analyse ubuntu image
        
        .. code-block:: bash
        
            $ paclair --conf conf/conf.yml Docker ubuntu analyse --statistics
            Medium: 3
        
        You can have the full json if you don't specify --statistics
        
        Delete ubuntu image
        
        .. code-block:: bash
        
            $ paclair --conf conf/conf.yml Docker ubuntu delete
            ubuntu was deleted from Clair.
        
        Contributing
        ------------
        
        Feel free to contribute.
        
        Authors
        -------
        
        -  **Yebinama** - *Initial work* - `Yebinama <https://github.com/yebinama>`__
        
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
