Install Toolkit for .NET Refactoring - AWS Toolkit for .NET Refactoring

Install Toolkit for .NET Refactoring

You can install Toolkit for .NET Refactoring within Microsoft Visual Studio, or the extension is available as part of license included Visual Studio Amazon Machine Images (AMIs) on Amazon EC2.

Install in Visual Studio

To install the Toolkit for .NET Refactoring extension, open Microsoft Visual Studio and complete the following steps:

  1. In Visual Studio, open the Extensions menu and select Manage Extensions.

  2. In the Manage Extensions window, search for Toolkit for .NET Refactoring. Select the extension and click Download.

  3. When the download is complete, Visual Studio prompts you to restart the application. Restart Visual Studio to install the Toolkit for .NET Refactoring extension.

Install with an AMI on Amazon EC2

If you are using a license included Visual Studio Amazon Machine Image (AMI) on Amazon EC2, you can use the caller role (refactoringtoolkit-RefactoringToolkitCallerRole) directly, without providing user credentials or editing configuration files. For more information about AMIs, see User-based subscriptions in AWS License Manager in the AWS License Manager User Guide.

The CloudFormation template creates an instance profile named refactoringtoolkit-Ec2InstanceProfile. For more information about the CloudFormation template, see Create roles and policies with CloudFormation in this guide.

You can launch an Amazon EC2 instance with an IAM role through the AWS Management Console or AWS CLI.

Launch an Amazon EC2 instance in the AWS Management Console

  1. Launch an instance. For more information, see Quickly launch an instance in the Amazon Elastic Compute Cloud User Guide for Linux Instances.

  2. Expand Advanced details, and in the IAM instance profile field, select refactoringtoolkit-Ec2InstanceProfile.

Launch an EC2 instance with AWS CLI

Use AWS CLI to launch an instance that uses the instance profile. For more information, see run-instances in the AWS CLI Command Reference.

The code below is an example command that illustrates how to launch an EC2 instance with the instance profile:

aws ec2 run-instances \ --image-id ami-11aa22bb \ --iam-instance-profile Name="s3access-profile" \ --key-name my-key-pair \ --security-groups my-security-group \ --subnet-id subnet-1a2b3c4d

For more information about instance profiles, see Using instance profiles in the AWS Identity and Access Management User Guide. For more information about using IAM roles with Amazon EC2 instances, see Using an IAM role to grant permissions to applications running on Amazon EC2 instances in the AWS Identity and Access Management User Guide. For information about retrieving credentials from instance metadata, see Retrieve security credentials from instance metadata in the Amazon Elastic Compute Cloud User Guide for Linux Instances.