Installation de AppScan 360° avec Helm

Une installation Helm de AppScan 360° nécessite une connexion Internet fiable et permanente, en plus des exigences de configuration de l'environnement AppScan 360°. Le système doit pouvoir télécharger régulièrement des graphiques Helm depuis HCL Harbor.

Avant l'installation de AppScan 360° avec Helm :
  • Vérifiez que vous disposez d'une connexion Internet stable et permanente pour télécharger des graphiques Helm à partir de GitHub et pour récupérer des images Docker et des packages Helm à partir de HCL Harbor.
  • Le fichier de configuration est disponible et correctement nommé.

Installer helmfile

Pour installer helmfile :
  1. Téléchargez le fichier binaire helmfile :
    wget https://github.com/helmfile/helmfile/releases/download/v0.169.1/helmfile_0.169.1_linux_amd64.tar.gz
  2. Procédez à l'extraction du fichier téléchargeable :
    tar -xvzf helmfile_0.169.1_linux_amd64.tar.gz
  3. Déplacez le fichier binaire helmfile vers un répertoire local approprié.
    Par exemple, usr/local/bin/.
    sudo mv helmfile /usr/local/bin/
  4. Donnez une autorisation exécutable au fichier :
    sudo chmod +x /usr/local/bin/helmfile
  5. Vérifiez l'installation :
    helmfile --version

Configurer la connexion à Harbor

Pour configurer la connexion à Harbor, procédez comme suit :
  • Utilisez la connexion Docker avec votre nom d'utilisateur username et votre mot de passe password comme défini dans le fichier cli-secret :
    docker login hclcr.io
  • Définissez les variables d'environnement pour le fichier docker/config.json :
    export HCLCR_USERNAME=<harbor-username>
export HCLCR_PASSWORD=<harbor-password/cli-secret>
  • Définissez les variables d'environnement pour le codage base64 :
    export AS360_KNI_JSON_CONFIG_AS_BASE64="<base64-value-of-docker-config.json>"

Configurer le référentiel GitHub

Le référentiel de AppScan 360° Helm est hébergé sur un serveur GitHub privé. Clonez le référentiel approprié à l'adresse https://github.com/HCL-TECH-SOFTWARE/ pour remplir correctement le référentiel local :
git clone --branch main https://github.com/HCL-TECH-SOFTWARE/AppScan-360-Helm-Files.git
Après le clonage, vérifiez que le référentiel local possède la structure suivante :
AppScan-360-Helm-Files
├── Helm.d
│   ├── helmfile-ASCP.yaml
│   ├── helmfile-ASRA.yaml
│   └── helmFileCustomization
│       ├── clusterKit.yaml
│       ├── singular-singular.clusterKit-Sample.yaml
│       └── siteKit.yaml
└── helmfile.yaml

Installer AppScan 360°

Dans le référentiel cloné (AppScan-360-Helm-Files), exécutez :
helmfile sync

Résolution des problèmes d'installation de Helm

  • No state file found

    Le fichier d'état doit être nommé helmfile.d/*.
    1. Accédez à AppScan-360-Helm-Files -> helm.d
    2. Exécutez run helmfile sync

  • ./helmfile.yaml: in .helmfiles[0]: in helm.d/helmfile-ASCP.yaml: failed processing release appscan360-ascp: values file matching "helmFileCustomizations/singular-singular.clusterKit.yaml" does not exist in "."

    Le fichier de propriétés (singular-singular.clusterKit.yaml) est manquant. Vérifiez que le fichier est au bon emplacement et réessayez.

  • Failed to pull helm-packages or docker images

    La connexion à Docker est manquante, ou les variables d'environnement HCLCR_USERNAME et HCLCR_PASSWORD sont manquantes. Vérifiez les informations de connexion et réessayez.

  • Failed to get pull secret

    Le fichier .docker/config.json est manquant ou AS360_KNI_JSON_CONFIG_AS_BASE64 avec la valeur appropriée n'est pas défini. Vérifiez les informations de connexion et réessayez.