Add docs and examples for Windows

[aiden-deloryn]

Changes

A new markdown file has been added to document Windows usage in Tekton.

Some examples have been added to demonstrate how to schedule TaskRuns
and PipelineRuns on a Windows node using node selectors and node
affinity constraints.

/kind documentation

Submitter Checklist

As the author of this PR, please check off the items in this checklist:

• Docs included if any changes are user facing
• Tests included if any functionality added or changed
• Follows the commit message standard
• Meets the Tekton contributor standards (including
  functionality, content, code)
• Release notes block below has been filled in or deleted (only if no user facing changes)

Release Notes

NONE

[tekton-robot]

Hi @aiden-deloryn. 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.

[aiden-deloryn]

/assign @dlorenc

[vdemeester]

/ok-to-test

[aiden-deloryn]

/retest

[aiden-deloryn]

/retest

[dlorenc]

The examples actually get run as part of tests, we probably don't have a Windows node in our test clusters to run these on.

[aiden-deloryn]

@dlorenc Aren't the examples under taskruns/no-ci/ and pipelineruns/no-ci/ supposed to be skipped for tests?

It seems the failed tests are due to linting / white-space errors:

./examples/v1beta1/pipelineruns/no-ci/windows-node-selectors.yaml
  17:10     error    trailing spaces  (trailing-spaces)

./examples/v1beta1/pipelineruns/no-ci/windows-node-affinity.yaml
  17:10     error    trailing spaces  (trailing-spaces)

./examples/v1beta1/taskruns/no-ci/windows-node-affinity.yaml
  24:9      error    wrong indentation: expected 6 but found 8  (indentation)

[vdemeester]

@dlorenc Aren't the examples under taskruns/no-ci/ and pipelineruns/no-ci/ supposed to be skipped for tests?

It seems the failed tests are due to linting / white-space errors:

./examples/v1beta1/pipelineruns/no-ci/windows-node-selectors.yaml
  17:10     error    trailing spaces  (trailing-spaces)

./examples/v1beta1/pipelineruns/no-ci/windows-node-affinity.yaml
  17:10     error    trailing spaces  (trailing-spaces)

./examples/v1beta1/taskruns/no-ci/windows-node-affinity.yaml
  24:9      error    wrong indentation: expected 6 but found 8  (indentation)

They don't run as part of the test (not applied to the cluster, …), but they still get "validated" by the linters 😝

[aiden-deloryn]

They don't run as part of the test (not applied to the cluster, …), but they still get "validated" by the linters 😝

That does appear to be the case. Thanks for the confirmation 😄

The tests succeeded after I fixed the linting errors. Please let me know if there is anything else I need to change.

[tekton-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: vdemeester

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 [vdemeester]

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

[bobcatfish]

I always love more docs :D

/lgtm