Metadata-Version: 2.0
Name: codebuilder
Version: 0.0.1a3
Summary: CLI helper for AWS CodeBuild and CodePipeline
Home-page: http://github.com/wnkz/codebuilder
Author: wnkz
Author-email: wnkz@users.noreply.github.com
License: MIT
Download-URL: https://github.com/wnkz/codebuilder/archive/0.0.1-alpha.3.tar.gz
Keywords: aws codebuild codepipeline docker kms
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: boto3 (>=1.4.4)
Requires-Dist: botocore (<1.6.0,>=1.5.0)
Requires-Dist: click (==6.7)
Requires-Dist: dpath (==1.4)

CodeBuilder - CLI helper for easy CI on AWS
===========================================

|Build Status| |Docs| |Version| |License|

CodeBuilder is a CLI tool which allows developpers to use simple commands
and helpers inside AWS CI/CD tools like CodePipeline and CodeBuild.


.. _`stable docs`: https://codebuilder.readthedocs.io/en/stable/
.. _`Read the Docs`: https://codebuilder.readthedocs.io/en/latest/

.. |Build Status| image:: https://img.shields.io/travis/wnkz/codebuilder/master.svg?style=flat
    :target: https://travis-ci.org/wnkz/codebuilder
    :alt: Build Status

.. |Docs| image:: https://readthedocs.org/projects/codebuilder/badge/?version=latest
    :target: http://codebuilder.readthedocs.io/en/latest/?badge=latest
    :alt: Read the docs

.. |Version| image:: https://img.shields.io/pypi/v/codebuilder.svg?style=flat
    :target: https://pypi.python.org/pypi/codebuilder/
    :alt: Version

.. |License| image:: http://img.shields.io/pypi/l/codebuilder.svg?style=flat
    :target: https://github.com/wnkz/codebuilder/blob/master/LICENSE
    :alt: License

Quick Start
-----------

Generally, you would run CodeBuilder on an `AWS CodeBuild environment <https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref.html>`__
where AWS CLI is properly installed and configured. CodeBuilder uses the exact same authentication method as Boto 3 and AWS CLI.

Install with ``pip``:

.. code-block:: sh

    $ pip install codebuilder

Example CodeBuild usage (``buildspec.yml``):

.. code-block:: yaml

    version: 0.1
    environment_variables:
      plaintext:
        KMS_CIPHERBLOB: "AQEC..."

    phases:
      install:
        commands:
          - pip install codebuilder
      pre_build:
        commands:
          - codebuilder aws ecr login
          - codebuilder aws kms decrypt ${KMS_CIPHERBLOB} > ${CODEBUILD_SRC_DIR}/secret
      build:
        commands:
          - docker build -t 123456789012.dkr.ecr.eu-west-1.amazonaws.com/foo .
      post_build:
        commands:
          - docker push 123456789012.dkr.ecr.eu-west-1.amazonaws.com/foo
          - codebuilder docker --image-name 123456789012.dkr.ecr.eu-west-1.amazonaws.com/foo get-image full --source-json-file config.json --in-place Parameters DockerImage
          - codebuilder aws ecr prune


