docs/report/introduction/methodology_aws/aws_ami.rst

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