Metadata-Version: 1.1
Name: zalando-kubectl
Version: 0.13
Summary: Kubectl wrapper in Python with OAuth token auth
Home-page: https://github.com/zalando-incubator/zalando-kubectl
Author: Henning Jacobs
Author-email: henning.jacobs@zalando.de
License: Apache License 2.0
Description: ===============
        Zalando Kubectl
        ===============
        
        .. image:: https://travis-ci.org/zalando-incubator/zalando-kubectl.svg?branch=master
           :target: https://travis-ci.org/zalando-incubator/zalando-kubectl
           :alt: Build Status
        
        .. image:: https://coveralls.io/repos/zalando-incubator/zalando-kubectl/badge.svg
           :target: https://coveralls.io/r/zalando-incubator/zalando-kubectl
           :alt: Code Coverage
        
        .. image:: https://img.shields.io/pypi/dw/zalando-kubectl.svg
           :target: https://pypi.python.org/pypi/zalando-kubectl/
           :alt: PyPI Downloads
        
        .. image:: https://img.shields.io/pypi/v/zalando-kubectl.svg
           :target: https://pypi.python.org/pypi/zalando-kubectl/
           :alt: Latest PyPI version
        
        .. image:: https://img.shields.io/pypi/l/zalando-kubectl.svg
           :target: https://pypi.python.org/pypi/zalando-kubectl/
           :alt: License
        
        Kubernetes CLI (kubectl) wrapper in Python with OAuth token authentication.
        
        This wrapper script ``zkubectl`` serves as a drop-in replacement for the ``kubectl`` binary:
        
        * it downloads the current ``kubectl`` binary from Google
        * it generates a new ``~/.kube/config`` with an OAuth Bearer token acquired via `zign`_.
        * it passes through commands to the ``kubectl`` binary
        
        
        Installation
        ============
        
        Requires Python 3.4+.
        
        .. code-block:: bash
        
            $ sudo pip3 install --upgrade zalando-kubectl
        
        Usage
        =====
        
        You can directly login to a known Kubernetes API server endpoint:
        
        .. code-block:: bash
        
            $ zkubectl login https://my-api-server.example.org
            $ zkubectl cluster-info
        
        You can also configure a Cluster Registry to look up clusters by ID:
        
        .. code-block:: bash
        
            $ zkubectl configure --cluster-registry=https://cluster-registry.example.org
            $ zkubectl login my-cluster-id
        
        The Cluster Registry needs to provide the following HTTP API for this to work:
        
        .. code-block:: bash
        
            $ curl -H "Authorization: Bearer $(zign tok)" https://cluster-registry.example.org/kubernetes-clusters/my-cluster-id
            {
                "api_server_url": "https://my-api-server.example.org"
            }
        
        
        Unit Tests
        ==========
        
        Run unit tests with Tox:
        
        .. code-block:: bash
        
            $ sudo pip3 install tox
            $ tox
        
        .. _zign: https://pypi.python.org/pypi/stups-zign
        
Keywords: kubectl kubernetes
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: License :: OSI Approved :: Apache Software License
