Skip to main content

Installing Service Workbench using Cloud9

You can install Service Workbench by using AWS Cloud9. This section provides information about the installation procedure for Service Workbench using AWS Cloud9 IDE.

SectionDescription
Creating AWS Cloud9 instanceDescribes the steps to create an AWS Cloud9 instance that will be used for Service Workbench installation.
Modifying the volumeDescribes the steps to modify the volume size.
Increasing the partitionDescribes the commands to increase the partition size for Service Workbench installation.
Installing Node Package ManagerDescribes the commands to install Node Package Manager.
Cloning the Git directoryDescribes the commands to clone Git directory that contains Service Workbench installation.
Making a copy of the environment fileDescribes the steps to make a copy of the environment file and make required settings inside the file for Service Workbench installation.
Running the script to install Service WorkbenchDescribes the steps to install Service Workbench.

Creating AWS Cloud9 instance

  1. Go to the AWS Cloud9 product page.
  2. Choose the Create environment button.
  3. Enter the name and description for the AWS Cloud9 environment.
  4. Choose Next step.
  5. For Instance type, choose m5.large (8 GiB + 2 vCPU).
  6. For Platform, choose Amazon Linux 2.
  7. Choose Next step.
  8. Review all the changes and choose Create environment.

Modifying the volume

For information on modifying the volume, refer to Resize an Amazon EBS volume used by an environment.

Increasing the partition

To increase the partition size, type the following command:

sudo growpart /dev/nvme0n1 1

Increase the file system inside the partition

sudo xfs_growfs –d /

For more information on partitioning, read Moving an environment and resizing/encrypting Amazon EBS volumes

Install Packer

Packer is used to build AMIs. For steps on packer installation, refer to the README.

Verifying the file size

To verify the file size, type: df –hT

Check the node version installed

Type node --version

To install long-term support version, enter:

nvm install 16

Installing Node Package Manager

npm install –g pnpm

Verify the Go version

go version

Note: Install everything in one directory.

Cloning the Git directory

git clone https://github.com/awslabs/service-workbench-on-aws-cn.git

Making a copy of the environment file

1. In the file explorer, choose example.yml.

  1. Copy this file and create a new version. Example, dev.yml.

  2. Uncomment the following in dev.yml:

    • awsRegion: us-east-1
    • solutionName: sw
    • envType: dev
    • createServiceCatalogPortfolio: true

4.Save dev.yml.

Running the script to install Service Workbench

scripts/environment-deploy.sh <stage> Example: scripts/environment-deploy.sh dev

Copying CloudFront URL details

Once the installation completes, the following details are displayed on your screen. Note the website URL and the root password. You can use this URL and password to sign in to Service Workbench.