Bug 1635251 - [DOCS] Ansible playbook to redeploy certificate for nodes is missing
Summary: [DOCS] Ansible playbook to redeploy certificate for nodes is missing
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.10.0
Hardware: All
OS: Linux
high
high
Target Milestone: ---
: 3.11.z
Assignee: Andrea Hoffer
QA Contact: Gaoyun Pei
Vikram Goyal
URL:
Whiteboard:
: 1652649 1656250 1683797 1694451 1775314 (view as bug list)
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2018-10-02 13:08 UTC by Suresh
Modified: 2023-03-24 14:16 UTC (History)
18 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2019-12-18 02:21:39 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Knowledge Base (Solution) 3782361 0 None None None 2019-01-03 15:30:37 UTC

Description Suresh 2018-10-02 13:08:02 UTC
Description of problem:
	
As per,

https://docs.openshift.com/container-platform/3.10/install_config/redeploying_certificates.html#redeploying-node-certificates


The redeploy certificate playbook for node seems to be missing.

# ls /usr/share/ansible/openshift-ansible/playbooks/openshift-node/redeploy-certificates.yml
ls: cannot access /usr/share/ansible/openshift-ansible/playbooks/openshift-node/redeploy-certificates.yml: No such file or directory

I don't see this playbook in 3.11 repository as well.




Version-Release number of the following components:
openshift-ansible-3.10.47-1.git.0.95bc2d2.el7_5.noarch

Comment 1 Scott Dodson 2018-10-02 14:00:42 UTC
In 3.10 and 3.11 nodes will automatically generate new certificate signing requests starting at 80% of their certificate's lifespan. Once the CSRs are created they can be approved via the API. This part of the product is owned by the Auth team so I'm moving this there so they can coordinate with the docs team to amend our certificate management documentation to account for this.

Comment 2 Erica von Buelow 2018-10-02 18:57:44 UTC
Moving to docs for prioritization.

Comment 4 Sergio G. 2018-10-15 13:16:41 UTC
@erica not sure if this is for docs or installer/configuration. Redeploying nodes certificates is a common task and without such playbook all the tasks are manual:
 - stopping services
 - delete node.kubeconfig/certificates
 - starting services
 - signing csr

Comment 5 Ryan Howe 2018-11-22 17:56:14 UTC
Docs bug filed: 
https://bugzilla.redhat.com/show_bug.cgi?id=1652649


To redeploy client and server certs run the following: 

# rm -f /etc/origin/node/certificate 
# systemctl restart atomic-openshift-node

Approve the requests: 

# oc get csr -o name | xargs oc adm certificate approve


Bootstrap.kubeconfig does not get updated via playbooks or above steps.

Comment 7 Ryan Howe 2019-01-03 15:31:32 UTC
*** Bug 1652649 has been marked as a duplicate of this bug. ***

Comment 8 Ryan Howe 2019-01-03 15:33:50 UTC
For steps to manually create the node certificates 3.10+ see KCS: https://access.redhat.com/solutions/3782361

Comment 10 Stephen Cuppett 2019-11-21 12:47:21 UTC
OCP 3.6-3.10 is no longer on full support [1]. Marking un-triaged bugs CLOSED DEFERRED. If you have a customer case with a support exception or have reproduced on 3.11+, please reopen and include those details. When reopening, please set the Version to the appropriate version where reproduced.

[1]: https://access.redhat.com/support/policy/updates/openshift

Comment 11 Sergio G. 2019-11-21 13:51:10 UTC
I can understand that the product is out of full support but are we still sending wrong instructions in the documentation? 

This bugzilla is about mentioning a non-existing playbook in the documentation. If you read the description you will see that the documentation says

> The openshift-node/redeploy-certificates.yml playbook only redeploys node certificates. This also include serial restarts of node services.
>
>To redeploy node certificates, run this playbook, specifying your inventory file:
>
>$ ansible-playbook -i <inventory_file> \
>    /usr/share/ansible/openshift-ansible/playbooks/openshift-node/redeploy-certificates.yml

while in 3.10 that playbook is gone and redeploying certificates for nodes is done by bootstraping the node again.

I'd ask you to re-consider if this bugzilla should be closed or not (IMHO it should be fixed). If not, please add a disclaimer on every single page saying that the documentation is outdated, not actively maintained and that it can contain wrong instructions so customers can be aware of that.

Comment 12 Vikram Goyal 2019-11-22 05:20:11 UTC
(In reply to Sergio G. from comment #11)
> I can understand that the product is out of full support but are we still
> sending wrong instructions in the documentation? 
> 
> This bugzilla is about mentioning a non-existing playbook in the
> documentation. If you read the description you will see that the
> documentation says
> 
> > The openshift-node/redeploy-certificates.yml playbook only redeploys node certificates. This also include serial restarts of node services.
> >
> >To redeploy node certificates, run this playbook, specifying your inventory file:
> >
> >$ ansible-playbook -i <inventory_file> \
> >    /usr/share/ansible/openshift-ansible/playbooks/openshift-node/redeploy-certificates.yml
> 
> while in 3.10 that playbook is gone and redeploying certificates for nodes
> is done by bootstraping the node again.
> 
> I'd ask you to re-consider if this bugzilla should be closed or not (IMHO it
> should be fixed). If not, please add a disclaimer on every single page
> saying that the documentation is outdated, not actively maintained and that
> it can contain wrong instructions so customers can be aware of that.

Hi Sergio,

That is indeed the plan. After Thanksgiving, we will be archiving these docs.

Comment 13 Andrea Hoffer 2019-12-09 18:22:25 UTC
Submitted PR: https://github.com/openshift/openshift-docs/pull/18520

@Ryan Howe - can you please review based on our discussion earlier today? Thanks!

Comment 14 Gaoyun Pei 2019-12-17 08:59:31 UTC
LGTM, thanks.

Comment 15 Andrea Hoffer 2019-12-17 14:27:52 UTC
Thanks @Gaoyun Pei!

PRs have been merged.

Comment 17 Jason Boxman 2019-12-19 01:24:27 UTC
*** Bug 1656250 has been marked as a duplicate of this bug. ***

Comment 18 Michael Burke 2020-01-14 20:27:40 UTC
*** Bug 1683797 has been marked as a duplicate of this bug. ***

Comment 19 Max Bridges 2020-02-13 16:49:20 UTC
*** Bug 1775314 has been marked as a duplicate of this bug. ***

Comment 20 Andrea Hoffer 2020-03-31 13:26:49 UTC
*** Bug 1694451 has been marked as a duplicate of this bug. ***


Note You need to log in before you can comment on or make changes to this bug.