Skip to content

Add env option to all Agones component deployments #4499

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lazy-slackoth wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Add env option to all Agones component deployments #4499

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
07227a8
Add option to configure env vars
Apr 6, 2026
d1b609b
docs: document env vars Helm values for all Agones components
Apr 22, 2026
6151a4f
docs: use inline links for env vars Helm table entries
Apr 22, 2026
248b41f
Merge branch 'main' into feature/add-custom-env-vars
lazy-slackoth Apr 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions install/helm/agones/templates/controller.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -199,6 +199,9 @@ spec:
- name: LEADER_ELECTION
value: "true"
{{- end }}
{{- if .Values.agones.controller.env }}
{{- toYaml .Values.agones.controller.env | nindent 8 }}
{{- end }}
ports:
- name: webhooks
containerPort: 8081
Expand Down
3 changes: 3 additions & 0 deletions install/helm/agones/templates/extensions-deployment.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -157,6 +157,9 @@ spec:
value: {{ .Values.agones.extensions.webhooks.port | quote }}
- name: HTTP_PORT
value: {{ .Values.agones.extensions.http.port | quote }}
{{- if .Values.agones.extensions.env }}
{{- toYaml .Values.agones.extensions.env | nindent 8 }}
{{- end }}
ports:
- name: webhooks
containerPort: {{ .Values.agones.extensions.webhooks.port }}
Expand Down
3 changes: 3 additions & 0 deletions install/helm/agones/templates/ping.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -113,6 +113,9 @@ spec:
value: {{ .Values.agones.ping.udp.rateLimit | quote }}
- name: FEATURE_GATES
value: {{ .Values.agones.featureGates | quote }}
{{- if .Values.agones.ping.env }}
{{- toYaml .Values.agones.ping.env | nindent 10 }}
{{- end }}
{{- if .Values.agones.image.controller.pullSecret }}
imagePullSecrets:
- name: {{.Values.agones.image.controller.pullSecret}}
Expand Down
3 changes: 3 additions & 0 deletions install/helm/agones/templates/processor.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -120,6 +120,9 @@ spec:
- name: RETRY_PERIOD
value: {{ .Values.agones.allocator.processor.leaderElection.retryPeriod | default "2s" | quote }}
{{- end }}
{{- if .Values.agones.allocator.processor.env }}
{{- toYaml .Values.agones.allocator.processor.env | nindent 8 }}
{{- end }}
livenessProbe:
httpGet:
path: /live
Expand Down
3 changes: 3 additions & 0 deletions install/helm/agones/templates/service/allocation.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -315,6 +315,9 @@ spec:
value: {{ .Values.agones.allocator.processor.grpc.address | quote }}
- name: PROCESSOR_GRPC_PORT
value: {{ .Values.agones.allocator.processor.grpc.port | quote }}
{{- end }}
{{- if .Values.agones.allocator.env }}
{{- toYaml .Values.agones.allocator.env | nindent 8 }}
{{- end }}
ports:
{{- if .Values.agones.allocator.service.http.enabled }}
Expand Down
5 changes: 5 additions & 0 deletions install/helm/agones/values.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -107,6 +107,7 @@ agones:
pdb:
minAvailable: 1
topologySpreadConstraints: []
env: []
extensions:
resources: {}
# requests:
Expand Down Expand Up @@ -168,6 +169,7 @@ agones:
periodSeconds: 3
failureThreshold: 3
topologySpreadConstraints: []
env: []
ping:
install: true
pdb:
Expand Down Expand Up @@ -216,6 +218,7 @@ agones:
failureThreshold: 3
timeoutSeconds: 1
topologySpreadConstraints: []
env: []
allocator:
install: true
pdb:
Expand Down Expand Up @@ -289,6 +292,7 @@ agones:
totalRemoteAllocationTimeout: 30s
allocationBatchWaitTime: 500ms
topologySpreadConstraints: []
env: []
processor:
replicas: 2
maxBatchSize: 100
Expand All @@ -303,6 +307,7 @@ agones:
effect: "NoExecute"
affinity: {}
topologySpreadConstraints: []
env: []
logLevel: info
leaderElection: {}
http:
Expand Down
5 changes: 5 additions & 0 deletions site/content/en/docs/Installation/Install Agones/helm.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -197,6 +197,7 @@ The following tables lists the configurable parameters of the Agones chart and t
| `agones.controller.mutatingWebhook.disableCaBundle` | **Deprecated**. Use `agones.extensions.mutatingWebhook.disableCaBundle` instead. Disable ca-bundle so it can be injected by cert-manager | `false` |
| `agones.controller.allocationBatchWaitTime` | Wait time between each allocation batch when performing allocations in controller mode | `500ms` |
| `agones.controller.topologySpreadConstraints` | Ensures better resource utilization and high availability by evenly distributing Pods in the agones-system namespace | `{}` |
| `agones.controller.env` | Additional [environment variables](https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/) to inject into the controller pod | `[]` |
Copy link
Copy Markdown
Member

@markmandel markmandel Apr 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the docs, but these need to be feature shortcoded:
https://agones.dev/site/docs/contribute/documentation-editing-contribution/#within-a-page

This is because docs publish immediately, not on release 👍🏻

You may also need to duplicate the whole table, since shortcodes don't work so great when in the middle of tables.

| `agones.controller.maxCreationParallelism` | Maximum number of parallelizing creation calls in GSS controller | `16` |
| `agones.controller.maxGameServerCreationsPerBatch` | Maximum number of GameServer creation calls per batch | `64` |
| `agones.controller.maxDeletionParallelism` | Maximum number of parallelizing deletion calls in GSS | `64` |
Expand Down Expand Up @@ -251,6 +252,7 @@ The following tables lists the configurable parameters of the Agones chart and t
| `agones.ping.pdb.minAvailable` | Description of the number of pods from that set that must still be available after the eviction, even in the absence of the evicted pod. Can be either an absolute number or a percentage. Mutually Exclusive with `maxUnavailable` | `1` |
| `agones.ping.pdb.maxUnavailable` | Description of the number of pods from that set that can be unavailable after the eviction. It can be either an absolute number or a percentage Mutually Exclusive with `minAvailable` | \`\` |
| `agones.ping.topologySpreadConstraints` | Ensures better resource utilization and high availability by evenly distributing Pods in the agones-system namespace | `{}` |
| `agones.ping.env` | Additional [environment variables](https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/) to inject into the ping pod | `[]` |


### Allocator Service
Expand Down Expand Up @@ -314,6 +316,8 @@ The following tables lists the configurable parameters of the Agones chart and t
| `agones.allocator.pdb.minAvailable` | Description of the number of pods from that set that must still be available after the eviction, even in the absence of the evicted pod. Can be either an absolute number or a percentage. Mutually Exclusive with `maxUnavailable` | `1` |
| `agones.allocator.pdb.maxUnavailable` | Description of the number of pods from that set that can be unavailable after the eviction. It can be either an absolute number or a percentage. Mutually Exclusive with `minAvailable` | \`\` |
| `agones.allocator.topologySpreadConstraints` | Ensures better resource utilization and high availability by evenly distributing Pods in the agones-system namespace | `{}` |
| `agones.allocator.env` | Additional [environment variables](https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/) to inject into the allocator pod | `[]` |
| `agones.allocator.processor.env` | Additional [environment variables](https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/) to inject into the allocator processor pod | `[]` |


### Extensions
Expand Down Expand Up @@ -354,6 +358,7 @@ The following tables lists the configurable parameters of the Agones chart and t
| `agones.extensions.pdb.maxUnavailable` | Description of the number of pods from that set that can be unavailable after the eviction. It can be either an absolute number or a percentage. Mutually Exclusive with `minAvailable` | \`\` |
| `agones.extensions.replicas` | The number of replicas to run in the deployment | `2` |
| `agones.extensions.topologySpreadConstraints` | Ensures better resource utilization and high availability by evenly distributing Pods in the agones-system namespace | `{}` |
| `agones.extensions.env` | Additional [environment variables](https://kubernetes.io/docs/tasks/inject-data-application/define-environment-variable-container/) to inject into the extensions pod | `[]` |

### GameServers

Expand Down
Loading