Nginx Ingress Integrator

  • By Tom Haddon
juju deploy nginx-ingress-integrator
Show information
You will need Juju 2.9 to be able to run this command. Learn how to upgrade to Juju 2.9.
Channel Version Revision Published Runs on
latest/stable 22 22 29 Jul 2021
Ubuntu 20.04
latest/edge 12 12 11 May 2021
Ubuntu 20.04


  • additional-hostnames | string

    Comma-separated list of additional hostnames for this ingress to listen on.

  • ingress-class | string

    The ingress class to target for this ingress resource. If your cluster has multiple ingress controllers, this allows you to select the correct one, by setting the ingressClassName field on the ingress resource created by the charm. This value isn't available to be set via the relation as it's a property of the cluster's configuration. If this value is empty, the charm will use whichever ingress class has the "" annotation set to "true". If multiple ingress classes are so configured, no selection will be made. For more details, see: * *

  • limit-rps | int

    Number of requests accepted from a given IP each second. The burst limit is set to this limit multiplied by 5. When clients exceed this limit a 503 error will be returned. Setting this to 0 disables rate-limiting.

  • limit-whitelist | string

    If rate-limiting is set, client IP source ranges to be excluded. The value is a comma-separated list of CIDRs.

  • max-body-size | int

    Default: 20

    Max allowed body-size (for file uploads) in megabytes, set to 0 to disable limits.

  • path-routes | string

    Comma separated list of the routes under the hostname that you wish to map to the relation. Example: "/admin,/portal" will map example.test/admin and example.test/portal only.

  • retry-errors | string

    Specifies in which cases a request should be retried against the next server. Comma-separated list, e.g. "error,timeout,http_502,http_503,http_504". See for more details. Unrecognised values will be ignored. The nginx default will be used if this config option is set to an empty value.

  • rewrite-enabled | boolean

    Whether requests should be written to the `rewrite-target`

  • rewrite-target | string

    Default: /

    The path to rewrite requests to.

  • service-hostname | string

    The hostname of the service to create an ingress for.

  • service-name | string

    The name of the service to create an ingress for.

  • service-namespace | string

    The namespace of the service to create an ingress for. Will default to the namespace this charm is deployed into.

  • service-port | int

    The port of the service to create an ingress for.

  • tls-secret-name | string

    The name of the TLS secret to use. Leaving this empty will configure an ingress with TLS disabled.