Commit graph

53 commits

Author SHA1 Message Date
joeduffy 7323436760 Rearrange demo directory so the "build" variants stand alone 2016-11-07 10:15:38 -08:00
joeduffy 736008168d Add two variants to the Mu demo
This adds two hypothetical variants to the Mu demo, "building" new capabilities
up from the basic Express and MongoDB app we start with:

1) The first variant is to leverage the Mu SDK for service discovery and
   configuration, eliminating the "loosely typed" approach that is common with
   Docker (e.g., having to fetch connection URLs from arguments, environment
   variables, etc).  This extends the Mu type system "into" the Docker container,
   whereas previously it stopped at the boundary.

2) The second variant really takes this to the next level, embellishing the nice
   DSL-like approach.  In this model, infrastructure is expressed in code.
2016-11-07 09:37:47 -08:00
joeduffy 31717d5f95 Eliminate manual persistence from demo Mufile
Instead of manually creating a volume, we will arrange for the mongodb/mongodb
to auto-mount a mu/x/fs/volume, as per [the cloud-neutral design doc](/docs/xcloud.md).
2016-11-06 12:36:28 -08:00
joeduffy c6cdb9a7ae Add a note on AWS IAM mapping
...plus a handful of random TODOs.
2016-11-06 10:02:06 -08:00
joeduffy a90b16f34d Add a note about Groups being members of other Groups 2016-11-06 09:51:23 -08:00
joeduffy be0097ed85 Add a document on the cloud-neutral Mu abstractions 2016-11-06 09:32:46 -08:00
joeduffy 371429a95a Add a small informative note on security personas 2016-11-04 16:06:53 -07:00
joeduffy ea707cab68 Add a reminder to figure out Security metadata in Mufiles 2016-11-04 15:43:03 -07:00
joeduffy d8ac8efa80 Start a new Security doc
This change refactors the Architecture doc, splitting out Security into its
own design document.
2016-11-04 15:37:12 -07:00
joeduffy d8ea7de341 Add some thoughts on security to the architecture doc 2016-11-04 15:34:50 -07:00
joeduffy 695573d211 Sketch out a few more necessary concepts 2016-11-04 13:50:10 -07:00
joeduffy 216b2867eb Add a reminder to figure out "secret" storage as a service 2016-11-04 13:21:47 -07:00
joeduffy b176a3b314 Reorganize some remaining TODOs 2016-11-04 13:19:24 -07:00
joeduffy 2226584cff Add a note about IAM, credentials, region, etc. flowing from AWS IaaS to CaaS 2016-11-04 13:10:50 -07:00
joeduffy 25e0979da3 Add initial thoughts on EC2 Container Service (ECS) targeting 2016-11-04 12:53:45 -07:00
joeduffy 7bd27e9036 Add a note to consider mu/job and mu/daemon types 2016-11-04 12:43:31 -07:00
joeduffy 7e26ab050d Add the "demo1" example app
This just adds a simple voting app for the demo script.  It leverages
a Node.js Express app for the frontend and a MongoDB database for the backend.
It conditionally provisions and attaches to an AWS Elastic Block Store volume
in the event that it's targeting an AWS cluster, and ephemeral storage otherwise.
2016-11-04 12:17:46 -07:00
joeduffy 9836600e73 Do a bit of random wordsmithing as I proofread 2016-11-04 11:34:30 -07:00
joeduffy 97d251772d Clean up out of date documentation 2016-11-04 11:27:09 -07:00
joeduffy 47d8044e9a Split the metadata spec from the targets doc
This change separates the metadata specification from the targets doc,
since they are both meant to be consumable independent of one another
and will evolve at their own paces.
2016-11-04 11:23:59 -07:00
joeduffy a270a9e0fc Eliminate TODO stacking; it kills MarkDown readability 2016-11-03 18:29:23 -07:00
joeduffy cb2726dfb7 Flesh out more of the AWS CloudFormation transformations 2016-11-03 18:27:21 -07:00
joeduffy 047bc0aae2 Add a few AWS-specific TODOs to the Metadata doc 2016-11-03 16:18:23 -07:00
joeduffy ab35057316 Sketch out the nested Stacks section 2016-11-03 16:11:28 -07:00
joeduffy 792e90fe17 Add a brief note about subclassing 2016-11-03 15:52:03 -07:00
joeduffy 523a55ed1e Articulate the parameters section 2016-11-03 15:47:52 -07:00
joeduffy 1742d0ecf1 Sketch out the Metadata spec; start on the AWS IaaS
This sketches out some more details in the Metadata format, in addition to
starting to articulate what the AWS IaaS provider looks like.  Sadly, more
questions than answers, but it's good to have the placeholders...
2016-11-03 15:12:22 -07:00
joeduffy 969294aad6 Introduce the notion of a Clusters
Simple developer scenarios can be done solely in terms of Stacks.  However, to
support more sophisticated cases -- where multiplexing many Stacks onto a shared
set of resources is preferred (for cost savings, provisioning time savings,
control, etc) -- we need to introduce the concept of a Cluster.  Each Cluster has
a fixed combination of IaaS/CaaS provider, decided at provisioning time.
2016-11-03 12:13:51 -07:00
joeduffy fe2f52c436 Link to prioritized platform list 2016-11-03 12:06:46 -07:00
joeduffy 55ab75b222 Clarify the IaaS/CaaS relationship 2016-11-02 13:33:48 -07:00
joeduffy 0232dd3a08 Refactor the Architecture doc, and start a Metadata specification
This just contains primarily scaffolding, however lays out a general direction
and table of contents for the metadata specification document (marapongo/mu#1).
2016-11-02 13:04:27 -07:00
joeduffy 48e178d0d2 Create the start of an Architecture doc
This doc will describe the overall architecture for the Mu tools, platform,
and related artifacts.  It will be a companion to the more detailed drill-down
into the Mufile format and its specific target transformations (marapongo/mu#1).

There are tons of todos, etc., however this is at least a start, with some
amount of conceptual overview plus scaffolding and structure to fill out.
2016-11-01 17:04:34 -07:00
joeduffy 8f529cb3d8 Add the Nginx hypothetical examples
This was really just a brainstorming exercise that helped get to the final
model we landed on.  I'm archiving it for posterity.  I'll decide whether to
carry it forward or delete it and leave it as an artifact for future reference
as I make more progress on the overall architecture and file format specification.
2016-11-01 11:01:55 -07:00
joeduffy 07444a9612 Add some README scaffolding around the converted examples 2016-11-01 10:39:36 -07:00
joeduffy 4d5bf5386e Tweak the README slightly
This reflects thinking of about two weeks ago.  Archiving.
2016-11-01 10:37:00 -07:00
joeduffy 23f8908efd Add an "overview2" document
This snapshots thinking as of maybe two weeks ago.  I'm preparing to
do a big overhaul of all of the write-ups, and specifically start on the
Mu.yaml file format spec, and so I want to archive everything that's in flight.
2016-11-01 10:35:57 -07:00
joeduffy d6b2575008 Add a few lingering changes to the Mu voting example
Some of this is out of date, however I'm archiving work in progress,
and will freshen it up momentarily.
2016-11-01 10:31:21 -07:00
joeduffy 8c3dbf9d6d Add Docker Compose and Kubernetes conversions as submodules 2016-11-01 10:30:39 -07:00
joeduffy 7d7609fc82 Fix a typo (cust => client variable name) 2016-10-25 17:25:12 -07:00
joeduffy 1ae888ce02 Add a sample app that sends a Twilio SMS anytime Mongo is updated
This was an interesting example I found in the Mulesoft GitHub repos.  It seemed like
a perfect candidate for Riff/Mu/Lambda, so I sketched out what it might look like.
2016-10-25 17:23:50 -07:00
joeduffy bbe6280d46 Sketch out the Mu YAML metadata for the vote50 app 2016-10-19 15:58:51 -07:00
joeduffy 26968a3314 Sketch out an AWS CloudFormation based compilation of the vote50 app
This change adds a .mu/ directory to the vote50 app.  Inside are the "expected"
contents that the Mu compiler should output.  Eventually we will validate against
this that the (currently non-existent) compiler generates the correct thing.

This isn't complete, although I can manually create bits and pieces of the stacks
using CloudFormation.  More files will come; for example, the code packages.

In a nutshell:

    .mu/                                # Shared files agnostic to the cloud target
        aws-native-cf/                  # Files specific to the AWS CloudFormation target
            app.template.yaml           # The CloudFormation stack for the overall app
            services/                   # A directory containing service-specific stacks
                voting.template.yaml    # The CloudFormation stack for the VotingService
        services/                       # Service files agnostic to the cloud target
            voting.proto                # The gRPC definition for VotingService's API
        mu.yaml                         # The Mu package manifest (minimal for now)
2016-10-15 12:18:28 -07:00
joeduffy b1aa61e03d Create a sample app that exposes a voting API for all 50 states 2016-10-15 09:00:28 -07:00
joeduffy e0af9a4d6a Reorder the topics slightly
Instead of leading in with the Service-based voting application, and then
simplifying it to a serverless Function-based one, do it in the reverse order.
This allows us to "grow" the sample, motivating each change as we go.
2016-10-15 08:36:38 -07:00
joeduffy eed7db741e Articulate multi-instancing of Services
This updates the doc to demonstrate how multi-instancing a Service
is as easy as `new`ing up many objects.
2016-10-15 08:27:55 -07:00
joeduffy 36a94fa107 Jot down a few more thoughts on how this might work 2016-10-14 14:20:11 -07:00
joeduffy 9aed189c5a Add some "in progress" thinking on programming model 2016-10-14 13:26:29 -07:00
joeduffy 3350ddbd0b Crisp up articulation of the build, package, and deploy steps 2016-10-11 15:10:06 -07:00
joeduffy 1eb06f86a6 Specify more of the Mu project management "flow" 2016-10-11 14:24:33 -07:00
joeduffy 4d83e15685 Refine a few of the HTTP endpoint concepts; wordsmith a bit 2016-10-11 12:10:48 -07:00