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

Refactor upgrade docs #7668

Merged
merged 8 commits into from
Feb 28, 2024
Merged

Conversation

csplinter
Copy link
Member

  • Added a new Upgrade Overview page
  • Added high-level content for separate management / workload component upgrades
  • Added mention of in-place upgrades for bare metal
  • Consolidated content that was reused across bare metal and vsphere upgrade docs

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

@eks-distro-bot eks-distro-bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Feb 21, 2024
Copy link

codecov bot commented Feb 21, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 73.61%. Comparing base (4583834) to head (4c55543).
Report is 144 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #7668      +/-   ##
==========================================
+ Coverage   73.48%   73.61%   +0.12%     
==========================================
  Files         579      588       +9     
  Lines       36357    37149     +792     
==========================================
+ Hits        26718    27346     +628     
- Misses       7875     8012     +137     
- Partials     1764     1791      +27     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@csplinter csplinter force-pushed the docs-refactor-upgrades branch from e145683 to afe58b3 Compare February 23, 2024 19:10
Copy link
Member

@drewvanstone drewvanstone left a comment

Choose a reason for hiding this comment

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

Couple small nits, but otherwise lgtm


If you are using an Kubernetes API-compatible client, you modify your workload cluster spec yaml and apply the modified yaml to your management cluster. The EKS Anywhere lifecycle controller, which runs on the management cluster, reconciles the desired changes on the workload cluster.

As of EKS Anywhere version `v0.19.0`, management components can be upgraded separately from cluster components. This is enables you to get the latest updates to the management components such as Cluster API controller, EKS Anywhere controller, and provider-specific controllers without impact to your workload clusters. Management components can only be upgraded with the `eksctl anywhere` CLI, which has new `eksctl anywhere upgrade plan management-components` and `eksctl anywhere upgrade management-component` commands. For more information, reference the [Upgrade management components page.]({{< relref "./management-components-upgrade" >}})
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
As of EKS Anywhere version `v0.19.0`, management components can be upgraded separately from cluster components. This is enables you to get the latest updates to the management components such as Cluster API controller, EKS Anywhere controller, and provider-specific controllers without impact to your workload clusters. Management components can only be upgraded with the `eksctl anywhere` CLI, which has new `eksctl anywhere upgrade plan management-components` and `eksctl anywhere upgrade management-component` commands. For more information, reference the [Upgrade management components page.]({{< relref "./management-components-upgrade" >}})
As of EKS Anywhere version `v0.19.0`, management components can be upgraded separately from cluster components. This is enables you to get the latest updates to the management components such as Cluster API controller, EKS Anywhere controller, and provider-specific controllers without impact to your workload clusters. Management components can only be upgraded with the `eksctl anywhere` CLI, which has new `eksctl anywhere upgrade plan management-components` and `eksctl anywhere upgrade management-component` commands. For more information, reference the [Upgrade Management Components page.]({{< relref "./management-components-upgrade" >}})


### Upgrading Kubernetes Versions

Each EKS Anywhere version supports at least 4 minor versions of Kubernetes. Kubernetes patch version increments are included in EKS Anywhere minor and patch releases. There are two places in the cluster spec where you can configure the Kubernetes version, `Cluster.Spec.KubernetesVersion` and `Cluster.Spec.WorkerNodeGroupConfiguration[].KubernetesVersion`. If only `Cluster.Spec.KubernetesVersion` is set, then that version will apply to both control plane and worker nodes. You can use `Cluster.Spec.WorkerNodeGroupConfiguration[].KubernetesVersion` to upgrade your worker nodes separately from control plane nodes. The `Cluster.Spec.WorkerNodeGroupConfiguration[].KubernetesVersion` cannot be greater than `Cluster.Spec.KubernetesVersion`.
Copy link
Member

Choose a reason for hiding this comment

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

cannot be greater than Cluster.Spec.KubernetesVersion

Should we call out the minimum version the worker nodes can be as well?

@eks-distro-bot
Copy link
Collaborator

[APPROVALNOTIFIER] This PR is APPROVED

Approval requirements bypassed by manually added approval.

This pull-request has been approved by:

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@eks-distro-bot eks-distro-bot merged commit 3c1d726 into aws:main Feb 28, 2024
8 checks passed
@csplinter
Copy link
Member Author

/cherrypick release-0.19

@eks-distro-pr-bot
Copy link
Contributor

@csplinter: new pull request created: #7732

In response to this:

/cherrypick release-0.19

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved area/docs Documentation documentation lgtm size/L Denotes a PR that changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

8 participants