Mise en route

Prérequis

• Vous avez installé le cluster Kubernetes.
• Vous avez installé Helm version 3.x ou ultérieure. Pour installer Helm, consultez Graphiques Helm.
• Vous avez installé les CRD de l'API Gateway à partir du canal standard officiel.

Comment déployer le contrôleur de passerelle NetScaler® Kubernetes dans un cluster Kubernetes

1. Générez values.yaml en fonction de votre cas d'utilisation. Pour plus d'informations sur les paramètres obligatoires et facultatifs que vous pouvez configurer lors de l'installation du contrôleur de passerelle NetScaler Kubernetes, consultez Configurations.
   netscaler:
  adcCredentialSecret: "nslogin"
  nsIP: "<nsIP>" # NetScaler Management IP or SNIP with management access enabled for HAor CLIP for
                 # NetScaler Cluster
gatewayController:
  entityPrefix: gwy
  gatewayControllerName: "citrix.com/nsgw-controller"
license:
  accept: yes
   Le nom d'utilisateur et le mot de passe d'un compte utilisateur système sur NetScaler MPX ou NetScaler VPX sont requis pour la passerelle Kubernetes. Assurez-vous que NetScaler dispose d'un compte utilisateur système non par défaut avec les privilèges nécessaires pour permettre au contrôleur de passerelle NetScaler Kubernetes de configurer NetScaler MPX ou VPX. Pour obtenir des instructions sur la création d'un compte utilisateur système sur NetScaler, consultez Créer un compte utilisateur système pour NetScaler Ingress Controller dans NetScaler.
   Vous pouvez fournir le nom d'utilisateur et le mot de passe directement ou utiliser les secrets Kubernetes. Pour utiliser les secrets Kubernetes, créez un secret pour le nom d'utilisateur et le mot de passe avec la commande suivante :
   kubectl create secret  generic nslogin --from-literal=username=<username> --from-literal=password=<password>
   Remarque :
   entityPrefix et gatewayControllerName sont obligatoires et doivent être uniques pour chaque déploiement du contrôleur de passerelle NetScaler Kubernetes.

2. Déployez le contrôleur de passerelle NetScaler Kubernetes à l'aide des graphiques Helm et de values.yaml généré à l'étape précédente. Pour plus d'informations, consultez Déploiement du contrôleur de passerelle NetScaler Kubernetes à l'aide du graphique Helm.
   helm repo add netscaler https://netscaler.github.io/netscaler-helm-charts/
helm install gateway-controller netscaler/netscaler-kubernetes-gateway-controller -f values.yaml
3. Vérifiez l'installation.
   kubectl get pods
4. (Facultatif) Afficher le résumé du pod NetScaler Kubernetes Gateway Controller.
   kubectl describe pod <pod name>
   Exemple :
   kubectl describe pod netscaler-kubernetes-gateway-controller-5678d66d9b-nqp6p
5. (Facultatif) Vérifier les journaux du NetScaler Kubernetes Gateway Controller.
   kubectl logs -f <pod name>
   Exemple :
   kubectl logs -f netscaler-kubernetes-gateway-controller-5678d66d9b-nqp6p
6. (Facultatif) Supprimer l'installation.
   helm uninstall gateway-controller

Comment déployer NetScaler CPX avec NetScaler Kubernetes Gateway Controller dans un cluster Kubernetes

1. Générez values.yaml en fonction de votre cas d'utilisation. Pour plus d'informations sur les paramètres obligatoires et facultatifs que vous pouvez configurer lors de l'installation de NetScaler CPX avec Kubernetes Gateway Controller, consultez Configurations.
   gatewayController:
    entityPrefix: gwy
    gatewayControllerName: "citrix.com/nscpxgw-controller"
license:
    accept: yes
service:
    annotations: {}
    spec:
        type: NodePort
        ports:
        - port: 80
          targetPort: 80
          protocol: TCP
          name: http
        - port: 443
          targetPort: 443
          protocol: TCP
          name: https
   Remarque :
   entityPrefix et gatewayControllerName sont obligatoires et doivent être uniques pour chaque déploiement de NetScaler CPX avec Kubernetes Gateway Controller.

2. Déployez le NetScaler CPX avec Kubernetes Gateway Controller à l'aide des charts Helm et du values.yaml généré à l'étape précédente. Pour plus d'informations, consultez Déploiement de NetScaler CPX avec Kubernetes Gateway Controller à l'aide du chart Helm.
   helm repo add netscaler https://netscaler.github.io/netscaler-helm-charts/
helm install cpx-gateway-controller netscaler/netscaler-cpx-with-gateway-controller  -f values.yaml
3. Vérifier l'installation.
   kubectl get pods
4. (Facultatif) Afficher le résumé du pod NetScaler Kubernetes Gateway Controller.
   kubectl describe pod <pod name>
   Exemple :
   kubectl describe pod cpx-gateway-controller-netscaler-cpx-with-gateway-controllz6ghg
5. (Facultatif) Vérifier les journaux du NetScaler Kubernetes Gateway Controller.
   kubectl logs -f <pod name> -c nskgwc
   Exemple :
   kubectl logs -f cpx-gateway-controller-netscaler-cpx-with-gateway-controllz6ghg -c nskgwc
6. (Facultatif) Supprimez l'installation.
   helm uninstall cpx-gateway-controller

La suite

• Déployer le contrôleur de passerelle Kubernetes NetScaler.
• Déployer NetScaler CPX avec le contrôleur de passerelle Kubernetes.