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