docs/report/introduction/methodology_aws/aws_ami.rst

   1 Amazon Machine Images
   2 ---------------------
   3
   4 An :abbr:`AMI (Amazon Machine Image)` provides the information required to
   5 launch an instance. CSIT is using Amazon :abbr:`EBS (Elastic Block Store)` where
   6 the root device for an instance launched from the AMI is a volume created from
   7 an Amazon EBS snapshot.
   8
   9 A the TG and SUT instances have slightly different software requirements,
  10 we are defining two AMIs for TG and SUT separately. AMI details examples:
  11
  12 TG:
  13 - AMI Name: csit_c5n_ubuntu_focal_tg
  14 - Platform details: Linux/UNIX
  15 - Architecture: x86_64
  16 - Usage operation: RunInstances
  17 - Image Type: machine
  18 - Virtualization type: hvm
  19 - Description: CSIT TG image based on Ubuntu Focal
  20 - Root Device Name: /dev/sda1
  21 - Root Device Type: ebs
  22
  23 SUT:
  24 - AMI Name: csit_c5n_ubuntu_focal_sut
  25 - Platform details: Linux/UNIX
  26 - Architecture: x86_64
  27 - Usage operation: RunInstances
  28 - Image Type: machine
  29 - Virtualization type: hvm
  30 - Description: CSIT SUT image based on Ubuntu Focal
  31 - Root Device Name: /dev/sda1
  32 - Root Device Type: ebs
  33
  34 Both TG and SUT AMIs are created manually before launching topology and are not
  35 part of automated scripts. To create CSIT AMIs:
  36
  37 ::
  38
  39   cd csit/fdio.infra.packer/aws_c5n/
  40   packer init
  41   packer build
  42
  43 Building AMIs requires Hashicorp Packer with Amazon plugin installed.
  44
  45 .. [aws_ami] `Amazon Machine Images <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html>`_