basic/minimal_setup_ami

このクラスタは、ゲーム AMI を設定するための最低限のインフラストラクチャを作成します。 IAM と VPC のリソースを渡す必要があります。

Content of this module

プロバイダ

  • 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.32.0

azs (list(string))

リージョンのアベイラビリティゾーンの一覧。subnet_ids が az よりも優先されます。リストの最初の値のみが使用されます。

custom_tags (map(string))

すべてのクラウドリソースに追加するユーザー定義タグのマップ。 [1] [5]

datacenter (string)

Consul/Nomad datacenter

デフォルト: default

game_ami_owners (list(string))

有効な AMI が持つことのできるオーナーの一覧。 デフォルトで Genvid パブリックアカウント。

バージョン 1.30.0 で変更: ami_owner から game_ami_owners へ名前が変更され、ストリングの一覧としました。

デフォルト: [『149754531711』]

game_ami_prefix (string)

ゲーム AMI の共通プレフィックスです。 AMI の保存 のセクションで使用したプレフィックスです。自分の AMI でテストしたい場合は、変更することができます。[6]

デフォルト: genvidtech

instance_game_type (string)

サーバーで使用する EC2 インスタンスのタイプ

デフォルト: g4dn.xlarge

region (string)

AWS デプロイメント領域

デフォルト: us-east-1

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 で追加.