basic/minimal_setup_ami
このクラスタは、ゲーム AMI を設定するための最低限のインフラストラクチャを作成します。 IAM と VPC のリソースを渡す必要があります。
このモジュールの内容
プロバイダ
aws (~> 3.35.0)
要件
terraform >= 0.13
aws ~> 3.35.0
入力
- bastionid (string)
この bastion インスタンスの ID
- cluster (string)
クラスタの名称
- game_instance_profile_name (string)
ゲームインスタンスに指定するインスタンスプロフィール名。
- key_pair_private (string)
新規作成しないで、使用する Key Pair Private PEM
- key_pair_public (string)
新規作成しないで、使用する Key Pair Public Key
- trusted_cidr (string)
信頼する CIDR。少なくともローカルマシンの外部 CIDR (<ip>/32) が含まれている必要があります。含まれていない場合、Consul/Nomad への提供とアクセスは失敗します。
- vpc_id (string)
新しく作成する代わりに使用する VPC ID を指定します。これにより、クラスタ間で VPC を共有できます。
重要
VPCは
namespace-stage-public-az
という名前のサブネットを持つ必要があり、そうでない場合は失敗します。vpc_id
はこのように始まります。vpc-...
とします。
- admin_password (string)
Windows マシンの管理者パスワードです。Windows マシンは、他のサーバーインスタンス、または 2 に同じ外部 IP が設定された他のマシンからのみ、アクセス可能です。
デフォルト: 1genvid6
- ami_version (string)
使用する AMI (
wingame
およびserver
) のバージョンプレフィックス (例: 1.20.0 は、 1.20.0 および 1.20.0.0 の両バージョンに一致)。バージョンサフィックス付きの AMI を使用するには、サフィックス付きのバージョン全体を指定する必要があります (例: 1.28.0.1.mysuffix)。
デフォルト: 1.42.0
- azs (list(string))
リージョンのアベイラビリティゾーンの一覧。subnet_ids が az よりも優先されます。リストの最初の値のみが使用されます。
- datacenter (string)
Consul/Nomad datacenter
デフォルト: default
- instance_game_type (string)
サーバーで使用する EC2 インスタンスのタイプ
デフォルト: g5.xlarge
- region (string)
AWS デプロイメント領域
デフォルト: us-east-1
- setup_ami_owners (list(string))
有効なAMIが持つことのできる所有者のリスト。 デフォルトはGenvidのパブリックアカウントです。7 8
デフォルト: ['149754531711']
- setup_ami_prefix (string)
ゲームAMIの共通接頭辞です。これは AMI の保存 のセクションで使用している接頭辞です。独自のAMIで実験したい場合は、これを変更することができます。6 8
デフォルト: genvidtech
- subnet_ids (list(string))
使用可能なパブリックサブネットの順番リスト。指定しない場合、すべての AZ のすべてのサブネットとなります。
注釈
AZ に対してサブネットは一つのみ。したがって、AZ に複数のサブネットが存在する場合、この変数は必須であり、各 AZ で使用するパブリックサブネットの ID を指定する必要があります。subnet_ids が AZ よりも優先されます。3
- toolbox_location (string)
Genvid ツールボックス Wheel ファイル。
AMI からアップデートする場合にのみ必要。指定しない場合は、ツールボックスはインストールされません。
- trusted_cidrs (list(string))
信頼する CIDR リスト
- use_drive_encryption (bool)
暗号化された EBS にしたい場合は true を選択します。EBS を暗号化したくない場合や、SDK のバージョンを 1.24 以下から 1.25 以上にアップグレードする場合は、false を選択してください。4
警告
既存のドライブでこの機能を切り替えると、ドライブが再生されます。1.25 以前のバージョンではドライブは暗号化されていません。バージョン 1.25 以降、暗号化はデフォルトで有効になっています。
デフォルト: True
出力
- ami_version
- azs_selected
リージョンのアベイラビリティゾーンの一覧
- cluster
- game_instance_ids
- game_private_ips
- game_public_ips
- private_key_pem
- region
- subnet_ids
使用したサブネットの順番リストを指定します。
- subnet_selected
vpc で使用する選択されたサブネットの一覧
- subnets_available
利用可能と検出されたサブネットの一覧。
- 1
カスタムタグに加えて、Genvid はリソースに独自のタグを追加する権利を有します。文書化されていない場合は、後方互換性を保証することなく、Genvid で使用することを意図しています。
- 2
セキュリティ向上のため、将来のクラスタのバージョンでは bastion ホスト を使用する予定です。
- 3
バージョン 1.24.0 で追加.
- 4
バージョン 1.25.0 で追加.
- 5
バージョン 1.26.0 で追加.
- 6
バージョン 1.27.0 で追加.
- 7
バージョン 1.30.0 で変更:
ami_owner
からgame_ami_owners
へ名前が変更され、ストリングの一覧としました。- 8(1,2)
バージョン 1.38.0 で変更: 変数が基本的なミニマムクラスタに使用されているものと意味合いが異なるため、
game_ami_*
からsetup_ami_*
に改名されました。