Dedicated Game Server Hosting and Scaling for Multiplayer Games on Kubernetes
Clone or download
markmandel Development tools to enable pprof
Tools for building a controller with pprof enabed, and Make targets
for accessing the http pprof endpoint while it is running on a Kubernetes
cluster, with accompanying documentation.

This will help in diagnosing #414
Latest commit 63cd0a4 Nov 15, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
build Development tools to enable pprof Nov 16, 2018
cmd Development tools to enable pprof Nov 16, 2018
docs Cluster Autoscaling: safe-to-evict=false annotations for GameServer Pods Nov 6, 2018
examples Changes to the GameServer configuration are reflected in the local sd… Nov 12, 2018
install Add crd-install helm hook to crds templates Nov 13, 2018
pkg More stringent linting rules (and update linter) Nov 15, 2018
sdks Changes to the GameServer configuration are reflected in the local sd… Nov 12, 2018
test/e2e More stringent linting rules (and update linter) Nov 15, 2018
vendor Added github.com/spf13/viper to dep toml Aug 24, 2018
.dockerignore Implement SDK SetLabel and SetAnnotation functionality Aug 26, 2018
.gitattributes Treat all files in the repo as binary, with no git magic updating lin… Apr 19, 2018
.gitignore switch to golangci-lint and fixes new lint issues. Sep 8, 2018
.golangci.yml More stringent linting rules (and update linter) Nov 15, 2018
CHANGELOG.md Change for the 0.5.0 release. Oct 16, 2018
CONTRIBUTING.md Process to become an reviewer/approver on Agones. Oct 31, 2018
Gopkg.lock Added github.com/spf13/viper to dep toml Aug 24, 2018
Gopkg.toml Added github.com/spf13/viper to dep toml Aug 24, 2018
LICENSE First commit for Agon. This is exciting. Dec 5, 2017
README.md Adding third part videos and presentations. Oct 25, 2018
cloudbuild.yaml adds the first e2e test Aug 16, 2018
code-of-conduct.md Adding CoC and Discuss mailing lists. Feb 19, 2018
doc.go Centralise the canonical import paths and more package docs Mar 8, 2018
sdk.proto Implement SDK SetLabel and SetAnnotation functionality Aug 26, 2018
sdk.swagger.json Implement SDK SetLabel and SetAnnotation functionality Aug 26, 2018

README.md

Agones

GoDoc Go Report Card GitHub release Follow on Twitter

Agones is a library for hosting, running and scaling dedicated game servers on Kubernetes.

Agones, is derived from the Greek word agōn which roughly translates to “contest”, “competition at games” and “gathering”. (source)

Disclaimer

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

Major Features

  • Be able to define a GameServer within Kubernetes - either through yaml or via the API
  • Manage GameServer lifecycles - including health checking and connection information.
  • Client SDKs for integration with dedicated game servers to work with Agones.

Why does this project exist?

For more details on why this project was written, read the announcement blog post.

Requirements

Installation

Follow these instructions to create a cluster on Google Kubernetes Engine (GKE), Minikube or Azure Kubernetes Service (AKS), and install Agones.

Usage

Documentation and usage guides on how to develop and host dedicated game servers on top of Agones.

Quickstarts:

Guides

Tutorials

Reference

Examples

Advanced

Third Party Content

Get involved

Code of Conduct

Participation in this project comes under the Contributor Covenant Code of Conduct

Development and Contribution

Please read the contributing guide for directions on submitting Pull Requests to Agones.

See the Developing, Testing and Building Agones documentation for developing, testing and building Agones from source.

The Release Process documentation displays the project's upcoming release calendar and release process.

Agones is in active development - we would love your help in shaping its future!

This all sounds great, but can you explain Docker and/or Kubernetes to me?

Docker

Kubernetes

Licence

Apache 2.0