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

Add docs around HA support for the pipeline controller #3418

Merged
merged 1 commit into from
Nov 5, 2020
Merged

Add docs around HA support for the pipeline controller #3418

merged 1 commit into from
Nov 5, 2020

Conversation

qu1queee
Copy link
Contributor

@qu1queee qu1queee commented Oct 20, 2020

Changes

Follow up from issue #2735

This adds documentation around HA support for the tekton pipeline controller.
HA is enabled by default, this PR introduces a doc with information on the behaviour
and how could devs/maintainers enable/disable it.

fyi @afrittoli

Submitter Checklist

These are the criteria that every PR should meet, please check them off as you
review them:

  • Includes tests (if functionality changed/added)
  • Includes docs (if user facing)
  • Commit messages follow commit message best practices
  • Release notes block has been filled in or deleted (only if no user facing changes)

See the contribution guide for more details.

Double check this list of stuff that's easy to miss:

Reviewer Notes

If API changes are included, additive changes must be approved by at least two OWNERS and backwards incompatible changes must be approved by more than 50% of the OWNERS, and they must first be added in a backwards compatible way.

Release Notes

@tekton-robot tekton-robot added the release-note Denotes a PR that will be considered when it comes time to generate release notes. label Oct 20, 2020
@tekton-robot tekton-robot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. labels Oct 20, 2020
@tekton-robot
Copy link
Collaborator

Hi @qu1queee. Thanks for your PR.

I'm waiting for a tektoncd member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work. Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

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.

Copy link
Member

@jerop jerop left a comment

Choose a reason for hiding this comment

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

/ok-to-test
/kind documentation

@tekton-robot tekton-robot added kind/documentation Categorizes issue or PR as related to documentation. ok-to-test Indicates a non-member PR verified by an org member that is safe to test. and removed needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. labels Oct 20, 2020
@afrittoli
Copy link
Member

/test pull-tekton-pipeline-unit-tests

@afrittoli
Copy link
Member

/test pull-tekton-pipeline-integration-tests

Copy link
Member

@afrittoli afrittoli left a comment

Choose a reason for hiding this comment

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

Thank you for this!

I think it would be nice to have this documentation discoverable from other docs, the install guide sounds like a good candidate - https://github.com/tektoncd/pipeline/blob/master/docs/install.md.

The active/passive vs active/active may need to be correct.

Once this is ready and merged, it would be great if you could add the new file to the sync config for the website, e.g. tektoncd/website#179

docs/developers/enabling-ha.md Outdated Show resolved Hide resolved
docs/developers/enabling-ha.md Show resolved Hide resolved
Comment on lines +39 to +42
| Parameter | Default |
| -------------------- | -------- |
| `data.resourceLock` | "leases" |
| `data.leaseDuration` | 15s |
| `data.renewDeadline` | 10s |
| `data.retryPeriod` | 2s |
Copy link
Member

Choose a reason for hiding this comment

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

@mattmoor since this is inherited from knative/pkg, is there some documentation from that package that we can point to in here?

Choose a reason for hiding this comment

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

Looks like that the key bucket is supported as well as I mentioned here: #3404, although they seem to be two different models of leadership election. As per my experiments, when the statefulset based leader election is enabled all instances become active. Perhaps @mattmoor can elaborate a litle about that.

docs/developers/enabling-ha.md Outdated Show resolved Hide resolved
@afrittoli
Copy link
Member

/test pull-tekton-pipeline-unit-tests

@afrittoli afrittoli closed this Oct 20, 2020
@afrittoli afrittoli reopened this Oct 20, 2020
@afrittoli
Copy link
Member

/retest

### Customizing High Availability for the Pipelines Controller

To customize the behavior of HA for the Tekton Pipelines controller, please refer to the related [documentation](/developers/enabling-ha.md).

Copy link
Member

Choose a reason for hiding this comment

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

the link is broken here, has extra /, link must point to developers/enabling-ha.md

Copy link
Contributor Author

Choose a reason for hiding this comment

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

fixed

@pritidesai
Copy link
Member

hey @afrittoli any more changes needed here? its planned for next release, possible in a day 😜 🙏

@afrittoli
Copy link
Member

I will review this today

This adds documentation around HA support for the tekton pipeline controller.
HA is enabled by default, therefore adding more information on the behaviour
and how could devs/maintainers use it.
Copy link
Member

@afrittoli afrittoli left a comment

Choose a reason for hiding this comment

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

Thanks for this!
We can add if needed after the release, but I'm happy for this to be merged as it is.
/approve

@tekton-robot
Copy link
Collaborator

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: afrittoli

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

@tekton-robot tekton-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Nov 5, 2020
@afrittoli
Copy link
Member

@mattmoor @imjasonh @bobcatfish @pritidesai this is needed for the release, if you have a chance to review

@pritidesai
Copy link
Member

thanks a bunch @qu1queee 🙏
/lgtm

@tekton-robot tekton-robot added the lgtm Indicates that a PR is ready to be merged. label Nov 5, 2020
@tekton-robot tekton-robot merged commit bfc654e into tektoncd:master Nov 5, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. kind/documentation Categorizes issue or PR as related to documentation. lgtm Indicates that a PR is ready to be merged. ok-to-test Indicates a non-member PR verified by an org member that is safe to test. release-note Denotes a PR that will be considered when it comes time to generate release notes. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants