Skip to content

Latest commit

 

History

History
71 lines (47 loc) · 4 KB

README.md

File metadata and controls

71 lines (47 loc) · 4 KB
Raw

Arm Virtual Hardware AWS-CloudFormation

The following section describes how to setup the AWS infrastructure for using the Arm Virtual Hardware Amazon Machine Image (AMI). Using a template file creates the setup that is for example required to run Arm Virtual Hardware with a GitHub-hosted Runner.

Prerequisites

What is Created

The Arm-VHT-CloudFormation-Template.yaml is a AWS CloudFormation template that creates the following AWS infrastructure items:

  • One S3 Bucket (to store temporary files)
  • One EC2 Security Group (to be associated with the EC2 instances)
  • One IAM User and Access Keys (to limit access rights in the AWS)
  • One IAM Role (to be associated with the EC2 Instances)

Required User Input

  • S3BucketName that identifies the S3 Bucket.
  • VpcId to be associated with the EC2 Security Group.

Provided Output

Resources to be used with Arm VHT AMI (see below in step 12).

How to run it for the first time

  1. Download the file Arm-VHT-CloudFormation-Template.yaml to your computer.

  2. Sign in with your AWS account on aws.amazon.com to open the AWS Management Console page.

  3. Type Cloudformation in the search and proceed to the corresponding AWS service page.

  4. Click the Create stack button.

  1. Select Template is ready option, and then Upload a template file.

  2. With the Choose file button select the file Arm-VHT-CloudFormation-Template.yaml downloaded in step 1.

  3. Click Next.

  1. Specify stack details as follows:
    • Stack name: use any name, for example Arm-VHT-Stack.
    • S3BucketName: shall have only small letters and numbers and be unique across AWS, as otherwise stack creation will fail later.
    • Vpcid: provide VPC ID for your target region. This can be found in VPC AWS service.

  1. On Configure stack options page keep default values and press Next.

  2. On Review page:

    • Acknowledge that a new AWS IAM User and AWS IAM AccessKey will be created.
    • Press Create stack.

  1. The infrastructure described in the template file will be provisioned. In Events tab you can follow the creation process. Use refresh button if the page does not get updated automatically. After a few minutes the stack creation should be successfully completed.

  1. Go to the created stack and in the Output tab, find the values for the parameters needed for using an Arm Virtual Hardware AMI:
    • VHTEC2SecurityGroupId: the name of created EC2 security group.
    • VHTS3BucketName: the name of created S3 bucket. It has the same value as provided in step 8.
    • VHTIAMProfile: the name of created IAM Instance Profile.
    • VHTAccessKeyId: the access key id for the IAM User created in the stack.
    • VHTSecretAccessKey: the secret access key value for the VHTAccessKeyId. See access key pair for details.

Note that when the cloud stack is not needed anymore CloudFormation service can be also used to easily delete the stack including all the provisioned resources. In this case it need to be ensured that the EC2 instance associated with the created EC2 Security Group is terminated before stack delete is started.