PyPI package bootstrap

.gitignore

@@ -7,3 +7,7 @@
 
 # Python
 *.pyc
+*.egg*
+coverage.xml
+junit.xml
+.coverage

README.rst

@@ -0,0 +1,132 @@
+=====
+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
+=====
+
+    $ ./senza/cli.py ./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

requirements.txt

@@ -0,0 +1,2 @@
+clickclick==0.3
+pystache

senza/__init__.py

@@ -0,0 +1 @@
+__version__ = '0.1'