mkdocs.yml

site_name: OVN-Kubernetes
site_url: https://www.ovn.org/ovn-kubernetes/
repo_url: https://github.com/ovn-kubernetes/ovn-kubernetes
repo_name: ovn-kubernetes/ovn-kubernetes
edit_uri: edit/master/docs
extra_css:
  - stylesheets/extra.css
site_dir: site
docs_dir: docs
copyright: Copyright © OVN-Kubernetes a Series of LF Projects, LLC. For website terms of use, trademark policy and other project policies please see <a href="https://lfprojects.org/policies/">LF Projects Policies</a>.
theme:
  name: material
  icon:
    repo: fontawesome/brands/git-alt
  logo: images/ovn-inside-k8s.png
  favicon: images/ovn-inside-k8s.png
  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: deep purple
      toggle:
        icon: material/weather-night
        name: Switch to dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: cyan
      toggle:
        icon: material/weather-sunny
        name: Switch to light mode
  features:
    - navigation.instant
    - navigation.tracking
    - navigation.indexes
    - navigation.tabs
    - navigation.tabs.sticky
    - content.code.annotate
    - content.code.copy
plugins:
  - search
  - meta-descriptions
  - awesome-pages
  - mike
  - mermaid2
  - blog:
      # NOTE: configuration options can be found at
      # https://squidfunk.github.io/mkdocs-material/setup/setting-up-a-blog/
      blog_dir: blog
      blog_toc: true
      post_excerpt: required
      post_excerpt_max_authors: 2
  - glightbox:
      touchNavigation: true
      loop: false
      zoomable: true
      draggable: true
markdown_extensions:
  - admonition
  - meta
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.details
  - pymdownx.highlight
  - pymdownx.inlinehilite
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:mermaid2.fence_mermaid_custom
  - pymdownx.snippets:
      base_path: site-src
      check_paths: true
  - toc:
      permalink: true
nav:
  - Overview:
    - Introduction: index.md
    - Architecture: design/architecture.md
    - Network Topology: design/topology.md
    - Gateway Modes: design/gateway-modes.md
    - Traffic Flows: design/traffic-flows.md
    - Pod Creation Workflow: design/pod-creation-workflow.md
    - Service Creation Workflow: design/service-creation-workflow.md
    - Service Traffic Policy: design/service-traffic-policy.md
    - Host To NodePort Hairpin: design/host-to-node-port-hairpin-trafficflow.md
    - ExternalIPs/LoadBalancerIngress: design/external-ip-and-loadbalancer-ingress.md
    - DPU Host No-Overlay Routing: design/dpu-host-no-overlay-routing.md
    - Internal Subnets: design/ovn-kubernetes-subnets.md
    - Kubevirt VM Live Migration: features/live-migration.md
  - Getting Started:
    - Launching OVN-Kubernetes sandbox env: installation/launching-ovn-kubernetes-on-kind.md
    - Launching OVN-Kubernetes Using Helm: installation/launching-ovn-kubernetes-with-helm.md
    - Launching OVN-Kubernetes with DPU Acceleration: installation/launching-ovn-kubernetes-with-dpu.md
    - Launching OVN-Kubernetes with kubeadm: installation/INSTALL.KUBEADM.md
    - Configuration Guide: getting-started/configuration.md
    - Requirements: features/requirements.md
    - CLI Guide: getting-started/cli-guide.md
    - Deploying Workloads on OVN-Kubernetes cluster: getting-started/example-pod-creation.md
    - Deploying Services on OVN-Kubernetes cluster: getting-started/example-service-creation.md
    - Setup and Building: getting-started/building-ovn-kubernetes.md
  - Developer Guide:
      - Contributing Guide: governance/CONTRIBUTING.md
      - Governance: governance/GOVERNANCE.md
      - Reviewing Guide: governance/REVIEWING.md
      - Project Areas: developer-guide/areas.md
      - Coding Guide: developer-guide/developer.md
      - OVN-Kubernetes Container Images: developer-guide/image-build.md
      - Documentation Guide: developer-guide/documentation.md
      - Local Testing Guide: developer-guide/local_testing_guide.md
      - CI Testing Guide: ci/ci.md
      - Debugging: developer-guide/debugging.md
      - Release Guide: developer-guide/release.md
  - API Reference Guide:
      - Introduction: api-reference/introduction.md
      - EgressIP: api-reference/egress-ip-api-spec.md
      - EgressService: api-reference/egress-service-api-spec.md
      - EgressQoS: api-reference/egress-qos-api-spec.md
      - EgressFirewall: api-reference/egress-firewall-api-spec.md
      - AdminPolicyBasedExternalRoutes: api-reference/admin-epbr-api-spec.md
      - UserDefinedNetwork: api-reference/userdefinednetwork-api-spec.md
      - RouteAdvertisements: api-reference/routeadvertisements-api-spec.md
      - ClusterNetworkConnect: api-reference/clusternetworkconnect-api-spec.md
      - VTEP: api-reference/vtep-api-spec.md
  - Features:
    - Universal Connectivity:
      - UserDefinedNetwork: features/user-defined-networks/user-defined-networks.md
      - Connecting UserDefinedNetworks: features/user-defined-networks/cluster-network-connect.md
      - Dynamic UDN Node Allocation: features/user-defined-networks/dynamic-udn.md
    - NetworkSecurityControls:
      - AdminNetworkPolicy: features/network-security-controls/admin-network-policy.md
      - NetworkPolicy: features/network-security-controls/network-policy.md
      - EgressFirewall: features/network-security-controls/egress-firewall.md
    - ClusterEgressControls:
      - EgressIP: features/cluster-egress-controls/egress-ip.md
      - EgressService: features/cluster-egress-controls/egress-service.md
      - EgressQoS: features/cluster-egress-controls/egress-qos.md
      - EgressGateway: features/cluster-egress-controls/egress-gateway.md
    - InfrastructureSecurityControls:
      - NodeIdentity: features/infrastructure-security-controls/node-identity.md
    - MultiNetworking:
      - Multihoming: features/multiple-networks/multi-homing.md
      - MultiNetworkPolicies: features/multiple-networks/multi-network-policies.md
      - MultiNetworkRails: features/multiple-networks/multi-vtep.md
    - Multicast: features/multicast.md
    - NetworkQoS:
        - Overview: features/network-qos.md
        - Usage Guide: features/network-qos-guide.md
    - LiveMigration: features/live-migration.md
    - HybridOverlay: features/hybrid-overlay.md
    - OVS Dynamic CPU Affinity: features/ovs-dynamic-cpu-affinity.md
    - Hardware Acceleration:
      - OVS Acceleration with kernel datapath: features/hardware-offload/ovs-kernel.md
      - OVS Acceleration with DOCA datapath: features/hardware-offload/ovs-doca.md
    - BGP Integration:
      - Route Advertisements: features/bgp-integration/route-advertisements.md
      - No-Overlay Mode: features/bgp-integration/no-overlay.md
      - EVPN: features/bgp-integration/evpn.md
  - Troubleshooting:
    - Introduction: troubleshooting/debugging.md
    - OVNKube Trace: troubleshooting/ovnkube-trace.md
    - Logging: troubleshooting/logging.md
  - Observability:
    - Metrics: observability/metrics.md
    - SDN Dashboard: observability/sdn-dashboard.md
    - OVN observability: observability/ovn-observability.md
  - Enhancement Proposals:
    # - FeatureName: okeps/<filename.md>
    - Localnet API: okeps/okep-5085-localnet-api.md
    - Network QoS: okeps/okep-4380-network-qos.md
    - User Defined Networks: okeps/okep-5193-user-defined-networks.md
    - Preconfigured UDN Addresses: okeps/okep-5233-preconfigured-udn-addresses.md
    - BGP: okeps/okep-5296-bgp.md
    - Layer2TransitRouter: okeps/okep-5094-layer2-transit-router.md
    - MCP for Troubleshooting: okeps/okep-5494-ovn-kubernetes-mcp-server.md
    - Dynamic UDN Node Allocation: okeps/okep-5552-dynamic-udn-node-allocation.md
    - Connecting User Defined Networks: okeps/okep-5224-connecting-udns/okep-5224-connecting-udns.md
    - No-Overlay Mode: okeps/okep-5259-no-overlay.md
    - EVPN: okeps/okep-5088-evpn.md
    - DPU Healthcheck: okeps/okep-5674-dpu-healthcheck.md
    - Extend Primary UDN/CUDN to Support Multiple Cluster Subnets in Layer3 Topology: okeps/okep-5377-extend-udn-to-support-multiple-cluster-subnets-in-layer3-topology.md
    - VRF-Lite Shared Gateway Mode with Uplinks: okeps/okep-6019-vrf-lite-shared-gateway-external-bridges.md
  - Blog:
    - blog/index.md