Metadata-Version: 1.1
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
Description: 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
        
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
