Helm を使用した AppScan 360° のインストール

Helm を使用した AppScan 360° のインストールには、AppScan 360° 環境のセットアップのほかに、永続的で信頼性の高いインターネット接続が必要です。システムは、HCL Harbor から定期的に Helm チャートをダウンロードできる必要があります。

Helm を使用して AppScan 360° をインストールする前に、次の手順を実行します。
  • GitHub から Helm チャートをダウンロードし、HCL Harbor から Docker イメージと Helm パッケージを取得するために安定した永続的なインターネット接続があることを確認します。
  • 構成ファイルが使用可能で、適切な名前が付けられていること

helmfile のインストール

helmfile をインストールするには、次の手順を実行します。
  1. helmfile バイナリー・ファイルをダウンロードします。
    wget https://github.com/helmfile/helmfile/releases/download/v0.169.1/helmfile_0.169.1_linux_amd64.tar.gz
  2. ダウンロードしたファイルを解凍します。
    tar -xvzf helmfile_0.169.1_linux_amd64.tar.gz
  3. helmfile バイナリーを適切なローカル・ディレクトリーに移動します。
    例えば、usr/local/bin/ です。
    sudo mv helmfile /usr/local/bin/
  4. ファイルに実行可能権限を与えます。
    sudo chmod +x /usr/local/bin/helmfile
  5. 次のようにして、インストールを確認します。
    helmfile --version

Harbor 接続をセットアップする

Harborへの接続をセットアップするには、次の手順を実行します。
  • usernamepassword (cli-secret で定義されている) を使用して、Docker ログインを使用します。
    docker login hclcr.io
  • docker/config.json ファイルの環境変数を設定します。
    export HCLCR_USERNAME=<harbor-username>
    export HCLCR_PASSWORD=<harbor-password/cli-secret>
  • base64 エンコーディングの環境変数を設定します。
    export AS360_KNI_JSON_CONFIG_AS_BASE64="<base64-value-of-docker-config.json>"

GitHub リポジトリーをセットアップする

AppScan 360° Helm のリポジトリーは、プライベート GitHub サーバー上でホストされています。https://github.com/HCL-TECH-SOFTWARE/ で、適切なリポジトリーのクローンを作成して、ローカル・リポジトリーに適切に入力します。
git clone --branch main https://github.com/HCL-TECH-SOFTWARE/AppScan-360-Helm-Files.git
クローンの作成後、ローカル・リポジトリーの構造が次のとおりであることを検証します。
AppScan-360-Helm-Files
├── Helm.d
│   ├── helmfile-ASCP.yaml
│   ├── helmfile-ASRA.yaml
│   └── helmFileCustomization
│       ├── clusterKit.yaml
│       ├── singular-singular.clusterKit-Sample.yaml
│       └── siteKit.yaml
└── helmfile.yaml

インストール AppScan 360°

クローンが作成されたリポジトリー (AppScan-360-Helm-Files) から、次のように実行します。
helmfile sync

Helm インストールのトラブルシューティング

  • No state file found

    状態ファイルには helmfile.d/* という名前を付ける必要があります。
    1. AppScan-360-Helm-Files -> helm.dに移動します。
    2. 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 "."

    プロパティー・ファイル (singular-singular.clusterKit.yaml) がありません。ファイルが適切な場所にあることを検証し、再試行してください。

  • Failed to pull helm-packages or docker images

    Docker ログインがないか、HCLCR_USERNAME および HCLCR_PASSWORD 環境変数がありません。ログイン情報を検証して再試行してください。

  • Failed to get pull secret

    .docker/config.json ファイルがないか、適切な値を持った AS360_KNI_JSON_CONFIG_AS_BASE64 が定義されていません。ログイン情報を検証して再試行してください。