Bug 1727781 - all links got 404 in "oc explain pods"
Summary: all links got 404 in "oc explain pods"
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: oc
Version: 4.1.z
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: ---
: 4.3.0
Assignee: Mike Dame
QA Contact: zhou ying
URL:
Whiteboard:
Depends On: 1477957
Blocks:
TreeView+ depends on / blocked
 
Reported: 2019-07-08 07:39 UTC by zhou ying
Modified: 2020-01-23 11:04 UTC (History)
9 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Cause: Upstream doc links were out of date in some comments on types Consequence: Broken links would be parsed down to oc explain Fix: Updated comments and rebased vendored types to pull in changes Result: Links are now valid
Clone Of: 1477957
Environment:
Last Closed: 2020-01-23 11:04:15 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2020:0062 0 None None None 2020-01-23 11:04:40 UTC

Description zhou ying 2019-07-08 07:39:16 UTC
+++ This bug was initially created as a clone of Bug #1477957 +++

Description of problem:
all links got 404 in "oc explain pods" 
Version-Release number of selected component (if applicable):
openshift v4.1.4

How reproducible:
Always

Steps to Reproduce:
1. oc explain pods
2. open any link

Actual results:
404 page not found

Expected results:
right web page displayed

Additional info:

Comment 1 Maciej Szulik 2019-08-16 14:36:11 UTC
Mike, since you're the expert, it looks like api-convetions moved to https://git.k8s.io/community/contributors/devel/api-conventions.md
not sure what else moved along with it.

Comment 3 Mike Dame 2019-08-16 19:11:20 UTC
I haven't been able to fetch or push to k8s repos all day, don't know why (it's only k8s). I opened an upstream issue to track this and hopefully will be able to actually make the change https://github.com/kubernetes/kubernetes/issues/81526

Comment 4 Mike Dame 2019-08-19 14:16:27 UTC
This is apparently being worked on in this PR: https://github.com/kubernetes/kubernetes/pull/74245

however that was opened in February and it's been pretty quiet from the author since... hopefully it gets an update soon

Comment 5 Maciej Szulik 2019-08-21 11:43:11 UTC
This requires a bigger change, we'll have to live with the current not working links, moving this to 4.3

Comment 6 Mike Dame 2019-10-29 16:48:15 UTC
This should be fixed now

Comment 8 zhou ying 2019-10-30 02:50:14 UTC
Confirmed with latest oc client, the issue has fixed:
[root@dhcp-140-138 ~]# oc version
Client Version: v4.3.0
Server Version: 4.3.0-0.nightly-2019-10-29-140935
Kubernetes Version: v1.16.2


[root@dhcp-140-138 ~]# oc explain services
KIND:     Service
VERSION:  v1

DESCRIPTION:
     Service is a named abstraction of software service (for example, mysql)
     consisting of local port (for example 3306) that the proxy listens on, and
     the selector that determines which pods will answer requests sent through
     the proxy.

FIELDS:
   apiVersion	<string>
     APIVersion defines the versioned schema of this representation of an
     object. Servers should convert recognized schemas to the latest internal
     value, and may reject unrecognized values. More info:
     https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

   kind	<string>
     Kind is a string value representing the REST resource this object
     represents. Servers may infer this from the endpoint the client submits
     requests to. Cannot be updated. In CamelCase. More info:
     https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

   metadata	<Object>
     Standard object's metadata. More info:
     https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

   spec	<Object>
     Spec defines the behavior of a service.
     https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

   status	<Object>
     Most recently observed status of the service. Populated by the system.
     Read-only. More info:
     https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

All the links can be opened.

Comment 10 errata-xmlrpc 2020-01-23 11:04:15 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2020:0062


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