Skip to content

Conversation

@ddhodge
Copy link
Contributor

@ddhodge ddhodge commented Dec 31, 2025

@netlify /stable/manage/upgrade-deployment/

@ddhodge ddhodge self-assigned this Dec 31, 2025
@ddhodge ddhodge added the area/documentation Documentation needed label Dec 31, 2025
@github-project-automation github-project-automation bot moved this to In progress in Documentation Dec 31, 2025
@netlify
Copy link

netlify bot commented Dec 31, 2025

Deploy Preview for infallible-bardeen-164bc9 ready!

Name Link
🔨 Latest commit 40c0fce
🔍 Latest deploy log https://app.netlify.com/projects/infallible-bardeen-164bc9/deploys/695cc0a2e5d1300008489bf0
😎 Deploy Preview https://deploy-preview-29837--infallible-bardeen-164bc9.netlify.app/stable/manage/upgrade-deployment/
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Collaborator

@aishwarya24 aishwarya24 left a comment

Choose a reason for hiding this comment

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

some comments


## Example deployment

The universe is deployed across three distinct zones in us-west1, specifically us-west1-a, us-west1-b, and us-west1-c, with one Master and one TServer provisioned in each zone using the following Helm command.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
The universe is deployed across three distinct zones in us-west1, specifically us-west1-a, us-west1-b, and us-west1-c, with one Master and one TServer provisioned in each zone using the following Helm command.
The universe is deployed across three distinct zones in us-west1, specifically us-west1-a, us-west1-b, and us-west1-c, with one Master and one TServer provisioned in each zone using the following Helm commands.

---

The following steps assume a multi-zone Kubernetes cluster, deployed as described in [Deploy on Google Kubernetes Engine](../../deploy/kubernetes/multi-zone/gke/helm-chart/), but you can adapt these steps to upgrade other types of deployments.

Copy link
Collaborator

Choose a reason for hiding this comment

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

So can all the steps on this page be used for both GKE-specific or general Kubernetes? Or just specific sections?

Copy link
Contributor Author

@ddhodge ddhodge Jan 6, 2026

Choose a reason for hiding this comment

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

@amannijhawan some questions can you TAL

Copy link
Contributor Author

Choose a reason for hiding this comment

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

--wait
```

To prevent software upgrades on a TServer during a Master upgrade, configure the partition.tserver setting to equal the number of TServers in that specific zone.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Unclear what partition.tserver=1 is actually doing in the example. Why would you require to provide this setting if TServers should not be upgraded?

--wait
```

After upgrading all the YB-Master and YB-TServer processes, monitor the cluster to ensure it is healthy. Make sure workloads are running as expected and there are no errors in the logs.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Is there a command to check if the masters and tservers are running fine after the upgrades?


```sh
helm upgrade yb-demo-us-west1-a yugabytedb/yugabyte \
--version 2024.2.3 \
Copy link
Collaborator

Choose a reason for hiding this comment

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

the upgrade version in the example is 2024.2.3. Line 154: states upgrading from 2024.2.3.3-b4 to 2025.1.1.2-b3.


To do this:

1. Copy the new software tar package into a TServer pod temporarily. This allows the pg_upgrade binary in the new software to access the data directory.
Copy link
Collaborator

Choose a reason for hiding this comment

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

where to get the package from... how and which pod to copy (kubectl cp)?

--wait
```

1. If auth is enabled on the cluster, do the following:
Copy link
Collaborator

Choose a reason for hiding this comment

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

When is authentication required vs optional ?

Co-authored-by: Aishwarya Chakravarthy  <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/documentation Documentation needed

Projects

Status: In progress

Development

Successfully merging this pull request may close these issues.

3 participants