Get Started

Introduction

The AWS Blu Age Refactoring Tool allows altering the outputs of the Transform action on the Transformation Center before they're fed to the Generate action. It is distributed as a standalone tool to assist in developing Refactor configurations (Java refactoring projects) to be used on the Transformation Center.

The goal of this page is to document the access to the Refactoring Tool.

Prerequisites

Toolbox buckets are replicated on the us-east-1 and us-east-2 regions. To use these replicated buckets, append the region to the bucket name: e.g. s3://toolbox-refactoring-tool-us-east-1. Make sure to adapt your user or role policy accordingly.

• The first step is to request access to the tool on Blu Age Toolbox. The access is restricted to L3 certified individuals.

• Once the Blu Age toolbox request is processed and approved, the bucket s3://toolbox-refactoring-tool will be accessible from the account specified in the request.

• S3 read permissions are required on the principal accessing the bucket from the authorized account. Below is an example policy allowing all read actions on the bucket:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetBucket*", 
        "s3:GetObject*", 
        "s3:List*"
      ],
      "Resource": [
        "arn:aws:s3:::toolbox-refactoring-tool",
        "arn:aws:s3:::toolbox-refactoring-tool/*"
      ]
    }
  ]
}

Usage

The bucket content can be listed by running the following AWS CLI command.

aws s3 ls s3://toolbox-refactoring-tool

This command returns a list of folders that correspond to different versions of the Refactoring tool. Example response:

PRE 3.10.0/
PRE 3.10.0.1/

The content of a specific version folder can be listed by running the following command (using the version 3.10.0.1 as an example):

aws s3 ls s3://toolbox-refactoring-tool/3.10.0.1/

The command returns the list of artifacts on that folder. Example response:

2024-02-08 16:55:30    1685701 gapwalk-3.10.0.1-toolbox-flat.zip
2024-02-08 16:55:31    1700551 gapwalk-3.10.0.1-toolbox-maven.zip

A specific version of the tool can be downloaded to the current the local directory by running the following command (still using 3.10.0.1 as an example):

aws s3 cp s3://toolbox-refactoring-tool/3.10.0.1/gapwalk-3.10.0.1-toolbox-maven.zip .

The . at the end means that the target folder is the current local directory. It can be replaced with any local path to download the tool to a different directory.