Open Match – Open Match Blog

Blog: 1.6.0

Wed, 14 Dec 2022 00:00:00 +0000

This is the 1.6.0 release of Open Match.

Check the official website for details on features, installation and usage.

Release Notes

Feature Highlights

HPA configuration can now be applied to each individual service separately #1390
Open-match-override setting is configurable from values.yaml file #1490

Breaking Changes

Security Fixes

Validation checks are applied on the necessary config values for their default values #1013

Enhancements

Migrated e2e-tests are accessible at subpackage open-match.dev/open-match/testing #1302

Usage Requirements

Kubernetes Version >= 1.21
- Not 1.25 until issue #1449 has been closed
Golang Version >= v1.15
Helm Version >= 3.8

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

gRPC API Definitions are available in API references - Preferred
HTTP API Definitions are available in SwaggerUI

Blog: 1.6.0-rc.1

Wed, 07 Dec 2022 00:00:00 +0000

This is the 1.6.0-rc.1 release of Open Match.

Check the official website for details on features, installation and usage.

Release Notes

Feature Highlights

HPA configuration can now be applied to each individual service separately #1390
Open-match-override setting is configurable from values.yaml file #1490

Breaking Changes

Security Fixes

Validation checks are applied on the necessary config values for their default values #1013

Enhancements

Migrated e2e-tests are accessible at subpackage open-match.dev/open-match/testing #1302

Usage Requirements

Kubernetes Version >= 1.21
- Not 1.25 until issue #1449 has been closed
Golang Version >= v1.15
Helm Version >= 3.8

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

gRPC API Definitions are available in API references - Preferred
HTTP API Definitions are available in SwaggerUI

Blog: 1.5.0

Fri, 07 Oct 2022 00:00:00 +0000

This is the 1.5.0 release of Open Match.

Check the official website for details on features, installation and usage.

Release Notes

Feature Highlights

New parameters for monitoring ticket behavior in open-match added (#1482) with dashboards included (#1501)
Provision to add custom annotations for service accounts #1469
Website www.open-match.dev is now indexed in google search engine #1453

Breaking Changes

Added ‘Persistent Field’ to tickets to ensure metadata persistence during backfill #1426
Fix: Added documentation to delete open-match namespace in helm to clean old tickets data #1477
The helm chart versions of telemetry components are updated. #1462

Chart	Current	Updating to
Prometheus	9.2.0	15.8.7
Grafana	4.0.1	6.29.3
Jaeger	0.13.3	0.56.5

Security Fixes

Default value of assignDeleteTimeout nullify the chances of unexpected behaviour #1465
Package updation github.com/gogo/protobuf due to security vulnerability #1459

Enhancements

Code implementation of execution workflow in WatchAssignment is refined #1472
Documentation updated for tutorial instructions to try on latest stable release branch #1470

Usage Requirements

Kubernetes Version >= 1.22
Golang Version >= v1.15
Helm Version >= 3.8

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

gRPC API Definitions are available in API references - Preferred
HTTP API Definitions are available in SwaggerUI

Blog: 1.5.0-rc.1

Fri, 23 Sep 2022 00:00:00 +0000

This is the 1.5.0-rc.1 release of Open Match.

Check the official website for details on features, installation and usage.

Release Notes

Feature Highlights

New parameters for monitoring ticket behaviour in open-match added #1482
Provision to add custom annotations for service accounts #1469
Website www.open-match.dev is now indexed in google search engine #1453

Breaking Changes

Added ‘Persistent Field’ to tickets to ensure metadata persistence during backfill #1426
Fix: Added documentation to delete open-match namespace in helm to clean old tickets data #1477
The helm chart versions of telemetry components are updated. #1462

Chart	Current	Updating to
Prometheus	9.2.0	15.8.7
Grafana	4.0.1	6.29.3
Jaeger	0.13.3	0.56.5

Security Fixes

Default value of assignDeleteTimeout nullify the chances of unexpected behaviour #1465
Package updation github.com/gogo/protobuf due to security vulnerability #1459

Enhancements

Code implementation of execution workflow in WatchAssignment is refined #1472
Documentation updated for tutorial instructions to try on latest stable release branch #1470

Usage Requirements

Kubernetes Version >= 1.21
Golang Version >= v1.15
Helm Version >= 3.8

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

gRPC API Definitions are available in API references - Preferred
HTTP API Definitions are available in SwaggerUI

Blog: 1.4.0

Wed, 17 Aug 2022 00:00:00 +0000

This is the v1.4.0 release of Open Match.

Check the official website for details on features, installation and usage.

Release Notes

Feature Highlights

Redis helm chart version change to 16.3.1 (#1440)
Patched bug that resulted in multiple redis master nodes which fixed (#1374) :
- Query service returning no tickets (#1420)
- Existing tickets not found for a WatchAssignmentsRequest (#1428)
AssignTickets empty check and test cases added (#1438)
Redis default values update (#1430)
Fixed outdated apiVersion in frontend scale testing helm template (#1419)

Breaking Changes

Updating the Redis helm chart version to 16.3.1 (#1440) requires changes to the api
- slave –> replica
- usePassword: –> auth: enabled:
- redis.fullname –> common.names.fullname
Outdated apiVersion in frontend scale testing helm template (#1419)
- extensions/v1beta1 –> apps/v1

Enhancements

Increased minimum resources based on best practices (#1439)
docker build optimization by using mount cache for go dependencies (#1435)

Usage Requirements

Kubernetes Version >= 1.21
Golang Version >= v1.15
Helm Version >= 3.8

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

gRPC API Definitions are available in API references - Preferred
HTTP API Definitions are available in SwaggerUI

Blog: 1.4.0-rc.1

Fri, 22 Apr 2022 00:00:00 +0000

This is the v1.4.0-rc.1 release of Open Match.

Check the official website for details on features, installation and usage.

Release Notes

Feature Highlights

Redis helm chart version change to 16.3.1 (#1440)
Patched bug that resulted in multiple redis master nodes which fixed (#1374) :
- Query service returning no tickets (#1420)
- Existing tickets not found for a WatchAssignmentsRequest (#1428)
AssignTickets empty check and test cases added (#1438)
Redis default values update (#1430)
Fixed outdated apiVersion in frontend scale testing helm template (#1419)

Breaking Changes

Updating the Redis helm chart version to 16.3.1 (#1440) requires changes to the api
- slave –> replica
- usePassword: –> auth: enabled:
- redis.fullname –> common.names.fullname
Outdated apiVersion in frontend scale testing helm template (#1419)
- extensions/v1beta1 –> apps/v1

Enhancements

Increased minimum resources based on best practices (#1439)
docker build optimization by using mount cache for go dependencies (#1435)

Usage Requirements

Kubernetes Version >= 1.21
Golang Version >= v1.14
Helm Version >= 3.8

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

gRPC API Definitions are available in API references - Preferred
HTTP API Definitions are available in SwaggerUI

Blog: 1.7.0

Thu, 17 Feb 2022 00:00:00 +0000

This is the 1.7.0 release of Open Match.

Check the official website for details on features, installation and usage.

Release Notes

Feature Highlights

Golang version is updated to 1.19.5 to support the ongoing changes in all dependencies #1443
A guide to setup redis enterprise integration with open-match is now available in tutorials #1517

Breaking Changes

Major changes includes updated toolchain and protobuf files following Golang version update #1444

Security Fixes

Ensuring the latest version of dependency package github.com/gogo/protobuf #1529
Removed the vulnerability in open-match documentation website’s swaggerui component #1521

Enhancements

Added Content-Type header in HTTP request to Match Functions helps in parsing JSON body #1530
Fetching Bitnami’s redis helm chart from archives to align with the updated retention policy #1523
Dependency packages are updated to latest versions #1531

Usage Requirements

Kubernetes Version >= 1.21
- Not 1.25 until issue #1449 has been closed
Golang Version >= v1.18
Helm Version >= 3.8

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

gRPC API Definitions are available in API references - Preferred
HTTP API Definitions are available in SwaggerUI

Blog: 1.7.0-rc.1

Thu, 10 Feb 2022 00:00:00 +0000

This is the 1.7.0-rc.1 release of Open Match.

Check the official website for details on features, installation and usage.

Release Notes

Feature Highlights

Golang version is updated to 1.19.5 to support the ongoing changes in all dependencies #1443
A guide to setup redis enterprise integration with open-match is now available in tutorials #1517

Breaking Changes

Major changes includes updated toolchain and protobuf files following Golang version update #1444

Security Fixes

Ensuring the latest version of dependency package github.com/gogo/protobuf #1529
Removed the vulnerability in open-match documentation website’s swaggerui component #1521

Enhancements

Added Content-Type header in HTTP request to Match Functions helps in parsing JSON body #1530
Fetching Bitnami’s redis helm chart from archives to align with the updated retention policy #1523
Dependency packages are updated to latest versions #1531

Usage Requirements

Kubernetes Version >= 1.21
- Not 1.25 until issue #1449 has been closed
Golang Version >= v1.18
Helm Version >= 3.8

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

gRPC API Definitions are available in API references - Preferred
HTTP API Definitions are available in SwaggerUI

Blog: 1.3.0

Fri, 15 Oct 2021 00:00:00 +0000

This is the v1.3.0 release of Open Match.

Check the official website for details on features, installation and usage.

Release Notes

Feature Highlights

Tickets assigned by Backfill now visible in AcknowledgeBackfillResponse (#1382)

Breaking Changes

AcknowledgeBackfill now returns AcknowledgeBackfillResponse instead of Backfill (#1382)

Enhancements

Workload Identity re-enabled for GKE clusters (#1403)
Default GKE Cluster version updated to 1.20 (#1402)
gRPC versions for tutorials updated to 1.36 (#1402)

Usage Requirements

Kubernetes Version >= 1.20
Golang Version >= v1.14

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

gRPC API Definitions are available in API references - Preferred
HTTP API Definitions are available in SwaggerUI

Blog: 1.3.0-rc.1

Mon, 20 Sep 2021 00:00:00 +0000

This is the v1.3.0-rc.1 release of Open Match.

Check the official website for details on features, installation and usage.

Release Notes

Feature Highlights

Tickets assigned by Backfill now visible in AcknowledgeBackfillResponse (#1382)

Breaking Changes

AcknowledgeBackfill now returns AcknowledgeBackfillResponse instead of Backfill (#1382)

Enhancements

Workload Identity re-enabled for GKE clusters (#1403)
Default GKE Cluster version updated to 1.20 (#1402)
gRPC versions for tutorials updated to 1.36 (#1402)

Usage Requirements

Kubernetes Version >= 1.20
Golang Version >= v1.14

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

gRPC API Definitions are available in API references - Preferred
HTTP API Definitions are available in SwaggerUI

Blog: 1.2.0

Mon, 03 May 2021 00:00:00 +0000

This is the v1.2.0 release of Open Match.

Check the README for details on features, installation and usage.

Release Notes

Feature Highlights Beta release for Backfill Feature

Backend
- Index Backfill (#1318)
- Autoincrement Backfill generation for caching (#1308)
Frontend
- Acknowledge Backfill (#1293)
- Update/Delete Backfill (#1292)
- Frontend can create backfill ticket (#1279)
Statestore
- Querying and Caching Backfill (#1310)
- Update backfill after MMF execution completion (#1299)
- Backfill indexing (#1290)
- Acknowledge Backfill (#1288)
- Statestore Backfill Support (#1273)
Query
- Querying and Caching Backfill (#1310)
Synchronizer
- Clean up expired backfills (#1334, #1297)

Breaking Changes - Previous releases are not compatible with this release.

Updated Redis chart location (#1315)
Update location for stable and incubator charts (#1314)

Enhancements

Update to gRPC Gateway v2 (#1358)
Clients can cancel WatchAssignment request (#1350)
Added Pod Tolerations, NodeSelector and Affinity in Helm for subcharts (#1311)
Improved logging and error output/reporting (#1352, #1349, #1347, #1344, #1343, #1340, #1332, #1331, #1320, #1287)

Usage Requirements

Kubernetes Version >= v1.15
Golang Version >= v1.14

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

Available both in SwaggerUI and API references.

Blog: 1.2.0-rc.1

Thu, 15 Apr 2021 00:00:00 +0000

This is the v1.2.0-rc.1 release of Open Match.

Check the README for details on features, installation and usage.

Release Notes

Feature Highlights Beta release for Backfill Feature

Backend
- Index Backfill (#1318)
- Autoincrement Backfill generation for caching (#1308)
Frontend
- Acknowledge Backfill (#1293)
- Update/Delete Backfill (#1292)
- Frontend can create backfill ticket (#1279)
Statestore
- Querying and Caching Backfill (#1310)
- Update backfill after MMF execution completion (#1299)
- Backfill indexing (#1290)
- Acknowledge Backfill (#1288)
- Statestore Backfill Support (#1273)
Query
- Querying and Caching Backfill (#1310)
Synchronizer
- Clean up expired backfills (#1334, #1297)

Breaking Changes - Previous releases are not compatible with this release.

Updated Redis chart location (#1315)
Update location for stable and incubator charts (#1314)

Enhancements

Update to gRPC Gateway v2 (#1358)
Clients can cancel WatchAssignment request (#1350)
Added Pod Tolerations, NodeSelector and Affinity in Helm for subcharts (#1311)
Improved logging and error output/reporting (#1352, #1349, #1347, #1344, #1343, #1340, #1332, #1331, #1320, #1287)

Usage Requirements

Kubernetes Version >= v1.15
Golang Version >= v1.14

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

Available both in SwaggerUI and API references.

Blog: 1.1.0

Thu, 17 Dec 2020 00:00:00 +0000

This is the v1.1.0 release of Open Match.

Check the README for details on features, installation and usage.

Release Notes

Feature Highlights

Inclusive/Exclusive bounds for DoubleRangeFilters #1268

Breaking Changes - Previous releases are not compatible with this release.

Service names now include the helm release name. This changes the default value from, eg, om-frontend to open-match-frontend. This is more consistent with helm best practices, and allows multiple Open Match installations in one namespace. For helm users, your values.yaml from 1.0 is still valid and includes service name overrides to the previous value #1246

Enhancements

Time to Assignment metrics added to backend #1241
Reduced Redis logging #1248
Improved testing for Nil pointer exceptions #1249
Added PR template #1250
Tests now use require (previously assert) with improved output (#1253, #1257)
Reduced unnecessary logging in backend and frontend services. Updated query and evaluator logging #1255
Improved Statestore tests for Redis #1264

Usage Requirements

Kubernetes Version >= v1.15
Golang Version >= v1.14

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

Available both in SwaggerUI and API references.

Blog: 1.1.0-rc.1

Fri, 20 Nov 2020 00:00:00 +0000

This is the v1.1.0-rc.1 release of Open Match.

Check the README for details on features, installation and usage.

Release Notes

Feature Highlights

Inclusive/Exclusive bounds for DoubleRangeFilters #1268

Breaking Changes - Previous releases are not compatible with this release.

Service names now include the helm release name. This changes the default value from, eg, om-frontend to open-match-frontend. This is more consistent with helm best practices, and allows multiple Open Match installations in one namespace. For helm users, your values.yaml from 1.0 is still valid and includes service name overrides to the previous value #1246

Enhancements

Time to Assignment metrics added to backend #1241
Reduced Redis logging #1248
Improved testing for Nil pointer exceptions #1249
Added PR template #1250
Tests now use require (previously assert) with improved output (#1253, #1257)
Reduced unnecessary logging in backend and frontend services. Updated query and evaluator logging #1255
Improved Statestore tests for Redis #1264

Usage Requirements

Kubernetes Version >= v1.15
Golang Version >= v1.14

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

Available both in SwaggerUI and API references.

Blog: 1.0.0

Mon, 01 Jun 2020 00:00:00 +0000

This is the v1.0.0 release of Open Match.

Check the README for details on features, installation and usage.

Release Notes

Feature Highlights

Assigned tickets will now automatically be deleted after a configured time. Default assignedDeleteTimeout = 10 minutes. #1211
Added API call to release all pending tickets. #1215 This enables callers through several API calls to delete all tickets.
Matchfunction library now supports passing gRPC call options. #1205
Metrics for many Open Match concepts now exported by Open Match, and a page with charts added to Grafana. #1192 #1193
Refactor and greatly improved test coverage, fixing several bugs and ensuring stability going forward. #1204 #1176 #1196 #1189 #1194

Breaking Changes - Previous releases are not compatible with this release.

Renamed several configuration values for consistency and clarity: #1206
ignoreListTTL -> pendingReleaseTimeout
pageSize/page.size -> queryPageSize
registrationIntervalMs -> registrationInterval
proposalCollectionIntervalMs -> proposalCollectionInterval
Default Evaluator now uses the main open match configmaps, removing the separate config maps. #1191

Breaking changes are only made if they fall within the stability guarantee.

Enhancements

Updated development guide. #1182
Fixed installing open match by default installing the integration test components. #1213
Improved error messages in several cases. #1207
Improved and corrected API documentation. #1212
Pods will now try to gracefully exit when receiving sigterm #1194

Usage Requirements

Kubernetes Version >= v1.10
Golang Version >= v1.14

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

Available both in SwaggerUI and API references.

Blog: 0.9.0

Mon, 03 Feb 2020 00:00:00 +0000

This is the 0.9.0 release of Open Match.

Check the README for details on features, installation and usage.

Release Notes

Feature Highlights

Refinements on the existing API. This represents the majority of API changes that need to be made before freezing the API for 1.0.
The backend and synchronizer have been mostly rewritten. They now no longer wait until the proposal window finishes if all running match functions finish early. Additionally they have better error handling, and optimistically stream data.
Revamped Grafana dashboards with detailed metrics documentation.
Have started end to end scale testing. Early results were presented in the January Community Meeting. Some minor issues have been discovered and fixed as a result.
New ReleaseTickets API on the BackendService to release ticket back to the pending tickets pool from the ignore list @caleb #1059

Breaking Changes - Previous releases are not compatible with this release.

Deprecated the previous evaluator and mmf harness. #1012 #1014
Updated Kubernetes client-go dependency to 1.13.12 #1020
Moved ignorelists config from redis to open-match-core #1028
Changed EvaluateResponse to MatchId instead of the entire Match object instead #1075 #1078 #1080 #1082
Removed the Rosters field from the MatchProfile proto #1084
Renamed Backend, Frontend, and Mmlogic proto APIs to BackendService, FrontendService, and QueryService respectively. #1055 #1065
Removed the Error field from the Assignment proto #1073
Changed FetchMatches proto from taking multiple profiles to one instead #1056

Note

Future releases towards 1.0.0 may still have breaking changes.

Enhancements

Improved Evaluator tutorials
Improved tutorials experience for Minikube users
Fixed a synchronizer logic that may incur go routine leaks
Fixed Open Match terminating gRPC connections after 1 minute. #1003
Configured Open Match’s default Redis setup such that it can function correctly under load #999
Added pod tolerations, nodeSelector and affinity to Open Match helm template #1015
Added the ability to specify custom Redis instance by overriding its endpoint in the helm template #1069
Optimized documentation about Open Match’s Grafana dashboards open-match-docs#136

Usage Requirements

v1.10 <= Kubernetes Version
Golang Version = v1.13.x

This software is currently alpha, and subject to change. Not to be used in production systems.

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

Available both in SwaggerUI and API references.

Blog: 0.8.0

Thu, 14 Nov 2019 00:00:00 +0000

This is the 0.8.0 release of Open Match.

Check the README for details on features, installation and usage.

Release Notes

Feature Highlights

Added Jaeger tracing support
Added CSharp support
Added Kubernetes v1.16 support
Added Open Match tutorials series to improve onboarding experience
Added Helm chart support
Improved scaling
Improved user experience to override Open Match runtime configurations

Breaking Changes - Previous releases are not compatible with this release.

ticket.Properties, which combined ticket filtering and custom data, have been removed. Instead ticket.SearchFields provides filtering without the need to configure indexes, and Extensions are used for arbitrary data.`
Open Match will now requires a om-override-configmap to configure evaluator hostname and initialize.

Note

Future releases towards 1.0.0 may still have breaking changes.

Security Fixes

Open Match will now requires privileged pods for Redis to disable TransparentHugePage support in the host kernel. #884

Enhancements

Added CSharp support with .csproj dependency requirements #813
Added Grafana dashboards to monitor Redis connection and Internal API calls. #876 #909
Added documentation for Open Match API references in open-match-docs repo open-match-docs#62
Fixed some Open Match prometheus metrics #829
Fixed a memory leak in Open Match state storage #830
Removed internal dependencies from the demo #859
Improved Open Match performance #864 #881
Provided a new package under pkg/matchfunction/matchfunction.go to help query Mmlogic.

Usage Requirements

v1.10 <= Kubernetes Version
Golang Version = v1.13.x

Images

# Servers
docker pull gcr.io/open-match-public-images/openmatch-backend:0.8.0
docker pull gcr.io/open-match-public-images/openmatch-frontend:0.8.0
docker pull gcr.io/open-match-public-images/openmatch-mmlogic:0.8.0
docker pull gcr.io/open-match-public-images/openmatch-synchronizer:0.8.0
# Evaluators
docker pull gcr.io/open-match-public-images/openmatch-evaluator-go-simple:0.8.0
# Sample Match Making Functions
docker pull gcr.io/open-match-public-images/openmatch-mmf-go-soloduel:0.8.0
docker pull gcr.io/open-match-public-images/openmatch-mmf-go-pool:0.8.0
# Test Clients
docker pull gcr.io/open-match-public-images/openmatch-demo-first-match:0.8.0

This software is currently alpha, and subject to change. Not to be used in production systems.

Installation

Follow Open Match Installation Guide to setup Open Match in your cluster.

API Definitions

Available both in SwaggerUI and API references.

Blog: 0.8.0-rc.1

Sat, 02 Nov 2019 00:00:00 +0000

This is the 0.8.0-rc.1 release of Open Match.

Check the README for details on features, installation and usage.

Release Notes

Feature Highlights

Added Jaeger tracing support
Added CSharp support
Improved scaling
Improved user experience to override Open Match runtime configurations

Breaking Changes - Previous releases are not compatible with this release.

ticket.Properties, which combined ticket filtering and custom data, have been removed. Instead ticket.SearchFields provides filtering without the need to configure indexes, and Extensions are used for arbitrary data.`

Note

Future releases towards 1.0.0 may still have breaking changes.

Security Fixes

Open Match will now requires privileged pods for Redis to disable TransparentHugePage support in the host kernel. #884

Enhancements

Added CSharp support with .csproj dependency requirements #813
Added Grafana dashboards to monitor Redis connection and Internal API calls. #876 #909
Added documentation for Open Match API references in open-match-docs repo open-match-docs#62
Fixed some Open Match prometheus metrics #829
Fixed a memory leak in Open Match state storage #830
Removed internal dependencies from the demo #859
Improved Open Match performance #864 #881
Provided a new package under pkg/matchfunction/matchfunction.go to help query Mmlogic.

Usage Requirements

v1.10 <= Kubernetes Version <= v1.15
Golang Version = v1.13.x

Images

# Servers
docker pull gcr.io/open-match-public-images/openmatch-backend:0.8.0-rc.1
docker pull gcr.io/open-match-public-images/openmatch-frontend:0.8.0-rc.1
docker pull gcr.io/open-match-public-images/openmatch-mmlogic:0.8.0-rc.1
docker pull gcr.io/open-match-public-images/openmatch-synchronizer:0.8.0-rc.1
# Evaluators
docker pull gcr.io/open-match-public-images/openmatch-evaluator-go-simple:0.8.0-rc.1
# Sample Match Making Functions
docker pull gcr.io/open-match-public-images/openmatch-mmf-go-soloduel:0.8.0-rc.1
docker pull gcr.io/open-match-public-images/openmatch-mmf-go-pool:0.8.0-rc.1
# Test Clients
docker pull gcr.io/open-match-public-images/openmatch-demo-first-match:0.8.0-rc.1

This software is currently alpha, and subject to change. Not to be used in production systems.

Installation

Follow Open Match Installation Guide - WIP to setup Open Match in your cluster.

API Definitions

Work in progress

Blog: 0.7.0

Fri, 27 Sep 2019 00:00:00 +0000

This is the 0.7.0 release of Open Match.

Check the README for details on features, installation and usage.

Release Notes

Feature Highlights

Added filtering based on string and boolean values.
Return all tickets when no filters are specified.
Improved scaling.
Supported payload logging.

Breaking Changes - Previous releases are not compatible with this release.

Changed several gRPC and HTTP endpoints from unary to streaming to improve system scalability. #739
Changed protobuf namespace from api to openmatch.
Renamed protobuf Filter to FloatRangeFilter.

Note

See https://open-match.dev/site/swaggerui/index.html. Future releases towards 1.0.0 may still have breaking changes.

Security Fixes

None

Enhancements

Payload logging now is available if debug/trace level logging is turned on. #696
New filtering mechanism. #681
Improved synchronizer logging to avoid log spam. #784
Serveral API changes from unary to streaming. #739
New Continuous Integration pipeline with faster build time for Open Match developers. #701
New Helm subchart to deploy customized evaluators and match functions. #652
New package to benchmark and scale testing Open Match. #797
Documentation on how to access Open Match under different cluster settings. open-match-docs#43
Documentation on how to use Open Match via HTTP/gRPC endpoints. open-match-docs#41

Images

# Servers
docker pull gcr.io/open-match-public-images/openmatch-backend:0.7.0
docker pull gcr.io/open-match-public-images/openmatch-frontend:0.7.0
docker pull gcr.io/open-match-public-images/openmatch-mmlogic:0.7.0
docker pull gcr.io/open-match-public-images/openmatch-synchronizer:0.7.0
# Evaluators
docker pull gcr.io/open-match-public-images/openmatch-evaluator-go-simple:0.7.0
# Sample Match Making Functions
docker pull gcr.io/open-match-public-images/openmatch-mmf-go-soloduel:0.7.0
docker pull gcr.io/open-match-public-images/openmatch-mmf-go-pool:0.7.0
# Test Clients
docker pull gcr.io/open-match-public-images/openmatch-demo-first-match:0.7.0

This software is currently alpha, and subject to change. Not to be used in production systems.

Installation

To deploy Open Match in your Kubernetes cluster run the following commands:

# Grant yourself cluster-admin permissions so that you can deploy service accounts.
kubectl create clusterrolebinding myname-cluster-admin-binding --clusterrole=cluster-admin --user=$(YOUR_KUBERNETES_USER_NAME)
# Place all Open Match components in their own namespace.
kubectl create namespace open-match
# Install Open Match and monitoring services.
kubectl apply -f http://open-match.dev/install/v0.7.0/yaml/install.yaml -n open-match
# Install the demo.
kubectl apply -f http://open-match.dev/install/v0.7.0/yaml/02-open-match-demo.yaml -n open-match

API Definitions

https://open-match.dev/api/v0.7.0/backend.swagger.json
https://open-match.dev/api/v0.7.0/evaluator.swagger.json
https://open-match.dev/api/v0.7.0/frontend.swagger.json
https://open-match.dev/api/v0.7.0/matchfunction.swagger.json
https://open-match.dev/api/v0.7.0/mmlogic.swagger.json

Blog: 0.7.0-rc.1

Wed, 18 Sep 2019 00:00:00 +0000

This is the 0.7.0-rc.1 release of Open Match.

Check the README for details on features, installation and usage.

Release Notes

New index filtering mechanism.
Improved synchronizer logging to avoid log spam.
Some APIs is changed from unary to streaming.
New Continuous Integration pipeline with faster build time for Open Match developers.
New Helm chart for better developer experience.
Payload logging now is available if debug/trace level logging is turned on.
Documentation on how to access Open Match under different cluster settings.
Documentation on how to use Open Match via HTTP/gRPC endpoints.
New package to support Open Match scale testing.

Breaking Changes

API changes from unary to streaming to improve system scalability. Previous releases are not compatible with this release.
API changes due to supports of new filtering types.

Note

See https://open-match.dev/site/swaggerui/index.html. Future releases towards 1.0.0 may still have breaking changes.

Enhancements

Better payload logging for debugging purpose.
New Helm subchart to deploy customized evaluators and match functions.
Open Match index filtering now supports StringEquals, AllIndex, and BoolEquals filters.

Images

# Servers
docker pull gcr.io/open-match-public-images/openmatch-backend:0.7.0-rc.1
docker pull gcr.io/open-match-public-images/openmatch-frontend:0.7.0-rc.1
docker pull gcr.io/open-match-public-images/openmatch-mmlogic:0.7.0-rc.1
docker pull gcr.io/open-match-public-images/openmatch-synchronizer:0.7.0-rc.1
# Evaluators
docker pull gcr.io/open-match-public-images/openmatch-evaluator-go-simple:0.7.0-rc.1
# Sample Match Making Functions
docker pull gcr.io/open-match-public-images/openmatch-mmf-go-soloduel:0.7.0-rc.1
docker pull gcr.io/open-match-public-images/openmatch-mmf-go-pool:0.7.0-rc.1
# Test Clients
docker pull gcr.io/open-match-public-images/openmatch-demo:0.7.0-rc.1

This software is currently alpha, and subject to change. Not to be used in production systems.

Installation

To deploy Open Match in your Kubernetes cluster run the following commands:

# Grant yourself cluster-admin permissions so that you can deploy service accounts.
kubectl create clusterrolebinding myname-cluster-admin-binding --clusterrole=cluster-admin --user=$(YOUR_KUBERNETES_USER_NAME)
# Place all Open Match components in their own namespace.
kubectl create namespace open-match
# Install Open Match and monitoring services.
kubectl apply -f http://open-match.dev/install/v0.7.0-rc.1/yaml/install.yaml --namespace open-match
# Install the demo.
kubectl apply -f http://open-match.dev/install/v0.7.0-rc.1/yaml/install-demo.yaml --namespace open-match

API Definitions

https://open-match.dev/api/v0.7.0-rc.1/backend.swagger.json
https://open-match.dev/api/v0.7.0-rc.1/evaluator.swagger.json
https://open-match.dev/api/v0.7.0-rc.1/frontend.swagger.json
https://open-match.dev/api/v0.7.0-rc.1/matchfunction.swagger.json
https://open-match.dev/api/v0.7.0-rc.1/mmlogic.swagger.json

Blog: 0.6.0

Fri, 02 Aug 2019 00:00:00 +0000

This is the 0.6.0 release of Open Match.

Check the README for details on features, installation and usage.

Release Notes

New API based on Tickets
New gRPC/HTTP harness for evaluator and MMFs.
New Demo that simulates game sessions and game server orchestration and talks to Open Match.
New sychronizer to gate batches of match proposals
Interactive API browser via swaggerui.
TLS transport encryption mode is now supported for gRPC and HTTP.
Improved instrumentation (Grafana and Prometheus metrics), logging, and test coverage.
Disable Jaeger in install.yaml
Unify server setup and call log configuration

Breaking Changes

Completely new API based on Tickets. Previous releases are not compatible with this release. See https://open-match.dev/site/swaggerui/index.html. Future releases towards 1.0.0 may have breaking changes but they will be less impactful as this release.
mmforc has been replaced by synchronizer.
All old client applications (example: clientloadgen) have been replaced by a demo which simulates game sessions and clients.
New go get location, open-match.dev/open-match, github.com/GoogleCloudPlatform/open-match will no longer work.

Enhancements

New Harness for MMF and Evaluator.
Major internal changes to improve reliability and correctness.

Images

# Servers
docker pull gcr.io/open-match-public-images/openmatch-backend:0.6.0
docker pull gcr.io/open-match-public-images/openmatch-frontend:0.6.0
docker pull gcr.io/open-match-public-images/openmatch-mmlogic:0.6.0
docker pull gcr.io/open-match-public-images/openmatch-synchronizer:0.6.0

# Evaluators
docker pull gcr.io/open-match-public-images/openmatch-evaluator-go-simple:0.6.0

# Sample Match Making Functions
docker pull gcr.io/open-match-public-images/openmatch-mmf-go-soloduel:0.6.0
docker pull gcr.io/open-match-public-images/openmatch-mmf-go-pool:0.6.0

# Test Clients
docker pull gcr.io/open-match-public-images/openmatch-demo:0.6.0

This software is currently alpha, and subject to change. Not to be used in production systems.

Installation

To deploy Open Match in your Kubernetes cluster run the following commands:

# Grant yourself cluster-admin permissions so that you can deploy service accounts.
kubectl create clusterrolebinding myname-cluster-admin-binding --clusterrole=cluster-admin --user=$(YOUR_KUBERNETES_USER_NAME)
# Place all Open Match components in their own namespace.
kubectl create namespace open-match
# Install Open Match and monitoring services.
kubectl apply -f http://open-match.dev/install/v0.6.0/yaml/install.yaml --namespace open-match
# Install the demo.
kubectl apply -f http://open-match.dev/install/v0.6.0/yaml/install-demo.yaml --namespace open-match

API Definitions

https://open-match.dev/api/v0.6.0/backend.swagger.json
https://open-match.dev/api/v0.6.0/evaluator.swagger.json
https://open-match.dev/api/v0.6.0/frontend.swagger.json
https://open-match.dev/api/v0.6.0/matchfunction.swagger.json
https://open-match.dev/api/v0.6.0/mmlogic.swagger.json

Blog: 0.6.0-rc.1

Tue, 16 Jul 2019 00:00:00 +0000

This is the 0.6.0-rc.1 release of Open Match.

Check the README for details on features, installation and usage.

Release Notes

New API based on Tickets
New gRPC/HTTP harness for evaluator and MMFs.
New Demo that simulates game sessions and game server orchestration and talks to Open Match.
New sychronizer to gate batches of match proposals
Interactive API browser via swaggerui.
TLS transport encryption mode is now supported for gRPC and HTTP.
Improved instrumentation (Grafana and Prometheus metrics), logging, and test coverage.

Breaking Changes

Completely new API based on Tickets. Previous releases are not compatible with this release. See https://open-match.dev/site/swaggerui/index.html. Future releases towards 1.0.0 may have breaking changes but they will be less impactful as this release.
mmforc has been replaced by synchronizer.
All old client applications (example: clientloadgen) have been replaced by a demo which simulates game sessions and clients.
New go get location, open-match.dev/open-match, github.com/GoogleCloudPlatform/open-match will no longer work.

Enhancements

New Harness for MMF and Evaluator.
Major internal changes to improve reliability and correctness.

Images

# Servers
docker pull gcr.io/open-match-public-images/openmatch-backend:0.6.0-rc.1
docker pull gcr.io/open-match-public-images/openmatch-frontend:0.6.0-rc.1
docker pull gcr.io/open-match-public-images/openmatch-mmlogic:0.6.0-rc.1
docker pull gcr.io/open-match-public-images/openmatch-synchronizer:0.6.0-rc.1

# Evaluators
docker pull gcr.io/open-match-public-images/openmatch-evaluator-go-simple:0.6.0-rc.1

# Sample Match Making Functions
docker pull gcr.io/open-match-public-images/openmatch-mmf-go-soloduel:0.6.0-rc.1
docker pull gcr.io/open-match-public-images/openmatch-mmf-go-pool:0.6.0-rc.1

# Test Clients
docker pull gcr.io/open-match-public-images/openmatch-demo:0.6.0-rc.1

This software is currently alpha, and subject to change. Not to be used in production systems.

Installation

To deploy Open Match in your Kubernetes cluster run the following commands:

# Grant yourself cluster-admin permissions so that you can deploy service accounts.
kubectl create clusterrolebinding myname-cluster-admin-binding --clusterrole=cluster-admin --user=$(YOUR_KUBERNETES_USER_NAME)
# Place all Open Match components in their own namespace.
kubectl create namespace open-match
# Install Open Match and monitoring services.
kubectl apply -f http://open-match.dev/install/v0.6.0-rc.1/yaml/install.yaml --namespace open-match
# Install the demo.
kubectl apply -f http://open-match.dev/install/v0.6.0-rc.1/yaml/install-demo.yaml --namespace open-match

API Definitions

https://open-match.dev/api/v0.6.0-rc.1/backend.swagger.json
https://open-match.dev/api/v0.6.0-rc.1/evaluator.swagger.json
https://open-match.dev/api/v0.6.0-rc.1/frontend.swagger.json
https://open-match.dev/api/v0.6.0-rc.1/matchfunction.swagger.json
https://open-match.dev/api/v0.6.0-rc.1/mmlogic.swagger.json

Blog: 0.6.0-preview

Fri, 28 Jun 2019 00:00:00 +0000

Release Notes

This is a preview of the next release of Open Match. You may use this to start building proof-of-concepts, please don’t run this in production.

Enhancements

New API (see API Definitions section below)
Improved HTTP API support
New Demo MMF and Evaluator
Improved error status codes
New sychronizer to gate batches of match proposals
Interactive API browser for debugging
Code rewrite with test coverage

Images

# Servers
docker pull gcr.io/open-match-public-images/openmatch-backend:0.6.0-preview1
docker pull gcr.io/open-match-public-images/openmatch-frontend:0.6.0-preview1
docker pull gcr.io/open-match-public-images/openmatch-mmlogic:0.6.0-preview1
docker pull gcr.io/open-match-public-images/openmatch-minimatch:0.6.0-preview1
docker pull gcr.io/open-match-public-images/openmatch-synchronizer:0.6.0-preview1

# Demo
docker pull gcr.io/open-match-public-images/openmatch-mmf-go-soloduel:0.6.0-preview1
docker pull gcr.io/open-match-public-images/openmatch-demo:0.6.0-preview1
docker pull gcr.io/open-match-public-images/openmatch-mmf-go-pool:0.6.0-preview1
docker pull gcr.io/open-match-public-images/openmatch-evaluator-go-simple:0.6.0-preview1

# Debugging Tools
docker pull gcr.io/open-match-public-images/openmatch-swaggerui:0.6.0-preview1

This software is currently alpha, and subject to change. Not to be used in production systems.

Installation

To deploy Open Match in your Kubernetes cluster run the following commands:

# Grant yourself cluster-admin permissions so that you can deploy service accounts.
kubectl create clusterrolebinding myname-cluster-admin-binding --clusterrole=cluster-admin --user=$(YOUR_KUBERNETES_USER_NAME)
# Place all Open Match components in their own namespace.
kubectl create namespace open-match
# Install Open Match and monitoring services.
kubectl apply -f https://open-match.dev/install/v0.6.0-preview1/yaml/install.yaml --namespace open-match
# Install the demo MMF and Evaluator.
kubectl apply -f https://open-match.dev/install/v0.6.0-preview1/yaml/install-demo.yaml --namespace open-match

API Definitions

https://open-match.dev/api/v0.6.0-preview1/backend.swagger.json
https://open-match.dev/api/v0.6.0-preview1/evaluator.swagger.json
https://open-match.dev/api/v0.6.0-preview1/frontend.swagger.json
https://open-match.dev/api/v0.6.0-preview1/matchfunction.swagger.json
https://open-match.dev/api/v0.6.0-preview1/mmlogic.swagger.json

Blog: 0.5.1

Tue, 07 May 2019 00:00:00 +0000

Check the README for details on features, installation and usage.

Release Notes

Enhancements

Optimizes the open-match cluster start up time #312

Features

Implements REST proxy for the gRPC services in open-match #275

See CHANGELOG for more details on changes.

Images

# Servers
docker pull gcr.io/open-match-public-images/openmatch-backendapi:0.5.1
docker pull gcr.io/open-match-public-images/openmatch-frontendapi:0.5.1
docker pull gcr.io/open-match-public-images/openmatch-mmforc:0.5.1
docker pull gcr.io/open-match-public-images/openmatch-mmlogicapi:0.5.1

# Evaluators
docker pull gcr.io/open-match-public-images/openmatch-evaluator-serving:0.5.1

# Sample Match Making Functions
docker pull gcr.io/open-match-public-images/openmatch-mmf-go-grpc-serving-simple:0.5.1

# Test Clients
docker pull gcr.io/open-match-public-images/openmatch-backendclient:0.5.1
docker pull gcr.io/open-match-public-images/openmatch-clientloadgen:0.5.1
docker pull gcr.io/open-match-public-images/openmatch-frontendclient:0.5.1

This software is currently alpha, and subject to change. Not to be used in production systems.

Installation

To deploy Open Match in your Kubernetes cluster run the following commands:

# Grant yourself cluster-admin permissions so that you can deploy service accounts.
kubectl create clusterrolebinding myname-cluster-admin-binding --clusterrole=cluster-admin --user=$(YOUR_KUBERNETES_USER_NAME)
# Place all Open Match components in their own namespace.
kubectl create namespace open-match
# Install Open Match and monitoring services.
kubectl apply -f https://github.com/googleforgames/open-match/releases/download/v0.5.1/install.yaml --namespace open-match
# Install the example MMF and Evaluator.
kubectl apply -f https://github.com/googleforgames/open-match/releases/download/v0.5.1/install-example.yaml --namespace open-match

Blog: 0.5.0

Tue, 30 Apr 2019 00:00:00 +0000

Check the README for details on features, installation and usage.

Release Notes

It is now possible to run Open Match from the yaml attached to this release. There have also been many improvements to help day to day development.

Breaking Changes

MMFs are now implemented as a gRPC service. (golang sample provided)
Using k8s jobs to trigger MMFs is now deprecated. All existing examples using the k8s mechanism have been removed.
Open Match now uses gRPC based Evaluator (golang sample provided). Existing k8s job based evaluation mechanism is deprecated.
MMFOrc component is now deprecated and removed from Open Match core.
All core Open Match services now use gRPC style request / response protos.

Enhancements

New release process
Documentation improvements
Redis bug fixes
Performance improvements for continuous integration
Using make to build the project now correctly works in more scenarios.
GOPATH is no longer required for most things.
Contribution process and continuous deployment are now easier to use.

Security Fixes

MMFs no longer require cluster admin.

See CHANGELOG for more details on changes.

Images

# Servers
docker pull gcr.io/open-match-public-images/openmatch-backendapi:0.5.0
docker pull gcr.io/open-match-public-images/openmatch-frontendapi:0.5.0
docker pull gcr.io/open-match-public-images/openmatch-mmforc:0.5.0
docker pull gcr.io/open-match-public-images/openmatch-mmlogicapi:0.5.0

# Evaluators
docker pull gcr.io/open-match-public-images/openmatch-evaluator-serving:0.5.0

# Sample Match Making Functions
docker pull gcr.io/open-match-public-images/openmatch-mmf-go-grpc-serving-simple:0.5.0

# Test Clients
docker pull gcr.io/open-match-public-images/openmatch-backendclient:0.5.0
docker pull gcr.io/open-match-public-images/openmatch-clientloadgen:0.5.0
docker pull gcr.io/open-match-public-images/openmatch-frontendclient:0.5.0

This software is currently alpha, and subject to change. Not to be used in production systems.

Installation

To deploy Open Match in your Kubernetes cluster run the following commands:

# Grant yourself cluster-admin permissions so that you can deploy service accounts.
kubectl create clusterrolebinding myname-cluster-admin-binding --clusterrole=cluster-admin --user=$(YOUR_KUBERNETES_USER_NAME)
# Place all Open Match components in their own namespace.
kubectl create namespace open-match
# Install Open Match and monitoring services.
kubectl apply -f https://github.com/googleforgames/open-match/releases/download/v0.5.0/install.yaml --namespace open-match
# Install the example MMF and Evaluator.
kubectl apply -f https://github.com/googleforgames/open-match/releases/download/v0.5.0/install-example.yaml --namespace open-match