Prerequisites to use AWS Microservice Extractor for .NET - AWS Microservice Extractor for .NET

Prerequisites to use AWS Microservice Extractor for .NET

This section describes the prerequisites for installing and using Microservice Extractor.

Prerequisites for analysis and extraction of monolithic application

To use Microservice Extractor to analyze and extract a monolithic application to deploy into smaller services, you must have the following:

  • A valid AWS CLI profile to publish metrics. For information about how to configure an AWS CLI profile, see Configuring the AWS CLI.

  • A monolithic application that must be one of the following:

    • A .NET Framework ASP.NET web service application hosted on IIS with the .NET Framework developer pack installed.

    • A .NET Core ASP.NET web service application with the developer pack installed.

  • The ability to build the application solution with MSBuild.

  • One of the following operating systems for analyzing the application and creating the visualization:

    • Windows 10 or later

    • Windows Server 2016 or later

  • For the application analysis, you must have:

    • .NET Framework version 4 or later, or .NET Core version 3.1 or later compatibility with source code solution.

    • 10 GB minimum of free disk space, in addition to the size of your application.

    • 8 GB minimum of available memory.

    • Compute power equivalent to or greater than that of an Intel Core i3 3-GHz processor.

  • For the extraction, you must have:

    • .NET Framework version 4.5 or later, or .NET Core version 3.1 or later compatibility with source code solution.

    • 20 GB minimum of free disk space, in addition to twice the size of your application.

Required AWS Identity and Access Management policies

To perform certain operations using AWS Microservice Extractor for .NET, you must attach AWS Identity and Access Management (IAM) policies to your IAM user. This section includes the policies that you must attach to your IAM user, and also instructions for attaching IAM policies to an IAM user.

You must use a valid AWS CLI profile to use the assessment tool and run the commands to complete an extraction. For information about how to configure your AWS CLI profile, see Configuring the AWS CLI.

How to attach an IAM policy to an IAM user

Perform the following steps to attach an IAM policy to an IAM user to grant permissions.

  1. Sign in to the AWS Management Console and open the IAM console at https://console.aws.amazon.com/iam/.

  2. In the left navigation pane, choose Policies.

  3. Choose Create policy.

  4. Choose the JSON tab and copy and paste the policy into the text box.

  5. Choose Review Policy and enter a Name and Description for the policy.

  6. Choose Create Policy.

  7. Filter the list of policies with the name of the policy that you just created.

  8. Select the radio button next to your new policy, and from the Policy actions dropdown, select Attach.

  9. Select the User name of the IAM user to which to attach the policy.

  10. Choose Attach policy.

  11. When you select an AWS profile from the dropdown in the Set up Microservice Extractor page of the tool, select the same IAM profile to which you attached the following permissions policies.

Permissions to use the AWS Microservice Extractor for .NET assessment tool

To use the AWS Microservice Extractor for .NET assessment tool, you must create an IAM policy that includes the following permissions attached to your IAM user. To view the type of application data collected by Microservice Extractor, see Information collected.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Resource": [ "*" ], "Action": [ "serviceextract:GetConfig" ] }, { "Sid": "SectionForMetricsService", "Effect": "Allow", "Action": "execute-api:invoke", "Resource": [ "arn:aws:execute-api:us-east-1:*:*/prod/POST/put-metric-data", "arn:aws:execute-api:us-east-1:*:*/prod/POST/put-log-data" ] } ] }