Define a DLocker interface for distributed locker

[ahrtr]

Also updated the contrib/lock example to demo how to use the DLocker.

For more background, please refer to the article by Martin Kleppmann.

• It should be an improvement to help users better use etcd as a distributed lock.
• It's also backward compatible. It won't break any existing applications

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: ahrtr

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:

• OWNERS [ahrtr]

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

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 0% with 3 lines in your changes missing coverage. Please review.

Project coverage is 68.78%. Comparing base (18eb5c6) to head (bddc7a9).
Report is 390 commits behind head on main.

❗ Current head bddc7a9 differs from pull request most recent head 9786c9e

Please upload reports for the commit 9786c9e to get more accurate results.

Files with missing lines	Patch %	Lines
client/v3/concurrency/mutex.go	0.00%	3 Missing ⚠️

Additional details and impacted files

Files with missing lines	Coverage Δ
client/v3/concurrency/mutex.go	63.75% <0.00%> (+2.71%)	⬆️

... and 16 files with indirect coverage changes

@@            Coverage Diff             @@
##             main   #18779      +/-   ##
==========================================
+ Coverage   68.74%   68.78%   +0.04%     
==========================================
  Files         420      420              
  Lines       35512    35515       +3     
==========================================
+ Hits        24411    24430      +19     
+ Misses       9671     9659      -12     
+ Partials     1430     1426       -4     

---

Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 18eb5c6...9786c9e. Read the comment docs.

[ivanvc]

/test pull-etcd-verify

I want to check if it was a flake in govet.

[ahrtr]

/test pull-etcd-integration-1-cpu-amd64

[k8s-ci-robot]

PR needs rebase.

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-sigs/prow repository.

[k8s-ci-robot]

@ahrtr: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name	Commit	Details	Required	Rerun command
pull-etcd-markdown-lint	9786c9e	link	true	/test pull-etcd-markdown-lint

Full PR test history. Your PR dashboard. Please help us cut down on flakes by linking to an open issue when you hit one in your PR.

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-sigs/prow repository. I understand the commands that are listed here.