SerAws - 0.0.2

-
As discussed in blog post SerAws – 0.0.0;  Version 0.0.2 of the addin marks an important milestone in the development of SerAws, in that it provides a vertical slice of functionality for a user to be able to round-trip information from AWS to EA and back again into AWS via CloudFormation.  It only covers the VPC entity, but this is sufficient to prove out the overall idea.  Please see below for the steps and accompanying screenshots describing the one round-trip operation.

1. Configure AWS Security Credentials

A windows form/dialog is provided to allow the user to enter AWS security credentials.  The figure below shows details of a fictional account.

SerAws-0.0.2-Screenshot1

Note that these details are not stored as part of the addin or EA, instead the security credentials are managed by the AWS SDK, and hence any other tooling that uses the SDK can also be used to manage them (e.g. AWS Toolkit for Visual Studio).

2. Import AWS Entities into EA

The .NET AWS SDK is used to query AWS and the corresponding elements are created in EA.  The diagram below shows the imported entities.

SerAws-0.0.2-Screenshot2

On the project browser on the left, you can see imported VPC, Subnet, Security Groups, Route Tables, Internet Gatewasy and Access Control List entities.  Paul and myself have a little solution on AWS that we use to host an EA database.  I have used that here to illustrate the operation of the addin.

Note, that at this stage, only the VPC element has all the data attributes from the AWS model.  The rest of the entities are placeholders, with only the AWS internal identifier having been used to name the elements within EA.  On the right you can see the attributes/properties for the VPC element - this will be used in the following steps to produce the CloudFormation file.

3.  Transform to the CloudFormation Model 

A set of model transformation templates are used to transform the AWS model to a CloudFormation model for VPC elements.  Below is the resultant output.

SerAws-0.0.2-Screenshot3

 4. CloudFormation Code Generation

A set of code generation templates are used to generate the CloudFormation json file.  Below is the generated file.


{
   "AWSTemplateFormatVersion" : "2010-09-09",
   "Resources" : {
      "VPCEA" : {
         "Type" : "AWS::EC2::VPC",
         "Properties" : {
            "CidrBlock" : "10.0.0.0/16",
            "EnableDnsSupport" : "True",
            "EnableDnsHostnames" : "True",
            "InstanceTenancy" : "default",
            "Tags" : [
               {"Key" : "Name", "Value" : "VPC-EA"}
            ]
         }
      }
   }
}



As stated previously, although the addin is still not entirely useful, it should be in a sufficient state to prove the concept.  With the next version (0.0.3) what I'm aiming for is to round-trip the configuration of the complete EA repository I share with Paul.



[Originally posted here.]































Comments











Post a Comment























Popular posts from this blog









Creating Items in Sparx EA via Java






-















 Introduction   This short post provides guidance on how to create "things" in a Sparx EA model via the Java API.    Theory   Creating "things" in EA via Java is driven by the Add New method and the Collection class. The first example in the code is adding a "view" to an existing root node. The code below will retrieve the root GUID if the "i" variable is set to 0;     rootPackageID =  rep . GetModels (). GetAt ( i ). GetPackageGUID ();     After obtaining the root GUID it is possible to create a view under the root node. Note the process of retrieving the packages under the root and placing them in a collection. The Add New process is driven from the Collection.   Importantly, for a view, the code needs to set a flag which indicates a particular icon. This process is only required for views.    org . sparx . Package  root =  rep . GetPackageByGuid ( rootPackageID );   // get the root   Collection < org . sparx . Package >  subPackages =  r








Read more










Module Management - Part 1 - getModule() Pattern






-















As discussed in  Module Management - Analysis , EA does not provide support for the ubiquitous Module Pattern .  This becomes an issue with an increase in complexity of model addins.  In order to a) Minimise the management of dependencies, and b) Cater for the use of 3rd party modules, The  framework  provides an analogous pattern, which I'm calling the getModule() pattern, because I lack imagination.   The premise is straight forward.  Rather than having an anonymous self executing function returning a module object, we instead have module class elements which have a method called "getModule()"  and this returns a module object when the method is called.   The getModule() method would be declared (via the EA interface) on a class element, and then we would place all of the module's code in the body of the getModule() method/operation.  The method would return a module object to the caller.   The sample contents of a typical getModule() operation might look like this.








Read more










Traversing a EA Model via Java






-















   Traversing an Enterprise Architect model from Sparx Systems  is relatively simple. This blog introduces the concept of model traversal via the Java API. For information on Java Set-Up see this blog entry .     The first step is to obtain the repository object as it provides the anchor from which all other operations are derived.        In the example below, a repository is held on the file system. The variable "repoLocation" holds the file system location of the "eap" file.     rep = new Repository();  // get a repository    rep.OpenFile(repoLocation);  //open the repository file   At the top of a model is a root node and it is typically where you want to start when traversing a model. From the root node you can then obtain a collection of packages.   At this point, it is easy to traverse the collection pulling in the packages via a loop and in this example printing out their names.   To see the complete example, go to GitHub .            org.sparx.Package myMode








Read more