@aws-cdk/aws-gamelift-alpha 2.105.0-alpha.0 → 2.106.1-alpha.0

package/.jsii

@@ -8,7 +8,7 @@
     "url": "https://aws.amazon.com"
   },
   "dependencies": {
-    "aws-cdk-lib": "^2.105.0",
+    "aws-cdk-lib": "^2.106.1",
     "constructs": "^10.0.0"
   },
   "dependencyClosure": {
@@ -3557,7 +3557,7 @@
     "stability": "experimental"
   },
   "homepage": "https://github.com/aws/aws-cdk",
-  "jsiiVersion": "5.2.9 (build 00bbc31)",
+  "jsiiVersion": "5.2.26 (build ba8b169)",
   "keywords": [
     "aws",
     "cdk",
@@ -3578,7 +3578,7 @@
   },
   "name": "@aws-cdk/aws-gamelift-alpha",
   "readme": {
-    "markdown": "# Amazon GameLift Construct Library\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\n[Amazon GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-intro.html) is a service used\nto deploy, operate, and scale dedicated, low-cost servers in the cloud for session-based multiplayer games. Built\non AWS global computing infrastructure, GameLift helps deliver high-performance, high-reliability game servers\nwhile dynamically scaling your resource usage to meet worldwide player demand.\n\nGameLift is composed of three main components:\n\n* GameLift FlexMatch which is a customizable matchmaking service for\nmultiplayer games. With FlexMatch, you can\nbuild a custom set of rules that defines what a multiplayer match looks like\nfor your game, and determines how to\nevaluate and select compatible players for each match. You can also customize\nkey aspects of the matchmaking\nprocess to fit your game, including fine-tuning the matching algorithm.\n\n* GameLift hosting for custom or realtime servers which helps you deploy,\noperate, and scale dedicated game servers. It regulates the resources needed to\nhost games, finds available game servers to host new game sessions, and puts\nplayers into games.\n\n* GameLift FleetIQ to optimize the use of low-cost Amazon Elastic Compute Cloud\n(Amazon EC2) Spot Instances for cloud-based game hosting. With GameLift\nFleetIQ, you can work directly with your hosting resources in Amazon EC2 and\nAmazon EC2 Auto Scaling while taking advantage of GameLift optimizations to\ndeliver inexpensive, resilient game hosting for your players\n\nThis module is part of the [AWS Cloud Development Kit](https://github.com/aws/aws-cdk) project. It allows you to define components for your matchmaking\nconfiguration or game server fleet management system.\n\n## GameLift FlexMatch\n\n### Defining a Matchmaking configuration\n\nFlexMatch is available both as a GameLift game hosting solution (including\nRealtime Servers) and as a standalone matchmaking service. To set up a\nFlexMatch matchmaker to process matchmaking requests, you have to create a\nmatchmaking configuration based on a RuleSet.\n\nMore details about matchmaking ruleSet are covered [below](#matchmaking-ruleset).\n\nThere is two types of Matchmaking configuration:\n\nThrough a game session queue system to let FlexMatch forms matches and uses the specified GameLift queue to start a game session for the match.\n\n```ts\ndeclare const queue: gamelift.GameSessionQueue;\ndeclare const ruleSet: gamelift.MatchmakingRuleSet;\n\nnew gamelift.QueuedMatchmakingConfiguration(this, 'QueuedMatchmakingConfiguration', {\n  matchmakingConfigurationName: 'test-queued-config-name',\n  gameSessionQueues: [queue],\n  ruleSet: ruleSet,\n});\n```\n\nOr through a standalone version to let FlexMatch forms matches and returns match information in an event.\n\n```ts\ndeclare const ruleSet: gamelift.MatchmakingRuleSet;\n\nnew gamelift.StandaloneMatchmakingConfiguration(this, 'StandaloneMatchmaking', {\n  matchmakingConfigurationName: 'test-standalone-config-name',\n  ruleSet: ruleSet,\n});\n```\n\n\nMore details about Game session queue are covered [below](#game-session-queue).\n\n### Matchmaking RuleSet\n\nEvery FlexMatch matchmaker must have a rule set. The rule set determines the\ntwo key elements of a match: your game's team structure and size, and how to\ngroup players together for the best possible match.\n\nFor example, a rule set might describe a match like this: Create a match with\ntwo teams of four to eight players each, one team is the cowboy and the other\nteam the aliens. A team can have novice and experienced players, but the\naverage skill of the two teams must be within 10 points of each other. If no\nmatch is made after 30 seconds, gradually relax the skill requirements.\n\n```ts\nnew gamelift.MatchmakingRuleSet(this, 'RuleSet', {\n  matchmakingRuleSetName: 'my-test-ruleset',\n  content: gamelift.RuleSetContent.fromJsonFile(path.join(__dirname, 'my-ruleset/ruleset.json')),\n});\n```\n\n### FlexMatch Monitoring\n\nYou can monitor GameLift FlexMatch activity for matchmaking configurations and\nmatchmaking rules using Amazon CloudWatch. These statistics are used to provide\na historical perspective on how your Gamelift FlexMatch solution is performing.\n\n#### FlexMatch Metrics\n\nGameLift FlexMatch sends metrics to CloudWatch so that you can collect and\nanalyze the activity of your matchmaking solution, including match acceptance\nworkflow, ticket consumtion.\n\nYou can then use CloudWatch alarms to alert you, for example, when matches has\nbeen rejected (potential matches that were rejected by at least one player\nsince the last report) exceed a certain thresold which could means that you may\nhave an issue in your matchmaking rules.\n\nCDK provides methods for accessing GameLift FlexMatch metrics with default configuration,\nsuch as `metricRuleEvaluationsPassed`, or `metricRuleEvaluationsFailed` (see\n[`IMatchmakingRuleSet`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-gamelift.IMatchmakingRuleSet.html)\nfor a full list). CDK also provides a generic `metric` method that can be used\nto produce metric configurations for any metric provided by GameLift FlexMatch;\nthe configurations are pre-populated with the correct dimensions for the\nmatchmaking configuration.\n\n```ts\ndeclare const matchmakingRuleSet: gamelift.MatchmakingRuleSet;\n// Alarm that triggers when the per-second average of not placed matches exceed 10%\nconst ruleEvaluationRatio = new cloudwatch.MathExpression({\n  expression: '1 - (ruleEvaluationsPassed / ruleEvaluationsFailed)',\n  usingMetrics: {\n    ruleEvaluationsPassed: matchmakingRuleSet.metricRuleEvaluationsPassed({ statistic: cloudwatch.Statistic.SUM }),\n    ruleEvaluationsFailed: matchmakingRuleSet.metric('ruleEvaluationsFailed'),\n  },\n});\nnew cloudwatch.Alarm(this, 'Alarm', {\n  metric: ruleEvaluationRatio,\n  threshold: 0.1,\n  evaluationPeriods: 3,\n});\n```\n\nSee: [Monitoring Using CloudWatch Metrics](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html)\nin the *Amazon GameLift Developer Guide*.\n\n\n## GameLift Hosting\n\n### Uploading builds and scripts to GameLift\n\nBefore deploying your GameLift-enabled multiplayer game servers for hosting with the GameLift service, you need to upload\nyour game server files. This section provides guidance on preparing and uploading custom game server build\nfiles or Realtime Servers server script files. When you upload files, you create a GameLift build or script resource, which\nyou then deploy on fleets of hosting resources.\n\nTo troubleshoot fleet activation problems related to the server script, see [Debug GameLift fleet issues](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-creating-debug.html).\n\n#### Upload a custom server build to GameLift\n\nBefore uploading your configured game server to GameLift for hosting, package the game build files into a build directory.\nThis directory must include all components required to run your game servers and host game sessions, including the following:\n\n* Game server binaries – The binary files required to run the game server. A build can include binaries for multiple game\nservers built to run on the same platform. For a list of supported platforms, see [Download Amazon GameLift SDKs](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-supported.html).\n\n* Dependencies – Any dependent files that your game server executables require to run. Examples include assets, configuration\nfiles, and dependent libraries.\n\n* Install script – A script file to handle tasks that are required to fully install your game build on GameLift hosting\nservers. Place this file at the root of the build directory. GameLift runs the install script as part of fleet creation.\n\nYou can set up any application in your build, including your install script, to access your resources securely on other AWS\nservices.\n\n```ts\ndeclare const bucket: s3.Bucket;\nconst build = new gamelift.Build(this, 'Build', {\n  content: gamelift.Content.fromBucket(bucket, \"sample-asset-key\")\n});\n\nnew CfnOutput(this, 'BuildArn', { value: build.buildArn });\nnew CfnOutput(this, 'BuildId', { value: build.buildId });\n```\n\n#### Upload a realtime server Script\n\nYour server script can include one or more files combined into a single .zip file for uploading. The .zip file must contain\nall files that your script needs to run.\n\nYou can store your zipped script files in either a local file directory or in an Amazon Simple Storage Service (Amazon S3)\nbucket or defines a directory asset which is archived as a .zip file and uploaded to S3 during deployment.\n\nAfter you create the script resource, GameLift deploys the script with a new Realtime Servers fleet. GameLift installs your\nserver script onto each instance in the fleet, placing the script files in `/local/game`.\n\n```ts\ndeclare const bucket: s3.Bucket;\nnew gamelift.Script(this, 'Script', {\n  content: gamelift.Content.fromBucket(bucket, \"sample-asset-key\")\n});\n```\n\n### Defining a GameLift Fleet\n\n#### Creating a custom game server fleet\n\nYour uploaded game servers are hosted on GameLift virtual computing resources,\ncalled instances. You set up your hosting resources by creating a fleet of\ninstances and deploying them to run your game servers. You can design a fleet\nto fit your game's needs.\n\n```ts\nnew gamelift.BuildFleet(this, 'Game server fleet', {\n  fleetName: 'test-fleet',\n  content: gamelift.Build.fromAsset(this, 'Build', path.join(__dirname, 'CustomerGameServer')),\n  instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  runtimeConfiguration: {\n    serverProcesses: [{\n      launchPath: 'test-launch-path',\n    }],\n  },\n});\n```\n\n### Managing game servers launch configuration\n\nGameLift uses a fleet's runtime configuration to determine the type and number\nof processes to run on each instance in the fleet. At a minimum, a runtime\nconfiguration contains one server process configuration that represents one\ngame server executable. You can also define additional server process\nconfigurations to run other types of processes related to your game. Each\nserver process configuration contains the following information:\n\n* The file name and path of an executable in your game build.\n\n* Optionally Parameters to pass to the process on launch.\n\n* The number of processes to run concurrently.\n\nA GameLift instance is limited to 50 processes running concurrently.\n\n```ts\ndeclare const build: gamelift.Build;\n// Server processes can be delcared in a declarative way through the constructor\nconst fleet = new gamelift.BuildFleet(this, 'Game server fleet', {\n  fleetName: 'test-fleet',\n  content: build,\n  instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  runtimeConfiguration: {\n    serverProcesses: [{\n      launchPath: '/local/game/GameLiftExampleServer.x86_64',\n      parameters: '-logFile /local/game/logs/myserver1935.log -port 1935',\n      concurrentExecutions: 100,\n    }]\n  }\n});\n```\n\nSee [Managing how game servers are launched for hosting](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-multiprocess.html)\nin the *Amazon GameLift Developer Guide*.\n\n### Defining an instance type\n\nGameLift uses Amazon Elastic Compute Cloud (Amazon EC2) resources, called\ninstances, to deploy your game servers and host game sessions for your players.\nWhen setting up a new fleet, you decide what type of instances your game needs\nand how to run game server processes on them (using a runtime configuration). All instances in a fleet use the same type of resources and the same runtime\nconfiguration. You can edit a fleet's runtime configuration and other fleet\nproperties, but the type of resources cannot be changed.\n\n```ts\ndeclare const build: gamelift.Build;\nnew gamelift.BuildFleet(this, 'Game server fleet', {\n  fleetName: 'test-fleet',\n  content: build,\n  instanceType: ec2.InstanceType.of(ec2.InstanceClass.C5, ec2.InstanceSize.LARGE),\n  runtimeConfiguration: {\n    serverProcesses: [{\n      launchPath: '/local/game/GameLiftExampleServer.x86_64',\n    }]\n  }\n});\n```\n\n### Using Spot instances\n\nWhen setting up your hosting resources, you have the option of using Spot\nInstances, On-Demand Instances, or a combination.\n\nBy default, fleet are using on demand capacity.\n\n```ts\ndeclare const build: gamelift.Build;\nnew gamelift.BuildFleet(this, 'Game server fleet', {\n  fleetName: 'test-fleet',\n  content: build,\n  instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  runtimeConfiguration: {\n    serverProcesses: [{\n      launchPath: '/local/game/GameLiftExampleServer.x86_64',\n    }]\n  },\n  useSpot: true\n});\n```\n\n### Allowing Ingress traffic\n\nThe allowed IP address ranges and port settings that allow inbound traffic to\naccess game sessions on this fleet.\n\nNew game sessions are assigned an IP address/port number combination, which\nmust fall into the fleet's allowed ranges. Fleets with custom game builds must\nhave permissions explicitly set. For Realtime Servers fleets, GameLift\nautomatically opens two port ranges, one for TCP messaging and one for UDP.\n\n```ts\ndeclare const build: gamelift.Build;\n\nconst fleet = new gamelift.BuildFleet(this, 'Game server fleet', {\n  fleetName: 'test-fleet',\n  content: build,\n  instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  runtimeConfiguration: {\n    serverProcesses: [{\n      launchPath: '/local/game/GameLiftExampleServer.x86_64',\n    }]\n  },\n  ingressRules: [{\n    source: gamelift.Peer.anyIpv4(),\n    port: gamelift.Port.tcpRange(100, 200),\n  }]\n});\n// Allowing a specific CIDR for port 1111 on UDP Protocol\nfleet.addIngressRule(gamelift.Peer.ipv4('1.2.3.4/32'), gamelift.Port.udp(1111));\n```\n\n### Managing locations\n\nA single Amazon GameLift fleet has a home Region by default (the Region you\ndeploy it to), but it can deploy resources to any number of GameLift supported\nRegions. Select Regions based on where your players are located and your\nlatency needs.\n\nBy default, home region is used as default location but we can add new locations if needed and define desired capacity\n\n```ts\ndeclare const build: gamelift.Build;\n\n// Locations can be added directly through constructor\nconst fleet = new gamelift.BuildFleet(this, 'Game server fleet', {\n  fleetName: 'test-fleet',\n  content: build,\n  instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  runtimeConfiguration: {\n    serverProcesses: [{\n      launchPath: '/local/game/GameLiftExampleServer.x86_64',\n    }]\n  },\n  locations: [ {\n    region: 'eu-west-1',\n    capacity: {\n      desiredCapacity: 5,\n      minSize: 2,\n      maxSize: 10\n    }\n  }, {\n    region: 'us-east-1',\n    capacity: {\n      desiredCapacity: 5,\n      minSize: 2,\n      maxSize: 10\n    }\n  }]\n});\n\n// Or through dedicated methods\nfleet.addLocation('ap-southeast-1', 5, 2, 10);\n```\n\n### Specifying an IAM role for a Fleet\n\nSome GameLift features require you to extend limited access to your AWS\nresources. This is done by creating an AWS IAM role. The GameLift Fleet class\nautomatically created an IAM role with all the minimum necessary permissions\nfor GameLift to access your resources. If you wish, you may\nspecify your own IAM role.\n\n```ts\ndeclare const build: gamelift.Build;\nconst role = new iam.Role(this, 'Role', {\n  assumedBy: new iam.CompositePrincipal(new iam.ServicePrincipal('gamelift.amazonaws.com'))\n});\nrole.addManagedPolicy(iam.ManagedPolicy.fromAwsManagedPolicyName('CloudWatchAgentServerPolicy'));\n\nconst fleet = new gamelift.BuildFleet(this, 'Game server fleet', {\n  fleetName: 'test-fleet',\n  content: build,\n  instanceType: ec2.InstanceType.of(ec2.InstanceClass.C5, ec2.InstanceSize.LARGE),\n  runtimeConfiguration: {\n    serverProcesses: [{\n      launchPath: '/local/game/GameLiftExampleServer.x86_64',\n    }]\n  },\n  role: role\n});\n\n// Actions can also be grantted through dedicated method\nfleet.grant(role, 'gamelift:ListFleets');\n```\n\n### Alias\n\nA GameLift alias is used to abstract a fleet designation. Fleet designations\ntell Amazon GameLift where to search for available resources when creating new\ngame sessions for players. By using aliases instead of specific fleet IDs, you\ncan more easily and seamlessly switch player traffic from one fleet to another\nby changing the alias's target location.\n\n```ts\ndeclare const fleet: gamelift.BuildFleet;\n\n// Add an alias to an existing fleet using a dedicated fleet method\nconst liveAlias = fleet.addAlias('live');\n\n// You can also create a standalone alias\nnew gamelift.Alias(this, 'TerminalAlias', {\n  aliasName: 'terminal-alias',\n  terminalMessage: 'A terminal message',\n});\n```\n\nSee [Add an alias to a GameLift fleet](https://docs.aws.amazon.com/gamelift/latest/developerguide/aliases-creating.html)\nin the *Amazon GameLift Developer Guide*.\n\n### Monitoring your Fleet\n\nGameLift is integrated with CloudWatch, so you can monitor the performance of\nyour game servers via logs and metrics.\n\n#### Fleet Metrics\n\nGameLift Fleet sends metrics to CloudWatch so that you can collect and analyze\nthe activity of your Fleet, including game  and player sessions and server\nprocesses.\n\nYou can then use CloudWatch alarms to alert you, for example, when matches has\nbeen rejected (potential matches that were rejected by at least one player\nsince the last report) exceed a certain threshold which could means that you may\nhave an issue in your matchmaking rules.\n\nCDK provides methods for accessing GameLift Fleet metrics with default configuration,\nsuch as `metricActiveInstances`, or `metricIdleInstances` (see [`IFleet`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-gamelift.IFleet.html)\nfor a full list). CDK also provides a generic `metric` method that can be used\nto produce metric configurations for any metric provided by GameLift Fleet,\nGame sessions or server processes; the configurations are pre-populated with\nthe correct dimensions for the matchmaking configuration.\n\n```ts\ndeclare const fleet: gamelift.BuildFleet;\n// Alarm that triggers when the per-second average of not used instances exceed 10%\nconst instancesUsedRatio = new cloudwatch.MathExpression({\n  expression: '1 - (activeInstances / idleInstances)',\n  usingMetrics: {\n    activeInstances: fleet.metric('ActiveInstances', { statistic: cloudwatch.Statistic.SUM }),\n    idleInstances: fleet.metricIdleInstances(),\n  },\n});\nnew cloudwatch.Alarm(this, 'Alarm', {\n  metric: instancesUsedRatio,\n  threshold: 0.1,\n  evaluationPeriods: 3,\n});\n```\n\nSee: [Monitoring Using CloudWatch Metrics](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html)\nin the *Amazon GameLift Developer Guide*.\n\n## Game session queue\n\nThe game session queue is the primary mechanism for processing new game session\nrequests and locating available game servers to host them. Although it is\npossible to request a new game session be hosted on specific fleet or location.\n\nThe `GameSessionQueue` resource creates a placement queue that processes requests for\nnew game sessions. A queue uses FleetIQ algorithms to determine the best placement\nlocations and find an available game server, then prompts the game server to start a\nnew game session. Queues can have destinations (GameLift fleets or aliases), which\ndetermine where the queue can place new game sessions. A queue can have destinations\nwith varied fleet type (Spot and On-Demand), instance type, and AWS Region.\n\n```ts\ndeclare const fleet: gamelift.BuildFleet;\ndeclare const alias: gamelift.Alias;\n\nconst queue = new gamelift.GameSessionQueue(this, 'GameSessionQueue', {\n  gameSessionQueueName: 'my-queue-name',\n  destinations: [fleet]\n});\nqueue.addDestination(alias);\n```\n\nA more complex configuration can also be definied to override how FleetIQ algorithms prioritize game session placement in order to favour a destination based on `Cost`, `Latency`, `Destination order`or `Location`.\n\n```ts\ndeclare const fleet: gamelift.BuildFleet;\ndeclare const topic: sns.Topic;\n\nnew gamelift.GameSessionQueue(this, 'MyGameSessionQueue', {\n      gameSessionQueueName: 'test-gameSessionQueue',\n      customEventData: 'test-event-data',\n      allowedLocations: ['eu-west-1', 'eu-west-2'],\n      destinations: [fleet],\n      notificationTarget: topic,\n      playerLatencyPolicies: [{\n        maximumIndividualPlayerLatency: Duration.millis(100),\n        policyDuration: Duration.seconds(300),\n      }],\n      priorityConfiguration: {\n        locationOrder: [\n          'eu-west-1',\n          'eu-west-2',\n        ],\n        priorityOrder: [\n          gamelift.PriorityType.LATENCY,\n          gamelift.PriorityType.COST,\n          gamelift.PriorityType.DESTINATION,\n          gamelift.PriorityType.LOCATION,\n        ],\n      },\n      timeout: Duration.seconds(300),\n    });\n```\n\nSee [Setting up GameLift queues for game session placement](https://docs.aws.amazon.com/gamelift/latest/developerguide/realtime-script-uploading.html)\nin the *Amazon GameLift Developer Guide*.\n\n## GameLift FleetIQ\n\nThe GameLift FleetIQ solution is a game hosting layer that supplements the full\nset of computing resource management tools that you get with Amazon EC2 and\nAuto Scaling. This solution lets you directly manage your Amazon EC2 and Auto\nScaling resources and integrate as needed with other AWS services.\n\n### Defining a Game Server Group\n\nWhen using GameLift FleetIQ, you prepare to launch Amazon EC2 instances as\nusual: make an Amazon Machine Image (AMI) with your game server software,\ncreate an Amazon EC2 launch template, and define configuration settings for an\nAuto Scaling group. However, instead of creating an Auto Scaling group\ndirectly, you create a GameLift FleetIQ game server group with your Amazon EC2\nand Auto Scaling resources and configuration. All game server groups must have\nat least two instance types defined for it.\n\nOnce a game server group and Auto Scaling group are up and running with\ninstances deployed, when updating a Game Server Group instance, only certain\nproperties in the Auto Scaling group may be overwrite. For all other Auto\nScaling group properties, such as MinSize, MaxSize, and LaunchTemplate, you can\nmodify these directly on the Auto Scaling group using the AWS Console or\ndedicated Api.\n\n```ts\ndeclare const launchTemplate: ec2.ILaunchTemplate;\ndeclare const vpc: ec2.IVpc;\n\nnew gamelift.GameServerGroup(this, 'Game server group', {\n  gameServerGroupName: 'sample-gameservergroup-name',\n  instanceDefinitions: [{\n    instanceType: ec2.InstanceType.of(ec2.InstanceClass.C5, ec2.InstanceSize.LARGE),\n  },\n  {\n    instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  }],\n  launchTemplate: launchTemplate,\n  vpc: vpc\n});\n```\n\nSee [Manage game server groups](https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-integrate-gameservergroup.html)\nin the *Amazon GameLift FleetIQ Developer Guide*.\n\n### Scaling Policy\n\nThe scaling policy uses the metric `PercentUtilizedGameServers` to maintain a\nbuffer of idle game servers that can immediately accommodate new games and\nplayers.\n\n```ts\ndeclare const launchTemplate: ec2.ILaunchTemplate;\ndeclare const vpc: ec2.IVpc;\n\nnew gamelift.GameServerGroup(this, 'Game server group', {\n  gameServerGroupName: 'sample-gameservergroup-name',\n  instanceDefinitions: [{\n    instanceType: ec2.InstanceType.of(ec2.InstanceClass.C5, ec2.InstanceSize.LARGE),\n  },\n  {\n    instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  }],\n  launchTemplate: launchTemplate,\n  vpc: vpc,\n  autoScalingPolicy: {\n    estimatedInstanceWarmup: Duration.minutes(5),\n    targetTrackingConfiguration: 5\n  }\n});\n```\n\nSee [Manage game server groups](https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-integrate-gameservergroup.html)\nin the *Amazon GameLift FleetIQ Developer Guide*.\n\n### Specifying an IAM role for GameLift\n\nThe GameLift FleetIQ class automatically creates an IAM role with all the minimum necessary\npermissions for GameLift to access your Amazon EC2 Auto Scaling groups. If you wish, you may\nspecify your own IAM role. It must have the correct permissions, or FleetIQ creation or resource usage may fail.\n\n```ts\ndeclare const launchTemplate: ec2.ILaunchTemplate;\ndeclare const vpc: ec2.IVpc;\n\nconst role = new iam.Role(this, 'Role', {\n  assumedBy: new iam.CompositePrincipal(new iam.ServicePrincipal('gamelift.amazonaws.com'),\n  new iam.ServicePrincipal('autoscaling.amazonaws.com'))\n});\nrole.addManagedPolicy(iam.ManagedPolicy.fromAwsManagedPolicyName('GameLiftGameServerGroupPolicy'));\n\nnew gamelift.GameServerGroup(this, 'Game server group', {\n  gameServerGroupName: 'sample-gameservergroup-name',\n  instanceDefinitions: [{\n    instanceType: ec2.InstanceType.of(ec2.InstanceClass.C5, ec2.InstanceSize.LARGE),\n  },\n  {\n    instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  }],\n  launchTemplate: launchTemplate,\n  vpc: vpc,\n  role: role\n});\n```\n\nSee [Controlling Access](https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-iam-permissions-roles.html)\nin the *Amazon GameLift FleetIQ Developer Guide*.\n\n### Specifying VPC Subnets\n\nGameLift FleetIQ use by default, all supported GameLift FleetIQ Availability\nZones in your chosen region. You can override this parameter to specify VPCs\nsubnets that you've set up.\n\nThis property cannot be updated after the game server group is created, and the\ncorresponding Auto Scaling group will always use the property value that is set\nwith this request, even if the Auto Scaling group is updated directly.\n\n```ts\ndeclare const launchTemplate: ec2.ILaunchTemplate;\ndeclare const vpc: ec2.IVpc;\n\nnew gamelift.GameServerGroup(this, 'GameServerGroup', {\n  gameServerGroupName: 'sample-gameservergroup-name',\n  instanceDefinitions: [{\n    instanceType: ec2.InstanceType.of(ec2.InstanceClass.C5, ec2.InstanceSize.LARGE),\n  },\n  {\n    instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  }],\n  launchTemplate: launchTemplate,\n  vpc: vpc,\n  vpcSubnets: { subnetType: ec2.SubnetType.PUBLIC }\n});\n```\n\n### FleetIQ Monitoring\n\nGameLift FleetIQ sends metrics to CloudWatch so that you can collect and\nanalyze the activity of your Game server fleet, including the number of\nutilized game servers, and the number of game server interruption due to\nlimited Spot availability.\n\nYou can then use CloudWatch alarms to alert you, for example, when the portion\nof game servers that are currently supporting game executions exceed a certain\nthreshold which could means that your autoscaling policy need to be adjust to\nadd more instances to match with player demand.\n\nCDK provides a generic `metric` method that can be used\nto produce metric configurations for any metric provided by GameLift FleetIQ;\nthe configurations are pre-populated with the correct dimensions for the\nmatchmaking configuration.\n\n```ts\ndeclare const gameServerGroup: gamelift.IGameServerGroup;\n// Alarm that triggers when the percent of utilized game servers exceed 90%\nnew cloudwatch.Alarm(this, 'Alarm', {\n  metric: gameServerGroup.metric('UtilizedGameServers'),\n  threshold: 0.9,\n  evaluationPeriods: 2,\n});\n```\n\nSee: [Monitoring with CloudWatch](https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-metrics.html)\nin the *Amazon GameLift FleetIQ Developer Guide*.\n"
+    "markdown": "# Amazon GameLift Construct Library\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\n[Amazon GameLift](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-intro.html) is a service used\nto deploy, operate, and scale dedicated, low-cost servers in the cloud for session-based multiplayer games. Built\non AWS global computing infrastructure, GameLift helps deliver high-performance, high-reliability game servers\nwhile dynamically scaling your resource usage to meet worldwide player demand.\n\nGameLift is composed of three main components:\n\n* GameLift FlexMatch which is a customizable matchmaking service for\nmultiplayer games. With FlexMatch, you can\nbuild a custom set of rules that defines what a multiplayer match looks like\nfor your game, and determines how to\nevaluate and select compatible players for each match. You can also customize\nkey aspects of the matchmaking\nprocess to fit your game, including fine-tuning the matching algorithm.\n\n* GameLift hosting for custom or realtime servers which helps you deploy,\noperate, and scale dedicated game servers. It regulates the resources needed to\nhost games, finds available game servers to host new game sessions, and puts\nplayers into games.\n\n* GameLift FleetIQ to optimize the use of low-cost Amazon Elastic Compute Cloud\n(Amazon EC2) Spot Instances for cloud-based game hosting. With GameLift\nFleetIQ, you can work directly with your hosting resources in Amazon EC2 and\nAmazon EC2 Auto Scaling while taking advantage of GameLift optimizations to\ndeliver inexpensive, resilient game hosting for your players\n\nThis module is part of the [AWS Cloud Development Kit](https://github.com/aws/aws-cdk) project. It allows you to define components for your matchmaking\nconfiguration or game server fleet management system.\n\n## GameLift FlexMatch\n\n### Defining a Matchmaking configuration\n\nFlexMatch is available both as a GameLift game hosting solution (including\nRealtime Servers) and as a standalone matchmaking service. To set up a\nFlexMatch matchmaker to process matchmaking requests, you have to create a\nmatchmaking configuration based on a RuleSet.\n\nMore details about matchmaking ruleSet are covered [below](#matchmaking-ruleset).\n\nThere is two types of Matchmaking configuration:\n\nThrough a game session queue system to let FlexMatch forms matches and uses the specified GameLift queue to start a game session for the match.\n\n```ts\ndeclare const queue: gamelift.GameSessionQueue;\ndeclare const ruleSet: gamelift.MatchmakingRuleSet;\n\nnew gamelift.QueuedMatchmakingConfiguration(this, 'QueuedMatchmakingConfiguration', {\n  matchmakingConfigurationName: 'test-queued-config-name',\n  gameSessionQueues: [queue],\n  ruleSet: ruleSet,\n});\n```\n\nOr through a standalone version to let FlexMatch forms matches and returns match information in an event.\n\n```ts\ndeclare const ruleSet: gamelift.MatchmakingRuleSet;\n\nnew gamelift.StandaloneMatchmakingConfiguration(this, 'StandaloneMatchmaking', {\n  matchmakingConfigurationName: 'test-standalone-config-name',\n  ruleSet: ruleSet,\n});\n```\n\n\nMore details about Game session queue are covered [below](#game-session-queue).\n\n### Matchmaking RuleSet\n\nEvery FlexMatch matchmaker must have a rule set. The rule set determines the\ntwo key elements of a match: your game's team structure and size, and how to\ngroup players together for the best possible match.\n\nFor example, a rule set might describe a match like this: Create a match with\ntwo teams of four to eight players each, one team is the cowboy and the other\nteam the aliens. A team can have novice and experienced players, but the\naverage skill of the two teams must be within 10 points of each other. If no\nmatch is made after 30 seconds, gradually relax the skill requirements.\n\n```ts\nnew gamelift.MatchmakingRuleSet(this, 'RuleSet', {\n  matchmakingRuleSetName: 'my-test-ruleset',\n  content: gamelift.RuleSetContent.fromJsonFile(path.join(__dirname, 'my-ruleset/ruleset.json')),\n});\n```\n\n### FlexMatch Monitoring\n\nYou can monitor GameLift FlexMatch activity for matchmaking configurations and\nmatchmaking rules using Amazon CloudWatch. These statistics are used to provide\na historical perspective on how your Gamelift FlexMatch solution is performing.\n\n#### FlexMatch Metrics\n\nGameLift FlexMatch sends metrics to CloudWatch so that you can collect and\nanalyze the activity of your matchmaking solution, including match acceptance\nworkflow, ticket consumtion.\n\nYou can then use CloudWatch alarms to alert you, for example, when matches has\nbeen rejected (potential matches that were rejected by at least one player\nsince the last report) exceed a certain thresold which could means that you may\nhave an issue in your matchmaking rules.\n\nCDK provides methods for accessing GameLift FlexMatch metrics with default configuration,\nsuch as `metricRuleEvaluationsPassed`, or `metricRuleEvaluationsFailed` (see\n[`IMatchmakingRuleSet`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-gamelift.IMatchmakingRuleSet.html)\nfor a full list). CDK also provides a generic `metric` method that can be used\nto produce metric configurations for any metric provided by GameLift FlexMatch;\nthe configurations are pre-populated with the correct dimensions for the\nmatchmaking configuration.\n\n```ts\ndeclare const matchmakingRuleSet: gamelift.MatchmakingRuleSet;\n// Alarm that triggers when the per-second average of not placed matches exceed 10%\nconst ruleEvaluationRatio = new cloudwatch.MathExpression({\n  expression: '1 - (ruleEvaluationsPassed / ruleEvaluationsFailed)',\n  usingMetrics: {\n    ruleEvaluationsPassed: matchmakingRuleSet.metricRuleEvaluationsPassed({ statistic: cloudwatch.Statistic.SUM }),\n    ruleEvaluationsFailed: matchmakingRuleSet.metric('ruleEvaluationsFailed'),\n  },\n});\nnew cloudwatch.Alarm(this, 'Alarm', {\n  metric: ruleEvaluationRatio,\n  threshold: 0.1,\n  evaluationPeriods: 3,\n});\n```\n\nSee: [Monitoring Using CloudWatch Metrics](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html)\nin the *Amazon GameLift Developer Guide*.\n\n\n## GameLift Hosting\n\n### Uploading builds and scripts to GameLift\n\nBefore deploying your GameLift-enabled multiplayer game servers for hosting with the GameLift service, you need to upload\nyour game server files. This section provides guidance on preparing and uploading custom game server build\nfiles or Realtime Servers server script files. When you upload files, you create a GameLift build or script resource, which\nyou then deploy on fleets of hosting resources.\n\nTo troubleshoot fleet activation problems related to the server script, see [Debug GameLift fleet issues](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-creating-debug.html).\n\n#### Upload a custom server build to GameLift\n\nBefore uploading your configured game server to GameLift for hosting, package the game build files into a build directory.\nThis directory must include all components required to run your game servers and host game sessions, including the following:\n\n* Game server binaries – The binary files required to run the game server. A build can include binaries for multiple game\nservers built to run on the same platform. For a list of supported platforms, see [Download Amazon GameLift SDKs](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-supported.html).\n\n* Dependencies – Any dependent files that your game server executables require to run. Examples include assets, configuration\nfiles, and dependent libraries.\n\n* Install script – A script file to handle tasks that are required to fully install your game build on GameLift hosting\nservers. Place this file at the root of the build directory. GameLift runs the install script as part of fleet creation.\n\nYou can set up any application in your build, including your install script, to access your resources securely on other AWS\nservices.\n\n```ts\ndeclare const bucket: s3.Bucket;\nconst build = new gamelift.Build(this, 'Build', {\n  content: gamelift.Content.fromBucket(bucket, \"sample-asset-key\")\n});\n\nnew CfnOutput(this, 'BuildArn', { value: build.buildArn });\nnew CfnOutput(this, 'BuildId', { value: build.buildId });\n```\n\nTo specify a server SDK version you used when integrating your game server build with Amazon GameLift use the `serverSdkVersion` parameter:\n\n> See [Integrate games with custom game servers](https://docs.aws.amazon.com/gamelift/latest/developerguide/integration-custom-intro.html) for more details.\n\n```ts\ndeclare const bucket: s3.Bucket;\nconst build = new gamelift.Build(this, 'Build', {\n  content: gamelift.Content.fromBucket(bucket, \"sample-asset-key\"),\n  serverSdkVersion: '5.0.0',\n});\n```\n\n#### Upload a realtime server Script\n\nYour server script can include one or more files combined into a single .zip file for uploading. The .zip file must contain\nall files that your script needs to run.\n\nYou can store your zipped script files in either a local file directory or in an Amazon Simple Storage Service (Amazon S3)\nbucket or defines a directory asset which is archived as a .zip file and uploaded to S3 during deployment.\n\nAfter you create the script resource, GameLift deploys the script with a new Realtime Servers fleet. GameLift installs your\nserver script onto each instance in the fleet, placing the script files in `/local/game`.\n\n```ts\ndeclare const bucket: s3.Bucket;\nnew gamelift.Script(this, 'Script', {\n  content: gamelift.Content.fromBucket(bucket, \"sample-asset-key\")\n});\n```\n\n### Defining a GameLift Fleet\n\n#### Creating a custom game server fleet\n\nYour uploaded game servers are hosted on GameLift virtual computing resources,\ncalled instances. You set up your hosting resources by creating a fleet of\ninstances and deploying them to run your game servers. You can design a fleet\nto fit your game's needs.\n\n```ts\nnew gamelift.BuildFleet(this, 'Game server fleet', {\n  fleetName: 'test-fleet',\n  content: gamelift.Build.fromAsset(this, 'Build', path.join(__dirname, 'CustomerGameServer')),\n  instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  runtimeConfiguration: {\n    serverProcesses: [{\n      launchPath: 'test-launch-path',\n    }],\n  },\n});\n```\n\n### Managing game servers launch configuration\n\nGameLift uses a fleet's runtime configuration to determine the type and number\nof processes to run on each instance in the fleet. At a minimum, a runtime\nconfiguration contains one server process configuration that represents one\ngame server executable. You can also define additional server process\nconfigurations to run other types of processes related to your game. Each\nserver process configuration contains the following information:\n\n* The file name and path of an executable in your game build.\n\n* Optionally Parameters to pass to the process on launch.\n\n* The number of processes to run concurrently.\n\nA GameLift instance is limited to 50 processes running concurrently.\n\n```ts\ndeclare const build: gamelift.Build;\n// Server processes can be delcared in a declarative way through the constructor\nconst fleet = new gamelift.BuildFleet(this, 'Game server fleet', {\n  fleetName: 'test-fleet',\n  content: build,\n  instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  runtimeConfiguration: {\n    serverProcesses: [{\n      launchPath: '/local/game/GameLiftExampleServer.x86_64',\n      parameters: '-logFile /local/game/logs/myserver1935.log -port 1935',\n      concurrentExecutions: 100,\n    }]\n  }\n});\n```\n\nSee [Managing how game servers are launched for hosting](https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-multiprocess.html)\nin the *Amazon GameLift Developer Guide*.\n\n### Defining an instance type\n\nGameLift uses Amazon Elastic Compute Cloud (Amazon EC2) resources, called\ninstances, to deploy your game servers and host game sessions for your players.\nWhen setting up a new fleet, you decide what type of instances your game needs\nand how to run game server processes on them (using a runtime configuration). All instances in a fleet use the same type of resources and the same runtime\nconfiguration. You can edit a fleet's runtime configuration and other fleet\nproperties, but the type of resources cannot be changed.\n\n```ts\ndeclare const build: gamelift.Build;\nnew gamelift.BuildFleet(this, 'Game server fleet', {\n  fleetName: 'test-fleet',\n  content: build,\n  instanceType: ec2.InstanceType.of(ec2.InstanceClass.C5, ec2.InstanceSize.LARGE),\n  runtimeConfiguration: {\n    serverProcesses: [{\n      launchPath: '/local/game/GameLiftExampleServer.x86_64',\n    }]\n  }\n});\n```\n\n### Using Spot instances\n\nWhen setting up your hosting resources, you have the option of using Spot\nInstances, On-Demand Instances, or a combination.\n\nBy default, fleet are using on demand capacity.\n\n```ts\ndeclare const build: gamelift.Build;\nnew gamelift.BuildFleet(this, 'Game server fleet', {\n  fleetName: 'test-fleet',\n  content: build,\n  instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  runtimeConfiguration: {\n    serverProcesses: [{\n      launchPath: '/local/game/GameLiftExampleServer.x86_64',\n    }]\n  },\n  useSpot: true\n});\n```\n\n### Allowing Ingress traffic\n\nThe allowed IP address ranges and port settings that allow inbound traffic to\naccess game sessions on this fleet.\n\nNew game sessions are assigned an IP address/port number combination, which\nmust fall into the fleet's allowed ranges. Fleets with custom game builds must\nhave permissions explicitly set. For Realtime Servers fleets, GameLift\nautomatically opens two port ranges, one for TCP messaging and one for UDP.\n\n```ts\ndeclare const build: gamelift.Build;\n\nconst fleet = new gamelift.BuildFleet(this, 'Game server fleet', {\n  fleetName: 'test-fleet',\n  content: build,\n  instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  runtimeConfiguration: {\n    serverProcesses: [{\n      launchPath: '/local/game/GameLiftExampleServer.x86_64',\n    }]\n  },\n  ingressRules: [{\n    source: gamelift.Peer.anyIpv4(),\n    port: gamelift.Port.tcpRange(100, 200),\n  }]\n});\n// Allowing a specific CIDR for port 1111 on UDP Protocol\nfleet.addIngressRule(gamelift.Peer.ipv4('1.2.3.4/32'), gamelift.Port.udp(1111));\n```\n\n### Managing locations\n\nA single Amazon GameLift fleet has a home Region by default (the Region you\ndeploy it to), but it can deploy resources to any number of GameLift supported\nRegions. Select Regions based on where your players are located and your\nlatency needs.\n\nBy default, home region is used as default location but we can add new locations if needed and define desired capacity\n\n```ts\ndeclare const build: gamelift.Build;\n\n// Locations can be added directly through constructor\nconst fleet = new gamelift.BuildFleet(this, 'Game server fleet', {\n  fleetName: 'test-fleet',\n  content: build,\n  instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  runtimeConfiguration: {\n    serverProcesses: [{\n      launchPath: '/local/game/GameLiftExampleServer.x86_64',\n    }]\n  },\n  locations: [ {\n    region: 'eu-west-1',\n    capacity: {\n      desiredCapacity: 5,\n      minSize: 2,\n      maxSize: 10\n    }\n  }, {\n    region: 'us-east-1',\n    capacity: {\n      desiredCapacity: 5,\n      minSize: 2,\n      maxSize: 10\n    }\n  }]\n});\n\n// Or through dedicated methods\nfleet.addLocation('ap-southeast-1', 5, 2, 10);\n```\n\n### Specifying an IAM role for a Fleet\n\nSome GameLift features require you to extend limited access to your AWS\nresources. This is done by creating an AWS IAM role. The GameLift Fleet class\nautomatically created an IAM role with all the minimum necessary permissions\nfor GameLift to access your resources. If you wish, you may\nspecify your own IAM role.\n\n```ts\ndeclare const build: gamelift.Build;\nconst role = new iam.Role(this, 'Role', {\n  assumedBy: new iam.CompositePrincipal(new iam.ServicePrincipal('gamelift.amazonaws.com'))\n});\nrole.addManagedPolicy(iam.ManagedPolicy.fromAwsManagedPolicyName('CloudWatchAgentServerPolicy'));\n\nconst fleet = new gamelift.BuildFleet(this, 'Game server fleet', {\n  fleetName: 'test-fleet',\n  content: build,\n  instanceType: ec2.InstanceType.of(ec2.InstanceClass.C5, ec2.InstanceSize.LARGE),\n  runtimeConfiguration: {\n    serverProcesses: [{\n      launchPath: '/local/game/GameLiftExampleServer.x86_64',\n    }]\n  },\n  role: role\n});\n\n// Actions can also be grantted through dedicated method\nfleet.grant(role, 'gamelift:ListFleets');\n```\n\n### Alias\n\nA GameLift alias is used to abstract a fleet designation. Fleet designations\ntell Amazon GameLift where to search for available resources when creating new\ngame sessions for players. By using aliases instead of specific fleet IDs, you\ncan more easily and seamlessly switch player traffic from one fleet to another\nby changing the alias's target location.\n\n```ts\ndeclare const fleet: gamelift.BuildFleet;\n\n// Add an alias to an existing fleet using a dedicated fleet method\nconst liveAlias = fleet.addAlias('live');\n\n// You can also create a standalone alias\nnew gamelift.Alias(this, 'TerminalAlias', {\n  aliasName: 'terminal-alias',\n  terminalMessage: 'A terminal message',\n});\n```\n\nSee [Add an alias to a GameLift fleet](https://docs.aws.amazon.com/gamelift/latest/developerguide/aliases-creating.html)\nin the *Amazon GameLift Developer Guide*.\n\n### Monitoring your Fleet\n\nGameLift is integrated with CloudWatch, so you can monitor the performance of\nyour game servers via logs and metrics.\n\n#### Fleet Metrics\n\nGameLift Fleet sends metrics to CloudWatch so that you can collect and analyze\nthe activity of your Fleet, including game  and player sessions and server\nprocesses.\n\nYou can then use CloudWatch alarms to alert you, for example, when matches has\nbeen rejected (potential matches that were rejected by at least one player\nsince the last report) exceed a certain threshold which could means that you may\nhave an issue in your matchmaking rules.\n\nCDK provides methods for accessing GameLift Fleet metrics with default configuration,\nsuch as `metricActiveInstances`, or `metricIdleInstances` (see [`IFleet`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-gamelift.IFleet.html)\nfor a full list). CDK also provides a generic `metric` method that can be used\nto produce metric configurations for any metric provided by GameLift Fleet,\nGame sessions or server processes; the configurations are pre-populated with\nthe correct dimensions for the matchmaking configuration.\n\n```ts\ndeclare const fleet: gamelift.BuildFleet;\n// Alarm that triggers when the per-second average of not used instances exceed 10%\nconst instancesUsedRatio = new cloudwatch.MathExpression({\n  expression: '1 - (activeInstances / idleInstances)',\n  usingMetrics: {\n    activeInstances: fleet.metric('ActiveInstances', { statistic: cloudwatch.Statistic.SUM }),\n    idleInstances: fleet.metricIdleInstances(),\n  },\n});\nnew cloudwatch.Alarm(this, 'Alarm', {\n  metric: instancesUsedRatio,\n  threshold: 0.1,\n  evaluationPeriods: 3,\n});\n```\n\nSee: [Monitoring Using CloudWatch Metrics](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html)\nin the *Amazon GameLift Developer Guide*.\n\n## Game session queue\n\nThe game session queue is the primary mechanism for processing new game session\nrequests and locating available game servers to host them. Although it is\npossible to request a new game session be hosted on specific fleet or location.\n\nThe `GameSessionQueue` resource creates a placement queue that processes requests for\nnew game sessions. A queue uses FleetIQ algorithms to determine the best placement\nlocations and find an available game server, then prompts the game server to start a\nnew game session. Queues can have destinations (GameLift fleets or aliases), which\ndetermine where the queue can place new game sessions. A queue can have destinations\nwith varied fleet type (Spot and On-Demand), instance type, and AWS Region.\n\n```ts\ndeclare const fleet: gamelift.BuildFleet;\ndeclare const alias: gamelift.Alias;\n\nconst queue = new gamelift.GameSessionQueue(this, 'GameSessionQueue', {\n  gameSessionQueueName: 'my-queue-name',\n  destinations: [fleet]\n});\nqueue.addDestination(alias);\n```\n\nA more complex configuration can also be definied to override how FleetIQ algorithms prioritize game session placement in order to favour a destination based on `Cost`, `Latency`, `Destination order`or `Location`.\n\n```ts\ndeclare const fleet: gamelift.BuildFleet;\ndeclare const topic: sns.Topic;\n\nnew gamelift.GameSessionQueue(this, 'MyGameSessionQueue', {\n      gameSessionQueueName: 'test-gameSessionQueue',\n      customEventData: 'test-event-data',\n      allowedLocations: ['eu-west-1', 'eu-west-2'],\n      destinations: [fleet],\n      notificationTarget: topic,\n      playerLatencyPolicies: [{\n        maximumIndividualPlayerLatency: Duration.millis(100),\n        policyDuration: Duration.seconds(300),\n      }],\n      priorityConfiguration: {\n        locationOrder: [\n          'eu-west-1',\n          'eu-west-2',\n        ],\n        priorityOrder: [\n          gamelift.PriorityType.LATENCY,\n          gamelift.PriorityType.COST,\n          gamelift.PriorityType.DESTINATION,\n          gamelift.PriorityType.LOCATION,\n        ],\n      },\n      timeout: Duration.seconds(300),\n    });\n```\n\nSee [Setting up GameLift queues for game session placement](https://docs.aws.amazon.com/gamelift/latest/developerguide/realtime-script-uploading.html)\nin the *Amazon GameLift Developer Guide*.\n\n## GameLift FleetIQ\n\nThe GameLift FleetIQ solution is a game hosting layer that supplements the full\nset of computing resource management tools that you get with Amazon EC2 and\nAuto Scaling. This solution lets you directly manage your Amazon EC2 and Auto\nScaling resources and integrate as needed with other AWS services.\n\n### Defining a Game Server Group\n\nWhen using GameLift FleetIQ, you prepare to launch Amazon EC2 instances as\nusual: make an Amazon Machine Image (AMI) with your game server software,\ncreate an Amazon EC2 launch template, and define configuration settings for an\nAuto Scaling group. However, instead of creating an Auto Scaling group\ndirectly, you create a GameLift FleetIQ game server group with your Amazon EC2\nand Auto Scaling resources and configuration. All game server groups must have\nat least two instance types defined for it.\n\nOnce a game server group and Auto Scaling group are up and running with\ninstances deployed, when updating a Game Server Group instance, only certain\nproperties in the Auto Scaling group may be overwrite. For all other Auto\nScaling group properties, such as MinSize, MaxSize, and LaunchTemplate, you can\nmodify these directly on the Auto Scaling group using the AWS Console or\ndedicated Api.\n\n```ts\ndeclare const launchTemplate: ec2.ILaunchTemplate;\ndeclare const vpc: ec2.IVpc;\n\nnew gamelift.GameServerGroup(this, 'Game server group', {\n  gameServerGroupName: 'sample-gameservergroup-name',\n  instanceDefinitions: [{\n    instanceType: ec2.InstanceType.of(ec2.InstanceClass.C5, ec2.InstanceSize.LARGE),\n  },\n  {\n    instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  }],\n  launchTemplate: launchTemplate,\n  vpc: vpc\n});\n```\n\nSee [Manage game server groups](https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-integrate-gameservergroup.html)\nin the *Amazon GameLift FleetIQ Developer Guide*.\n\n### Scaling Policy\n\nThe scaling policy uses the metric `PercentUtilizedGameServers` to maintain a\nbuffer of idle game servers that can immediately accommodate new games and\nplayers.\n\n```ts\ndeclare const launchTemplate: ec2.ILaunchTemplate;\ndeclare const vpc: ec2.IVpc;\n\nnew gamelift.GameServerGroup(this, 'Game server group', {\n  gameServerGroupName: 'sample-gameservergroup-name',\n  instanceDefinitions: [{\n    instanceType: ec2.InstanceType.of(ec2.InstanceClass.C5, ec2.InstanceSize.LARGE),\n  },\n  {\n    instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  }],\n  launchTemplate: launchTemplate,\n  vpc: vpc,\n  autoScalingPolicy: {\n    estimatedInstanceWarmup: Duration.minutes(5),\n    targetTrackingConfiguration: 5\n  }\n});\n```\n\nSee [Manage game server groups](https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-integrate-gameservergroup.html)\nin the *Amazon GameLift FleetIQ Developer Guide*.\n\n### Specifying an IAM role for GameLift\n\nThe GameLift FleetIQ class automatically creates an IAM role with all the minimum necessary\npermissions for GameLift to access your Amazon EC2 Auto Scaling groups. If you wish, you may\nspecify your own IAM role. It must have the correct permissions, or FleetIQ creation or resource usage may fail.\n\n```ts\ndeclare const launchTemplate: ec2.ILaunchTemplate;\ndeclare const vpc: ec2.IVpc;\n\nconst role = new iam.Role(this, 'Role', {\n  assumedBy: new iam.CompositePrincipal(new iam.ServicePrincipal('gamelift.amazonaws.com'),\n  new iam.ServicePrincipal('autoscaling.amazonaws.com'))\n});\nrole.addManagedPolicy(iam.ManagedPolicy.fromAwsManagedPolicyName('GameLiftGameServerGroupPolicy'));\n\nnew gamelift.GameServerGroup(this, 'Game server group', {\n  gameServerGroupName: 'sample-gameservergroup-name',\n  instanceDefinitions: [{\n    instanceType: ec2.InstanceType.of(ec2.InstanceClass.C5, ec2.InstanceSize.LARGE),\n  },\n  {\n    instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  }],\n  launchTemplate: launchTemplate,\n  vpc: vpc,\n  role: role\n});\n```\n\nSee [Controlling Access](https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-iam-permissions-roles.html)\nin the *Amazon GameLift FleetIQ Developer Guide*.\n\n### Specifying VPC Subnets\n\nGameLift FleetIQ use by default, all supported GameLift FleetIQ Availability\nZones in your chosen region. You can override this parameter to specify VPCs\nsubnets that you've set up.\n\nThis property cannot be updated after the game server group is created, and the\ncorresponding Auto Scaling group will always use the property value that is set\nwith this request, even if the Auto Scaling group is updated directly.\n\n```ts\ndeclare const launchTemplate: ec2.ILaunchTemplate;\ndeclare const vpc: ec2.IVpc;\n\nnew gamelift.GameServerGroup(this, 'GameServerGroup', {\n  gameServerGroupName: 'sample-gameservergroup-name',\n  instanceDefinitions: [{\n    instanceType: ec2.InstanceType.of(ec2.InstanceClass.C5, ec2.InstanceSize.LARGE),\n  },\n  {\n    instanceType: ec2.InstanceType.of(ec2.InstanceClass.C4, ec2.InstanceSize.LARGE),\n  }],\n  launchTemplate: launchTemplate,\n  vpc: vpc,\n  vpcSubnets: { subnetType: ec2.SubnetType.PUBLIC }\n});\n```\n\n### FleetIQ Monitoring\n\nGameLift FleetIQ sends metrics to CloudWatch so that you can collect and\nanalyze the activity of your Game server fleet, including the number of\nutilized game servers, and the number of game server interruption due to\nlimited Spot availability.\n\nYou can then use CloudWatch alarms to alert you, for example, when the portion\nof game servers that are currently supporting game executions exceed a certain\nthreshold which could means that your autoscaling policy need to be adjust to\nadd more instances to match with player demand.\n\nCDK provides a generic `metric` method that can be used\nto produce metric configurations for any metric provided by GameLift FleetIQ;\nthe configurations are pre-populated with the correct dimensions for the\nmatchmaking configuration.\n\n```ts\ndeclare const gameServerGroup: gamelift.IGameServerGroup;\n// Alarm that triggers when the percent of utilized game servers exceed 90%\nnew cloudwatch.Alarm(this, 'Alarm', {\n  metric: gameServerGroup.metric('UtilizedGameServers'),\n  threshold: 0.9,\n  evaluationPeriods: 2,\n});\n```\n\nSee: [Monitoring with CloudWatch](https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-metrics.html)\nin the *Amazon GameLift FleetIQ Developer Guide*.\n"
   },
   "repository": {
     "directory": "packages/@aws-cdk/aws-gamelift-alpha",
@@ -4345,7 +4345,7 @@
         },
         "locationInModule": {
           "filename": "lib/build.ts",
-          "line": 239
+          "line": 273
         },
         "parameters": [
           {
@@ -4371,7 +4371,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/build.ts",
-        "line": 150
+        "line": 184
       },
       "methods": [
         {
@@ -4381,7 +4381,7 @@
           },
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 164
+            "line": 198
           },
           "name": "fromAsset",
           "parameters": [
@@ -4425,7 +4425,7 @@
           },
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 155
+            "line": 189
           },
           "name": "fromBucket",
           "parameters": [
@@ -4475,7 +4475,7 @@
           },
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 180
+            "line": 214
           },
           "name": "fromBuildArn",
           "parameters": [
@@ -4512,7 +4512,7 @@
           },
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 187
+            "line": 221
           },
           "name": "fromBuildAttributes",
           "parameters": [
@@ -4549,7 +4549,7 @@
           },
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 173
+            "line": 207
           },
           "name": "fromBuildId",
           "parameters": [
@@ -4590,7 +4590,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 227
+            "line": 261
           },
           "name": "buildArn",
           "overrides": "@aws-cdk/aws-gamelift-alpha.BuildBase",
@@ -4606,7 +4606,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 222
+            "line": 256
           },
           "name": "buildId",
           "overrides": "@aws-cdk/aws-gamelift-alpha.BuildBase",
@@ -4622,7 +4622,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 237
+            "line": 271
           },
           "name": "grantPrincipal",
           "overrides": "@aws-cdk/aws-gamelift-alpha.BuildBase",
@@ -4638,7 +4638,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 232
+            "line": 266
           },
           "name": "role",
           "type": {
@@ -4663,7 +4663,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/build.ts",
-        "line": 63
+        "line": 88
       },
       "name": "BuildAttributes",
       "properties": [
@@ -4678,7 +4678,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 71
+            "line": 96
           },
           "name": "buildArn",
           "optional": true,
@@ -4697,7 +4697,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 80
+            "line": 105
           },
           "name": "buildId",
           "optional": true,
@@ -4715,7 +4715,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 85
+            "line": 110
           },
           "name": "role",
           "optional": true,
@@ -5151,7 +5151,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/build.ts",
-        "line": 91
+        "line": 116
       },
       "name": "BuildProps",
       "properties": [
@@ -5164,7 +5164,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 116
+            "line": 141
           },
           "name": "content",
           "type": {
@@ -5181,7 +5181,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 97
+            "line": 122
           },
           "name": "buildName",
           "optional": true,
@@ -5199,7 +5199,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 104
+            "line": 129
           },
           "name": "buildVersion",
           "optional": true,
@@ -5217,7 +5217,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 111
+            "line": 136
           },
           "name": "operatingSystem",
           "optional": true,
@@ -5237,13 +5237,32 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/build.ts",
-            "line": 139
+            "line": 164
           },
           "name": "role",
           "optional": true,
           "type": {
             "fqn": "aws-cdk-lib.aws_iam.IRole"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- 4.0.2",
+            "see": "https://docs.aws.amazon.com/gamelift/latest/developerguide/integration-custom-intro.html",
+            "stability": "experimental",
+            "summary": "A server SDK version you used when integrating your game server build with Amazon GameLift."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/build.ts",
+            "line": 173
+          },
+          "name": "serverSdkVersion",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
         }
       ],
       "symbolId": "lib/build:BuildProps"
@@ -5255,7 +5274,7 @@
         "remarks": "The class helps you on preparing and uploading custom game server build files or Realtime Servers server script files.",
         "stability": "experimental",
         "summary": "Before deploying your GameLift-enabled multiplayer game servers for hosting with the GameLift service, you need to upload your game server files.",
-        "example": "declare const bucket: s3.Bucket;\nconst build = new gamelift.Build(this, 'Build', {\n  content: gamelift.Content.fromBucket(bucket, \"sample-asset-key\")\n});\n\nnew CfnOutput(this, 'BuildArn', { value: build.buildArn });\nnew CfnOutput(this, 'BuildId', { value: build.buildId });",
+        "example": "declare const bucket: s3.Bucket;\nconst build = new gamelift.Build(this, 'Build', {\n  content: gamelift.Content.fromBucket(bucket, \"sample-asset-key\"),\n  serverSdkVersion: '5.0.0',\n});",
         "custom": {
           "exampleMetadata": "infused"
         }
@@ -11044,21 +11063,39 @@
       "members": [
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Amazon Linux operating system."
           },
           "name": "AMAZON_LINUX"
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Amazon Linux 2 operating system."
           },
           "name": "AMAZON_LINUX_2"
         },
         {
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Amazon Linux 2023 operating system."
+          },
+          "name": "AMAZON_LINUX_2023"
+        },
+        {
+          "docs": {
+            "deprecated": "If you have active fleets using the Windows Server 2012 operating system,\nyou can continue to create new builds using this OS until October 10, 2023, when Microsoft ends its support.\nAll others must use Windows Server 2016 when creating new Windows-based builds.",
+            "stability": "deprecated",
+            "summary": "Windows Server 2012 operating system."
           },
           "name": "WINDOWS_2012"
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Windows Server 2016 operating system."
+          },
+          "name": "WINDOWS_2016"
         }
       ],
       "name": "OperatingSystem",
@@ -13216,6 +13253,6 @@
       "symbolId": "lib/standalone-matchmaking-configuration:StandaloneMatchmakingConfigurationProps"
     }
   },
-  "version": "2.105.0-alpha.0",
+  "version": "2.106.1-alpha.0",
   "fingerprint": "**********"
 }

package/.warnings.jsii.js

@@ -33,6 +33,19 @@ function _aws_cdk_aws_gamelift_alpha_IBuild(p) {
 function _aws_cdk_aws_gamelift_alpha_BuildBase(p) {
 }
 function _aws_cdk_aws_gamelift_alpha_OperatingSystem(p) {
+    if (p == null)
+        return;
+    visitedObjects.add(p);
+    try {
+        const ns = require("./lib/build.js");
+        if (Object.values(ns.OperatingSystem).filter(x => x === p).length > 1)
+            return;
+        if (p === ns.OperatingSystem.WINDOWS_2012)
+            print("@aws-cdk/aws-gamelift-alpha.OperatingSystem#WINDOWS_2012", "If you have active fleets using the Windows Server 2012 operating system,\nyou can continue to create new builds using this OS until October 10, 2023, when Microsoft ends its support.\nAll others must use Windows Server 2016 when creating new Windows-based builds.");
+    }
+    finally {
+        visitedObjects.delete(p);
+    }
 }
 function _aws_cdk_aws_gamelift_alpha_BuildAttributes(p) {
 }

package/README.md

@@ -187,6 +187,18 @@ new CfnOutput(this, 'BuildArn', { value: build.buildArn });
 new CfnOutput(this, 'BuildId', { value: build.buildId });
 ```
 
+To specify a server SDK version you used when integrating your game server build with Amazon GameLift use the `serverSdkVersion` parameter:
+
+> See [Integrate games with custom game servers](https://docs.aws.amazon.com/gamelift/latest/developerguide/integration-custom-intro.html) for more details.
+
+```ts
+declare const bucket: s3.Bucket;
+const build = new gamelift.Build(this, 'Build', {
+  content: gamelift.Content.fromBucket(bucket, "sample-asset-key"),
+  serverSdkVersion: '5.0.0',
+});
+```
+
 #### Upload a realtime server Script
 
 Your server script can include one or more files combined into a single .zip file for uploading. The .zip file must contain

package/awslint.json

@@ -1,5 +1,9 @@
 {
-    "exclude": [
-        "*:*"
-    ]
-}
+  "exclude": [
+    "docs-public-apis:@aws-cdk/aws-gamelift-alpha.OperatingSystem.AMAZON_LINUX",
+    "docs-public-apis:@aws-cdk/aws-gamelift-alpha.OperatingSystem.AMAZON_LINUX_2",
+    "docs-public-apis:@aws-cdk/aws-gamelift-alpha.OperatingSystem.WINDOWS_2012",
+    "docs-public-apis:@aws-cdk/aws-gamelift-alpha.Protocol.TCP",
+    "docs-public-apis:@aws-cdk/aws-gamelift-alpha.Protocol.UDP"
+  ]
+}

package/lib/alias.js

@@ -19,7 +19,7 @@ class AliasBase extends cdk.Resource {
 }
 exports.AliasBase = AliasBase;
 _a = JSII_RTTI_SYMBOL_1;
-AliasBase[_a] = { fqn: "@aws-cdk/aws-gamelift-alpha.AliasBase", version: "2.105.0-alpha.0" };
+AliasBase[_a] = { fqn: "@aws-cdk/aws-gamelift-alpha.AliasBase", version: "2.106.1-alpha.0" };
 /**
  * A Amazon GameLift alias is used to abstract a fleet designation.
  * Fleet designations tell GameLift where to search for available resources when creating new game sessions for players.
@@ -144,5 +144,5 @@ class Alias extends AliasBase {
 }
 exports.Alias = Alias;
 _b = JSII_RTTI_SYMBOL_1;
-Alias[_b] = { fqn: "@aws-cdk/aws-gamelift-alpha.Alias", version: "2.105.0-alpha.0" };
+Alias[_b] = { fqn: "@aws-cdk/aws-gamelift-alpha.Alias", version: "2.106.1-alpha.0" };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWxpYXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJhbGlhcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7QUFBQSx3Q0FBd0M7QUFJeEMsMkRBQW9EO0FBNkZwRDs7R0FFRztBQUNILE1BQXNCLFNBQVUsU0FBUSxHQUFHLENBQUMsUUFBUTtJQVNsRDs7T0FFRztJQUNILElBQVcseUJBQXlCO1FBQ2xDLE9BQU8sSUFBSSxDQUFDLFFBQVEsQ0FBQztLQUN0Qjs7QUFkSCw4QkFlQzs7O0FBRUQ7Ozs7Ozs7Ozs7Ozs7OztHQWVHO0FBQ0gsTUFBYSxLQUFNLFNBQVEsU0FBUztJQUVsQzs7T0FFRztJQUNILE1BQU0sQ0FBQyxXQUFXLENBQUMsS0FBZ0IsRUFBRSxFQUFVLEVBQUUsT0FBZTtRQUM5RCxPQUFPLElBQUksQ0FBQyxtQkFBbUIsQ0FBQyxLQUFLLEVBQUUsRUFBRSxFQUFFLEVBQUUsT0FBTyxFQUFFLE9BQU8sRUFBRSxDQUFDLENBQUM7S0FDbEU7SUFFRDs7T0FFRztJQUNILE1BQU0sQ0FBQyxZQUFZLENBQUMsS0FBZ0IsRUFBRSxFQUFVLEVBQUUsUUFBZ0I7UUFDaEUsT0FBTyxJQUFJLENBQUMsbUJBQW1CLENBQUMsS0FBSyxFQUFFLEVBQUUsRUFBRSxFQUFFLFFBQVEsRUFBRSxRQUFRLEVBQUUsQ0FBQyxDQUFDO0tBQ3BFO0lBRUQ7O09BRUc7SUFDSCxNQUFNLENBQUMsbUJBQW1CLENBQUMsS0FBZ0IsRUFBRSxFQUFVLEVBQUUsS0FBc0I7Ozs7Ozs7Ozs7UUFDN0UsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsUUFBUSxFQUFFO1lBQ3JDLE1BQU0sSUFBSSxLQUFLLENBQUMsZ0VBQWdFLENBQUMsQ0FBQztTQUNuRjtRQUNELE1BQU0sT0FBTyxHQUFHLEtBQUssQ0FBQyxPQUFPO1lBQzNCLEdBQUcsQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxDQUFDLFFBQVEsQ0FBQyxLQUFL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LFlBQVksRUFBRSxJQUFJLENBQUMsT0FBTztZQUMxQixTQUFTLEVBQUUsR0FBRyxDQUFDLFNBQVMsQ0FBQyxtQkFBbUI7U0FDN0MsQ0FBQyxDQUFDO0tBQ0o7SUFFTyxvQkFBb0IsQ0FBQyxLQUFpQjtRQUM1QyxJQUFJLEtBQUssQ0FBQyxLQUFLLEVBQUc7WUFDaEIsT0FBTztnQkFDTCxPQUFPLEVBQUUsS0FBSyxDQUFDLEtBQUssQ0FBQyxPQUFPO2dCQUM1QixJQUFJLEVBQUUsUUFBUTthQUNmLENBQUM7U0FDSDtRQUNELE9BQU87WUFDTCxPQUFPLEVBQUUsS0FBSyxDQUFDLGVBQWU7WUFDOUIsSUFBSSxFQUFFLFVBQVU7U0FDakIsQ0FBQztLQUNIOztBQW5ISCxzQkFvSEMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgKiBhcyBjZGsgZnJvbSAnYXdzLWNkay1saWIvY29yZSc7XG5pbXBvcnQgeyBDb25zdHJ1Y3QgfSBmcm9tICdjb25zdHJ1Y3RzJztcbmltcG9ydCB7IElGbGVldCB9IGZyb20gJy4vZmxlZXQtYmFzZSc7XG5pbXBvcnQgeyBJR2FtZVNlc3Npb25RdWV1ZURlc3RpbmF0aW9uIH0gZnJvbSAnLi9nYW1lLXNlc3Npb24tcXVldWUnO1xuaW1wb3J0IHsgQ2ZuQWxpYXMgfSBmcm9tICdhd3MtY2RrLWxpYi9hd3MtZ2FtZWxpZnQnO1xuXG4vKipcbiAqIFJlcHJlc2VudHMgYSBHYW1lbGlmdCBBbGlhcyBmb3IgYSBHYW1lbGlmdCBmbGVldCBkZXN0aW5hdGlvbi5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBJQWxpYXMgZXh0ZW5kcyBjZGsuSVJlc291cmNlLCBJR2FtZVNlc3Npb25RdWV1ZURlc3RpbmF0aW9uIHtcblxuICAvKipcbiAgICAgKiBUaGUgSWRlbnRpZmllciBvZiB0aGUgYWxpYXMuXG4gICAgICpcbiAgICAgKiBAYXR0cmlidXRlXG4gICAgICovXG4gIHJlYWRvbmx5IGFsaWFzSWQ6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIEFSTiBvZiB0aGUgYWxpYXMuXG4gICAqXG4gICAqIEBhdHRyaWJ1dGVcbiAgICovXG4gIHJlYWRvbmx5IGFsaWFzQXJuOiBzdHJpbmc7XG59XG5cbi8qKlxuICogT3B0aW9ucyBmb3IgYGdhbWVsaWZ0LkFsaWFzYC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBBbGlhc09wdGlvbnMge1xuICAvKipcbiAgICAgKiBEZXNjcmlwdGlvbiBmb3IgdGhlIGFsaWFzXG4gICAgICpcbiAgICAgKiBAZGVmYXVsdCBObyBkZXNjcmlwdGlvblxuICAgICAqL1xuICByZWFkb25seSBkZXNjcmlwdGlvbj86IHN0cmluZztcbn1cblxuLyoqXG4gKiBBIGZ1bGwgc3BlY2lmaWNhdGlvbiBvZiBhbiBhbGlhcyB0aGF0IGNhbiBiZSB1c2VkIHRvIGltcG9ydCBpdCBmbHVlbnRseSBpbnRvIHRoZSBDREsgYXBwbGljYXRpb24uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQWxpYXNBdHRyaWJ1dGVzIHtcbiAgLyoqXG4gICAgICAgKiBUaGUgQVJOIG9mIHRoZSBhbGlhc1xuICAgICAgICpcbiAgICAgICAqIEF0IGxlYXN0IG9uZSBvZiBgYWxpYXNBcm5gIGFuZCBgYWxpYXNJZGAgbXVzdCBiZSBwcm92aWRlZC5cbiAgICAgICAqXG4gICAgICAgKiBAZGVmYXVsdCBkZXJpdmVkIGZyb20gYGFsaWFzSWRgLlxuICAgICAgICovXG4gIHJlYWRvbmx5IGFsaWFzQXJuPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgICAqIFRoZSBpZGVudGlmaWVyIG9mIHRoZSBhbGlhc1xuICAgICAqXG4gICAgICogQXQgbGVhc3Qgb25lIG9mIGBhbGlhc0lkYCBhbmQgYGFsaWFzQXJuYCAgbXVzdCBiZSBwcm92aWRlZC5cbiAgICAgKlxuICAgICAqIEBkZWZhdWx0IGRlcml2ZWQgZnJvbSBgYWxpYXNBcm5gLlxuICAgICAqL1xuICByZWFkb25seSBhbGlhc0lkPzogc3RyaW5nO1xufVxuXG4vKipcbiAqIFByb3BlcnRpZXMgZm9yIGEgbmV3IEZsZWV0IGFsaWFzXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQWxpYXNQcm9wcyB7XG4gIC8qKlxuICAgICAqIE5hbWUgb2YgdGhpcyBhbGlhc1xuICAgICAqL1xuICByZWFkb25seSBhbGlhc05hbWU6IHN0cmluZztcblxuICAvKipcbiAgICAgKiBBIGh1bWFuLXJlYWRhYmxlIGRlc2NyaXB0aW9uIG9mIHRoZSBhbGlhc1xuICAgICAqXG4gICAgICogQGRlZmF1bHQgbm8gZGVzY3JpcHRpb25cbiAgICAgKi9cbiAgcmVhZG9ubHkgZGVzY3JpcHRpb24/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEEgZmxlZXQgdGhhdCB0aGUgYWxpYXMgcG9pbnRzIHRvLlxuICAgKiBJZiBzcGVjaWZpZWQsIHRoZSBhbGlhcyByZXNvbHZlcyB0byBvbmUgc3BlY2lmaWMgZmxlZXQuXG4gICAqXG4gICAqIEF0IGxlYXN0IG9uZSBvZiBgZmxlZXRgIGFuZCBgdGVybWluYWxNZXNzYWdlYCBtdXN0IGJlIHByb3ZpZGVkLlxuICAgKlxuICAgKiBAZGVmYXVsdCBubyBmbGVldCB0aGF0IHRoZSBhbGlhcyBwb2ludHMgdG8uXG4gICAqL1xuICByZWFkb25seSBmbGVldD86IElGbGVldDtcblxuICAvKipcbiAgICogVGhlIG1lc3NhZ2UgdGV4dCB0byBiZSB1c2VkIHdpdGggYSB0ZXJtaW5hbCByb3V0aW5nIHN0cmF0ZWd5LlxuICAgKlxuICAgKiBBdCBsZWFzdCBvbmUgb2YgYGZsZWV0YCBhbmQgYHRlcm1pbmFsTWVzc2FnZWAgbXVzdCBiZSBwcm92aWRlZC5cbiAgICpcbiAgICogQGRlZmF1bHQgbm8gdGVybWluYWwgbWVzc2FnZVxuICAgKi9cbiAgcmVhZG9ubHkgdGVybWluYWxNZXNzYWdlPzogc3RyaW5nO1xufVxuXG4vKipcbiAqIEJhc2UgY2xhc3MgZm9yIG5ldyBhbmQgaW1wb3J0ZWQgR2FtZUxpZnQgQWxpYXMuXG4gKi9cbmV4cG9ydCBhYnN0cmFjdCBjbGFzcyBBbGlhc0Jhc2UgZXh0ZW5kcyBjZGsuUmVzb3VyY2UgaW1wbGVtZW50cyBJQWxpYXMge1xuICAvKipcbiAqIFRoZSBJZGVudGlmaWVyIG9mIHRoZSBhbGlhcy5cbiAqL1xuICBwdWJsaWMgYWJzdHJhY3QgcmVhZG9ubHkgYWxpYXNJZDogc3RyaW5nO1xuICAvKipcbiAgICogVGhlIEFSTiBvZiB0aGUgYWxpYXNcbiAgICovXG4gIHB1YmxpYyBhYnN0cmFjdCByZWFkb25seSBhbGlhc0Fybjogc3RyaW5nO1xuICAvKipcbiAgICogVGhlIEFSTiB0byBwdXQgaW50byB0aGUgZGVzdGluYXRpb24gZmllbGQgb2YgYSBnYW1lIHNlc3Npb24gcXVldWVcbiAgICovXG4gIHB1YmxpYyBnZXQgcmVzb3VyY2VBcm5Gb3JEZXN0aW5hdGlvbigpIHtcbiAgICByZXR1cm4gdGhpcy5hbGlhc0FybjtcbiAgfVxufVxuXG4vKipcbiAqIEEgQW1hem9uIEdhbWVMaWZ0IGFsaWFzIGlzIHVzZWQgdG8gYWJzdHJhY3QgYSBmbGVldCBkZXNpZ25hdGlvbi5cbiAqIEZsZWV0IGRlc2lnbmF0aW9ucyB0ZWxsIEdhbWVMaWZ0IHdoZXJlIHRvIHNlYXJjaCBmb3IgYXZhaWxhYmxlIHJlc291cmNlcyB3aGVuIGNyZWF0aW5nIG5ldyBnYW1lIHNlc3Npb25zIGZvciBwbGF5ZXJzLlxuICogVXNlIGFsaWFzZXMgaW5zdGVhZCBvZiBzcGVjaWZpYyBmbGVldCBJRHMgdG8gc2VhbWxlc3NseSBzd2l0Y2ggcGxheWVyIHRyYWZmaWMgZnJvbSBvbmUgZmxlZXQgdG8gYW5vdGhlciBieSBjaGFuZ2luZyB0aGUgYWxpYXMncyB0YXJnZXQgbG9jYXRpb24uXG4gKlxuICogQWxpYXNlcyBhcmUgdXNlZnVsIGluIGdhbWVzIHRoYXQgZG9uJ3QgdXNlIHF1ZXVlcy5cbiAqIFN3aXRjaGluZyBmbGVldHMgaW4gYSBxdWV1ZSBpcyBhIHNpbXBsZSBtYXR0ZXIgb2YgY3JlYXRpbmcgYSBuZXcgZmxlZXQsIGFkZGluZyBpdCB0byB0aGUgcXVldWUsIGFuZCByZW1vdmluZyB0aGUgb2xkIGZsZWV0LCBub25lIG9mIHdoaWNoIGlzIHZpc2libGUgdG8gcGxheWVycy5cbiAqIEluIGNvbnRyYXN0LCBnYW1lIGNsaWVudHMgdGhhdCBkb24ndCB1c2UgcXVldWVzIG11c3Qgc3BlY2lmeSB3aGljaCBmbGVldCB0byB1c2Ugd2hlbiBjb21tdW5pY2F0aW5nIHdpdGggdGhlIEdhbWVMaWZ0IHNlcnZpY2UuXG4gKiBXaXRob3V0IGFsaWFzZXMsIGEgZmxlZXQgc3dpdGNoIHJlcXVpcmVzIHVwZGF0ZXMgdG8geW91ciBnYW1lIGNvZGUgYW5kIHBvc3NpYmx5IGRpc3RyaWJ1dGlvbiBvZiBhbiB1cGRhdGVkIGdhbWUgY2xpZW50cyB0byBwbGF5ZXJzLlxuICpcbiAqIFdoZW4gdXBkYXRpbmcgdGhlIGZsZWV0LWlkIGFuIGFsaWFzIHBvaW50cyB0bywgdGhlcmUgaXMgYSB0cmFuc2l0aW9uIHBlcmlvZCBvZiB1cCB0byAyIG1pbnV0ZXMgd2hlcmUgZ2FtZSBzZXNzaW9ucyBvbiB0aGUgYWxpYXMgbWF5IGVuZCB1cCBvbiB0aGUgb2xkIGZsZWV0LlxuICpcbiAqIEBzZWUgaHR0cHM6Ly9kb2NzLmF3cy5hbWF6b24uY29tL2dhbWVsaWZ0L2xhdGVzdC9kZXZlbG9wZXJndWlkZS9hbGlhc2VzLWNyZWF0aW5nLmh0bWxcbiAqXG4gKiBAcmVzb3VyY2UgQVdTOjpHYW1lTGlmdDo6QWxpYXNcbiAqL1xuZXhwb3J0IGNsYXNzIEFsaWFzIGV4dGVuZHMgQWxpYXNCYXNlIHtcblxuICAvKipcbiAgICogSW1wb3J0IGFuIGV4aXN0aW5nIGFsaWFzIGZyb20gaXRzIGlkZW50aWZpZXIuXG4gICAqL1xuICBzdGF0aWMgZnJvbUFsaWFzSWQoc2NvcGU6IENvbnN0cnVjdCwgaWQ6IHN0cmluZywgYWxpYXNJZDogc3RyaW5nKTogSUFsaWFzIHtcbiAgICByZXR1cm4gdGhpcy5mcm9tQWxpYXNBdHRyaWJ1dGVzKHNjb3BlLCBpZCwgeyBhbGlhc0lkOiBhbGlhc0lkIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIEltcG9ydCBhbiBleGlzdGluZyBhbGlhcyBmcm9tIGl0cyBBUk4uXG4gICAqL1xuICBzdGF0aWMgZnJvbUFsaWFzQXJuKHNjb3BlOiBDb25zdHJ1Y3QsIGlkOiBzdHJpbmcsIGFsaWFzQXJuOiBzdHJpbmcpOiBJQWxpYXMge1xuICAgIHJldHVybiB0aGlzLmZyb21BbGlhc0F0dHJpYnV0ZXMoc2NvcGUsIGlkLCB7IGFsaWFzQXJuOiBhbGlhc0FybiB9KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBJbXBvcnQgYW4gZXhpc3RpbmcgYWxpYXMgZnJvbSBpdHMgYXR0cmlidXRlcy5cbiAgICovXG4gIHN0YXRpYyBmcm9tQWxpYXNBdHRyaWJ1dGVzKHNjb3BlOiBDb25zdHJ1Y3QsIGlkOiBzdHJpbmcsIGF0dHJzOiBBbGlhc0F0dHJpYnV0ZXMpOiBJQWxpYXMge1xuICAgIGlmICghYXR0cnMuYWxpYXNJZCAmJiAhYXR0cnMuYWxpYXNBcm4pIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcignRWl0aGVyIGFsaWFzSWQgb3IgYWxpYXNBcm4gbXVzdCBiZSBwcm92aWRlZCBpbiBBbGlhc0F0dHJpYnV0ZXMnKTtcbiAgICB9XG4gICAgY29uc3QgYWxpYXNJZCA9IGF0dHJzLmFsaWFzSWQgPz9cbiAgICAgIGNkay5TdGFjay5vZihzY29wZSkuc3BsaXRBcm4oYXR0cnMuYWxpYXNBcm4hLCBjZGsuQXJuRm9ybWF0LlNMQVNIX1JFU09VUkNFX05BTUUpLnJlc291cmNlTmFtZTtcblxuICAgIGlmICghYWxpYXNJZCkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKGBObyBhbGlhcyBpZGVudGlmaWVyIGZvdW5kIGluIEFSTjogJyR7YXR0cnMuYWxpYXNBcm59J2ApO1xuICAgIH1cblxuICAgIGNvbnN0IGFsaWFzQXJuID0gYXR0cnMuYWxpYXNBcm4gPz8gY2RrLlN0YWNrLm9mKHNjb3BlKS5mb3JtYXRBcm4oe1xuICAgICAgc2VydmljZTogJ2dhbWVsaWZ0JyxcbiAgICAgIHJlc291cmNlOiAnYWxpYXMnLFxuICAgICAgcmVzb3VyY2VOYW1lOiBhdHRycy5hbGlhc0lkLFxuICAgICAgYXJuRm9ybWF0OiBjZGsuQXJuRm9ybWF0LlNMQVNIX1JFU09VUkNFX05BTUUsXG4gICAgfSk7XG4gICAgY2xhc3MgSW1wb3J0IGV4dGVuZHMgQWxpYXNCYXNlIHtcbiAgICAgIHB1YmxpYyByZWFkb25seSBhbGlhc0lkID0gYWxpYXNJZCE7XG4gICAgICBwdWJsaWMgcmVhZG9ubHkgYWxpYXNBcm4gPSBhbGlhc0FybjtcblxuICAgICAgY29uc3RydWN0b3IoczogQ29uc3RydWN0LCBpOiBzdHJpbmcpIHtcbiAgICAgICAgc3VwZXIocywgaSwge1xuICAgICAgICAgIGVudmlyb25tZW50RnJvbUFybjogYWxpYXNBcm4sXG4gICAgICAgIH0pO1xuICAgICAgfVxuICAgIH1cbiAgICByZXR1cm4gbmV3IEltcG9ydChzY29wZSwgaWQpO1xuICB9XG5cbiAgLyoqXG4gICAqIFRoZSBJZGVudGlmaWVyIG9mIHRoZSBhbGlhcy5cbiAgICovXG4gIHB1YmxpYyByZWFkb25seSBhbGlhc0lkOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAgKiBUaGUgQVJOIG9mIHRoZSBhbGlhcy5cbiAgICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgYWxpYXNBcm46IHN0cmluZztcblxuICAvKipcbiAgICogQSBmbGVldCB0aGF0IHRoZSBhbGlhcyBwb2ludHMgdG8uXG4gICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgZmxlZXQ/OiBJRmxlZXQ7XG5cbiAgY29uc3RydWN0b3Ioc2NvcGU6IENvbnN0cnVjdCwgaWQ6IHN0cmluZywgcHJvcHM6IEFsaWFzUHJvcHMpIHtcbiAgICBzdXBlcihzY29wZSwgaWQsIHtcbiAgICAgIHBoeXNpY2FsTmFtZTogcHJvcHMuYWxpYXNOYW1lLFxuICAgIH0pO1xuXG4gICAgaWYgKCFjZGsuVG9rZW4uaXNVbnJlc29sdmVkKHByb3BzLmFsaWFzTmFtZSkpIHtcbiAgICAgIGlmIChwcm9wcy5hbGlhc05hbWUubGVuZ3RoID4gMTAyNCkge1xuICAgICAgICB0aHJvdyBuZXcgRXJyb3IoYEFsaWFzIG5hbWUgY2FuIG5vdCBiZSBsb25nZXIgdGhhbiAxMDI0IGNoYXJhY3RlcnMgYnV0IGhhcyAke3Byb3BzLmFsaWFzTmFtZS5sZW5ndGh9IGNoYXJhY3RlcnMuYCk7XG4gICAgICB9XG4gICAgfVxuXG4gICAgaWYgKHByb3BzLmRlc2NyaXB0aW9uICYmICFjZGsuVG9rZW4uaXNVbnJlc29sdmVkKHByb3BzLmRlc2NyaXB0aW9uKSkge1xuICAgICAgaWYgKHByb3BzLmRlc2NyaXB0aW9uLmxlbmd0aCA+IDEwMjQpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKGBBbGlhcyBkZXNjcmlwdGlvbiBjYW4gbm90IGJlIGxvbmdlciB0aGFuIDEwMjQgY2hhcmFjdGVycyBidXQgaGFzICR7cHJvcHMuZGVzY3JpcHRpb24ubGVuZ3RofSBjaGFyYWN0ZXJzLmApO1xuICAgICAgfVxuICAgIH1cblxuICAgIGlmICghcHJvcHMudGVybWluYWxNZXNzYWdlICYmICFwcm9wcy5mbGVldCkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKCdFaXRoZXIgYSB0ZXJtaW5hbCBtZXNzYWdlIG9yIGEgZmxlZXQgbXVzdCBiZSBiaW5kZWQgdG8gdGhpcyBBbGlhcy4nKTtcbiAgICB9XG5cbiAgICBpZiAocHJvcHMudGVybWluYWxNZXNzYWdlICYmIHByb3BzLmZsZWV0KSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoJ0VpdGhlciBhIHRlcm1pbmFsIG1lc3NhZ2Ugb3IgYSBmbGVldCBtdXN0IGJlIGJpbmRlZCB0byB0aGlzIEFsaWFzLCBub3QgYm90aC4nKTtcbiAgICB9XG5cbiAgICBjb25zdCByZXNvdXJjZSA9IG5ldyBDZm5BbGlhcyh0aGlzLCAnUmVzb3VyY2UnLCB7XG4gICAgICBuYW1lOiBwcm9wcy5hbGlhc05hbWUsXG4gICAgICBkZXNjcmlwdGlvbjogcHJvcHMuZGVzY3JpcHRpb24sXG4gICAgICByb3V0aW5nU3RyYXRlZ3k6IHRoaXMucGFyc2VSb3V0aW5nU3RyYXRlZ3kocHJvcHMpLFxuICAgIH0pO1xuXG4gICAgdGhpcy5hbGlhc0lkID0gdGhpcy5nZXRSZXNvdXJjZU5hbWVBdHRyaWJ1dGUocmVzb3VyY2UucmVmKTtcbiAgICB0aGlzLmFsaWFzQXJuID0gY2RrLlN0YWNrLm9mKHNjb3BlKS5mb3JtYXRBcm4oe1xuICAgICAgc2VydmljZTogJ2dhbWVsaWZ0JyxcbiAgICAgIHJlc291cmNlOiAnYWxpYXMnLFxuICAgICAgcmVzb3VyY2VOYW1lOiB0aGlzLmFsaWFzSWQsXG4gICAgICBhcm5Gb3JtYXQ6IGNkay5Bcm5Gb3JtYXQuU0xBU0hfUkVTT1VSQ0VfTkFNRSxcbiAgICB9KTtcbiAgfVxuXG4gIHByaXZhdGUgcGFyc2VSb3V0aW5nU3RyYXRlZ3kocHJvcHM6IEFsaWFzUHJvcHMpOiBDZm5BbGlhcy5Sb3V0aW5nU3RyYXRlZ3lQcm9wZXJ0eSB7XG4gICAgaWYgKHByb3BzLmZsZWV0ICkge1xuICAgICAgcmV0dXJuIHtcbiAgICAgICAgZmxlZXRJZDogcHJvcHMuZmxlZXQuZmxlZXRJZCxcbiAgICAgICAgdHlwZTogJ1NJTVBMRScsXG4gICAgICB9O1xuICAgIH1cbiAgICByZXR1cm4ge1xuICAgICAgbWVzc2FnZTogcHJvcHMudGVybWluYWxNZXNzYWdlLFxuICAgICAgdHlwZTogJ1RFUk1JTkFMJyxcbiAgICB9O1xuICB9XG59XG5cbiJdfQ==

package/lib/build-fleet.js

@@ -151,5 +151,5 @@ class BuildFleet extends fleet_base_1.FleetBase {
 }
 exports.BuildFleet = BuildFleet;
 _a = JSII_RTTI_SYMBOL_1;
-BuildFleet[_a] = { fqn: "@aws-cdk/aws-gamelift-alpha.BuildFleet", version: "2.105.0-alpha.0" };
+BuildFleet[_a] = { fqn: "@aws-cdk/aws-gamelift-alpha.BuildFleet", version: "2.106.1-alpha.0" };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVpbGQtZmxlZXQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJidWlsZC1mbGVldC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7QUFBQSwyQ0FBMkM7QUFDM0Msd0NBQXdDO0FBR3hDLDZDQUE2RDtBQUM3RCwyREFBb0Q7QUErQnBEOzs7Ozs7Ozs7R0FTRztBQUNILE1BQWEsVUFBVyxTQUFRLHNCQUFTO0lBRXZDOztPQUVHO0lBQ0gsTUFBTSxDQUFDLGdCQUFnQixDQUFDLEtBQWdCLEVBQUUsRUFBVSxFQUFFLFlBQW9CO1FBQ3hFLE9BQU8sSUFBSSxDQUFDLG1CQUFtQixDQUFDLEtBQUssRUFBRSxFQUFFLEVBQUUsRUFBRSxPQUFPLEVBQUUsWUFBWSxFQUFFLENBQUMsQ0FBQztLQUN2RTtJQUVEOztPQUVHO0lBQ0gsTUFBTSxDQUFDLGlCQUFpQixDQUFDLEtBQWdCLEVBQUUsRUFBVSxFQUFFLGFBQXFCO1FBQzFFLE9BQU8sSUFBSSxDQUFDLG1CQUFtQixDQUFDLEtBQUssRUFBRSxFQUFFLEVBQUUsRUFBRSxRQUFRLEVBQUUsYUFBYSxFQUFFLENBQUMsQ0FBQztLQUN6RTtJQTZCRCxZQUFZLEtBQWdCLEVBQUUsRUFBVSxFQUFFLEtBQXNCO1FBQzlELEtBQUssQ0FBQyxLQUFLLEVBQUUsRUFBRSxFQUFFO1lBQ2YsWUFBWSxFQUFFLEtBQUssQ0FBQyxTQUFTO1NBQzlCLENBQUMsQ0FBQztRQUxZLGlCQUFZLEdBQWtCLEVBQUUsQ0FBQzs7Ozs7OytDQXpDdkMsVUFBVTs7OztRQWdEbkIsSUFBSSxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsWUFBWSxDQUFDLEtBQUssQ0FBQyxTQUFTLENBQUMsRUFBRTtZQUM1QyxJQUFJLEtBQUssQ0FBQyxTQUFTLENBQUMsTUFBTSxHQUFHLElBQUksRUFBRTtnQkFDakMsTUFBTSxJQUFJLEtBQUssQ0FBQyw2REFBNkQsS0FBSyxDQUFDLFNBQVMsQ0FBQyxNQUFNLGNBQWMsQ0FBQyxDQUFDO2FBQ3BIO1NB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bXBvcnQgKiBhcyBjZGsgZnJvbSAnYXdzLWNkay1saWIvY29yZSc7XG5pbXBvcnQgeyBDb25zdHJ1Y3QgfSBmcm9tICdjb25zdHJ1Y3RzJztcbmltcG9ydCB7IElCdWlsZCB9IGZyb20gJy4vYnVpbGQnO1xuaW1wb3J0IHsgRmxlZXRCYXNlLCBGbGVldFByb3BzLCBJRmxlZXQgfSBmcm9tICcuL2ZsZWV0LWJhc2UnO1xuaW1wb3J0IHsgQ2ZuRmxlZXQgfSBmcm9tICdhd3MtY2RrLWxpYi9hd3MtZ2FtZWxpZnQnO1xuaW1wb3J0IHsgUG9ydCwgSVBlZXIsIEluZ3Jlc3NSdWxlIH0gZnJvbSAnLi9pbmdyZXNzLXJ1bGUnO1xuXG4vKipcbiAqIFJlcHJlc2VudHMgYSBHYW1lTGlmdCBGbGVldCB1c2VkIHRvIHJ1biBhIGN1c3RvbSBnYW1lIGJ1aWxkLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIElCdWlsZEZsZWV0IGV4dGVuZHMgSUZsZWV0IHt9XG5cbi8qKlxuICogUHJvcGVydGllcyBmb3IgYSBuZXcgR2FtZWxpZnQgYnVpbGQgZmxlZXRcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBCdWlsZEZsZWV0UHJvcHMgZXh0ZW5kcyBGbGVldFByb3BzIHtcblxuICAvKipcbiAgICAgKiBBIGJ1aWxkIHRvIGJlIGRlcGxveWVkIG9uIHRoZSBmbGVldC5cbiAgICAgKiBUaGUgYnVpbGQgbXVzdCBoYXZlIGJlZW4gc3VjY2Vzc2Z1bGx5IHVwbG9hZGVkIHRvIEFtYXpvbiBHYW1lTGlmdCBhbmQgYmUgaW4gYSBgUkVBRFlgIHN0YXR1cy5cbiAgICAgKlxuICAgICAqIFRoaXMgZmxlZXQgc2V0dGluZyBjYW5ub3QgYmUgY2hhbmdlZCBvbmNlIHRoZSBmbGVldCBpcyBjcmVhdGVkLlxuICAgICAqL1xuICByZWFkb25seSBjb250ZW50OiBJQnVpbGQ7XG5cbiAgLyoqXG4gICAqIFRoZSBhbGxvd2VkIElQIGFkZHJlc3MgcmFuZ2VzIGFuZCBwb3J0IHNldHRpbmdzIHRoYXQgYWxsb3cgaW5ib3VuZCB0cmFmZmljIHRvIGFjY2VzcyBnYW1lIHNlc3Npb25zIG9uIHRoaXMgZmxlZXQuXG4gICAqXG4gICAqIFRoaXMgcHJvcGVydHkgbXVzdCBiZSBzZXQgYmVmb3JlIHBsYXllcnMgY2FuIGNvbm5lY3QgdG8gZ2FtZSBzZXNzaW9ucy5cbiAgICpcbiAgICogQGRlZmF1bHQgbm8gaW5ib3VuZCB0cmFmZmljIGFsbG93ZWRcbiAgICovXG4gIHJlYWRvbmx5IGluZ3Jlc3NSdWxlcz86IEluZ3Jlc3NSdWxlW107XG59XG5cbi8qKlxuICogQSBmbGVldCBjb250YWlucyBBbWF6b24gRWxhc3RpYyBDb21wdXRlIENsb3VkIChBbWF6b24gRUMyKSBpbnN0YW5jZXMgdGhhdCBHYW1lTGlmdCBob3N0cy5cbiAqIEEgZmxlZXQgdXNlcyB0aGUgY29uZmlndXJhdGlvbiBhbmQgc2NhbGluZyBsb2dpYyB0aGF0IHlvdSBkZWZpbmUgdG8gcnVuIHlvdXIgZ2FtZSBzZXJ2ZXIgYnVpbGQuIFlvdSBjYW4gdXNlIGEgZmxlZXQgZGlyZWN0bHkgd2l0aG91dCBhIHF1ZXVlLlxuICogWW91IGNhbiBhbHNvIGFzc29jaWF0ZSBtdWx0aXBsZSBmbGVldHMgd2l0aCBhIEdhbWVMaWZ0IHF1ZXVlLlxuICpcbiAqIEZvciBleGFtcGxlLCB5b3UgY2FuIHVzZSBTcG90IEluc3RhbmNlIGZsZWV0cyBjb25maWd1cmVkIHdpdGggeW91ciBwcmVmZXJyZWQgbG9jYXRpb25zLCBhbG9uZyB3aXRoIGEgYmFja3VwIE9uLURlbWFuZCBJbnN0YW5jZSBmbGVldCB3aXRoIHRoZSBzYW1lIGxvY2F0aW9ucy5cbiAqIFVzaW5nIG11bHRpcGxlIFNwb3QgSW5zdGFuY2UgZmxlZXRzIG9mIGRpZmZlcmVudCBpbnN0YW5jZSB0eXBlcyByZWR1Y2VzIHRoZSBjaGFuY2Ugb2YgbmVlZGluZyBPbi1EZW1hbmQgSW5zdGFuY2UgcGxhY2VtZW50LlxuICpcbiAqIEByZXNvdXJjZSBBV1M6OkdhbWVMaWZ0OjpGbGVldFxuICovXG5leHBvcnQgY2xhc3MgQnVpbGRGbGVldCBleHRlbmRzIEZsZWV0QmFzZSBpbXBsZW1lbnRzIElCdWlsZEZsZWV0IHtcblxuICAvKipcbiAgICogSW1wb3J0IGFuIGV4aXN0aW5nIGZsZWV0IGZyb20gaXRzIGlkZW50aWZpZXIuXG4gICAqL1xuICBzdGF0aWMgZnJvbUJ1aWxkRmxlZXRJZChzY29wZTogQ29uc3RydWN0LCBpZDogc3RyaW5nLCBidWlsZEZsZWV0SWQ6IHN0cmluZyk6IElCdWlsZEZsZWV0IHtcbiAgICByZXR1cm4gdGhpcy5mcm9tRmxlZXRBdHRyaWJ1dGVzKHNjb3BlLCBpZCwgeyBmbGVldElkOiBidWlsZEZsZWV0SWQgfSk7XG4gIH1cblxuICAvKipcbiAgICogSW1wb3J0IGFuIGV4aXN0aW5nIGZsZWV0IGZyb20gaXRzIEFSTi5cbiAgICovXG4gIHN0YXRpYyBmcm9tQnVpbGRGbGVldEFybihzY29wZTogQ29uc3RydWN0LCBpZDogc3RyaW5nLCBidWlsZEZsZWV0QXJuOiBzdHJpbmcpOiBJQnVpbGRGbGVldCB7XG4gICAgcmV0dXJuIHRoaXMuZnJvbUZsZWV0QXR0cmlidXRlcyhzY29wZSwgaWQsIHsgZmxlZXRBcm46IGJ1aWxkRmxlZXRBcm4gfSk7XG4gIH1cblxuICAvKipcbiAgICogVGhlIElkZW50aWZpZXIgb2YgdGhlIGZsZWV0LlxuICAgKi9cbiAgcHVibGljIHJlYWRvbmx5IGZsZWV0SWQ6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIEFSTiBvZiB0aGUgZmxlZXQuXG4gICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgZmxlZXRBcm46IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIGJ1aWxkIGNvbnRlbnQgb2YgdGhlIGZsZWV0XG4gICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgY29udGVudDogSUJ1aWxkO1xuXG4gIC8qKlxuICAgKiBUaGUgSUFNIHJvbGUgR2FtZUxpZnQgYXNzdW1lcyBieSBmbGVldCBpbnN0YW5jZXMgdG8gYWNjZXNzIEFXUyByZXNzb3VyY2VzLlxuICAgKi9cbiAgcHVibGljIHJlYWRvbmx5IHJvbGU6IGlhbS5JUm9sZTtcblxuICAvKipcbiAgICogVGhlIHByaW5jaXBhbCB0aGlzIEdhbWVMaWZ0IGZsZWV0IGlzIHVzaW5nLlxuICAgKi9cbiAgcHVibGljIHJlYWRvbmx5IGdyYW50UHJpbmNpcGFsOiBpYW0uSVByaW5jaXBhbDtcblxuICBwcml2YXRlIHJlYWRvbmx5IGluZ3Jlc3NSdWxlczogSW5ncmVzc1J1bGVbXSA9IFtdO1xuXG4gIGNvbnN0cnVjdG9yKHNjb3BlOiBDb25zdHJ1Y3QsIGlkOiBzdHJpbmcsIHByb3BzOiBCdWlsZEZsZWV0UHJvcHMpIHtcbiAgICBzdXBlcihzY29wZSwgaWQsIHtcbiAgICAgIHBoeXNpY2FsTmFtZTogcHJvcHMuZmxlZXROYW1lLFxuICAgIH0pO1xuXG4gICAgaWYgKCFjZGsuVG9rZW4uaXNVbnJlc29sdmVkKHByb3BzLmZsZWV0TmFtZSkpIHtcbiAgICAgIGlmIChwcm9wcy5mbGVldE5hbWUubGVuZ3RoID4gMTAyNCkge1xuICAgICAgICB0aHJvdyBuZXcgRXJyb3IoYEZsZWV0IG5hbWUgY2FuIG5vdCBiZSBsb25nZXIgdGhhbiAxMDI0IGNoYXJhY3RlcnMgYnV0IGhhcyAke3Byb3BzLmZsZWV0TmFtZS5sZW5ndGh9IGNoYXJhY3RlcnMuYCk7XG4gICAgICB9XG4gICAgfVxuXG4gICAgaWYgKHByb3BzLmRlc2NyaXB0aW9uICYmICFjZGsuVG9rZW4uaXNVbnJlc29sdmVkKHByb3BzLmRlc2NyaXB0aW9uKSkge1xuICAgICAgaWYgKHByb3BzLmRlc2NyaXB0aW9uLmxlbmd0aCA+IDEwMjQpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKGBGbGVldCBkZXNjcmlwdGlvbiBjYW4gbm90IGJlIGxvbmdlciB0aGFuIDEwMjQgY2hhcmFjdGVycyBidXQgaGFzICR7cHJvcHMuZGVzY3JpcHRpb24ubGVuZ3RofSBjaGFyYWN0ZXJzLmApO1xuICAgICAgfVxuICAgIH1cblxuICAgIGlmIChwcm9wcy5taW5TaXplICYmIHByb3BzLm1pblNpemUgPCAwKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYFRoZSBtaW5pbXVtIG51bWJlciBvZiBpbnN0YW5jZXMgYWxsb3dlZCBpbiB0aGUgRmxlZXQgY2Fubm90IGJlIGxvd2VyIHRoYW4gMCwgZ2l2ZW4gJHtwcm9wcy5taW5TaXplfWApO1xuICAgIH1cblxuICAgIGlmIChwcm9wcy5tYXhTaXplICYmIHByb3BzLm1heFNpemUgPCAwKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYFRoZSBtYXhpbXVtIG51bWJlciBvZiBpbnN0YW5jZXMgYWxsb3dlZCBpbiB0aGUgRmxlZXQgY2Fubm90IGJlIGxvd2VyIHRoYW4gMCwgZ2l2ZW4gJHtwcm9wcy5tYXhTaXplfWApO1xuICAgIH1cblxuICAgIGlmIChwcm9wcy5wZWVyVnBjKSB7XG4gICAgICB0aGlzLndhcm5WcGNQZWVyaW5nQXV0aG9yaXphdGlvbnModGhpcyk7XG4gICAgfVxuXG4gICAgLy8gQWRkIGFsbCBsb2NhdGlvbnNcbiAgICBpZiAocHJvcHMubG9jYXRpb25zICYmIHByb3BzLmxvY2F0aW9ucz8ubGVuZ3RoID4gMTAwKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYE5vIG1vcmUgdGhhbiAxMDAgbG9jYXRpb25zIGFyZSBhbGxvd2VkIHBlciBmbGVldCwgZ2l2ZW4gJHtwcm9wcy5sb2NhdGlvbnMubGVuZ3RofWApO1xuICAgIH1cbiAgICAocHJvcHMubG9jYXRpb25zIHx8IFtdKS5mb3JFYWNoKHRoaXMuYWRkSW50ZXJuYWxMb2NhdGlvbi5iaW5kKHRoaXMpKTtcblxuICAgIC8vIEFkZCBhbGwgSW5ncmVzcyBydWxlc1xuICAgIGlmIChwcm9wcy5pbmdyZXNzUnVsZXMgJiYgcHJvcHMuaW5ncmVzc1J1bGVzPy5sZW5ndGggPiA1MCkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKGBObyBtb3JlIHRoYW4gNTAgaW5ncmVzcyBydWxlcyBhcmUgYWxsb3dlZCBwZXIgZmxlZXQsIGdpdmVuICR7cHJvcHMuaW5ncmVzc1J1bGVzLmxlbmd0aH1gKTtcbiAgICB9XG4gICAgKHByb3BzLmluZ3Jlc3NSdWxlcyB8fCBbXSkuZm9yRWFjaCh0aGlzLmFkZEludGVybmFsSW5ncmVzc1J1bGUuYmluZCh0aGlzKSk7XG5cbiAgICB0aGlzLmNvbnRlbnQgPSBwcm9wcy5jb250ZW50O1xuICAgIHRoaXMucm9sZSA9IHByb3BzLnJvbGUgPz8gbmV3IGlhbS5Sb2xlKHRoaXMsICdTZXJ2aWNlUm9sZScsIHtcbiAgICAgIGFzc3VtZWRCeTogbmV3IGlhbS5Db21wb3NpdGVQcmluY2lwYWwoXG4gICAgICAgIG5ldyBpYW0uU2VydmljZVByaW5jaXBhbCgnZ2FtZWxpZnQuYW1hem9uYXdzLmNvbScpLFxuICAgICAgICBuZXcgaWFtLlNlcnZpY2VQcmluY2lwYWwoJ2VjMi5hbWF6b25hd3MuY29tJykpLFxuICAgIH0pO1xuICAgIHRoaXMuZ3JhbnRQcmluY2lwYWwgPSB0aGlzLnJvbGU7XG5cbiAgICBjb25zdCByZXNvdXJjZSA9IG5ldyBDZm5GbGVldCh0aGlzLCAnUmVzb3VyY2UnLCB7XG4gICAgICBidWlsZElkOiB0aGlzLmNvbnRlbnQuYnVpbGRJZCxcbiAgICAgIGNlcnRpZmljYXRlQ29uZmlndXJhdGlvbjoge1xuICAgICAgICBjZXJ0aWZpY2F0ZVR5cGU6IHByb3BzLnVzZUNlcnRpZmljYXRlID8gJ0dFTkVSQVRFRCc6ICdESVNBQkxFRCcsXG4gICAgICB9LFxuICAgICAgZGVzY3JpcHRpb246IHByb3BzLmRlc2NyaXB0aW9uLFxuICAgICAgZGVzaXJlZEVjMkluc3RhbmNlczogcHJvcHMuZGVzaXJlZENhcGFjaXR5LFxuICAgICAgZWMySW5ib3VuZFBlcm1pc3Npb25zOiBjZGsuTGF6eS5hbnkoeyBwcm9kdWNlOiAoKSA9PiB0aGlzLnBhcnNlSW5ncmVzc1J1bGVzKCkgfSksXG4gICAgICBlYzJJbnN0YW5jZVR5cGU6IHByb3BzLmluc3RhbmNlVHlwZS50b1N0cmluZygpLFxuICAgICAgZmxlZXRUeXBlOiBwcm9wcy51c2VTcG90ID8gJ1NQT1QnIDogJ09OX0RFTUFORCcsXG4gICAgICBpbnN0YW5jZVJvbGVBcm46IHRoaXMucm9sZS5yb2xlQXJuLFxuICAgICAgbG9jYXRpb25zOiBjZGsuTGF6eS5hbnkoeyBwcm9kdWNlOiAoKSA9PiB0aGlzLnBhcnNlTG9jYXRpb25zKCkgfSksXG4gICAgICBtYXhTaXplOiBwcm9wcy5tYXhTaXplID8gcHJvcHMubWF4U2l6ZSA6IDEsXG4gICAgICBtaW5TaXplOiBwcm9wcy5taW5TaXplID8gcHJvcHMubWluU2l6ZSA6IDAsXG4gICAgICBuYW1lOiB0aGlzLnBoeXNpY2FsTmFtZSxcbiAgICAgIG5ld0dhbWVTZXNzaW9uUHJvdGVjdGlvblBvbGljeTogcHJvcHMucHJvdGVjdE5ld0dhbWVTZXNzaW9uID8gJ0Z1bGxQcm90ZWN0aW9uJyA6ICdOb1Byb3RlY3Rpb24nLFxuICAgICAgcGVlclZwY0F3c0FjY291bnRJZDogcHJvcHMucGVlclZwYyAmJiBwcm9wcy5wZWVyVnBjLmVudi5hY2NvdW50LFxuICAgICAgcGVlclZwY0lkOiBwcm9wcy5wZWVyVnBjICYmIHByb3BzLnBlZXJWcGMudnBjSWQsXG4gICAgICByZXNvdXJjZUNyZWF0aW9uTGltaXRQb2xpY3k6IHRoaXMucGFyc2VSZXNvdXJjZUNyZWF0aW9uTGltaXRQb2xpY3kocHJvcHMpLFxuICAgICAgcnVudGltZUNvbmZpZ3VyYXRpb246IHRoaXMucGFyc2VSdW50aW1lQ29uZmlndXJhdGlvbihwcm9wcyksXG4gICAgfSk7XG5cbiAgICB0aGlzLmZsZWV0SWQgPSB0aGlzLmdldFJlc291cmNlTmFtZUF0dHJpYnV0ZShyZXNvdXJjZS5yZWYpO1xuICAgIHRoaXMuZmxlZXRBcm4gPSBjZGsuU3RhY2sub2Yoc2NvcGUpLmZvcm1hdEFybih7XG4gICAgICBzZXJ2aWNlOiAnZ2FtZWxpZnQnLFxuICAgICAgcmVzb3VyY2U6ICdmbGVldCcsXG4gICAgICByZXNvdXJjZU5hbWU6IHRoaXMuZmxlZXRJZCxcbiAgICAgIGFybkZvcm1hdDogY2RrLkFybkZvcm1hdC5TTEFTSF9SRVNPVVJDRV9OQU1FLFxuICAgIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIEFkZHMgYW4gaW5ncmVzcyBydWxlIHRvIGFsbG93IGluYm91bmQgdHJhZmZpYyB0byBhY2Nlc3MgZ2FtZSBzZXNzaW9ucyBvbiB0aGlzIGZsZWV0LlxuICAgKlxuICAgKiBAcGFyYW0gc291cmNlIEEgcmFuZ2Ugb2YgYWxsb3dlZCBJUCBhZGRyZXNzZXNcbiAgICogQHBhcmFtIHBvcnQgVGhlIHBvcnQgcmFuZ2UgdXNlZCBmb3IgaW5ncmVzcyB0cmFmZmljXG4gICAqL1xuICBwdWJsaWMgYWRkSW5ncmVzc1J1bGUoc291cmNlOiBJUGVlciwgcG9ydDogUG9ydCkge1xuICAgIHRoaXMuYWRkSW50ZXJuYWxJbmdyZXNzUnVsZSh7XG4gICAgICBzb3VyY2U6IHNvdXJjZSxcbiAgICAgIHBvcnQ6IHBvcnQsXG4gICAgfSk7XG4gIH1cblxuICBwcml2YXRlIGFkZEludGVybmFsSW5ncmVzc1J1bGUoaW5ncmVzc1J1bGU6IEluZ3Jlc3NSdWxlKSB7XG4gICAgaWYgKHRoaXMuaW5ncmVzc1J1bGVzLmxlbmd0aCA9PSA1MCkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKCdObyBtb3JlIHRoYW4gNTAgaW5ncmVzcyBydWxlcyBhcmUgYWxsb3dlZCBwZXIgZmxlZXQnKTtcbiAgICB9XG4gICAgdGhpcy5pbmdyZXNzUnVsZXMucHVzaChpbmdyZXNzUnVsZSk7XG4gIH1cblxuICBwcml2YXRlIHBhcnNlSW5ncmVzc1J1bGVzKCk6IENmbkZsZWV0LklwUGVybWlzc2lvblByb3BlcnR5W10gfCB1bmRlZmluZWQge1xuICAgIGlmICghdGhpcy5pbmdyZXNzUnVsZXMgfHwgdGhpcy5pbmdyZXNzUnVsZXMubGVuZ3RoID09PSAwKSB7XG4gICAgICByZXR1cm4gdW5kZWZpbmVkO1xuICAgIH1cblxuICAgIHJldHVybiB0aGlzLmluZ3Jlc3NSdWxlcy5tYXAocGFyc2VJbmdyZXNzUnVsZSk7XG5cbiAgICBmdW5jdGlvbiBwYXJzZUluZ3Jlc3NSdWxlKGluZ3Jlc3NSdWxlOiBJbmdyZXNzUnVsZSk6IENmbkZsZWV0LklwUGVybWlzc2lvblByb3BlcnR5IHtcbiAgICAgIHJldHVybiB7XG4gICAgICAgIC4uLmluZ3Jlc3NSdWxlLnBvcnQudG9Kc29uKCksXG4gICAgICAgIC4uLmluZ3Jlc3NSdWxlLnNvdXJjZS50b0pzb24oKSxcbiAgICAgIH07XG4gICAgfVxuICB9XG59Il19

package/lib/build.d.ts

@@ -45,9 +45,30 @@ export declare abstract class BuildBase extends cdk.Resource implements IBuild {
  * The operating system that the game server binaries are built to run on.
  */
 export declare enum OperatingSystem {
+    /**
+     * Amazon Linux operating system.
+     */
     AMAZON_LINUX = "AMAZON_LINUX",
+    /**
+     * Amazon Linux 2 operating system.
+     */
     AMAZON_LINUX_2 = "AMAZON_LINUX_2",
-    WINDOWS_2012 = "WINDOWS_2012"
+    /**
+     * Amazon Linux 2023 operating system.
+     */
+    AMAZON_LINUX_2023 = "AMAZON_LINUX_2023",
+    /**
+     * Windows Server 2012 operating system.
+     *
+     * @deprecated If you have active fleets using the Windows Server 2012 operating system,
+     * you can continue to create new builds using this OS until October 10, 2023, when Microsoft ends its support.
+     * All others must use Windows Server 2016 when creating new Windows-based builds.
+     */
+    WINDOWS_2012 = "WINDOWS_2012",
+    /**
+     * Windows Server 2016 operating system.
+     */
+    WINDOWS_2016 = "WINDOWS_2016"
 }
 /**
  * Represents a Build content defined outside of this stack.
@@ -123,6 +144,14 @@ export interface BuildProps {
       * @default - a role will be created with default permissions.
       */
     readonly role?: iam.IRole;
+    /**
+     * A server SDK version you used when integrating your game server build with Amazon GameLift.
+     *
+     * @see https://docs.aws.amazon.com/gamelift/latest/developerguide/integration-custom-intro.html
+     *
+     * @default - 4.0.2
+     */
+    readonly serverSdkVersion?: string;
 }
 /**
  * A GameLift build, that is installed and runs on instances in an Amazon GameLift fleet. It consists of
@@ -170,4 +199,5 @@ export declare class Build extends BuildBase {
      */
     readonly grantPrincipal: iam.IPrincipal;
     constructor(scope: Construct, id: string, props: BuildProps);
+    private validateServerSdkVersion;
 }