Skip to main content
Version: v0.15

Update Note: Version 0.2.8

Upgrade from legacy key declaration​

Route backends​

  • Old version
version: 1.0
gateway:
    routes:
        - path: /
          name: example route
          backends:
            - https://example.com
            - https://example2.com
            - https://example4.com
  • New version
version: 2
gateway:
  routes:
    - path: /
      name: example route
      hosts:
        - example.com
        - example.localhost
      rewrite: /
      methods: []
      healthCheck:
        path: "/"
        interval: 30s
        timeout: 10s
        healthyStatuses: [200, 404]
      ## destination: will be overridden by backends
      destination: ""
      backends:
        - endpoint: https://example.com
        - endpoint: https://example1.com
        - endpoint: https://example2.com
      cors: {}

Gateway TLS​

  • Old version
version: "1.0"
gateway:
    tlsCertFile: cert.pem
    tlsKeyFile: key.pem
  • New version
version: 2
gateway:
  tls:  # Global TLS configuration for the gateway
    keys:  # List of TLS certificates and private keys
      - cert: /path/to/certificate.crt  # File path to the TLS certificate
        key: /path/to/private.key  # File path to the private key
      - cert: LS0tLS1CRUdJTiBQUklWQVRFIEtFWS0tLS...  # Base64-encoded certificate
        key:  LS0tLS1CRUdJTiBQUklWQVRFIEtFWS0tLS...  # Base64-encoded private key
      - cert: |  # Raw certificate content (PEM format)
          -----BEGIN CERTIFICATE-----
            <certificate content>
          -----END CERTIFICATE-----
        key: |  # Raw private key content (PEM format)
          -----BEGIN PRIVATE KEY-----
             <private-key content>
          -----END PRIVATE KEY-----
  routes: