Skip to content
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.

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

More description on fleetautoscaler.md #3632

Merged
merged 2 commits into from
Feb 6, 2024

Conversation

markmandel
Copy link
Member

What type of PR is this?

Uncomment only one /kind <> line, press enter to put that in a new line, and remove leading whitespace from that line:

/kind breaking
/kind bug
/kind cleanup

/kind documentation

/kind feature
/kind hotfix
/kind release

What this PR does / Why we need it:

Updated fleetautoscaler.md with more general descriptions of each type of autoscaling strategy.

Since we have 4 now, it seemed like it would be useful to provide some use cases around each type of autoscaling and why you would choose one over another.

Which issue(s) this PR fixes:

Work on #2716

Special notes for your reviewer:

Pulling out some of the docs work I've been doing on Counters and Lists. More to come as I feel it's in a happy place.

Updated fleetautoscaler.md with more general descriptions of each type
of autoscaling strategy.

Since we have 4 now, it seemed like it would be useful to provide some
use cases around each type of autoscaling and why you would choose one
over another.

Work on googleforgames#2716
@markmandel markmandel added kind/feature New features for Agones kind/documentation Documentation for Agones labels Feb 5, 2024
@github-actions github-actions bot added the size/M label Feb 5, 2024
@agones-bot
Copy link
Collaborator

Build Succeeded 👏

Build Id: 8e0c721f-eb83-4020-810b-96118183e2bd

The following development artifacts have been built, and will exist for the next 30 days:

A preview of the website (the last 30 builds are retained):

To install this version:

  • git fetch https://github.com/googleforgames/agones.git pull/3632/head:pr_3632 && git checkout pr_3632
  • helm install agones ./install/helm/agones --namespace agones-system --set agones.image.registry=us-docker.pkg.dev/agones-images/ci --set agones.image.tag=1.39.0-dev-8630ffe-amd64

```

## Spec Field Reference

Since Agones defines a new
Copy link
Member

Choose a reason for hiding this comment

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

You didn't change this part, but this sentence reads strangely to me. It sounds like we are suggesting that other people add a CRD for autoscaling. I think what's its trying to say is that we created a CRD to do this. With the prevalence of CRDs (in k8s and agones), I don't think this is necessary. Can we say something more direct like

The CRD used for fleet autoscaling has the following fields:

Copy link
Member Author

Choose a reason for hiding this comment

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

Yeah - agreed 100%. (We have it in a few other places, but can clean that up later).

I've delete it and cleaned up the sentence before the spec reference.

minCapacity: 10
# MaxCapacity is the maximum aggregate List total capacity across the fleet.
# MaxCapacity must be greater than or equal to both MinCapacity and BufferSize. Required field.
maxCapacity: 100
```

## Webhook Autoscaling
Copy link
Member

Choose a reason for hiding this comment

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

This section should link to the existing Webhook Endpoint Specification section with a note about how to implement the custom webhook (since once you point at your own service you need to understand what data gets passed back and forth).

And the below section can have some of the background information removed (or simplified) since it's now captured here.

Copy link
Member Author

Choose a reason for hiding this comment

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

Done! Incoming!

Copy link
Collaborator

@igooch igooch left a comment

Choose a reason for hiding this comment

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

LGTM

@agones-bot
Copy link
Collaborator

Build Succeeded 👏

Build Id: 98c06fc4-76fa-44ad-9637-bc15e2033708

The following development artifacts have been built, and will exist for the next 30 days:

A preview of the website (the last 30 builds are retained):

To install this version:

  • git fetch https://github.com/googleforgames/agones.git pull/3632/head:pr_3632 && git checkout pr_3632
  • helm install agones ./install/helm/agones --namespace agones-system --set agones.image.registry=us-docker.pkg.dev/agones-images/ci --set agones.image.tag=1.39.0-dev-3adc1b7-amd64

@roberthbailey roberthbailey merged commit eb42fa7 into googleforgames:main Feb 6, 2024
4 checks passed
@markmandel markmandel deleted the docs/fleet-autoscaler branch February 6, 2024 20:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
kind/documentation Documentation for Agones kind/feature New features for Agones size/M
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants