Service NetScaler Console

Installer un opérateur d’agent NetScaler à l’aide de la console OpenShift

Remarque :

L’agent OpenShift est pris en charge uniquement dans le service NetScaler Console.

Un opérateur est une boîte à outils open source qui vous permet de déployer et de gérer les applications Kubernetes de manière efficace, automatisée et évolutive. En tant qu’administrateur, vous pouvez déployer un agent dans le cluster OpenShift à l’aide de l’opérateur d’agent NetScaler ADM.

Remarque :

Un agent configuré dans le cluster OpenShift n’est pas automatiquement mis à niveau par défaut.

Conditions préalables

Avant de déployer, assurez-vous que :

  • Vous disposez des contraintes de contexte de sécurité privilégiées pour contrôler les autorisations des pods. Pour l’agent, exécutez la commande suivante pour obtenir les contraintes de contexte de sécurité privilégiées pour le compte de service :

    oc adm policy add-scc-to-user privileged -z adm-agent-serviceaccount

  • Exécutez la commande suivante pour créer un secret de connexion d’agent :

    kubectl create secret generic admlogin --from-literal=username=nsroot --from-literal=password=<adm-agent-password> -n <namespace>

    Remarque :

    • <adm-agent-password> est un exemple de mot de passe. Vous devez définir un mot de passe pour l’agent et NetScaler CPX utilise ces informations d’identification pour s’enregistrer auprès de l’agent.

    • Fournissez admlogin pour loginSecret dans le fichier YAML de l’agent lors de la création de l’instance.

    Si vous déployez NetScaler CPX et l’agent dans des espaces de noms différents, assurez-vous de :

    • Étiqueter l’espace de noms avec citrix-cpx=enabled dans lequel NetScaler CPX a été déployé.

    • Définir helper.required sur true ou false lors de l’installation de l’opérateur d’agent.

      Remarque :

      Par défaut, helper.required est défini sur false. Si ce paramètre est défini sur false, vous devez vous assurer de créer le secret admlogin dans chaque espace de noms si NetScaler CPX et l’agent se trouvent dans des espaces de noms différents.

  • Vous disposez de accessSecret qui est requis dans le fichier YAML de l’agent. Ces informations d’identification sont nécessaires pour que l’agent se connecte au service NetScaler Console.

    kubectl create secret generic <secretname> --from-literal=accessid=<ID> --from-literal=accesssecret=<Secret> -n namespace

    Remarque :

    Fournissez un nom de secret pour accessSecret dans le fichier YAML de l’agent lors de la création de l’instance.

    Vous pouvez obtenir l’ID d’accès et le secret pour accéder à NetScaler Console en suivant la procédure suivante :

    1. Connectez-vous à la console de gestion Citrix Cloud.

    2. Dans le menu Citrix Cloud, sélectionnez Identity and Access Management.

      Gestion des identités et des accès

    3. Dans l’onglet API Access, entrez un nom de client sécurisé et cliquez sur Create Client.

      Accès API

    4. L’ID et le secret sont générés. Cliquez sur Download et enregistrez le fichier CSV.

      Fichier ID et secret

Installer l’opérateur d’agent

  1. Connectez-vous à la console du cluster OpenShift.

  2. Accédez à Operators > OperatorHub.

  3. Dans la barre de recherche, indiquez le nom de l’agent et sélectionnez l’opérateur d’agent NetScaler ADM, puis cliquez sur Install.

    Opérateur d'agent

  4. Dans la page Install Operator, vous avez deux options :

    • All namespaces on the cluster (default) - Permet à l’opérateur d’agent de s’abonner à tous les espaces de noms disponibles dans le cluster et vous permet d’initialiser l’instance de l’opérateur d’agent à partir de n’importe quel espace de noms du cluster.

    • A specific namespace on the cluster - Permet à l’opérateur d’agent de s’abonner à un espace de noms sélectionné sur le cluster et vous ne pouvez initialiser l’instance de l’opérateur d’agent qu’à partir de l’espace de noms sélectionné.

      Dans cet exemple, l’opérateur d’agent est affecté à un espace de noms appelé Default. Sélectionnez Automatic sous Update approval, puis cliquez sur Install.

      Installer

      Attendez que l’opérateur d’agent soit abonné avec succès.

      Abonné

  5. Accédez à Workloads > Pods et vérifiez que le pod netscaler-adm-agent-operator-controller est opérationnel.

  6. Une fois le pod opérationnel, cliquez sur Create Instance.

    Créer une instance

  7. Sélectionnez la YAML view pour mettre à jour les paramètres, puis cliquez sur Create.

    Remarque :

    Assurez-vous qu’il ne doit y avoir qu’une seule instance d’agent par cluster OpenShift.

    Vue YAML

  8. Accédez à Workloads > Pods et assurez-vous que les pods d’agent sont opérationnels.

    Vérifier le pod

Supprimer une instance d’agent

Vous pouvez supprimer l’instance d’agent du cluster en accédant à Operators > Installed Operators. Dans l’onglet NetScaler ADM Agent Operator, sélectionnez l’instance, puis sélectionnez Delete AdmAgent dans la liste.

Supprimer

Désinstaller l’opérateur d’agent

Si vous souhaitez désinstaller le pod de l’opérateur d’agent du cluster, accédez à Operators > Installed Operators, puis sélectionnez Uninstall Operator dans la liste.

Désinstaller l'opérateur

Installer un opérateur d’agent NetScaler à l’aide de la console OpenShift