Skip to content

docs: update CRD docs #192

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
Jul 16, 2025
Merged

docs: update CRD docs #192

merged 10 commits into from
Jul 16, 2025

Conversation

kayx23
Copy link
Contributor

@kayx23 kayx23 commented Jul 3, 2025

Description

  • Updated CRD docs.
  • Added a couple missing kubebuilder annotation enums.

HMAC related docs are not updated. See: #192 (comment)

Type of change

  • Bugfix
  • New feature provided
  • Improve performance
  • Backport patches
  • Documentation
  • Refactor
  • Chore
  • CI/CD or Tests

Copy link

github-actions bot commented Jul 3, 2025

conformance test report - apisix mode

apiVersion: gateway.networking.k8s.io/v1
date: "2025-07-04T09:06:03Z"
gatewayAPIChannel: standard
gatewayAPIVersion: v1.2.0
implementation:
  contact: null
  organization: APISIX
  project: apisix-ingress-controller
  url: https://github.com/apache/apisix-ingress-controller.git
  version: v2.0.0
kind: ConformanceReport
mode: default
profiles:
- core:
    failedTests:
    - HTTPRouteCrossNamespace
    - HTTPRouteMatchingAcrossRoutes
    result: failure
    skippedTests:
    - HTTPRouteHTTPSListener
    statistics:
      Failed: 2
      Passed: 30
      Skipped: 1
  name: GATEWAY-HTTP
  summary: Core tests failed with 2 test failures.

Copy link

github-actions bot commented Jul 3, 2025

conformance test report

apiVersion: gateway.networking.k8s.io/v1
date: "2025-07-16T02:55:18Z"
gatewayAPIChannel: standard
gatewayAPIVersion: v1.2.0
implementation:
  contact: null
  organization: APISIX
  project: apisix-ingress-controller
  url: https://github.com/apache/apisix-ingress-controller.git
  version: v2.0.0
kind: ConformanceReport
mode: default
profiles:
- core:
    result: partial
    skippedTests:
    - HTTPRouteHTTPSListener
    statistics:
      Failed: 0
      Passed: 32
      Skipped: 1
  name: GATEWAY-HTTP
  summary: Core tests partially succeeded with 1 test skips.

@kayx23 kayx23 changed the title [WIP] docs: update CRD doc docs: update CRD docs Jul 4, 2025
@kayx23 kayx23 marked this pull request as ready for review July 4, 2025 08:33

// FilterFunc is a user-defined function for advanced request filtering.
// The function can use Nginx variables through the `vars` parameter.
// This field is supported in APISIX but not in API7 Enterprise.
FilterFunc string `json:"filter_func,omitempty" yaml:"filter_func,omitempty"`
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This field is supported in APISIX but not in API7 Enterprise.

cc: @oil-oil as discussed yesterday, filter_func

@kayx23
Copy link
Contributor Author

kayx23 commented Jul 4, 2025

HMAC related docs are not updated (and not marked yet). There was a breaking change and APISIX CRD docs generated for hmac-auth is not applicable for either APISIX or Enterprise.

R&D to remove HMAC - since the change is not just a documentary change.

discussion: https://applink.feishu.cn/client/message/link/open?token=AmgIUwWIYsABaG8vyr4BgAQ%3D

@kayx23
Copy link
Contributor Author

kayx23 commented Jul 4, 2025

One issue:

The generated doc has a non-clickable link rendered in markdown:

image

I think its due to this line:

image

Might need to manually replace at the moment or update the template.

Copy link

github-actions bot commented Jul 8, 2025

conformance test report - apisix mode

apiVersion: gateway.networking.k8s.io/v1
date: "2025-07-16T02:51:24Z"
gatewayAPIChannel: standard
gatewayAPIVersion: v1.2.0
implementation:
  contact: null
  organization: APISIX
  project: apisix-ingress-controller
  url: https://github.com/apache/apisix-ingress-controller.git
  version: v2.0.0
kind: ConformanceReport
mode: default
profiles:
- core:
    failedTests:
    - HTTPRouteInvalidBackendRefUnknownKind
    result: failure
    skippedTests:
    - HTTPRouteHTTPSListener
    statistics:
      Failed: 1
      Passed: 31
      Skipped: 1
  name: GATEWAY-HTTP
  summary: Core tests failed with 1 test failures.

Copy link

github-actions bot commented Jul 8, 2025

conformance test report - apisix-standalone mode

apiVersion: gateway.networking.k8s.io/v1
date: "2025-07-16T02:50:24Z"
gatewayAPIChannel: standard
gatewayAPIVersion: v1.2.0
implementation:
  contact: null
  organization: APISIX
  project: apisix-ingress-controller
  url: https://github.com/apache/apisix-ingress-controller.git
  version: v2.0.0
kind: ConformanceReport
mode: default
profiles:
- core:
    failedTests:
    - HTTPRouteInvalidBackendRefUnknownKind
    result: failure
    skippedTests:
    - HTTPRouteHTTPSListener
    statistics:
      Failed: 1
      Passed: 31
      Skipped: 1
  name: GATEWAY-HTTP
  summary: Core tests failed with 1 test failures.

@AlinsRan AlinsRan merged commit 63397b4 into release-v2-dev Jul 16, 2025
26 of 32 checks passed
@AlinsRan AlinsRan deleted the docs/update-crd branch July 16, 2025 08:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants