-
Notifications
You must be signed in to change notification settings - Fork 26
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
docs: add the takeover how-to doc (preview) #967
base: main
Are you sure you want to change the base?
Conversation
docs/howtos/takeover.md
Outdated
|
||
## Takeover and comparison options | ||
|
||
> See the how-to guide on drift detection for an explaination on comparison options. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
> See the how-to guide on drift detection for an explaination on comparison options. | |
> See the how-to guide on drift detection for an explanation on comparison options. |
docs/howtos/takeover.md
Outdated
# For simplicity reasons, the CRP is configured to roll out changes to | ||
# all member clusters at once. This is not a setup recommended for production | ||
# use. | ||
type: RollingUpdate | ||
rollingUpdate: | ||
maxUnavailable: 100% | ||
unavailablePeriodSeconds: 1 | ||
applyStrategy: | ||
whenToTakeOver: IfNoDiff | ||
EOF |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
# For simplicity reasons, the CRP is configured to roll out changes to | |
# all member clusters at once. This is not a setup recommended for production | |
# use. | |
type: RollingUpdate | |
rollingUpdate: | |
maxUnavailable: 100% | |
unavailablePeriodSeconds: 1 | |
applyStrategy: | |
whenToTakeOver: IfNoDiff | |
EOF | |
# For simplicity reasons, the CRP is configured to roll out changes to | |
# all member clusters at once. This is not a setup recommended for production | |
# use. | |
type: RollingUpdate | |
rollingUpdate: | |
maxUnavailable: 100% | |
unavailablePeriodSeconds: 1 | |
applyStrategy: | |
whenToTakeOver: IfNoDiff | |
EOF |
The steps below explain how the takeover experience functions. The code assumes that you have | ||
a fleet of two clusters, `member-1` and `member-2`: | ||
|
||
* Switch to the first member cluster, and create a namespace, `work-2`, with labels: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
* Switch to the first member cluster, and create a namespace, `work-2`, with labels: | |
* Switch to the second member cluster, and create a namespace, `work-2`, with labels: |
The `comparisonOptions` setting applies to the takeover process as well. | ||
If `partialComparison` is used, Fleet will only report configuration differences in the managed | ||
fields; the presence of extra fields on the member cluster side will not stop Fleet from taking | ||
over the pre-existing resource; on the contrary, with `fullComparsion`, Fleet will only take over |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
over the pre-existing resource; on the contrary, with `fullComparsion`, Fleet will only take over | |
over the pre-existing resource; on the contrary, with `fullComparison`, Fleet will only take over |
Description of your changes
This PR adds a how-to doc for the new takeover experience.
I have:
make reviewable
to ensure this PR is ready for review.How has this code been tested
N/A
Special notes for your reviewer