basic/minimal_cluster¶
IAM や VPC のリソースを持たない AWS 向けの基本的なクラスタです。このようなリソースを作成できない場合や、共有したい場合に便利です。
このモジュールは、以下の主なリソースを作成することで、 SDK クラスタをデプロイすることができます: - EC2 サーバー (SGroups)
Content of this module
入力¶
-
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
-
server_instance_profile_name (string)
サーバー、エンコード、内部、パブリックインスタンスに指定するインスタンスプロフィール名。
-
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 (ゲームおよび genvid) のバージョンプレフィックス (例: 1.20.0 は、 1.20.0 および 1.20.0.0 の両バージョンに一致)。
バージョンサフィックス付きの AMI を使用するには、サフィックス付きのバージョン全体を指定する必要があります (例: 1.28.0.1.mysuffix)。
Default: 1.29.0
-
azs (list(string))
リージョンのアベイラビリティゾーンの一覧。subnet_ids が az よりも優先されます。[3]
-
datacenter (string)
Consul/Nomad datacenter
デフォルト: default
-
game_ami_prefix (string)
ゲーム AMI の共通プレフィックスです。 AMI の保存 のセクションで使用したプレフィックスです。自分の AMI でテストしたい場合は、変更することができます。[6]
デフォルト: default
-
instance_encoding_count (number)
生成する内部ワーカー数
デフォルト: 1
-
instance_encoding_type (string)
エンコーディングサーバーで使用する EC2 インスタンスのタイプ
デフォルト: c5.2xlarge
-
instance_game_count (number)
生成されるゲームインスタンス数
デフォルト: 1
-
instance_game_type (string)
ゲームサーバーで使用する EC2 インスタンスのタイプ
デフォルト: g4dn.xlarge
-
instance_internal_count (number)
生成する内部ワーカー数
デフォルト: 1
-
instance_internal_type (string)
内部サーバーで使用する EC2 インスタンスのタイプ
デフォルト: t2.small
-
instance_public_count (number)
生成するパブリックワーカー数
デフォルト: 1
-
instance_public_type (string)
パブリックサーバーで使用する EC2 インスタンスのタイプ
デフォルト: t2.small
-
instance_server_count (number)
監視サーバー数。奇数である必要があります。プロダクションのデプロイの場合、通常は 3 です。
デフォルト: 1
-
instance_server_type (string)
管理サーバーで使用する EC2 インスタンスのタイプ
デフォルト: t2.small
-
region (string)
AWS デプロイメント領域
デフォルト: us-east-1
-
server_ami_prefix (string)
サーバー AMI の共通プレフィックスです。自分の AMI でテストしたい場合は、変更することができます。[6]
デフォルト: genvidtech
-
subnet_ids (list(string))
使用可能なパブリックサブネットの順番リスト。指定しない場合、サブネットは利用可能なアベイラビリティゾーンから自動的に選択されます。注釈: AZ に対してサブネットは一つのみ。したがって、AZ に複数のサブネットが存在する場合、この変数は必須であり、各 AZ で使用するパブリックサブネットの ID を指定する必要があります。subnet_ids が AZ よりも優先されます。[3]
-
toolbox_location (string)
Genvid ツールボックス Wheel ファイル。
AMI からアップデートする場合にのみ必要。指定しない場合は、ツールボックスはインストールされません。
-
trusted_cidrs (list(string))
信頼する CIDR リスト。
-
trusted_security_groups (list(string))
信頼するセキュリティグループの一覧。
-
use_drive_encryption (bool)
暗号化された EBS にしたい場合は true を選択します。EBS を暗号化したくない場合や、SDK のバージョンを 1.24 以下から 1.25 以上にアップグレードする場合は、false を選択してください。
警告
既存のドライブでこの機能を切り替えると、ドライブが再生されます。1.25 以前のバージョンではドライブは暗号化されていません。バージョン 1.25 以降、暗号化はデフォルトで有効になっています。
デフォルト: True
出力¶
-
azs_available
使用可能と検出されたアベイラビリティゾーンの一覧。
-
azs_selected
使用するために選択したアベイラビリティゾーンの一覧。
-
cluster
クラスタの名称
-
consul_nodes
Consul ノード
-
encoding_worker_private_ips
エンコードインスタンスのプライベート IP アドレス
-
encoding_worker_public_ips
エンコードインスタンスのパブリック IP アドレス
-
game_instance_profile_name
ゲームインスタンスで使用するインスタンスプロフィール名
-
game_private_ips
ゲームインスタンスのプライベート IP アドレス
-
game_public_ips
ゲームインスタンスのパブリック IP アドレス
-
internal_worker_private_ips
内部インスタンスのプライベート IP アドレス
-
internal_worker_public_ips
内部インスタンスのパブリック IP アドレス
-
private_key_pem
SSH や RDP でインスタンスに接続するためのプライベートキー
-
public_key
AWS が認証に使用するインスタンスに接続するためのパブリックキー
-
public_worker_private_ips
パブリックインスタンスのプライベート IP アドレス
-
public_worker_public_ips
パブリックインスタンスのパブリック IP アドレス
-
region
領域
-
server_instance_profile_name
サーバー、エンコード、内部、パブリックインスタンスで使用するインスタンスプロフィール名
-
server_private_ips
サーバーインスタンスのプライベート IP アドレス
-
server_public_ips
サーバーインスタンスのパブリック IP アドレス
-
subnet_available
var.subnet_ids が空の場合に、利用可能と検出されたサブネットの一覧
-
subnet_selected
vpc で使用する選択されたサブネットの一覧
-
vpc_id_selected
選択した VPC の ID
[1] | カスタムタグに加えて、Genvid はリソースに独自のタグを追加する権利を有します。文書化されていない場合は、後方互換性を保証することなく、Genvid で使用することを意図しています。 |
[2] | セキュリティ向上のため、将来のクラスタのバージョンでは bastion ホスト を使用する予定です。 |
[3] | (1, 2) バージョン 1.24.0 で追加. |
[4] | バージョン 1.25.0 で追加. |
[5] | バージョン 1.26.0 で追加. |
[6] | (1, 2) バージョン 1.27.0 で追加. |