Added a Recycler Pod Template Example

[pospispa]

Recycle pod template example is missing in the documentation.

That's why it is now added.

Related Trello card: https://trello.com/c/WhCK1Ndv/86-5-add-checks-and-documentation-about-template-pods-for-recycling
Related source code pull request: kubernetes/kubernetes#36221

cc: @jsafrane

---

This change is

[saad-ali]

Documentation is good. However, I'm not sure if we want to add more documentation, in this case, for the recycle retention policy, considering we want to deprecate it.

CC @kubernetes/sig-storage

[pospispa]

I know that the recycle retention policy should be deprecated, however, I don't know when it should be deprecated. Is there a plan when it will be deprecated and when it will be removed from source code?

[saad-ali]

Is there a plan when it will be deprecated and when it will be removed from source code?

@childsb @wattsteve?

[jsafrane]

I think it makes sense to document existing behavior with some note that dynamic provisioning is much better option and recyler should be used only when it's absolutely necessary.

[childsb]

I've re-opened a PR to add a deprecation statement for recycler.

Saad - can we merge this for 1.5? It's non functional and will start the count-down clock for recycler.

kubernetes/kubernetes#36760

[devin-donnelly]

Fine from a Docs perspective. Can somebody give it a tech LGTM?

@jsafrane?

[saad-ali]

I've re-opened a PR to add a deprecation statement for recycler.

Saad - can we merge this for 1.5? It's non functional and will start the count-down clock for recycler.

kubernetes/kubernetes#36760

Ack. @childsb could you do the tech review for this PR.

[jsafrane]

tech lgtm

[jsafrane]

@pospispa, please rebase