basic/setup_ami

This cluster creates the minimal infrastructure for setting up a Game AMI.

Terraform module path is changed from basic/setup-ami to basic/setup_ami [5]

Providers

  • aws (~> 3.35.0)
  • tls

Requirements

  • terraform >= 0.13
  • aws ~> 3.35.0

Inputs

bastionid (string)

Id of this bastion instance

cluster (string)

Name of your cluster

trusted_cidr (string)

CIDR to be trusted. This should at least contain the external CIDR (<ip>/32) for the local machine. Otherwise, the provision and access to Consul/Nomad will fail.

admin_password (string)

The administrator password for the Windows machine. The Windows machine is only accessible from the other server instances and from other machines that share the same external IP as yours [2].

Default: 1genvid6

ami_version (string)

Version prefix of the AMIs (both wingame and server) to use (ex: 1.20.0 will match both 1.20.0 and 1.20.0.0 versions).

In order to use an AMI with a version suffix, the whole version with the suffix must be specified (ex: 1.28.0.1.mysuffix)

Default: 1.36.0

custom_tags (map(string))

Map of user defined tags to add to all cloud resources.

datacenter (string)

Consul/Nomad datacenter

Default: default

game_ami_owners (list(string))

The list of owners that a valid AMI can have. Default to Genvid public account.

Changed in version 1.30.0: Renamed from ami_owner to game_ami_owners and made it a list of strings.

Default: [‘149754531711’]

game_ami_prefix (string)

A common prefix for the game AMI. This is the prefix we use in the Save the AMI section. You can change it if you want to experiment with your own AMI. [5]

Default: genvidtech

game_az (string)

AWS Availability Zone where the game instance is to be created.

Default: a

game_instance_profile_name (string)

The instance profile name to provide for the game instances.

iam_policy_auto_create (bool)

Flag for enabling automatic creation of IAM pofiles

Default: True

instance_game_type (string)

Type of EC2 instance to use for server

Default: g5.xlarge

region (string)

AWS deployment region

Default: us-east-1

toolbox_location (string)

Genvid Toolbox Wheel file.

Only required if you need to update the one from the AMI. An empty value indicates to not install the toolbox.

trusted_cidrs (list(string))

A list of CIDR to be trusted

use_drive_encryption (bool)

If you want to have encrypted EBS, select true. If you do not want to have encypted EBS, or you are upgrading the SDK version from 1.24 or below to 1.25 or higher, select false.

Turning on encryption prevents AMIs from being transferable between regions or OUs.

Warning

Your drives will be recreated if you toggle this feature with existing drives. Prior to 1.25, the drives were not encrypted. Starting with version 1.25 the encryption is enabled by default.

Outputs

ami_version
cluster
game_instance_ids
game_private_ips
game_public_ips
private_key_pem
region
[1]In addition to custom tags, Genvid reserves the right to add its own tags on resources. If they are not documented, they are intended to be used by Genvid without any guarantee of backward compatibility.
[2]Future versions of the Cluster will use a bastion host instead for increased security.
[3]

New in version 1.25.0.

[4]

New in version 1.26.0.

[5](1, 2)

New in version 1.27.0.