ingress-nginx/mkdocs.yml at main · kubernetes/ingress-nginx · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
site_name: Ingress-Nginx Controller
repo_name: "kubernetes/ingress-nginx"
repo_url: https://github.com/kubernetes/ingress-nginx
site_url: https://kubernetes.github.io/ingress-nginx
edit_uri: edit/main/docs/

# Extensions
markdown_extensions:
  - admonition
  - abbr
  - attr_list
  - def_list
  - footnotes
  - meta
  - md_in_html
  - toc:
      # insert a blank space before the character
      permalink: " ¶"
  - pymdownx.arithmatex:
      generic: true
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret
  - pymdownx.critic
  - pymdownx.details
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:materialx.emoji.to_svg
  - pymdownx.highlight
  - pymdownx.inlinehilite
  - pymdownx.keys
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.snippets:
      check_paths: true
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.tilde

theme:
  name: material
  features:
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.instant
    - navigation.sections
    - content.code.copy

  palette:
    primary: "teal"
    accent: "green"

  include_sidebar: true

plugins:
  - search
  - awesome-pages
  - minify:
      minify_html: true

extra_css: [extra.css]


nav:
  - Welcome:
      - Welcome: "index.md"
      - How it works: "how-it-works.md"
      - Troubleshooting: "troubleshooting.md"
      - kubectl plugin: "kubectl-plugin.md"
  - Deployment:
      - Installation Guide: "deploy/index.md"
      - Bare-metal considerations: "deploy/baremetal.md"
      - Role Based Access Control (RBAC): "deploy/rbac.md"
      - Upgrade: "deploy/upgrade.md"
      - Hardening guide: "deploy/hardening-guide.md"
  - User Guide:
      - NGINX Configuration:
          - Introduction: "user-guide/nginx-configuration/index.md"
          - Basic usage: "user-guide/basic-usage.md"
          - Annotations: "user-guide/nginx-configuration/annotations.md"
          - Annotations Risks: "user-guide/nginx-configuration/annotations-risk.md"
          - ConfigMap: "user-guide/nginx-configuration/configmap.md"
          - Custom NGINX template: "user-guide/nginx-configuration/custom-template.md"
          - Log format: "user-guide/nginx-configuration/log-format.md"
      - Command line arguments: "user-guide/cli-arguments.md"
      - Custom errors: "user-guide/custom-errors.md"
      - Default backend: "user-guide/default-backend.md"
      - Exposing TCP and UDP services: "user-guide/exposing-tcp-udp-services.md"
      - Exposing FCGI services: "user-guide/fcgi-services.md"
      - Regular expressions in paths: user-guide/ingress-path-matching.md
      - External Articles: "user-guide/external-articles.md"
      - Miscellaneous: "user-guide/miscellaneous.md"
      - Prometheus and Grafana installation: "user-guide/monitoring.md"
      - Multiple Ingress controllers: "user-guide/multiple-ingress.md"
      - TLS/HTTPS: "user-guide/tls.md"
      - Third party addons:
          - ModSecurity Web Application Firewall: "user-guide/third-party-addons/modsecurity.md"
          - OpenTelemetry: "user-guide/third-party-addons/opentelemetry.md"
  - Examples:
      - Introduction: "examples/index.md"
      - Prerequisites: "examples/PREREQUISITES.md"
      - Sticky Sessions: "examples/affinity/cookie/README.md"
      - Auth:
          - Basic Authentication: "examples/auth/basic/README.md"
          - Client Certificate Authentication: "examples/auth/client-certs/README.md"
          - External Basic Authentication: "examples/auth/external-auth/README.md"
          - External OAUTH Authentication: "examples/auth/oauth-external-auth/README.md"
      - Customization:
          - Configuration Snippets: "examples/customization/configuration-snippets/README.md"
          - Custom Configuration: "examples/customization/custom-configuration/README.md"
          - Custom Errors: "examples/customization/custom-errors/README.md"
          - Custom Headers: "examples/customization/custom-headers/README.md"
          - External authentication: "examples/customization/external-auth-headers/README.md"
          - Custom DH parameters for perfect forward secrecy: "examples/customization/ssl-dh-param/README.md"
          - Sysctl tuning: "examples/customization/sysctl/README.md"
      - Docker registry: "examples/docker-registry/README.md"
      - gRPC: "examples/grpc/README.md"
      - Multi TLS certificate termination: "examples/multi-tls/README.md"
      - Rewrite: "examples/rewrite/README.md"
      - Static IPs: "examples/static-ip/README.md"
      - TLS termination: "examples/tls-termination/README.md"
      - Open Policy Agent rules: "examples/openpolicyagent/README.md"
      - Canary Deployments: "examples/canary/README.md"
  - Developer Guide:
      - Getting Started: "developer-guide/getting-started.md"
      - Code Overview: "developer-guide/code-overview.md"
  - FAQ: "faq.md"