Install with YAML
- Kubernetes cluster, tested on Kubernetes version 1.27+
Install Core Open Match
Open Match comprises of a set of core services hosted in a Kubernetes cluster. The simplest way to install Open Match core is to use the
01-open-match-core.yaml for the latest release. This installs Open Match with the default configuration.
- Core Open Match service deployments.
- A Redis deployment as Open Match’s state storage system.
- HorizontalAutoScalars to auto-scale Open Match based on pods' average CPU utilization.
Here is the command to install the Open Match core in your cluster:
# Install the core Open Match services. kubectl apply --namespace open-match \ -f https://open-match.dev/install/v1.8.0/yaml/01-open-match-core.yaml
--namespace open-matchis Required. Open Match may not work as expected without this flag.
After installing Open Match core services, here is the expected state for the pods for these services:
kubectl get -n open-match pod
Output: NAME READY STATUS RESTARTS AGE open-match-backend-76d8d76c96-fmhmn 0/1 ContainerCreating 0 3m53s open-match-frontend-57fc9f6b66-86hxj 0/1 ContainerCreating 0 3m53s open-match-query-799d8549d4-5qpgx 0/1 ContainerCreating 0 3m53s open-match-swaggerui-867d79b885-m9q6x 0/1 ContainerCreating 0 3m54s open-match-synchronizer-7f48f84dfd-j8swx 0/1 ContainerCreating 0 3m54s
Open Match needs to be customized to run as a Matchmaker.
This custom configuration is provided to the Open Match components via a ConfigMap
Thus, starting the core service pods will remain in
ContainerCreating until this config map is available.
If you finished reading the tutorials and are building your own custom matchmaker and need to deploy a custom evaluator, then skip the next step and instead use the Customization Guide for steps to customize your Open Match installation.
Install the Default Evaluator
Run the below command to install the default Evaluator in the open-match namespace and to configure Open Match to use it.
kubectl apply --namespace open-match \ -f https://open-match.dev/install/v1.8.0/yaml/06-open-match-override-configmap.yaml \ -f https://open-match.dev/install/v1.8.0/yaml/07-open-match-default-evaluator.yaml
Delete Open Match
To delete Open Match and the corresponding sample components from this cluster, simply run:
kubectl delete namespace open-match
Follow the Getting Started guide to see Open Match in action.
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.
Last modified September 8, 2023