Metadata-Version: 1.1
Name: stups-senza
Version: 0.4
Summary: AWS Cloud Formation deployment CLI
Home-page: https://github.com/zalando-stups/senza
Author: Henning Jacobs
Author-email: henning.jacobs@zalando.de
License: Apache License 2.0
Description: =====
        Senza
        =====
        
        Senza is a command line tool for generating and executing AWS Cloud Formation templates in a sane way. It supports
        Cloud Formation templates as YAML input and adds own 'components' on top. Components are predefined Cloud Formation
        snippets that are easy to configure and generate all the boilerplate JSON that is required by Cloud Formation.
        
        Installation
        ============
        
        .. code-block:: bash
        
            $ sudo pip3 install --upgrade stups-senza
        
        Usage
        =====
        
        .. code-block:: bash
        
            $ senza ./my-definition.yaml create eu-west-1 1.0
        
        Senza Definition
        ================
        
        .. code-block:: yaml
        
            # basic information for generating and executing this definition
            SenzaInfo:
            StackName: kio
            OperatorTopicId: arn:aws:sns:eu-west-1:1234567890:kio-operators
            Parameters:
                - ImageVersion:
                    Description: "Docker image version of Kio."
        
            # a list of senza components to apply to the definition
            SenzaComponents:
        
            # this basic configuration is required for the other components
            - Configuration:
                Type: Senza::Configuration
                ServerSubnets:
                    eu-west-1:
                    - subnet-123456
                    - subnet-123456
                    - subnet-123456
                    eu-central-1:
                    - subnet-123456
                    - subnet-123456
                LoadBalancerSubnets:
                    eu-west-1:
                    - subnet-123456
                    - subnet-123456
                    - subnet-123456
                    eu-central-1:
                    - subnet-123456
                    - subnet-123456
                Images:
                    AppImage:
                    eu-west-1: ami-123456
                    eu-central-1: ami-123456
        
            # will create a launch configuration and auto scaling group with scaling triggers
            - AppServer:
                Type: Senza::TaupageAutoScalingGroup
                InstanceType: t2.micro
                Image: AppImage
                SecurityGroups:
                    - sg-123456
                ElasticLoadBalancer: AppLoadBalancer
                TaupageConfig:
                    runtime: Docker
                    source: stups/kio:{{Arguments.ImageVersion}}
                    ports:
                    8080: 8080
                    notify_cfn:
                    stack: "{{SenzaInfo.StackName}}-{{SenzaInfo.StackVersion}}"
                    resource: "AppServer"
                    environment:
                    HTTP_CORS_ORIGIN: "*.example.com"
                    PGSSLMODE: verify-full
                    DB_SUBNAME: "//kio.example.eu-west-1.rds.amazonaws.com:5432/kio?ssl=true"
                    DB_USER: kio
                    DB_PASSWORD: aws:kms:abcdef1234567890abcdef=
                AutoScaling:
                    Minimum: 2
                    Maximum: 10
                    MetricType: CPU
                    ScaleUpThreshold: 70
                    ScaleDownThreshold: 40
        
            # creates an ELB entry and Route53 domains to this ELB
            - AppLoadBalancer:
                Type: Senza::ElasticLoadBalancer
                HTTPPort: 8080
                SSLCertificateId: arn:aws:iam::1234567890:server-certificate/kio-example-com
                HealthCheckPath: /ui/
                SecurityGroups:
                    - sg-123456
                Domains:
                    MainDomain:
                    Type: weighted
                    Zone: example.com
                    Subdomain: kio
                    VersionDomain:
                    Type: standalone
                    Zone: example.com
                    Subdomain: kio-{{SenzaInfo.StackVersion}}
        
        
            # just plain Cloud Formation definitions are fully supported:
        
            Outputs:
            URL:
                Description: "The ELB URL of the new Kio deployment."
                Value:
                "Fn::Join":
                    - ""
                    -
                    - "http://"
                    - "Fn::GetAtt":
                        - AppLoadBalancer
                        - DNSName
        
        During evaluation, you can mustache templating with access to the rendered definition, including the SenzaInfo,
        SenzaComponents and Arguments key (containing all given arguments).
        
        Components
        ==========
        
        * Senza::Configuration
        * Senza::AutoScalingGroup
        * Senza::TaupageAutoScalingGroup
        * Senza::ElasticLoadBalancer
        
Keywords: aws account saml login federated shibboleth
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: Implementation :: CPython
