Aller au contenu principal

Ingress

info

Cette page concerne uniquement l'installation sur un existing cluster à l'aide de KOTS ou Helm.

Installation basée sur Helm​

Dans votre fichier values.yaml, ajoutez l'extrait suivant, adapté à vos besoins :

ingress:
enabled: true
# -- Ingress controller in use in the cluster. Mandatory if using istio or `experimental.ingressRoutes=true`
# Supported: ingress-nginx / traefik / contour / aws_alb / openshift (Openshift Route) / istio
controller: 'ingress-nginx'
pathType: 'Prefix'
path: '/'
ingressClassName: 'my-class-name'
annotations:
kubernetes.io/ingress.class: <ingress_class> # for ingress controllers that do not support ingressClassName
labels:
example.of.a.label: 'my-label'
tls:
enabled: true
existingSecret: 'secret-containing-the-ingress-tls-certificates'
istio:
# -- Istio revision, if any
revision: ''
gateway:
# -- Enable Istio gateway handling
enabled: false
# -- Istio Gateway name
name: ''
# -- Istio Gateway namespace
namespace: ''
# -- Istio Gateway selector
selector: 'ingressgateway'

Consultez Certificat TLS pour obtenir de l'aide sur la configuration de TLS.

Gateway API

Le chart Helm de GitGuardian peut également exposer le trafic externe via la Kubernetes Gateway API au lieu de la ressource Ingress traditionnelle. Cela est utile dans les clusters multi-tenant ou lorsque votre équipe plateforme a standardisé sur Gateway API. Consultez Gateway API.

Fonctionnalité héritée

La fonctionnalité expérimentale de routes Ingress est dépréciée. Pour les utilisateurs existants, consultez Routes Ingress héritées. Les nouveaux déploiements doivent utiliser le routage standard basé sur nginx.

Installation basée sur KOTS​

Sur les clusters existants, un Ingress par défaut est fourni. Cet Ingress par défaut s'appuie sur un service Kubernetes (nommé gitguardian).

L'ingress par défaut est personnalisable, permettant des modifications du className, pathType, Annotations/Labels.

TLS sera activé si vous téléchargez un certificat dans la section TLS certificates.

Dans la KOTS Admin Console, vous pouvez configurer les paramètres suivants :

  • ClassName de la ressource à utiliser
  • PathType et Path pour router vers l'instance GitGuardian
  • Annotations et Labels spécifiques à votre ingress controller

Ingress

Utiliser votre propre Ingress​

Vous avez la possibilité de désactiver l'Ingress par défaut et de configurer le vôtre. Voici comment procéder selon votre type d'installation :

Installation basée sur Helm​

Dans le fichier values.yaml, définissez le paramètre ingress.enabled sur false.

Installation basée sur KOTS​

Dans la KOTS Admin Console, utilisez simplement un Service.

Ingress annotations

Configuration Ingress personnalisée​

Si vous choisissez d'utiliser votre propre Ingress, voici les champs que vous devrez modifier :

  • defaultBackend
  • ingressClassName (utilisez ceci pour les ingress controllers qui le prennent en charge ; sinon, utilisez l'annotation dépréciée kubernetes.io/ingress.class)
  • rules
  • tls

Pour obtenir plus de détails sur chacun de ces champs, exécutez la commande kubectl explain ingress.spec.

Configuration du protocole​

Le service backend est configuré pour écouter uniquement en HTTPS, et votre Ingress doit être configuré en conséquence.

Si vous utilisez le NGINX Ingress controller, cette configuration est déjà gérée dans l'Ingress inclus via l'annotation nginx.ingress.kubernetes.io/backend-protocol: HTTPS. Cependant, si vous utilisez un ingress controller différent, vous devrez peut-être ajouter les annotations nécessaires dans la zone de texte fournie.

Exemple de configuration​

Voici un exemple de ce à quoi pourrait ressembler une configuration Ingress personnalisée :

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
annotations:
kubernetes.io/ingress.class: <ingress_class> # for ingress controllers that do not support ingressClassName
labels:
kots.io/app-slug: gitguardian-seal
kots.io/backup: velero
name: gitguardian
namespace: <your-namespace>
spec:
ingressClassName: <ingress_class> # for ingress controllers that support this field
rules:
- host: <application_hostname>
http:
paths:
- backend:
service:
name: gitguardian
port:
number: 443
path: /
pathType: Prefix
tls:
- hosts:
- <application_hostname>
secretName: <secret_name> # when using a kubernetes secret