basic/minimal_setup_ami¶
This cluster creates the minimal infrastructure for setting up a Game AMI. You must pass it the IAM and VPC resources.
Content of this module
Requirements¶
- terraform >= 0.12
Inputs¶
-
cluster (string)
Name of your cluster
-
key_pair_private (string)
Key Pair Private PEM to use instead of creating a new one
-
key_pair_public (string)
Key Pair Public Key to use instead of creating a new one
-
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.
-
vpc_id (string)
VPC ID to use instead of creating a new one
-
admin_password (string)
Administrative password for the game machine
-
ami_version (string)
Version prefix of the AMIs (both game and genvid) 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.25.0.1.mysuffix)
-
azs (list(string))
A list of availability zones in the region. subnet_ids takes precedence over azs. Only the first value from the list is used.
-
datacenter (string)
Consul/Nomad datacenter
-
game_az (string)
AWS Availability Zone where the game instance is to be created.
-
game_instance_profile_name (string)
The instance profile name to provide for the game instances.
-
instance_game_type (string)
Type of EC2 instance to use for server
-
namespace (string)
Deployment namespace that will regroup the clusters
-
region (string)
AWS deployment region
-
stage (string)
Deployment stage
-
subnet_ids (list(string))
Only the first value of subnet_ids is used. if not set, we will use the first AZs, if not set we will use the first subnet found in vpc_id.
New in version 1.24.0.
-
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, select false.
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
-
azs_selected
A list of availability zones in the region
-
cluster
-
game_instance_ids
-
game_private_ips
-
game_public_ips
-
private_key_pem
-
region
-
subnet_ids
Specifies an ordered list of subnets that was used.
-
subnet_selected
A list of selected subnets to use in the vpc
-
subnets_available
List of subnets that were detected as available to use.